不具合の修正
— 異世界衰弱・ログ・管理画面

2026年3月公開（異世界衰弱の部屋・再戦・ログまわり）

「異世界衰弱」のマルチプレイとログまわりで、ロビー人数の表示ずれや再戦カウントダウンの開始・停止の仕様、本番環境でのログ保存・管理画面からの確認ができるようにする修正を行いました。テーマは「不具合の修正」として、実施した内容をまとめます。

1. 修正・対応した内容の一覧

部屋まわりのログ強化 — list_rooms の返却内容（部屋一覧の要約）をログに記録。部屋状態更新時（参加・退出・再戦辞退）に room_updated をログ出力。
再戦で「いいえ」／未選択の人の扱い — ロビー人数表示が正しく更新されることを確認。カウントダウン終了時に「いいえ／未選択」の人を Socket の部屋から leave_room するよう修正（表示と実態の一致）。
再戦カウントダウンの仕様変更 — カウント開始を「終了ポップアップ表示時」に統一。「はい」を押してもカウントを止めず・リセットしない（30→0 のまま進行）。サーバーが rematch_pending に countdown_ends_at を含めるよう変更。
ゲームログの網羅 — サーバー側に rematch_decliners_left・rematch_show_room_sent・rematch_timeout_all_left・cards_revealed・turn_timer_reset などを追加。クライアント側に再戦ポップアップ表示・タイムアウト／辞退受信時のログを追加。
WEB公開時もログを記録・毎日17時にクリア — 本番でも同じログファイルに記録。毎日17時（サーバーローカル時刻）にログをクリアするバックグラウンドスレッドを追加。deploy_remote.sh でログ用ディレクトリ作成、DEPLOY.md に説明を追記。
管理画面に「異世界衰弱ログ」タブを追加 — 管理用ログイン（Basic認証）のみアクセス可能な /share/admin に「異世界衰弱ログ」タブを追加。タブクリックで main に fantasy_debug.log の内容（直近約200万文字）を表示。

2. ロビー人数表示まわり

「再戦しますか？」で「いいえ」を選んだ人や、何も押さなかった人（未選択＝いいえ扱い）がロビーにいるあいだ、部屋一覧の「○/4人」が正しく減るかが課題でした。ログの参照元はサーバーの room["players"] のみであり、退出時に _fantasy_emit_room_list_updated() を呼んでいるため、表示は正しく更新されることを確認しました。あわせて、カウントダウン終了時に「いいえ／未選択」の人を Socket の部屋から leave_room する処理を追加し、部屋所属と表示の整合をとりました。

3. 再戦カウントダウン

もともとは「はい」または「いいえ」を押してからカウントが動き、押した人によってはカウントが止まっているように見える状態でした。修正後は次のとおりです。

開始 — ゲーム終了ポップアップ「再戦しますか？」が表示された時点でカウント開始。サーバーが rematch_pending に countdown_ends_at を付与し、クライアントはそれを使って表示。
「はい」を押したとき — カウントは止めず・リセットしない。メッセージを「参加しました。」に変えるだけ。30→0 まで常にカウントダウン表示。
「いいえ」「参加を取り消す」 — 従来どおりロビーに戻し、その人用のカウント表示は終了。

4. ログの保存と管理画面での確認

ログは test/game-card-fantasybattle/fantasy_debug.log に追記されます。ローカル・本番どちらでも同じパス（app.py 実体基準）で記録されます。毎日17時ちょうど（サーバーのローカル時刻）にファイルをクリアするバックグラウンドスレッドを起動しており、日本時間で運用する場合はサーバーのタイムゾーンを JST にしておきます。

管理者は、管理用ログイン（Basic認証）後に /share/admin を開き、右端の「異世界衰弱ログ」タブをクリックすると、main エリアに上記ログの内容（直近約200万文字）が表示されます。誰でも見られるURLにはしておらず、管理用ログインだけがアクセスできる形にしています。

5. 関連ドキュメント・画面

フローチャート（1回目→3回目ゲーム・4人→2人→1人再戦希望）… fantasy_flowchart_1st_to_3rd.html（機能別フローチャート一覧からも参照可）
デプロイ後のログ・17時クリアの説明 … DEPLOY.md の「5-4. ゲーム（異世界衰弱）のログ」
サーバー時刻の確認 … date / timedatectl。ログの末尾確認 … tail -n 50 ~/make-001/test/game-card-fantasybattle/fantasy_debug.log

6. 追記（追加履歴）

以下は追記した箇所です。見出しに【追記】と日付（YYYY-MM-DD）を付け、直後に「追記日時: 〇〇年〇月〇日」を記載しています。今後も同じ形式（id="addendum-YYYY-MM-DD" の h3 ＋日時＋箇条書き）で追記していく予定です。

【追記】2026-03-20（ゲーム終了後フローの実地デバッグと修正）

追記日時: 2026年3月20日

