データモデル

Nolto のデータは Project → Plan → Phase の階層構造で管理されます。すべての変更は Event として記録され、監査ログとして機能します。

エンティティ階層

Project
├── Plan
│   ├── Phase (0〜50件)
│   │   └── Test Result (フェーズのテスト結果・追記式)
│   ├── Review (最終レビュー GO / NO-GO・追記式)
│   └── Event (イミュータブルな監査ログ)
├── Member (owner / member / viewer)
└── Contributor (git author マッピング)

Project

プロジェクトは、関連するプランをまとめるグループです。

ロールと権限

Plan

プランは AI 開発ツールが生成した実装計画です。

Phase

フェーズはプランのサブタスクです。順序付きで管理されます。

ステータス遷移

ステータス値

許可される遷移

許可されていない遷移をリクエストすると 400 Bad Request が返ります。

テスト結果（verdict）と最終レビュー（verdict）はこのステータスとは独立した別の値です。記録してもプラン・フェーズのステータスは変わりません。

フェーズからプランへの自動派生

フェーズのステータスを更新すると、親プランのステータスが以下のルールで自動的に再計算されます:

1. フェーズが 0 件 → not_started
2. 全フェーズが discarded → discarded
3. discarded 以外の全フェーズが done → done
4. いずれかのフェーズが in_progress → in_progress
5. 上記以外 → not_started

Test Result（テスト結果）

フェーズのテスト結果を記録する追記専用のレコードです。同じフェーズに対して再テストのたびに追記され、UI ではフェーズごとに最新の結果が表示されます。

判定値（verdict）

更新・削除はできません（イミュータブル）。記録時に phase_test_recorded イベントが追加されます。

Review（最終レビュー）

プラン単位の最終レビュー結果（GO / NO-GO）を記録する追記専用のレコードです。プランのステータスは変更しません（GO ＝ 完了ではありません）。

判定値（verdict）

更新・削除はできません（イミュータブル）。記録時に plan_review_recorded イベントが追加されます。

Contributor

Git の author 情報をプランに紐づけるエンティティです。

プラン登録時に git.userEmail を指定すると、同じメールアドレスの Nolto ユーザーが自動的にマッチングされます。

Event（監査ログ）

すべてのプラン・フェーズの変更は不変（イミュータブル）なイベントとして記録されます。

イベントタイプ

イベントの構造

ReadablePlan（LLM 変換出力）

LLM が生成する構造化データです。プランの displayBody フィールドに格納されます。