feat: scaffold agentic interior design workflow

README.md

@@ -0,0 +1,39 @@
+# AI 空间风格工作台
+
+这是一个以户型为约束、以布局与风格决策为核心的 Agent 型室内概念设计工作流。
+
+第一阶段不追求施工图、真实商品匹配或精确报价，而是建立三个可持续修改的核心状态：
+
+- `Plan State`：墙、门窗、房间、比例、图层和置信度。
+- `Scene State`：家具布局、相机、锁定对象和 3D 白模。
+- `Style State`：色板、材质、灯光、造型语言、禁用项和已锁定决策。
+
+## 仓库结构
+
+```text
+apps/web             Next.js 风格工作台
+services/api         FastAPI 工作流与集成接口
+contracts            前后端共享的数据协议说明
+docs                 架构与工作流设计
+11-2-104-模型.pdf     真实测试图纸
+```
+
+## 本地启动
+
+1. 将 `.env.example` 复制为 `.env`，按注释填写配置。
+2. 安装前端依赖：`pnpm install`。
+3. 启动前端：`pnpm dev`。
+4. 创建 Python 虚拟环境并安装 API：`pip install -e "services/api[dev]"`。
+5. 启动 API：`uvicorn app.main:app --app-dir services/api --reload --port 8000`。
+
+前端默认访问 `http://localhost:3000`，API 文档默认位于 `http://localhost:8000/docs`。
+
+## 当前垂直切片
+
+- 显示样例户型与图层开关。
+- 展示从导入、清洗、白模到风格方向和多轮修改的阶段状态。
+- 提供结构化 Style DNA 面板。
+- 提供可验证的工作流状态机和命令接口。
+- 预留 MinIO、百度 OCR、GPU Worker 和多模型路由适配器。
+
+详见 [架构设计](docs/architecture.md) 与 [工作流定义](docs/workflow.md)。