対象とした確認フロー — test/game-card-fantasybattle/docs/game-end-to-lobby-flowchart.html と関連仕様（GAME-END-SPEC.md）を基準に、2人戦＋観戦者、4人戦＋観戦者の終了後遷移を実機で再検証。特に「再戦不成立なら部屋を閉じ、ロビーへ戻す」意図（部屋上限10の圧迫防止）に沿うかを確認した。
実際に起きていた不具合 — 4人戦で A が「いいえ」、B/C が「はい」のケースで、30秒後に B/C の再戦が始まらず「対戦相手がいませんでした」に遷移することがあった。表面上は再戦判定不具合に見えるが、ログで背景タスク内の離脱処理例外が原因と判明。
根本原因 — 背景タスクから leave_room（request context 前提）を呼び、Working outside of request context が発生。カウントダウン処理が途中で落ちるため、game_started が出ず、最終的に不成立/期限切れ側の遷移になっていた。
修正内容 — 背景タスク内の離脱処理を socketio.server.leave_room(sid, room_id, namespace="/") に置換。あわせて「再戦可能人数が2人未満になった時点」で rematch_timeout を即時通知する判定を整理し、2人戦では不要な30秒待機が発生しないようにした。
確認できた最終挙動（期待仕様） — 4人戦では B/C 再戦が成立して観戦継続、未参加 D は再戦開始時点でロビーへ移動。続く2人戦で片方が「いいえ」の場合は、残りプレイヤー＋観戦者が即「対戦相手がいませんでした」表示になり、60秒放置で自動ロビー遷移することをログと画面で確認した。

【追記】2026-03-18（観戦・再戦・不成立・表示崩れ・スキル挙動の調整）

追記日時: 2026年3月18日

デプロイアプリが動かない（PowerShell のパースエラー） — さくらサーバーにアップロードする「デプロイ」アプリからバンドル作成を実行したところ、build_deploy_bundle.ps1 が PowerShell の構文エラーで停止し、デプロイが実行できない状態になった。原因は「パイプ構文の書き方」と「Windows 側での文字コード解釈」の組み合わせで、具体的には次のような経緯だった。
- 事象（どのファイルが、どうなったか） — build_deploy_bundle.ps1 で Get-ChildItem ... | Where-Object ... | ForEach-Object ... のようなパイプ処理をしていた部分が、改行位置やコメントの影響で崩れ、EmptyPipeElement / UnexpectedToken 系のエラーとして解釈されて失敗した。
- 原因（なぜそうなったか） — PowerShell は「パイプ記号 | の直前・直後の改行」や、保存時の文字コードの差で、スクリプト全体のトークン化が変わることがある。とくに日本語コメント等が混ざると、環境によって UTF-8 を想定どおり読めず、パースエラーの引き金になりやすい（同じ見た目でも別マシン／別設定で再発しうる）。
- 対処（どう直したか） — 不安定になりやすいパイプ処理をやめ、foreach で明示的に回す形に変更し、コメントも ASCII のみで書く方針に統一した。これにより PowerShell の解釈差で壊れにくくなり、デプロイが再び実行できる状態になった。
- 追加対応（デプロイ対象の拡張） — 「HTML ファイルは毎回指定せずデプロイ対象にしたい」要件に合わせ、test/game-card-fantasybattle/docs/ 配下の .html/.htm を再帰的にバンドルへ含める処理を build_deploy_bundle.ps1 に追加した（相対パスを維持してコピー）。
- 記録 — 経緯と対処の詳細は docs/deploy-app-fixes.md にも整理した（どのファイルを直したか／なぜ再発したか／再発時のチェック項目）。
観戦者数表示の不整合 — 入室直後に「観戦者0人」のままになるケースに対応。join_room の応答に spectator_count を含め、クライアントで即時反映するようにした（早着 room_updated が先に届いても表示が落ちないよう currentRoomId の設定タイミングも調整）。
観戦者がゲーム開始時に部屋に取り残される — check_room がプレイヤーのみ判定して観戦者を「期限切れ」扱いしていた問題を修正し、観戦者も部屋在籍として扱うようにした。
切断起因のゲーム終了（不成立）表示 — 「再戦しますか？」やカウントダウンを出さず、切断の説明＋「ロビーに戻る」のみに統一。後から rematch_* が届いても画面が切り替わらないよう、切断時は再戦UIを抑制するフラグ（suppressRematchUI）で固定するようにした。
切断終了時はランキングに加算しない — 切断起因の終了は不成立扱いとし、ランキング（累積ポイント）へ反映しないようにした。
観戦者のゲーム終了UI — 観戦者はポイント/順位表示を出さない。正常終了時は「このまま待てばプレイヤーの再戦が決まり次第、次の試合も続けて観戦できます」の案内文を表示するようにした。
再戦フローの即時確定（待ち続け防止） — 誰かが「いいえ」または退出してプレイヤーが2人未満になった時点で、残りのプレイヤー・観戦者へ rematch_timeout を即時通知し、「対戦相手がいませんでした」へ遷移するようにした。観戦者も再戦の結果（成立/不成立）に追従して表示が切り替わる（操作は不可のまま）ように調整。
精霊の加護（追加で2回連続でめくれる） — ノーペア時に次の人へ回ってしまう問題を修正し、追加分は同一プレイヤーが続けてめくれるようにした。
レイアウト崩れの修正 — PCで誤って「最大化」判定が走り、カード表示やチャット領域が崩れる問題に対応。最大化は「タッチ端末＋モバイル幅」のみに限定し、また「観戦者○人」の折り返しでヘッダー高さが変動しないよう1行固定にした。
盤面の縦余白の削減 — グリッドの計算結果に合わせてゲームエリアの縦幅を詰め、無駄な余白を減らしてスマートに見えるよう調整。
闇の力（悪魔）の演出中の操作ロック — 闇の力の消滅演出中に「続けてめくれない」体感になりやすい点を改善。消滅対象カードのみクリック不可にして、発動者が続けてめくれる体感を損ねないようにした（観戦者入室タイミングと重なった際の誤認も減らす）。
ゲストのニックネーム保持（編集可＋開始時重複チェック） — ゲストのニックネームは localStorage に保存して1時間保持しつつ、入力欄は自由に編集可能にした。部屋作成/参加/観戦/テスト開始などのゲーム開始操作の直前に入力値を自動保存し、同時にサーバ側で「既に使われているニックネーム」かどうかをチェックして重複を防ぐ（同一人物がA→B→Aに戻すのは、Aが他で使われていなければOK）。
ニックネーム重複アラートが連続で出る問題（テスト後・ページ移動後） — テストモードやページ移動の直後に「このニックネームは既に使われています…」が出続けて操作できなくなるケースがあった。原因は (1) test_ 部屋が残って名前が「使用中」扱いで固定される、(2) ページ移動やブラウザの bfcache 等で WebSocket の切断が遅れ「ゴースト在室」が残る、の複合だった。対処として app.py で test_ 部屋を切断時に即削除し、また「接続中 sid のみ」を使用中判定に採用。クライアント（templates/game_fantasybattle.html）でも pagehide/beforeunload で socket.disconnect() を呼び、ページ離脱時に確実に切断するようにした。さらに、弾かれた場合に *_rejected で原因（登録済み衝突か／どの部屋で使用中か）が追えるよう、拒否理由の詳細ログも追加した。

