========================================================================
ソースコードディレクトリ構造 (Source Code Directory Structure)
========================================================================
1. 概要 (Overview)
------------------------------------------------------------------------
本ドキュメントは apps/client/src，apps/server/src，packages/shared/src 配下の
ソースコード構造を定義する．
プロジェクト全体の構成（設定ファイル・インフラ）については ENV_01 を参照すること．
2. クライアント (apps/client/src)
------------------------------------------------------------------------
2-1. 構成一覧
src/
├── app.tsx # ルートUI
├── index.css # 全体スタイル
├── main.tsx # 起動エントリ
├── vite-env.d.ts # Vite型定義
├── assets/ # 画像素材
├── components/
│ └── LandscapeOnlyGate.tsx # 横向き制御ゲート
├── config/
│ └── index.ts # クライアント設定
├── hooks/
│ ├── useAppFlow.ts # 画面遷移フック
│ ├── useSocketSubscriptions.ts # WS購読フック
│ ├── application/ # アプリケーション層フック
│ └── types/ # フック型定義
├── network/
│ ├── SocketManager.ts # WSクライアント
│ └── handlers/
│ ├── CommonHandler.ts # 共通WSハンドラ
│ ├── GameHandler.ts # ゲームWSハンドラ
│ ├── GameSyncHandler.ts # ゲーム同期ハンドラ
│ ├── LobbyHandler.ts # ロビーWSハンドラ
│ ├── TitleHandler.ts # タイトルWSハンドラ
│ └── socketEventBridge.ts # イベントブリッジ
├── styles/
│ └── safeArea.ts # セーフエリア定義
└── scenes/
├── game/
│ ├── GameManager.ts # ゲーム制御
│ ├── GameScene.tsx # ゲーム画面
│ ├── GameView.tsx # ゲーム描画
│ ├── application/ # ゲームアプリケーション層
│ ├── entities/
│ │ ├── bomb/ # 爆弾エンティティ
│ │ ├── hurricane/ # ハリケーンエンティティ
│ │ ├── map/
│ │ │ ├── GameMapController.ts # マップ制御
│ │ │ ├── GameMapModel.ts # マップモデル
│ │ │ └── GameMapView.ts # マップ描画
│ │ └── player/
│ │ ├── PlayerController.ts # プレイヤー制御
│ │ ├── PlayerModel.ts # プレイヤーモデル
│ │ ├── PlayerRepository.ts # プレイヤーリポジトリ
│ │ └── PlayerView.ts # プレイヤー描画
│ ├── hooks/ # ゲーム画面フック
│ ├── input/
│ │ ├── GameInputOverlay.tsx # 入力オーバーレイ
│ │ ├── bomb/ # 爆弾ボタンUI
│ │ ├── hooks/ # 入力共通フック
│ │ ├── minimap/ # ミニマップUI
│ │ ├── joystick/
│ │ │ ├── common/ # スティック定数・型
│ │ │ ├── model/ # スティックモデル
│ │ │ ├── hooks/ # スティック制御フック
│ │ │ └── presentation/ # スティック描画
│ │ └── presentation/ # 入力UI共通表示
│ ├── presentation/ # ゲームHUD
│ └── styles/ # ゲーム画面スタイル
├── lobby/
│ ├── LobbyScene.tsx # ロビー画面
│ ├── components/ # モーダル・設定UI
│ ├── presentation/ # ロビー表示ロジック
│ └── styles/ # ロビースタイル
├── result/
│ ├── ResultScene.tsx # 結果画面
│ ├── components/ # ランキング・統計表示
│ ├── hooks/ # 結果画面フック
│ ├── styles/ # 結果画面スタイル
│ └── types/ # 結果画面型定義
├── shared/
│ └── styles/ # シーン共通スタイル
└── title/
└── TitleScene.tsx # タイトル画面
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/
│ ├── logger.ts # ログ出力
│ ├── constants/ # ログ定数
│ └── contracts/ # ログ契約型
├── domains/
│ ├── game/
│ │ ├── GameManager.ts # ゲーム状態管理
│ │ ├── application/
│ │ │ ├── ports/
│ │ │ │ └── gameUseCasePorts.ts # ユースケース入出力境界
│ │ │ ├── services/
│ │ │ │ ├── GameSessionLifecycleService.ts # セッション管理
│ │ │ │ ├── GamePlayerOperationService.ts # プレイヤー操作
│ │ │ │ ├── GameRoomSession.ts # ルームセッション
│ │ │ │ ├── TeamAssignmentService.ts # チーム割当
│ │ │ │ ├── currentPlayersBootstrapBuilder.ts # 初期プレイヤー構築
│ │ │ │ ├── gameResultCalculator.ts # 結果算出
│ │ │ │ └── bot/ # Bot AIシステム
│ │ │ └── useCases/ # ゲームユースケース
│ │ ├── entities/
│ │ │ ├── bomb/ # 爆弾エンティティ
│ │ │ ├── map/
│ │ │ │ └── MapStore.ts # マップ状態保持
│ │ │ └── player/
│ │ │ └── Player.ts # サーバーPlayer
│ │ └── loop/
│ │ ├── GameLoop.ts # 固定ループ (20Hz)
│ │ ├── HurricaneSystem.ts # ハリケーン制御
│ │ └── hurricane/ # ハリケーン詳細処理
│ └── room/
│ ├── RoomManager.ts # ルーム管理
│ └── application/
│ ├── ports/
│ │ └── roomUseCasePorts.ts # ユースケース入出力境界
│ ├── services/ # ルームサービス群
│ └── useCases/ # ルームユースケース
└── network/
├── SocketManager.ts # WS接続管理
├── adapters/
│ ├── socketEmitters.ts # 送信アダプタ
│ ├── gamePayloadSanitizers.ts # ゲームペイロード検証・整形
│ └── realtimeRoomSyncState.ts # リアルタイムルーム同期状態
├── handlers/
│ ├── CommonHandler.ts # 共通WSハンドラ
│ ├── connectionEventLogger.ts # 接続イベントログ
│ ├── createOutputAdapters.ts # 出力アダプタ生成
│ ├── eventDefinitionRegistrar.ts # イベント定義登録
│ ├── orchestratorEventLogger.ts # オーケストレータログ
│ ├── payloadGuard.ts # ペイロードガード
│ ├── registerConnectionHandlers.ts # 接続ハンドラ登録
│ ├── socketEventBridge.ts # イベントブリッジ
│ ├── registration/ # 接続登録コンテキスト
│ ├── game/
│ │ ├── registerGameHandlers.ts # ゲーム受信イベント配線
│ │ ├── createGameOutputAdapter.ts # ゲーム出力アダプタ生成
│ │ ├── gameEventOrchestrators.ts # ゲームイベントオーケストレータ
│ │ ├── aoi/ # 視認範囲フィルタ処理
│ │ ├── runtime/ # ゲームランタイム解決
│ │ └── services/ # ゲーム同期サービス群
│ └── room/
│ ├── registerRoomHandlers.ts # ルーム受信イベント配線
│ ├── createRoomOutputAdapter.ts # ルーム出力アダプタ生成
│ └── roomEventOrchestrators.ts # ルームイベントオーケストレータ
├── bootstrap/
│ ├── boot.ts # 起動配線
│ ├── createHttpServer.ts # HTTP生成
│ ├── createIo.ts # Socket.IO生成
│ └── createServerRuntime.ts # ランタイム生成
├── 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/
│ ├── index.ts # 設定エクスポート
│ ├── gameConfig.ts # 共通定数
│ ├── networkConfig.ts # 通信設定
│ └── teamValidators.ts # チーム検証
├── domains/
│ ├── app/
│ │ ├── app.const.ts # アプリ定数
│ │ └── app.type.ts # アプリ型
│ ├── game/
│ │ ├── aoi/ # 視認範囲 (Area of Interest)
│ │ ├── bombHit/ # 爆弾判定ロジック・型
│ │ ├── gridMap/
│ │ │ ├── gridMap.logic.ts # マップ計算
│ │ │ ├── gridMap.type.ts # マップ型定義
│ │ │ └── groupedCellUpdates.ts # セル更新グループ化
│ │ ├── player/
│ │ │ ├── player.type.ts # プレイヤー型
│ │ │ └── moveSync.ts # 移動同期ロジック
│ │ └── tick/ # ティックシステム
│ └── room/
│ ├── room.const.ts # ルーム定数
│ └── room.type.ts # ルーム型
└── protocol/
├── socketEvents.ts # イベント名定義
├── eventPayloads.ts # ペイロード再公開
├── eventPayloadMaps.ts # 型マッピング
├── socketEventBridge.ts # 型安全ブリッジ
├── events.ts # イベント再公開
├── bombIdentity.ts # 爆弾一意性保証
├── payloads/
│ ├── commonPayloads.ts # 共通ペイロード型
│ ├── gamePayloads.ts # ゲームペイロード型
│ ├── lobbyPayloads.ts # ロビーペイロード型
│ └── playerHitEffectPayloads.ts # ヒットエフェクト型
└── maps/
├── commonEventPayloadMap.ts # 共通イベントマップ
├── gameEventPayloadMap.ts # ゲームイベントマップ
└── lobbyEventPayloadMap.ts # ロビーイベントマップ
4-2. 設計方針
・client と server の両方から import される「真実の定義場所」として機能する
・config/ にゲーム定数・通信設定を集約する
・domains/ にドメインロジック（移動計算・マップ・判定）を配置する
・protocol/ にソケットイベント定義・ペイロード型・型マッピングを一元管理する
・protocol/events.ts は再公開専用とし，型本体を置かない（GUIDE_05 参照）
