Tasks: <特性名称>

关联规格: spec.md 版本: v<X.Y.Z>

状态

步骤	状态	备注
spec.md	🔲 草稿	用户确认后改为 ✅ 已评审
design.md	🔲 草稿	用户确认后改为 ✅ 已评审；接手时的第一入口
tasks.md	🔲 草稿	拆解完成后改为 ✅ 已拆解
实现	🔲 未开始	0 / N 完成。偏差处理见 design.md 顶部调整原则 + `docs/SDD-Guide.md` §3-§4

按 Wave 组织任务：按依赖分组——无依赖的归 Wave 1（可并行），依赖前序的归后续 Wave。每个任务标 依赖:，让 agent 能自行判断下一步、把无依赖的并行跑。

后端 Test-First（务实版）：

前端：当前用「手动验证」（每个任务附验证步骤）。目标是 Playwright 交互测试（docs/SDD-Guide.md §6，🚧 规划中）—— 落地后前端任务改写自动化断言。

自包含任务：每个任务内联文件、逻辑、AC 覆盖，实现期不必回读 spec。但设计论证（为什么这么做）指向 design §X，不复制（避免第三处漂移）。

T001: 数据库 ORM 模型 + DAO 文件: src/backend/bisheng/{module}/domain/models/{entity}.py 逻辑: 定义 SQLModel 表（继承 SQLModelSerializable，含 tenant_id/create_time/update_time），编写 DAO classmethod（get_xxx/aget_xxx/create_xxx/update_xxx/delete_xxx）依赖: 无
T002: 错误码定义文件: src/backend/bisheng/common/errcode/{module}.py 逻辑: 定义 MMMEE 错误码类，继承 BaseErrorCode，在 release-contract.md 注册模块编码依赖: 无

T003: {Module}Service 单元测试文件: src/backend/test/test_{module}_service.py 逻辑: 测试核心方法，mock DAO 层测试: test_create_success → AC-01, test_permission_denied → AC-02 覆盖 AC: AC-01, AC-02 基础设施: 如 conftest.py 不存在，本任务一并创建基础 fixture 依赖: T001
T004: {Module}Service 实现文件: src/backend/bisheng/{module}/domain/services/{service}.py 逻辑: 业务逻辑，调用 DAO + PermissionService 测试: T003 全部通过 覆盖 AC: AC-01, AC-02 依赖: T001, T003

T005: API 端点集成测试文件: src/backend/test/test_{module}_api.py 逻辑: TestClient 测试 HTTP 端点，覆盖 happy path + 主要 error path 覆盖 AC: AC-01, AC-02 依赖: T004
T006: API 端点 + Router 注册文件: src/backend/bisheng/{module}/api/endpoints/{endpoint}.py, src/backend/bisheng/{module}/api/router.py 逻辑: FastAPI endpoint 定义，UserPayload 认证注入，委托 Service 处理， UnifiedResponseModel 响应包装。在 api/router.py 注册（如新模块）测试: T005 全部通过 覆盖 AC: AC-01, AC-02 依赖: T004, T005

T007: Platform 页面实现文件: src/frontend/platform/src/pages/{Page}/index.tsx, src/frontend/platform/src/controllers/API/{module}.ts 逻辑: 组件结构、API 集成、状态管理（Zustand）、i18n 覆盖 AC: AC-01, AC-02 手动验证:
- 打开 http://192.168.106.114:4001/xxx
- 执行 <操作>，验证 <预期结果>
- 检查错误场景：<描述> 依赖: T006

T008: Client 页面实现文件: src/frontend/client/src/pages/{page}.tsx, src/frontend/client/src/api/{module}.ts 逻辑: 组件结构、API 集成、状态管理（Zustand） 覆盖 AC: AC-03 手动验证:
- 打开 http://192.168.106.114:4001/workspace/xxx
- 执行 <操作>，验证 <预期结果> 依赖: T006

T009: Celery 任务定义文件: src/backend/bisheng/worker/{module}/tasks.py 逻辑: 异步任务实现，调用 Domain Service 约束: 任务参数中包含 tenant_id，Worker 执行前恢复 current_tenant_id ContextVar 覆盖 AC: AC-04 依赖: T004

只留一行指针，论证在 design.md（决策 / 坑），这里不重复（见 docs/SDD-Guide.md §4）。推翻已 ★ 确认的决策时，先停下与用户重新确认（§3 第四个 ★），再记录。