feat: scaffold agentic interior design workflow

2026-08-01 21:07:17 +08:00
parent 77779bd3a9
commit 6a15217d55
42 changed files with 7156 additions and 1 deletions
@@ -0,0 +1,31 @@
+# Workflow API Contract
+
+后端的 Pydantic 模型是运行时事实来源，前端 TypeScript 类型保持同名字段。
+
+## ProjectSnapshot
+
+```json
+{
+  "project_id": "demo-apartment",
+  "name": "11-2-104 住宅概念方案",
+  "stage": "plan_review",
+  "revision": 3,
+  "plan": {},
+  "scene": {},
+  "style": {},
+  "available_commands": ["confirm_plan"],
+  "updated_at": "2026-08-01T12:00:00Z"
+}
+```
+
+## CommandRequest
+
+```json
+{
+  "command": "confirm_plan",
+  "expected_revision": 3,
+  "payload": {}
+}
+```
+
+`expected_revision` 用于乐观锁。若客户端基于旧版本提交，服务端返回 `409 Conflict`，避免覆盖其他修改。