======================================================================== 負荷テスト仕様 (Load Test Specification) ======================================================================== 1. 概要 (Overview) ------------------------------------------------------------------------ 1-1. 目的 大人数同時接続時のサーバー安定性を検証する． 実際のプレイヤーと同等の通信・ゲームプレイをシミュレートするBotを 複数同時接続し，サーバーの処理能力と通信の健全性を確認する． 1-2. テストツール ・ファイル: test/load-bot.ts ・言語: TypeScript（ts-node で直接実行） ・通信: Socket.IO クライアント ・設定ファイル: test/load-bot.constants.ts ・環境変数: test/.env.local 1-3. テスト構成 ・1体目のBot（index=0）がオーナーとしてルームを作成し，ゲーム開始を実行する ・残りのBotが順次参加し，ゲーム中のプレイヤー動作をシミュレートする ・ゲーム終了通知を受信したら全Botが切断する ※ 環境構築・実行手順は docs/02_ENV/ENV_06_テスト操作手順.txt を参照すること 2. Botのシミュレーション動作 (Bot Behavior) ------------------------------------------------------------------------ 2-1. 接続・入室 ■ 接続 ・Socket.IOで指定URLに接続する ・トランスポート: websocket, polling ・再接続: 無効（reconnection: false） ・タイムアウト: 10秒 ■ 入室 ・接続直後にjoin-roomイベントを送信する ・プレイヤー名: "bot-{index}"（0始まり） ・ルームID: 定数で指定（既定: "1"） ■ 参加タイミングの分散 ・各Botの接続開始を JOIN_DELAY_MS（既定: 25ms）ずつずらす ・接続スパイクによるサーバー負荷集中を回避する 2-2. ゲーム開始 ■ オーナーBot（index=0）の動作 ・接続後 START_DELAY_MS（既定: 800ms）経過後にstart-gameイベントを送信する ・不足分はサーバー側でBot AIが補充される ■ 全Botの動作 ・game-startイベント受信後にready-for-gameを送信する ・game-startに含まれるstartTimeまで待機してからゲームプレイを開始する ・gridCols/gridRowsを受信し，フィールドサイズを動的に更新する 2-3. クロック同期 ■ Ping/Pong ・5秒間隔でpingイベントを送信する（初回は接続直後に即時送信） ・pong受信時にRTTを計測し，clockOffsetMsを更新する ・計算式: clockOffsetMs = serverTime + (RTT / 2) - clientNow ■ game-start時の補正 ・game-startペイロードのserverNowでclockOffsetMsを上書きする ・ゲーム開始直前に最も正確なオフセットを取得する ■ 経過時間の算出 ・getElapsedMs() = max(0, getServerNow() - gameStartTimeMs) ・ボムの爆発判定やフィーバータイム判定に使用する 2-4. 移動 ■ 移動方式 ・MOVE_TICK_MS（既定: 50ms）間隔で位置を更新し，moveイベントを送信する ・ランダムな角度で方向を決定し，BOT_SPEEDで直線移動する ・フィールド端に到達したら方向をランダムに再設定する（壁反射） ■ ハリケーン回避 ・ハリケーンの直径×1.5の範囲内に入った場合，逃げる方向へ移動方向を変更する ・複数のハリケーンが近い場合，回避ベクトルを合算して逃げる方向を決定する ■ スタン中の動作 ・isStunned()がtrueの間は移動とボム設置をスキップする 2-5. ボム設置 ■ 設置条件 ・BOT_CAN_PLACE_BOMBがtrueであること ・ゲームが開始済みであること ・スタン中でないこと ・前回設置からクールダウン時間が経過していること ■ クールダウン ・通常時: BOMB_NORMAL_COOLDOWN_MS（既定: 4000ms） ・フィーバータイム時: BOMB_FEVER_COOLDOWN_MS（既定: 2000ms） ・フィーバー判定: 残り時間 ≤ 60秒 ■ 送信データ ・requestId: "{botIndex}-{serial}" で一意に生成する ・x, y: Botの現在座標 ・explodeAtElapsedMs: 現在の経過時間 + BOMB_FUSE_MS ■ 設置タイミング ・移動tickのたびに設置条件を判定し，条件を満たせば即座に設置する 2-6. 被弾・リスポーン ■ 爆弾の被弾判定 ・他プレイヤーのbomb-placedイベントを受信し，trackedBombsに登録する ・100ms間隔で爆発時刻に達したボムを走査する ・爆発範囲（BOMB_RADIUS_GRID + PLAYER_RADIUS）内にいれば被弾処理を実行する ・自チームのボムは友軍撃ちとして無視する（ownerTeamId === myTeamId） ■ 被弾処理（爆弾・ハリケーン共通） ・hitCountを1増加させる ・5回未満: PLAYER_HIT_STUN_MS（既定: 1000ms）のスタンを適用する ・5回到達: リスポーンを実行する - hitCountを0にリセットする - PLAYER_RESPAWN_STUN_MS（既定: 2000ms）のスタンを適用する - スタン明け後の次回tickMoveで初期スポーン座標に戻る ■ 爆弾の被弾報告 ・被弾と判定した場合，bomb-hit-reportイベント（bombId）をサーバーに送信する ・サーバーはplayer-hitを被弾者以外に送信するため，自分のhitCountはクライアント側で管理する ■ ハリケーン被弾 ・hurricane-hitイベントで自分のplayerIdが含まれていれば被弾処理を実行する 2-7. ゲーム終了 ■ 終了処理 ・game-endまたはgame-resultイベントを受信したら以下を実行する - gameEndedフラグをtrueに設定する - 全タイマー（移動・Ping・ボム判定）を停止する - ソケットを切断する 3. 統計収集 (Statistics) ------------------------------------------------------------------------ 3-1. 収集項目 ・connected: 接続成功数 ・joined: ルーム参加数 ・startSent: ゲーム開始リクエスト送信数 ・moveSent: 移動イベント送信数 ・disconnects: 切断数 ・errors: 接続エラー数 ・gameStarts: ゲーム開始通知受信数 3-2. 出力タイミング ・テスト開始時: 設定値一覧を標準出力する ・テスト終了時: 最終統計を標準出力する 4. 確認観点 (Verification Points) ------------------------------------------------------------------------ 4-1. サーバー安定性 ・指定Bot数での同時接続中にサーバーがクラッシュしないこと ・全Botが正常にルーム参加・ゲーム開始できること ・ゲーム終了まで切断エラーが発生しないこと 4-2. パフォーマンス ・サーバーのティック処理時間が50ms以内に収まること - サーバーログの avgTickMs / maxTickMs を確認する ・CPU使用率（cpuUsagePct）が許容範囲内であること ・推定送信帯域（outboundBytesPerSec）が過大でないこと 4-3. ゲームプレイの正常性 ・Botの移動座標がサーバーに正しく同期されること ・ボムの設置・爆発が正常に処理されること ・被弾・リスポーンが正常に動作すること ・ハリケーンの出現・被弾が正常に処理されること 4-4. 段階的テスト ・少数（4〜8体）から開始し，段階的にBot数を増やすこと ・各段階でサーバーログを確認してからBot数を引き上げる ・本番サーバーに対して実施する場合は管理者へ事前連絡すること