181 lines
16 KiB
Markdown
181 lines
16 KiB
Markdown
# 実装状況
|
||
|
||
この文書は仕様書そのものではなく、現在のコードがどこまで到達しているかを記録する。ゲームルールの正本は `GAME_SPECIFICATION.md`、System境界と不変条件の正本は `SYSTEM_SPECIFICATION.md` とする。
|
||
|
||
## 実装・自動検証済み
|
||
|
||
### S0: 決定的Simulation基盤
|
||
|
||
- 1ゲーム分固定Tickと11段階の処理順
|
||
- Command Queue、priority、予約時刻、処理後も保持する受理ID／idempotency対応、旧Queue Snapshot移行
|
||
- 原子的State Transaction
|
||
- subsystem別の決定的RNG Stream
|
||
- Stable ID、全件検証後に一括Commitする再入安全なDomain Event Batch、Simulation Digest
|
||
- Directory単位のAtomic Save、Checksum、backup、Load直後の時刻維持
|
||
- 同一Seed・Command列を24時間再生したDigest一致
|
||
|
||
### S1: 世界・建設
|
||
|
||
- `(x, y, layer)` Cell、ZoneとFRONT/BACKの分離
|
||
- Rank 1〜7の非破壊World拡張
|
||
- Occupancy、掘削、構造支持Component
|
||
- 決定的A*、Path Cache、明示Connectorと利用権限
|
||
- セル容量・密度・動的Cost、Soft Collision、混雑回避
|
||
- Cost低下・通行再開時のCache失効、権限別の正確な経路Cost、無関係な障害を除いた不到達理由
|
||
- Elevator稼働状態と有限Queue、Request／Unit二重登録防止、停止時迂回、30分停滞検知と安全復旧候補
|
||
- Placement検証、ConstructionJob、取消、完成、撤去
|
||
- 建設完了通知の保留・確定・破棄境界。完成処理の検証中は外部通知を出さず、成功時だけ順序を保って一度ずつ公開する
|
||
- 硬度別の地下掘削Job、入口までの接続、支保条件、中断再開、FRONT／BACK同時解放
|
||
- 地下施設の全Footprint掘削済み検証と、Zoneを跨ぐFootprintの拒否
|
||
- 境界施設はanchorを境界へ固定し地上側へのFootprint展開を許可、地上／地下施設は全Footprintを指定Zoneへ厳格固定
|
||
- 主要施設占有と独立して同一Cellへ共存できるROUTE／DECORATION／UTILITYの3種subslot、複数Cell横断、Path投影用query、厳密Snapshot
|
||
- ROUTE subslotの追加・置換・撤去とPath graphを原子的に同期し、失敗時の双方復元、revision／stale判定、冪等再送、隔離まで扱うAdapter
|
||
- 完成した客用通路／業務用通路を実ROUTEへ、従業員ドアを職員専用FRONT↔BACK Connectorへ原子的に投影・撤去する境界。安定ID、crosslink、exact rollback、隔離、厳密Snapshotを含む
|
||
- Runtime v6で掘削、subslot、Path投影、施設投影を1分Tick・Rank拡張・建設完了・撤去・Saveへ統合。Runtime v5の旧代理施設を決定的に実ROUTEへ移行する
|
||
- World、Path、Constructionを含むSnapshot往復
|
||
|
||
### S2: 施設・在庫・物流・Mana・経済
|
||
|
||
- Facility状態の優先評価と複数reason
|
||
- 営業時間、Policy Snapshot、priority Queue、Capacity Slot
|
||
- Service開始・進行・中断・完了Callback
|
||
- owner別Inventory Stack、FEFO Reservation、期限切れ、監査修復、既定IDの再利用を防ぐTombstone
|
||
- 入力fingerprint付き冪等性、競合する一括操作の事前拒否、全件原子rollback
|
||
- Logistics Request、貨物所有権移転、決定的Dispatcher、候補外になった運搬人の予約積載保持
|
||
- 歩行Graphと独立したMana Network、優先供給、蓄電、Brownout、復旧保持
|
||
- Goldを直接代入しない複式Ledger、逆仕訳、部分返金、日次照合
|
||
- 建設費・撤去返金とLedgerの原子的Adapter
|
||
- 原料予約から施設Serviceと売上記帳までの統合Cycle
|
||
- Cycle途中のSave→Load→再実行でDigest完全一致
|
||
- §7.6のMVP施設16種をStable ID付きDefinitionとして登録・Schema検証
|
||
- 施設詳細Schema version 2を追加。静的Definitionと可変Instance／日次履歴の境界、Access、Upgrade、営業時間、Policy、環境・リスク、客層、解禁、統計、サービス種別ごとの時間・品質・価格・処理単位・欲求効果を定義し、Registryで厳密検証
|
||
- 受付、厨房、成人向け個室を詳細Schemaへ先行移行し、複数接客・BACK生産・夜間成人向け営業の3類型を自動検証。その他MVP 13施設と拡張16施設は互換Schema version 1で段階移行可能
|
||
- MVP互換性を保つ拡張施設16種を`data/facilities/expansion/`へ分離して定義。地上一般向け5種、地下FRONT5種、BACK6種についてZone／Layer、建設費、Footprint、人員、容量、時間、価格、在庫、Risk Tagを固定し、通常建築パレットへの解放前に個別検証できるCatalog境界を追加
|
||
|
||
### S3: 客・従業員
|
||
|
||
- 6種のGuest Need（Hunger／Sleep／Hygiene／Medical／Leisure／Intimacy）、Utility、状態遷移、実経路を1セル／分で移動
|
||
- 旧5欲求Saveだけの決定的移行、現行経路での旧Need名・欠落・混在拒否、成人確認付き昼夜Intimacy
|
||
- 所持金と未決済予約を考慮した施設選択
|
||
- Queue、Service、退出、経路失敗の安全な復旧
|
||
- Staffの複数Shift、Task Dispatcher、実移動、疲労と危険作業制約
|
||
- 雇用区分、人物別日給、ID順の日次給与入力、当日発生と繰越債務を分けた部分清算、退職者の未払給与別台帳、旧Saveの互換移行
|
||
- 清算ID／日付／入力fingerprintによる二重発生防止と、派生合計まで照合する給与履歴Snapshot
|
||
- 勤務終了、施設人員喪失、Service猶予と失敗の連動
|
||
- Guest／Staffのnamespaced Path投影、密度同期、固定小数点混雑速度、30分停滞復旧
|
||
- Guest／Staff／Facility／Inventory／Ledgerの24時間決定的再生
|
||
- 破損Snapshotと孤児参照を副作用なしで拒否
|
||
|
||
### S4: 関係・Event
|
||
|
||
- Affection、Trust、Fear、Corruption、Rival Bond、Shield
|
||
- Shield攻撃、反復Penalty、段階閾値、Route Lock確認境界
|
||
- データ駆動Condition／Action／Choice
|
||
- foreground Event排他、Actor Lock、Cost escrow
|
||
- Content FilterのFADE／REPLACE／DISABLE
|
||
- 選択二重送信、Actor欠落、Action失敗、Save途中再開の安全な復旧
|
||
- Threshold発火と24時間exact replayのRuntime統合
|
||
- 配置確定前に共有施設・重複時間、Shield攻撃候補、発火可能Event、Route Lock警告、施設／時間の回避案を決定的に比較する読み取り専用Preview
|
||
|
||
### S5: 行政・監査
|
||
|
||
- Heat、Suspicion、Incident重複排除、日次減衰とactive-case下限
|
||
- Evidenceの位置、視線、到達、証言、既知施設による発見根拠
|
||
- 監査予告、専用RNG、監査官の実Path巡回、到達不能時の安全退出
|
||
- 証拠点による処分、罰金の複式台帳反映、`resolution_id`二重適用防止
|
||
- Authority全Command、Domain Event、Snapshot、原子的RestoreのRuntime統合
|
||
- 毎日06:00評価、途中Save、24時間exact replay
|
||
- Raid Wave、明示参加者と画面外戦力、扉・設備・目的物のラウンド更新
|
||
- 防衛Score、疲労・奇襲・複数入口、Active Skill、撤退方針、複数Wave
|
||
- Round再送、操作種別付き解決ID、外部効果／RNG rollback、厳密な時刻契約
|
||
- Cancel終了の原子反映、Wave別侵入口、防具軽減、途中Save、JSON輸送、破損Snapshot拒否
|
||
- Defense全10 Command、専用RNG、Skill費用、Staff／Facility損害、Raid排他LockのRuntime統合
|
||
- 終了Raidの履歴化と後続治療／修理、scheduled Command時刻、Runtime v1からDefense付きv2への決定的移行
|
||
|
||
### S6: 保存・運用の基礎
|
||
|
||
- 正式Saveを維持する3世代Autosave
|
||
- Checksum付きRecovery候補と明示的Recovery Load
|
||
- N→N+1の連続Migration RegistryとMigration前backup
|
||
- Migration／Autosave回転中断の自己修復とRecovery候補
|
||
- 保存root・親directory・非package・package内symlink越境を全Load入口で拒否するパス安全性
|
||
- 通常Saveのrename中断マーカーと自己復旧、Autosave世代縮小時の検証済み候補だけを安全に整理
|
||
- 安定Save ID、完全Manifest既定値、Thumbnail生成と上書き時のidentity保持
|
||
- 実行画面だけが有効化する本番Autosave policyと、Test／独立Runtimeの保存先分離
|
||
- 毎日06:00の固定境界Checkpoint、3世代回転、手動保存Queue、復旧候補の検査・明示Load
|
||
- Load直後の時刻保持と、壊れたTask／終了Event Lockだけを対象とする原子的なRecovery限定修復
|
||
- 正式、backup、移行前、Autosaveの各候補をRuntime全Domainへ隔離復元し、ゲームとして成立する最初の候補だけを採用する復旧fallback
|
||
- Saveより厳しいContent FilterをLoadで弱めない安全な統合と、不明enumの厳密拒否
|
||
- Simulation、Path、Save、Load、stallの実測付き性能予算Collector
|
||
- PERF-MVP-001の正確なFixtureと24時間Harness。完全条件を3回連続24/24合格（x4 P95 8.14～8.45ms、最大停止予算も合格）。これは独立Service合成の論理負荷であり、Runtime全Domainや実描画Frameの計測とは区別する
|
||
|
||
### 14日運営Coordinator基盤
|
||
|
||
- 暦日は00:00に更新し、06:00に前営業日の日次締めと朝運用境界を固定順で一度だけ実行
|
||
- 需要の60分更新と30分ごとの来客計画、fixed-point carry、収容・来客上限
|
||
- DaySummary、前日差、7日移動平均、施設別損益、未払解消と3回連続破綻
|
||
- 外部Domainのcapture／validate／apply／rollback境界、14日間の省略なしexact replay、Snapshot v3と旧版移行
|
||
|
||
### MVP人物・進行データ境界
|
||
|
||
- 客8クラスと種族4種を別軸にした32通りの成人確認済みGuestDefinition生成
|
||
- 自由雇用候補20人の固定ID、成人確認、役割、契約費、日給、4技能、許可業務
|
||
- ヒロイン`heroine_anri`とライバル`rival_rai`の相互参照、固有効果、通常売却禁止タグ
|
||
- 不明field／tag、重複ID、成人未確認、18歳未満、孤児参照、型の暗黙変換を全体fail-closedで拒否
|
||
- Rank 1～7の逐次条件、累計Faith／客、地上・地下稼働条件、派生MapBounds、冪等昇格Request
|
||
- World拡張用capture／apply／rollback境界、rollback失敗時の隔離、厳密Snapshot往復
|
||
- 32 Guest定義のRuntime登録、候補雇用時の契約費・日給・Shift・Pathの一括確定、重複雇用防止
|
||
- 累計Faith／累計客の実取引連動、Rank昇格とWorld／Path／GameStateの原子的確定、旧Runtime Rank 1保存の安全な移行
|
||
|
||
### 操作画面
|
||
|
||
- V3モックを基準にした暖色の木・革・羊皮紙UI。上部の常設HUD、左の管理カテゴリ、中央の生きたMap、右の施設Inspector、下部の建築パレットへ領域を分離
|
||
- 表層の世界樹宿と地下根域の製品向け背景アセットを導入。背景Texture、UI Palette、重ね描画Opacityを`VisualThemeProfile`へ分離し、Main SceneのTheme指定だけで一括交換可能。Theme欠落時は手続き描画へ安全にFallbackする
|
||
- 施設16種、管理カテゴリ6種、資源4種、表裏層・掘削・回転・保存などの操作アイコンを、実透明の4×4 Atlas Assetとして導入。UIは安定IDから`VisualThemeProfile`の割り当てを取得し、画像名やAtlas座標を直接参照しないため、後からTheme単位または個別割り当てで交換可能
|
||
- 施設Iconを中央Mapの完成施設・建設中施設・配置Previewへも接続。占有CellとHit Testは従来どおりWorldServiceを正とし、Iconは占有範囲中央へ視覚的に重ねるだけなのでSimulationとSave互換性を維持する。選択中の施設／工事は右Inspectorにも同じTheme Iconを表示
|
||
- 客8クラスと従業員8役割群の成人キャラクターMarkerを実透明4×4 Atlasとして導入。客種別／従業員役割の安定IDからTheme割り当てを解決し、派生客種別はクラス接頭辞へ、未知IDは既定MarkerへFallbackする
|
||
- 外枠・木・革・羊皮紙Panel、Button 4状態、選択／警告枠、待機Badge、工事中、客／従業員経路、FRONT／BACK境界装飾を4×4 UI Skin Atlasとして導入。主要Panel、全Button、Map経路、工事中Cell、待機Badgeを意味ID経由で接続し、Theme欠落時は従来のStyleBoxFlat／手続き描画へFallbackする
|
||
- 外部の画像生成AIで正式素材を再制作するための`ART_ASSET_PRODUCTION_SPECIFICATION.md`を追加。現在接続済みの全画像について推奨解像度、Alpha、Atlas順序、生成指示、差し替え手順、納品判定を固定した
|
||
- 1440×810を基準解像度として、`canvas_items`／`expand`／fractional stretchとHiDPIを有効化。背景、施設、共通操作、人物AtlasにはMipmapを生成し、720p・1080p・1440p・4Kで同一UI構造を維持する
|
||
- 上部HUDへ営業日、時刻、時間帯、来客、宿泊予定、所持金、Mana、資材、Faith、Heat、一時停止、x1／x2／x4を常設
|
||
- 実World Cell、占有、工事、施設、Guest、StaffのFRONT／BACK別描画
|
||
- PathServiceの実密度／容量から緑・黄・赤の混雑経路を描画し、FacilityServiceの実待機列をMap上の数字Badgeとして表示
|
||
- 施設選択と状態、reason、待機列、Service、配置人員の表示
|
||
- 仕様表のMVP施設16種を選べる画面下部の横スクロール建設パレット
|
||
- 回転、配置Preview、重なり等の失敗理由、建設Command
|
||
- 掘削モード、正式な費用・入口接続・支保Preview、Rank／運営gate、進捗表示、FRONT／BACK同時解放Command
|
||
- 時間、一時停止、x1／x2／x4、Event、Heat、手動Save／Load
|
||
- 本番運営の明示起動、個人AP、未払給与、前日損益、要確認／破綻状態、失敗境界の再試行表示
|
||
- 検証済み雇用候補20人の一覧。氏名、役割、勤務帯、契約金、日給、4技能を表示し、原子的な雇用Command、未払／破綻gate、二重クリック防止、即時／予約実行結果、Save済みCommand履歴からの再試行連番復元へ追従する
|
||
- foreground Eventの日本語Choiceボタン、安定した選択Command、解決後の停止解除と選択欄消去
|
||
- 1280×720、1440×810、1920×1080、2560×1440、3840×2160で、左Navigation／中央Map／右Inspector／下部Paletteの位置関係を含むLayout自動検証
|
||
|
||
## 統合済みの運営縦断
|
||
|
||
- 14日運営CoordinatorをEconomy／Guest／Staff／Facility／Authority／Eventへ接続し、06:00の営業日締め・朝処理、給与、未払、3回連続支払不能による破綻までRuntimeから実行する
|
||
- 人物カタログを使った自動来客・雇用時の日給と、累計客／Faith／稼働施設によるRank条件を日次運営へ接続する
|
||
- 実Simulation Tickによる24時間連続運転、選択待ち停止再開、Save復元、部分給与、破綻後no-opを受入試験で確認する
|
||
- 14日20,160分については運営境界を加速した連続／Day 7復元の一致を確認する。全Actor AIを含む20,160回の実Tick受入とは区別する
|
||
- 掘削と客用通路／業務用通路／従業員ドアをRuntime v6へ統合し、完成失敗時のConstruction・World・Path・通知を一括で戻す
|
||
|
||
## MVP垂直スライスとして残る範囲
|
||
|
||
現在は、安全に保存・再生できる「操作可能なSystem縦断」であり、14日MVPの内容完成ではない。次の範囲は引き続き必要となる。
|
||
|
||
- 全Actor AI、全Event、監査、経路移動を含む20,160分の実TickによるS14-CORE受入
|
||
- ユニーク2人の配置・接触判定と、そこから生成する14日Event列
|
||
- 通常隣接Edgeを安全に抑制する垂直Topologyと、客用／業務用昇降機
|
||
- 配置と同一Shiftから関係Event候補を生成する接触判定と事前リスクPreview
|
||
- 夕方混雑、FRONT／BACK比較、健全／地下収支を直接比較するScenario Test
|
||
- 100客・30従業員の実描画Frame試験
|
||
- 製品用アート、音響、物語本文、完全なチュートリアル、バランス調整
|
||
|
||
## 実行方法
|
||
|
||
make test
|
||
make check
|
||
make run
|
||
|
||
試遊の手順は `PLAYTEST_GUIDE.md`、仕様とTestの対応は `TEST_MATRIX.md` を参照する。各Systemのテストは画面Nodeに依存せずheadlessで実行でき、新しいSystemを追加する際はSnapshot、Atomic Restore、決定性Testを同じ変更に含める。
|
||
14日受入の共通Fixtureと数値境界は `MVP_ACCEPTANCE_SCENARIOS.md` に固定する。
|