アーキテクチャ
GMShop Edgeは、Cloudflare WorkersまたはBun/Nitro上でReact/TanStackのフルスタックを使用します。1回のデプロイで、公開ショップ、顧客アカウントエリア、決済、履行、サプライヤー連携、Telegram連携、および管理コンソールをすべてカバーします。
共有のアプリケーション境界
ルートは依然として細くなっています。機能ページ、スキーマ、サーバー関数、およびドメインの動作は src/features に存在します。クロスドメインの実行時の仕組みは src/server にあります。Drizzle のスキーマは src/db/schema にあります。
このアプリケーションは、権威あるデータベースに、ID、RBAC(役割ベースアクセス制御)、カタログ、注文、在庫、権限、サプライヤーの状態、ウォレットの記録、通知、再生防止、レート制限、アウトボックス、および監査データを保持します。金額は、小単位の十進整数文字列として保存され、浮動小数点数との計算は行いません。
Cloudflare Workers アダプター
労働者の配置は:
DB:権威ある用途および商業状態について、D1。FILES: 商品メディア、ダウンロード用ファイル、自動処理の生成物、エクスポートを保存する非公開 R2。CACHE: 検証済み、バージョン管理された、範囲指定された読み込みキャッシュ。セキュリティの制限は、データベースに依存した状態を維持します。COMMERCE_QUEUE: 配送、自動化、通知、サプライヤー、および返金に関連する作業用のキュー。死キューも含まれます。EMAIL: Cloudflare Send Email の任意のバインディング。- スケジュールされた処理およびメンテナンスのための、1分間のCronトリガー。
ブン/ニトロ アダプター
Bun 実行環境は、一つのデータディレクトリ内に、対応するアダプターを提供します。
- SQLite を、主要なデータベースとして。
- 進行中の、容量制限付きキャッシュ。
- プライベートなローカルオブジェクトストレージ。
- 耐久性のある、SQLite をバックアップしたキュー。
- ワンミ分のリアルタイムスケジューラ。
GMSHOP_DATA_DIR には、データベース、オブジェクト、キューの状態、および実行時のデータが含まれます。Bun は、意図的に シングルインスタンスのみ をサポートしています。マルチレプリカの展開や共有ネットワークストレージはサポートされていません。
データと基礎的な作業
プライベートなオブジェクトは、承認されたデータベース記録に基づいて処理されます。クライアントは、直接オブジェクトのキーを選択することはありません。キューとスケジュールされた作業は、サプライヤーの同期、購買、履行、通知、払い戻し、再試行、保持、Telegramのメンテナンス、および同期されていないストアフロントリクエストの外で、これらの処理を行います。
クリーンインストール時の移行の基準は drizzle/0000_gmshop.sql です。 その後、他の移行は順番に適用され、Bun データ操作によってチェックサムが検証されます。