Enable first operating day with staff assignments, opening guide, and ledger
This commit is contained in:
Codex
@@ -0,0 +1,104 @@
|
||||
# 制作課題台帳
|
||||
|
||||
更新日: 2026-09-09。承認済み [全体制作計画](DEVELOPMENT_PLAN.md) の実行台帳。基準はドット断面版コミット `423fd6dd2e75da926e38b35ac8c435e462b168d9`、制作ブランチは `codex/first-operating-loop`。P1の通常開業ガイド・継続配属API／パネル・日次帳簿を接続し、通常初期予算での最小宿を単日受入・専用保存復元で確認した。全自動テストの構成ターゲットは成功終了。補給・厨房・物流を含む3営業日は未合格。部品の接続、単日成立、段階全体の完成を区別する。
|
||||
|
||||
## 状態の読み方
|
||||
|
||||
| 区分 | 意味 |
|
||||
|---|---|
|
||||
| 実装済み | 対象の部品または経路がコードにあり、下記の根拠を確認できる。段階全体の完成とは限らない |
|
||||
| 画面へ未接続 | Service、Runtime、データに部品があるが、通常の画面操作から完結しない |
|
||||
| 仕様との相違 | 正本・データ・実装・補助資料に差がある。採用方式を決めてからコードと仕様を揃える |
|
||||
| 未検証 | 必要な通常プレイ、異常系、保存再開、実機、長期受入の結果をまだ記録していない |
|
||||
| 未実装 | 計画で要求する機能・コンテンツの実行経路がない |
|
||||
| 進行中 | 担当作業が動いているが、統合・受入前。実装済みへの読み替えをしない |
|
||||
|
||||
仕様の正本は [GAME_SPECIFICATION.md](GAME_SPECIFICATION.md) と [SYSTEM_SPECIFICATION.md](SYSTEM_SPECIFICATION.md)。ルール変更時は [DESIGN_DECISIONS.md](DESIGN_DECISIONS.md) に理由と保存互換への影響を残す。
|
||||
|
||||
## P0：制作の基準点
|
||||
|
||||
| ID | 現在地と根拠 | 残り・完了判定 |
|
||||
|---|---|---|
|
||||
| BASE-01 | **基準保存済み**。ローカル制作版の初期コミット `423fd6d`、完全履歴bundle、Kenney原文ライセンスと取得元を保存。`git bundle verify`成功。詳細は [復旧ガイド](RECOVERY_GUIDE.md) | 別ディレクトリclone、Headless Editor読込、Pixel回帰238項目は成功。復元先の目視見学と元Drive版との全内容照合は未確認。Drive版は復旧候補として残す |
|
||||
| BASE-02 | **資料更新済み／実機未検証**。[試遊ガイド](PLAYTEST_GUIDE.md)、[UI仕様](UI_OPERATION_SPECIFICATION.md)、[実装状況](IMPLEMENTATION_STATUS.md)を現Pixel表示へ同期。通常・見学・Capture・Test・Windows書き出しはMakefileにある | Windows Export Templateを用いた書き出し、クリーンなWindowsで起動・入力・保存を確認。コマンドがあることを実機合格としない |
|
||||
| BASE-03 | **台帳作成済み**。この文書で部品の実装、画面未接続、仕様差、検証残を分類 | 以後は各機能の統合時に根拠・検証結果・残る差を更新する |
|
||||
|
||||
P0の保存物はGit管理対象の制作ファイル。`.godot/`、`build/`、`artifacts/`、ゲームの `user://` 保存はbundleの外にある。
|
||||
|
||||
## P1：通常プレイの宿を経営
|
||||
|
||||
完成条件: 見学用の施設・食材支給やデバッグCommandに依存せず、通常画面だけで3営業日を運営し、欠品・人員・経路不足へ対処して保存再開できること。**段階全体は未合格。**
|
||||
|
||||
| ID | 実装済みの根拠 | 未接続・仕様差・検証残と次の確認 |
|
||||
|---|---|---|
|
||||
| PLAY-01 | **最小ループ実装済み・単日確認**。初期Gold 5,000／資材50、通常UIの建築経路で受付1・一般客室2・通路7、アカネ雇用・配属、自然来客の宿泊320G、翌06:00決算まで確認。`test_first_operating_day.gd` | 受入は見学Fixture・無料在庫・客挿入なし。**3営業日未検証／バランス調整残**。受付売上6,020G等の数値を正本と照合し、補給・厨房・配送込みの序盤へ広げる |
|
||||
| PLAY-02 | **通常UI接続済み・個別API103項目／単日確認**。雇用済み一覧、配属・再配属・未配属、DAY／NIGHT継続計画、変更不可・経路・定員等の理由、予約Commandと保存復元。StaffService v4、D-032 | 実通勤と到着後の稼働はMOVE-07へ分離。現在は経路存在を検証して論理配属し、人物位置は変えない。長期の複数施設・人員不足対応は3営業日受入で検証 |
|
||||
| PLAY-03 | `inventory_service.gd` のStack・予約・期限、`logistics_dispatcher.gd`、Runtimeの配送Command、`test_inventory_logistics.gd` | **画面へ未接続／未検証**。発注費を支払う仕入れから倉庫→厨房→接客施設までを通常操作へ接続。欠品、容量超過、期限切れ、配送失敗を同じ経営ループで再現する |
|
||||
| PLAY-04 | 厨房・食堂DefinitionとFacility Service／Inventory Callbackが存在。見学は食堂へ `ingredient/basic_meal` を32個支給する | **仕様との相違／画面へ未接続**。食材消費と仕様の料理ポイント／食器を照合する。客の注文に依存しない厨房生産の入口と材料→料理の扱いを決定し、実配送を含む通常運営へ接続する。見学支給は完成の根拠にしない |
|
||||
| PLAY-05 | **日次帳簿UI接続済み・単日確認**。06:00営業日、入出金と建築、確定売上・運営費・給与・利益・前日差・未払・施設別損益を表示。翌朝給与120G、未払0、照合一致 | **操作未接続／仕様差・調整残**。価格・営業／休業Policy UI、受付の直接収入、宿泊の決済・記帳時点、維持費分類を正本と照合。受付売上6,020G・全利益6,040Gは製品バランス合格ではない |
|
||||
| PLAY-06 | **基礎実装済み・単日Save復元確認**。手動1枠と世代保存に加え、単日受入の専用 `user://tests/first_operating_day_<process_id>/restore-check` から配属・決算・開業達成を復元 | **未検証**。通常3日運営の建設中・配送中・行列中を保存し、再起動後の一致を確認。手動10枠UIは別途制作 |
|
||||
|
||||
確認済みの単日経路: 通常初期予算→建設→アカネの日勤配属→自然来客宿泊→翌06:00給与・決算→専用保存復元。`make test-opening` で再現し、`make capture-opening` は `artifacts/first-operating-day/{opening,staffed,first-close}.png` を出力する。建築は現金出金、営業成績は確定損益として分離した。最終UIはPixel238・Dashboard121・Staff44・開業35項目が合格し、既存全自動テストの構成ターゲットも成功終了した。詳細は [P1単日検証記録](qa/P1_FIRST_OPERATING_DAY.md) を参照する。
|
||||
|
||||
## P2：上下移動と混雑
|
||||
|
||||
完成条件: 3階以上で実乗降し、同じ人数・需要のまま設備と動線の改善で待ち時間・離脱が減ること。**現在は運行未統合。**
|
||||
|
||||
| ID | 実装済みの根拠 | 未接続・仕様差・検証残と次の確認 |
|
||||
|---|---|---|
|
||||
| MOVE-01 | `path_service.gd` の隣接経路、Connector、アクセス権、`facility_infrastructure_projector.gd` の通路・職員ドア投影 | **仕様との相違／未統合**。同一階の徒歩と設備による垂直移動を分け、通常隣接Edgeで階間を迂回する経路を抑制。旧通路・Saveからの移行を決める |
|
||||
| MOVE-02 | PathにElevator状態、有限Queue、要求重複防止、停止時迂回、停滞検知の部品 | **未統合**。昇降路、停止階、車両、定員、待機要求を1方式の運行モデルへつなぐ。部品のQueue試験だけで昇降機完成としない |
|
||||
| MOVE-03 | 昇降機Definitionがパレットにある。現在のRuntimeは安全なTopology未統合として建設を拒否 | **画面へ未接続／未検証**。建設・延伸・停止階変更・撤去・客用／業務用権限を運行へ統合する |
|
||||
| MOVE-04 | `world_preview.gd` の徒歩補間と人物の小型描画 | **未実装**。待つ→乗る→昇降→降りるの運行状態を表示し、車内と徒歩の重複を防ぐ。見学の上階通路移動は乗降試験ではない |
|
||||
| MOVE-05 | Path単体の停止・Queue・停滞検知とSnapshot試験 | **未検証**。統合した車両で満員、撤去、経路変更、車内Save復元を試験し、永久行列・二重乗車・閉じ込めを解消 |
|
||||
| MOVE-06 | 既存の混雑密度／容量表示、[MVP受入](MVP_ACCEPTANCE_SCENARIOS.md)の比較条件 | **未検証**。同一Seed・需要・人数・施設数で改善前後を比較し、画面と移動時間P95・離脱で記録する |
|
||||
| MOVE-07 | **計画と経路検証のみ接続済み**。通常UIの配属は継続計画を保存し、経路が存在するかを検証。人物のcurrent_cellは変更しない | **未統合**。勤務開始→実通勤→職場到着→人員稼働をつなぎ、移動中や不到達の人物を到着済み人員として扱わない。再配属・夜勤・Save復元を含める |
|
||||
|
||||
## P3：営みと初見の操作
|
||||
|
||||
| ID | 現在地 | 次の完了判定 |
|
||||
|---|---|---|
|
||||
| LIFE-01 | **一部実装済み**。Runtime位置、サービス中位置の描画投影、待機・利用・作業Badge、停止 | 実状態に基づく歩行／待機／利用／睡眠／清掃／運搬／休憩の一覧と利用位置を確定する |
|
||||
| LIFE-02 | **試作実装済み／専用素材未制作**。Kenney静止画の足スライス・上下動・左右反転。衣服の継ぎ目修正済み | 専用歩行・作業フレームを共通人物で確認し、縮小、拡大、混雑、職種識別を満たしてから展開 |
|
||||
| LIFE-03 | **一部実装済み**。`pixel_tower_art.gd` の施設別家具、昼夜背景、世界樹の枝葉。現在の対象はMVP16施設 | 種類、営業、混雑、故障を家具と状態で識別できること。計画の施設数はMVP16種へ統一済み |
|
||||
| LIFE-04 | **素材一部導入／音未接続**。Kenney Tiny Town／Tiny Dungeonの公式素材とCC0原文保存 | UI音・環境音をKenney優先で選定し、音量設定と頻発音の重複抑制を確認 |
|
||||
| UX-01 | **一部実装済み・通常UI接続**。配置・掘削Preview、停止理由、待機・人員、配属・勤務変更、日次帳簿 | 在庫・欠品・接続、価格や営業方針などの対処を通常画面から完結させる |
|
||||
| UX-02 | **最小ガイド実装済み・単日確認**。実状態に応じる6段階、通常操作へのボタン、折り畳み、達成履歴・Save復元 | Day 1〜5解禁との整合、スキップ、複数失敗からの回復、初見30分で改善まで到達する試遊は残る |
|
||||
| UX-03 | **一部実装済み／未接続**。ホイール、中ボタン、Home、キーボード開閉、Pixel・カメラ回帰 | 中ボタンなし・トラックパッド代替操作、日本語可読性、拡大時のドット、色以外の状態判別を実入力で確認 |
|
||||
|
||||
## P4：The Tree固有の判断
|
||||
|
||||
| ID | 実装済みの根拠 | 残り |
|
||||
|---|---|---|
|
||||
| TREE-01 | Rank条件・非破壊拡張・Runtime統合、掘削gate・費用・支保、表裏同時開通 | **通常導線未検証**。Rank 1→2→3、地下解禁と対応施設を通常営業から通す |
|
||||
| TREE-02 | BACK層、職員専用接続、物流・Task・混雑部品 | **未接続／未検証**。裏方改善で表の混雑と接客待ちが改善する同条件比較 |
|
||||
| TREE-03 | Heat、予告・実Path監査、罰金台帳、日次処理 | **通常経営未検証**。地下の追加収益・対策費・監査を可視化し、合法／地下比較を行う |
|
||||
| TREE-04 | `heroine_anri`／`rival_rai` の定義、関係Service、Event、配置リスクPreview部品 | **未接続**。実配属・同一Shift・接触から14日Event列を生成する |
|
||||
| TREE-05 | 条件、閾値、Actor Lock、Choice、Route Lock確認、foreground UI | **未接続／未検証**。配置の事前警告→関係理由→重要分岐→復帰を実人物で一巡 |
|
||||
| TREE-06 | FADE／REPLACE／DISABLEと厳密Save FilterのRuntime試験 | **画面へ未接続／進行未検証**。設定UIと代替本文を結び、変更後も14日が途切れないことを確認 |
|
||||
|
||||
## P5：14日MVPと実機受入
|
||||
|
||||
| ID | 既存の根拠 | 未検証の完成条件 |
|
||||
|---|---|---|
|
||||
| MVP-01 | 14日Coordinator、Rank・人物Catalog、[受入シナリオ](MVP_ACCEPTANCE_SCENARIOS.md) | 開業→混雑→Day 7保存→BACK改善→地下→Day 14結果を通常操作で通す |
|
||||
| MVP-02 | 24時間実Tick、14日運営境界を加速した連続／Day 7復元の一致 | 全Actor AI・Event・監査・実経路を含む20,160分を省略せず実行。00:00と06:00を個別に保存再開 |
|
||||
| MVP-03 | 既存S14の混雑・BACK・合法／地下・関係の比較条件 | 移動P95 15%以上短縮、BACK物流中央値20%以上短縮等、正本のA/B条件を統合したゲームで満たす |
|
||||
| MVP-04 | 論理負荷PERF-MVP-001、UI解像度・カメラの回帰 | Windows 11基準機を決め、100客＋30従業員の実描画を1280×720・x1／x4で計測。平均55fps／1% low 45fps／入力100ms、保存・日次処理の境界を確認 |
|
||||
| MVP-05 | 地上／地下とFRONT／BACKの説明、操作ガイド | 初見30分で軸と改善操作を理解し、14日完走後に改善判断を振り返れる試遊結果を残す |
|
||||
|
||||
過去の全System合格記録、直前のUI・カメラ359項目、見学のPNGは、それぞれ対象が異なる。この台帳の作成では全System試験やWindows実機を再実行していない。
|
||||
|
||||
## P6・P7：製品版と配布
|
||||
|
||||
- **画面へ未接続／未実装**: Rank 4〜7の本編進行、拡張施設、研究・投資・探索、長編本文と結末。基盤やDefinitionの存在と、遊べる章の完成を分ける。
|
||||
- **仕様との相違**: 全体エンディングがゲーム仕様§3.1の3種と§3.6の4種で異なる。台本量を確定する前に整理する。
|
||||
- **未実装／未検証**: タイトル、ニューゲーム、続きから、設定、手動10枠UI、自動3世代の選択と復旧提示、クレジット、配布パッケージ。現在の手動1枠を製品仕様達成としない。
|
||||
- **未検証**: Windows初回起動、日本語・入力・DPI、低性能GPU、保存先と互換性。`make export-windows` とPresetはあるが、この台帳時点の対象PC合格記録はない。
|
||||
|
||||
## 直近の統合チェック
|
||||
|
||||
1. 通常UIの最小宿・翌朝決算・専用保存復元は単日確認済み。新しい配属、ガイド、帳簿を含む全体回帰の結果を確認して次の検証済みコミットを記録する。
|
||||
2. MOVE-01〜03の階間経路と基本昇降機、MOVE-07の実通勤・到着後稼働を統合する。現在の論理配属で人物移動を完成扱いにしない。
|
||||
3. PLAY-03〜05の発注・厨房生産・実配送・会計仕様差を解消し、通常3営業日を継続する。建設中・配送中・行列中の保存再開を含める。
|
||||
4. 通常開始と保存なし見学の両方で表示・操作を確認し、最小宿の成功をP1全体完成やWindows製品合格としない。
|
||||
Reference in New Issue
Block a user