========================================================================
ソースコードディレクトリ構造 (Source Code Directory Structure)
========================================================================
1. 概要 (Overview)
------------------------------------------------------------------------
本ドキュメントは apps/client/src，apps/server/src，packages/shared/src 配下の
ソースコード構造を定義する．
プロジェクト全体の構成（設定ファイル・インフラ）については ENV_01 を参照すること．
記載粒度: 全フォルダを漏れなく記載する．ファイルはエントリーポイント（index.ts・main.tsx 等）のみ明記する．
フォルダを追加・削除・移動した場合は本ドキュメントを合わせて更新すること．
2. クライアント (apps/client/src)
------------------------------------------------------------------------
2-1. 構成一覧
src/
├── main.tsx # 起動エントリ
├── app.tsx # ルートUI
├── components/ # 共通コンポーネント
├── config/ # クライアント設定
├── hooks/ # グローバルフック
│ ├── application/ # アプリケーション層フック
│ └── types/ # フック型定義
├── network/ # サーバー通信層
│ └── handlers/ # WSハンドラ・イベントブリッジ
├── styles/ # 全体スタイル
└── scenes/ # 画面シーン群
├── game/ # ゲーム画面
│ ├── application/ # ゲームアプリケーション層
│ │ ├── assets/ # ゲームアセット管理
│ │ ├── combat/ # 戦闘処理
│ │ ├── culling/ # 描画カリング
│ │ ├── lifecycle/ # ライフサイクル管理
│ │ ├── loopSteps/ # ゲームループステップ
│ │ ├── network/ # ゲームネットワーク処理
│ │ │ ├── adapters/ # ネットワークアダプタ
│ │ │ ├── handlers/ # ネットワークハンドラ
│ │ │ └── receivers/ # 受信処理
│ │ ├── orchestrators/ # オーケストレータ
│ │ ├── runtime/ # ランタイム管理
│ │ ├── time/ # 時刻・タイマー管理
│ │ └── ui/ # UI制御
│ ├── entities/ # 描画・状態管理エンティティ
│ │ ├── bomb/ # 爆弾エンティティ
│ │ ├── hurricane/ # ハリケーンエンティティ
│ │ ├── map/ # マップエンティティ
│ │ └── player/ # プレイヤーエンティティ
│ ├── hooks/ # ゲーム画面フック
│ ├── input/ # 入力UI群
│ │ ├── bomb/ # 爆弾ボタンUI
│ │ │ ├── hooks/ # 爆弾ボタンフック
│ │ │ └── presentation/ # 爆弾ボタン表示
│ │ ├── hooks/ # 入力共通フック
│ │ ├── joystick/ # ジョイスティックUI
│ │ │ ├── common/ # スティック定数・型
│ │ │ ├── hooks/ # スティック制御フック
│ │ │ ├── model/ # スティックモデル
│ │ │ └── presentation/ # スティック描画
│ │ ├── minimap/ # ミニマップUI
│ │ │ ├── hooks/ # ミニマップフック
│ │ │ └── presentation/ # ミニマップ表示
│ │ └── presentation/ # 入力UI共通表示
│ ├── presentation/ # ゲームHUD
│ └── styles/ # ゲーム画面スタイル
├── lobby/ # ロビー画面
│ ├── components/ # ロビーUIコンポーネント
│ ├── presentation/ # ロビー表示ロジック
│ └── styles/ # ロビースタイル
├── result/ # リザルト画面
│ ├── components/ # リザルトUIコンポーネント
│ ├── hooks/ # リザルト画面フック
│ ├── styles/ # リザルト画面スタイル
│ └── types/ # リザルト画面型定義
├── shared/ # シーン間共通リソース
│ └── styles/ # シーン共通スタイル
└── title/ # タイトル画面
2-2. 設計方針
・scenes/ 配下にシーン単位（title，lobby，game，result）で分割する
・各シーンは MVC ベースの構成とし，entities/ に描画対象を集約する
・network/ 層がサーバーとの通信を担当し，scenes/ 内から直接 protocol を参照しない
3. サーバー (apps/server/src)
------------------------------------------------------------------------
3-1. 構成一覧
src/
├── index.ts # サーバー起点
├── application/ # アプリケーション統合層
│ └── coordinators/ # アプリ統合制御
├── common/ # 共通ユーティリティ
├── config/ # サーバー設定
├── logging/ # ログ出力基盤
│ ├── constants/ # ログ定数
│ └── contracts/ # ログ契約型
├── domains/ # ビジネスロジック層
│ ├── game/ # ゲームドメイン
│ │ ├── application/ # ゲームアプリケーション層
│ │ │ ├── ports/ # ユースケース入出力境界
│ │ │ ├── services/ # ゲームサービス群
│ │ │ │ └── bot/ # Bot AIシステム
│ │ │ │ ├── adapters/ # Botアダプタ
│ │ │ │ ├── combat/ # Bot戦闘行動
│ │ │ │ ├── movement/ # Bot移動処理
│ │ │ │ ├── orchestrators/ # Botオーケストレータ
│ │ │ │ ├── policies/ # Bot行動ポリシー
│ │ │ │ ├── roster/ # Bot管理・編成
│ │ │ │ ├── state/ # Bot状態管理
│ │ │ │ └── types/ # Bot型定義
│ │ │ └── useCases/ # ゲームユースケース
│ │ ├── entities/ # ゲームエンティティ
│ │ │ ├── bomb/ # 爆弾エンティティ
│ │ │ ├── map/ # マップ状態
│ │ │ └── player/ # プレイヤーエンティティ
│ │ └── loop/ # ゲームループ
│ │ └── hurricane/ # ハリケーン詳細処理
│ └── room/ # ルームドメイン
│ └── application/ # ルームアプリケーション層
│ ├── ports/ # ユースケース入出力境界
│ ├── services/ # ルームサービス群
│ └── useCases/ # ルームユースケース
└── network/ # Socket.IO通信層
├── adapters/ # 送信アダプタ群
├── bootstrap/ # 起動配線
├── handlers/ # イベントハンドラ群
│ ├── game/ # ゲームイベントハンドラ
│ │ ├── aoi/ # 視認範囲フィルタ処理
│ │ ├── input/ # ゲーム入力ハンドラ
│ │ ├── runtime/ # ゲームランタイム解決
│ │ └── services/ # ゲーム同期サービス群
│ ├── registration/ # 接続登録コンテキスト
│ └── room/ # ルームハンドラ群
├── types/ # ネットワーク型定義
└── validation/ # ペイロード検証
3-2. 設計方針
・domains/ にビジネスロジックを集約し，game/ と room/ に分離する
・network/ 層が Socket.IO の接続管理・イベント配線を担当する
・domains/ は protocol を直接参照せず，ports/ 経由で network 層と連携する
・loop/ 配下にサーバーティック（20Hz）とハリケーンシステムを配置する
4. 共有パッケージ (packages/shared/src)
------------------------------------------------------------------------
4-1. 構成一覧
src/
├── index.ts # 共有エクスポート
├── config/ # 共通設定・定数
├── domains/ # 共有ドメインロジック
│ ├── app/ # アプリ定数・型
│ ├── game/ # ゲームドメイン共有ロジック
│ │ ├── aoi/ # 視認範囲ロジック
│ │ ├── bombHit/ # 爆弾判定ロジック
│ │ ├── gridMap/ # マップ計算・型
│ │ ├── player/ # プレイヤー型・移動同期
│ │ └── tick/ # ティックシステム
│ └── room/ # ルーム定数・型
└── protocol/ # ソケットイベント定義
├── maps/ # イベント方向別型マップ
└── payloads/ # イベントペイロード型
4-2. 設計方針
・client と server の両方から import される「真実の定義場所」として機能する
・config/ にゲーム定数・通信設定を集約する
・domains/ にドメインロジック（移動計算・マップ・判定）を配置する
・protocol/ にソケットイベント定義・ペイロード型・型マッピングを一元管理する
・protocol/events.ts は再公開専用とし，型本体を置かない（GUIDE_05 参照）
