データモデル

Nolto ではサーバーにある roadmap が進捗の正本です。1つのプロジェクトに複数の roadmap を置け、それぞれを slug で区別します。CLI の手元の JSON は nolto roadmap path [slug] が返すリポジトリの外のキャッシュで、Git では管理しません。サーバーは roadmap、集計値、関連文書、生成済みの表示用 artifact を保持します。

Organization

組織の admin は、その組織が所有するすべてのプロジェクトで暗黙的に owner として扱われます。組織の member は、明示的に project_members 行を持つプロジェクトだけにアクセスできます（自動加入はありません）。

Free の組織はメンバー（招待中を含む）3 名・アクティブなプロジェクト 3 件まで。1 人が管理者になれる組織は 10 件までです。

Project

project は roadmap の共有範囲と権限の単位です。

リポジトリ側の nolto.json が project ID を保持します。roadmap slug は、キャッシュの JSON ファイル名と同じです。

Roadmap

{
  "schemaVersion": 3,
  "project": {
    "id": "my-app",
    "name": "My App",
    "repository": "https://github.com/example/my-app"
  },
  "summary": "認証改善を進行中",
  "phases": []
}

サーバーは task_total、task_done、task_blocked を payload から再計算します。

Phase

phase status は task から導出されます。すべて完了なら done、進行中があれば in-progress、blocked のみがあれば blocked、着手前なら todo です。

Task

RoadmapStatus は todo、in-progress、done、blocked の4種類です。

Plan document

Phase または Task の plan が参照する Markdown を CLI が読み込み、roadmap と同時に同期します。

同じ path の content hash が変わると既存 artifact は無効化され、再生成対象になります。

課題

課題は project ごとに採番され、project key（^[A-Z][A-Z0-9]{1,9}$、例 NOLTO）と番号でキー NOLTO-12 になります。key は project の設定画面で owner / admin が設定し、課題を 1 件でも作ると変更できません。課題機能は project ごとに有効化されます。

Issue

isClosed な状態の課題が「完了」です。一覧の既定は完了を除外し、closed=include / only で切り替えます。

種別・状態・カテゴリ

project ごとのマスタです。種別と状態には色（#rrggbb）と既定フラグがあり、状態には isClosed があります。

使用中の項目を削除するときは付け替え先（replaceWithId）を指定します。既定の項目と最後の 1 件は削除できません。

コメントと履歴

コメントとフィールド変更は同じ行に記録されます。フィールドだけを変えた場合は本文が空の履歴行、コメント付きで変えた場合は本文と changes の両方を持つ行になります。

本文中の [@表示名](mention:<userId>) はメンションで、Web UI ではチップとして表示されます。

添付

本文からは ![name](attachment:<id>)（画像）または [name](attachment:<id>) で参照します。

保存済みフィルタ

プラン表示

worker は plan document を個別に claim し、最大3回まで整形を試みます。render_status が success で render_payload の検証に成功すると、プラン画面で整形ビューと Markdown を切り替えられます。処理中は生成中の案内を表示し、失敗または不正な artifact の場合は Markdown 原文を表示します。