Skip to content

Latest commit

 

History

History
153 lines (90 loc) · 3.62 KB

ARCHITECTURE.md

File metadata and controls

153 lines (90 loc) · 3.62 KB

アーキテクチャの概要

ディレクトリ構造

app/

React アプリケーションのソースコード

app/components/

React Component

app/components/atoms/

ボタンなどの最小単位のコンポーネント

app/components/molecules/

ドロワーなどのatomsよりも大きなコンポーネント

app/components/organisms/

カードなどのatomsやmoleculesよりも大きなコンポーネント

app/components/organisms/kitchen/

厨房画面で使用するコンポーネント

app/components/organisms/reception/

受付画面で使用するコンポーネント

app/components/organisms/register/

登録画面で使用するコンポーネント

app/crud/

データベースを操作に関連する関数など

app/hooks/

React Hooksのカスタムフック

app/routes/

ルーティングやサイドバー、ヘッダー

app/styles/

アプリケーションのスタイル管理

app/type/

TypeScriptの型定義

prisma/

prismaに関連する設定ファイルやスキーマ定義

public/

静的ファイル（画像やアイコンなど）

データベースのバックアップと永続化

このプロジェクトでは、SQLiteデータベースのバックアップと永続化にLitestreamを使用しています。

フローチャート

flowchart LR
    subgraph CloudRun[Cloud Run]
        direction TB
        RemixApp[Remix App]
        Litestream[Litestream]
    end

    subgraph CloudStorage[Cloud Storage]
        DB[/prod.db/]
    end

    RemixApp --> Litestream
    Litestream -->|replicate| DB
Loading

動作の仕組み

  1. データベースの復元

    • コンテナ起動時、Google Cloud Storageから最新のバックアップを復元
    • 初回起動時やバックアップが存在しない場合は、空のデータベースを使用

  2. リアルタイムレプリケーション

    • アプリケーション実行中、データベースの変更をCloud Storageに自動的にレプリケート
    • WALモードの無効化によりPrismaとの互換性を確保

制限事項

  1. インスタンス数の制限

    • Cloud Runのインスタンス数は最大1に制限
    • 複数インスタンスでの同時実行はデータ整合性の問題を引き起こす可能性あり

  2. Prismaとの互換性

    • PrismaはSQLiteのWALモードに非対応
    • 起動時にPRAGMA journal_mode=DELETEを実行して対応

開発環境との違い

開発環境では通常のSQLiteデータベースとして動作し、Litestreamは使用しません。本番環境（Cloud Run）でのみLitestreamによるバックアップと永続化が有効になります。

デプロイ時の設定

  1. 必要な環境変数

    LITESTREAM_BUCKET=<バックアップ先のバケット名>

  2. 必要な権限

    • Cloud Run サービスアカウントに以下の権限が必要：
      • roles/storage.objectViewer
      • roles/storage.objectCreator

トラブルシューティング

  1. データベースロックエラー

    Error: SQLite database error
database is locked

    対処法：

    • アプリケーションの再起動
    • WALモードが正しく無効化されているか確認

  2. バックアップの確認

    # バックアップの存在確認
gcloud storage ls gs://<BUCKET_NAME>/prod.db/

参考リンク