# アーキテクチャ 

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 データ操作によってチェックサムが検証されます。