【追記】2026-03-17（ロビーのニックネーム保持）

追記日時: 2026年3月17日

ゲストのニックネームを1時間保持 — ロビーで入力したニックネームを、未ログイン（ゲスト）の場合はブラウザの localStorage に保存し、60 * 60 * 1000（1時間）の TTL 内であれば次回アクセス時に自動復元するようにした。キーは fantasy_guest_nickname_v1。期限切れの場合は自動で削除。

【追記】2026-03-15（ドキュメント配信・機能別フローチャート記事・メニュー表記・観戦v1・私の意見スタイル）

追記日時: 2026年3月15日

ドキュメント配信ルートの追加 — app.py に /test/game-card-fantasybattle/docs/<path:filename> を追加。send_from_directory で test/game-card-fantasybattle/docs を配信。HTML 等の拡張子のみ許可し、.. 禁止・拡張子チェックでパス対策。フローチャートをブラウザで直接参照可能にした。
記事「異世界衰弱（機能別フローチャート）」の新設 — /fantasy-flowcharts で表示。再戦フロー・観戦モード（初版・v1）のフローチャートへのリンクをまとめた記事を追加。観戦モードは Cursor 生成→不安要素のリスト化→ChatGPT 5.4 thinking で v1 改善の経緯も記載（私の意見は .author-opinion でスタイル）。
メニュー・ヘッダー表記の統一 — 「不具合の修正（異世界衰弱）」を「異世界衰弱（不具合の修正）」に変更。サイドバー・サイト記事ナビ・当ページ（/bugfix-fantasy）のヘッダーを統一。
関連ドキュメントのリンク化 — 5. 関連ドキュメントのフローチャートを、docs ルートの URL と「機能別フローチャート一覧」記事へのリンクに更新（従来はパス文字列のみ）。
観戦モード v1 フローチャートの整備 — spectator-mode-flowchart.html（初版）を Cursor が生成。不安要素を SPECTATOR-FLOWCHART-CONCERNS.md にリスト。ChatGPT 5.4 thinking に確認させて spectator-mode-flowchart_v1.html として改善版を作成。v1 を元に実装を進める方針。
共通 CSS「私の意見」スタイル — main-layout.css に .author-opinion を追加。オレンジ文字・薄いグレー背景・枠・角丸・余白。記事内の制作者の個人的見解に適用。

【追記】2026-03-15（接続表示・先読み・スキル表示・ヘッダー・協力コメント・全画面ロビー）