feat: ship end-to-end interior design MVP

contracts/workflow-contract.md

@@ -13,6 +13,10 @@
   "plan": {},
   "scene": {},
   "style": {},
+  "brief": {},
+  "directions": [],
+  "renders": [],
+  "events": [],
   "available_commands": ["confirm_plan"],
   "updated_at": "2026-08-01T12:00:00Z"
 }
@@ -47,3 +51,14 @@
 - `GET /v1/projects/{project_id}/preview`：从 MinIO 派生文件桶读取 PDF 首页预览。
 - 新项目初始阶段为 `region_selection`，`plan.regions` 提供归一化的 `[x0, y0, x1, y1]` 候选区域。
 - `select_region` 必须引用真实存在的候选区域 ID，成功后修订号递增并进入 `plan_review`。
+
+## Product Workflow
+
+- `POST /v1/projects/{project_id}/spatial-analysis`：裁剪已选户型并调用空间理解模型；模型异常时返回 `degraded=true` 的可编辑房间草案。
+- `POST /v1/projects/{project_id}/style-directions`：保存需求访谈并调用总调度模型生成三套 Style DNA。
+- `POST /v1/projects/{project_id}/chat`：多轮设计对话，返回回复并把可识别的偏好更新到 `brief`。
+- `POST /v1/projects/{project_id}/renders`：调用模型池中的真实生图模型，下载并验证结果后写入渲染桶。
+- `GET /v1/projects/{project_id}/renders/{asset_id}`：读取已持久化效果图。
+- `POST /v1/projects/{project_id}/renders/{asset_id}/edit`：以历史效果图为参考执行文字修改，生成新的版本资产。
+
+生图和编辑接口只在用户主动操作时调用收费模型。所有生成资产先验证为真实图片，再写入 MinIO 并加入 `ProjectSnapshot.renders`。