Enable first operating day with staff assignments, opening guide, and ledger

2026-09-09 08:26:20 +09:00
parent 423fd6dd2e
commit 29a660aed0
28 changed files with 2451 additions and 156 deletions
@@ -0,0 +1,93 @@
+# ローカル制作版の復旧ガイド
+
+更新日: 2026-09-09。現行の制作フォルダや元Drive版を上書きせず、Gitの基準bundleから別ディレクトリへ復元する手順です。
+
+## 保存した基準点
+
+| 項目 | 値 |
+|---|---|
+| ローカル正本 | `/Users/korizatou114/Projects/とりにく工房ゲーム制作部` |
+| 基準コミット | `423fd6dd2e75da926e38b35ac8c435e462b168d9` |
+| コミット内容 | `Preserve approved pixel tower prototype as development baseline` |
+| 制作ブランチ | `codex/first-operating-loop` |
+| 復旧bundle | `/Users/korizatou114/Projects/the-tree-backups/the-tree-baseline-2026-09-09.bundle` |
+| bundle SHA-256 | `6c33456fed426b5348f7f3a1b2ee5e0dfdf8f9d70bca9acc293ba62b7ae05cd0` |
+
+bundleはこの基準点までの完全なGit履歴を保持します。作成時の `main`、`codex/first-operating-loop`、`HEAD` は同じ基準コミットを指します。この後のP0資料更新とP1実装は、別途コミットして新しいbundleを作るまで、この基準bundleには含まれません。
+
+含むものはGit管理されたソース、Godotプロジェクト、Definition、テスト、資料、元画像、Kenney原文ライセンス等です。`.godot/` のインポートキャッシュ、`build/` の配布物、`artifacts/` のキャプチャ、ゲームの `user://` 保存は含みません。Godot実行ファイルとWindows Export Templateも別途必要です。
+
+元Drive版は内容照合が終わるまで復旧候補として残します。制作正本へ自動で同期したり、復旧のために元Drive版を削除したりしません。
+
+## 1. bundleを確認する
+
+現在の制作フォルダで実行します。いずれも読み取り専用です。
+
+```sh
+cd '/Users/korizatou114/Projects/とりにく工房ゲーム制作部'
+git bundle verify '/Users/korizatou114/Projects/the-tree-backups/the-tree-baseline-2026-09-09.bundle'
+git bundle list-heads '/Users/korizatou114/Projects/the-tree-backups/the-tree-baseline-2026-09-09.bundle'
+shasum -a 256 '/Users/korizatou114/Projects/the-tree-backups/the-tree-baseline-2026-09-09.bundle'
+```
+
+`verify`が成功し、完全履歴と表示され、SHA-256が上表と一致することを確認します。SHA-256が異なる場合は同じ基準bundleとして使わず、別の保存物か破損かを確認します。
+
+## 2. 新しいフォルダへcloneする
+
+復元先は例として `TheTree-restored-2026-09-09` を使います。同名のフォルダがある場合は別名を選び、既存フォルダを消して空ける操作は行いません。
+
+```sh
+git clone --branch codex/first-operating-loop \
+  '/Users/korizatou114/Projects/the-tree-backups/the-tree-baseline-2026-09-09.bundle' \
+  '/Users/korizatou114/Projects/TheTree-restored-2026-09-09'
+cd '/Users/korizatou114/Projects/TheTree-restored-2026-09-09'
+git rev-parse HEAD
+git status --short
+```
+
+HEADが `423fd6dd2e75da926e38b35ac8c435e462b168d9` と一致し、作業ツリーが空の差分であることを確認します。そのコピーで制作を続ける場合だけ、復旧用のブランチを作ります。
+
+```sh
+git switch -c codex/recovered-pixel-baseline
+```
+
+この手順で現在の制作フォルダの履歴や未コミット変更は動きません。元フォルダに対する `reset --hard`、`clean`、上書きコピーは必要ありません。
+
+## 3. キャッシュを再生成して確認する
+
+復元先のフォルダで、Godot 4.7系を使って実行します。
+
+```sh
+godot --headless --editor --path . --quit
+make test-pixel-ui
+```
+
+初回は元画像から `.godot/` を再生成するため時間がかかります。`godot` がPATHになければ、実際のGodot実行ファイルを用い、Makeには `GODOT='/実際のGodot実行ファイル'` を渡します。
+
+描画可能なデスクトップで保存なしの見学を開きます。
+
+```sh
+make preview-pixel
+```
+
+受付、食堂、客室、実際の客と従業員が表示され、ズーム・パン・停止・レイヤー切替が動けば、表示の復元を確認できます。見学は手動保存・読込・自動保存を無効にしており、通常ゲームのセーブを更新しません。
+
+通常ゲームは `make run`、全Systemの検証は `make test`、Windows配布物の再生成は対応するExport Templateを用いて `make export-windows` です。基準版は通常3営業日運営や昇降機運行が完成した版ではないため、未実装の項目を復旧失敗と判定しません。
+
+## ゲームのセーブと復旧コードは別に扱う
+
+コードを別フォルダへcloneしても、同じプロジェクト名の通常起動は同じ `user://` 保存先を使います。ソースの復元だけでゲームのセーブ履歴は戻りません。通常の手動保存は `user://saves/manual_ui`、その他の世代保存とRecovery候補はSaveServiceが管理します。
+
+プレイデータも保全する場合は、通常ゲームを閉じてからOS上の実際のユーザーデータディレクトリを別の場所へ丸ごとコピーします。復旧確認ではまず保存なし見学を使い、旧版から現行セーブへ上書き保存しないでください。通常ゲームへ戻すときは、読込可否と保存形式の移行を確認したうえで、Loadの正式・backup・autosave等の復旧候補を使用します。
+
+## 検証記録
+
+2026-09-09に次を確認しました。
+
+- `git bundle verify` 成功。基準bundleは完全履歴を保持し、SHA-256は上表と一致。
+- bundleから `/tmp/the-tree-recovery-check.Ph7d3m/project` へ別ディレクトリclone成功。HEAD一致、clone直後のGit差分なし。
+- `project.godot`、`Makefile`、Main、見学シナリオ、Kenney両パックの原文ライセンスが存在。
+- Godot `4.7.2.stable.official.ed1daf0bf` で復元先のHeadless Editor読込・素材再インポート成功。
+- 復元先の `test_pixel_tower.gd` が **238項目合格**。カメラ、実施設クリック、停止、Simulation不変等の回帰。
+
+この復旧確認では、全System試験、通常ゲームのセーブ上書き、Windows書き出し、復元先での目視見学は行っていません。`/tmp` の検証コピーは長期バックアップではなく、長期の復旧元は上表のbundleです。