docs(plan): 标注 A4 完成状态与 WBS 状态列
背景：A4 已完成，开发计划需显式标注阶段与 7 项 WBS 的完成状态。\n改动：§6.5 增加「✅ 已完成」执行状态；WBS 表新增状态列并逐项标 ✅；与 §5.2 批次总览、§12.1 DoD、版本记录保持一致。\n影响面：仅文档；不改变范围与验收口径。\n回滚：回滚本提交即可。\n验证：prettier 通过；A4 报告/门禁数据已在上一提交回写。
This commit is contained in:
Stev_Wang committed
1 parent
02c716d6f2
commit
a5a2914214
1 file changed
+21
-19
@@ -516,16 +516,16 @@ PRD §7 把 **M-27（素材元素级拆解）** 与「自动字幕 → TTS 配
|
||||
|
||||
| 编号 | 任务 | 端 | 内容与产出 | 依赖 | 验收要点 | EPD | 状态 |
|
||||
| --- | --- | --- | --- | --- | --- | --- | --- |
|
||||
| A0-INF-01 | Monorepo 与工具链 | INF | pnpm workspace + Turborepo；TS strict；ESLint 9 flat + Prettier + commitlint + lint-staged；`.nvmrc` 24.15.0、`engines`、`packageManager`、`only-allow pnpm`；`apps/api`、`apps/worker`、`apps/web`、`packages/*`、`prisma/`、`infra/` 目录骨架 | — | `pnpm install` 成功；`pnpm lint` / `pnpm typecheck` 可执行；目录与 AGENTS §5 一致；npm / yarn 被拒绝 | 1.0 ✅ |
|
||||
| A0-INF-02 | 本地依赖与迁移种子 | INF | `docker-compose.dev.yaml`（PG18 / Redis7.4 / MinIO）、健康检查；`.env.example`；Prisma 初始化、首版迁移、种子脚本（超管、示例角色、核心字典、电商行业包占位） | A0-INF-01 | `pnpm compose:up` 三依赖健康；`pnpm db:migrate` 正向成功；种子可重复执行不重复插入 | 0.5 ✅ |
|
||||
| A0-INF-03 | CI 与质量门禁 | INF | 流水线：`install --frozen-lockfile` → lint → typecheck → test → build → OpenAPI 产物；依赖缓存；失败阻断合并 | A0-INF-01 | 首条 PR 全绿；故意写 `any` / 类型错误 / 未格式化能被拦截 | 0.5 ✅ |
|
||||
| A0-BE-01 | API 骨架 | BE | NestJS 11 + Fastify；Pino + trace_id；统一错误过滤器（`{code,message,details,trace_id}`）；`/health`；Swagger / OpenAPI 生成；Zod 管道；CORS 与安全头 | A0-INF-01 | `GET /health` 返回 200；错误结构统一；OpenAPI 可导出且含错误码 | 1.0 ✅ |
|
||||
| A0-BE-02 | Prisma 基线 | BE | Prisma client 封装；迁移基线；`outbox_events` / `idempotency_keys` / `system_configs` 骨架；ULID 主键、软删、时间字段约定 | A0-INF-02 | 迁移可升可回滚；字段命名与工程规范 05 一致；无跨模块表 | 0.5 ✅ |
|
||||
| A0-SH-01 | shared 包基线 | SH | 错误码枚举（400xx–500xx）、权限点常量骨架与命名规范（`模块:动作`）、ULID、游标分页、时间与命名工具、通用 Zod schema | A0-INF-01 | 前后端同时引用成功；shared 不依赖任何业务包 | 0.5 ✅ |
|
||||
| A0-FE-01 | Web 骨架 | FE | Vite 6 + React 19 + Router 7 + TanStack Query 5 + Zustand 5；`@douyinfe/semi-ui-19` + `react19-adapter`；路径别名；请求层（token 注入、401 刷新、统一错误提示） | A0-INF-01 | 页面可启动；路由可切换；请求层有单测 | 0.5 ✅ |
|
||||
| A0-FE-02 | UI 包基线 | FE | Semi 二次封装（表格 / 查询表单 / 弹窗 / 空态 / 错误态 / 加载骨架）；`icons.ts` 统一出口（Remix Icon 语义名）；locale；主题 token | A0-FE-01 | 业务代码不直接引图标库、不内联 SVG；ESLint 可拦截违规引用 | 0.5 ✅ |
|
||||
| A0-FE-03 | 布局与登录壳 | FE | 侧边导航（按模块分组）、顶栏（用户 / 任务角标占位）、面包屑、401 / 403 / 404 页、登录页静态壳 | A0-FE-01 | 布局可打开；403 页可演示；导航配置集中管理、可按权限过滤 | 0.5 ✅ |
|
||||
| A0-QA-01 | 冒烟与报告 | QA | 健康检查 / 登录页 / OpenAPI 冒烟用例；覆盖率报告；CI 产物归档 | A0-INF-03 | CI 产出测试报告；3 条冒烟通过 | 0.5 ✅ |
|
||||
| A0-INF-01 | Monorepo 与工具链 | INF | pnpm workspace + Turborepo；TS strict；ESLint 9 flat + Prettier + commitlint + lint-staged；`.nvmrc` 24.15.0、`engines`、`packageManager`、`only-allow pnpm`；`apps/api`、`apps/worker`、`apps/web`、`packages/*`、`prisma/`、`infra/` 目录骨架 | — | `pnpm install` 成功；`pnpm lint` / `pnpm typecheck` 可执行；目录与 AGENTS §5 一致；npm / yarn 被拒绝 | 1.0 | ✅ |
|
||||
| A0-INF-02 | 本地依赖与迁移种子 | INF | `docker-compose.dev.yaml`（PG18 / Redis7.4 / MinIO）、健康检查；`.env.example`；Prisma 初始化、首版迁移、种子脚本（超管、示例角色、核心字典、电商行业包占位） | A0-INF-01 | `pnpm compose:up` 三依赖健康；`pnpm db:migrate` 正向成功；种子可重复执行不重复插入 | 0.5 | ✅ |
|
||||
| A0-INF-03 | CI 与质量门禁 | INF | 流水线：`install --frozen-lockfile` → lint → typecheck → test → build → OpenAPI 产物；依赖缓存；失败阻断合并 | A0-INF-01 | 首条 PR 全绿；故意写 `any` / 类型错误 / 未格式化能被拦截 | 0.5 | ✅ |
|
||||
| A0-BE-01 | API 骨架 | BE | NestJS 11 + Fastify；Pino + trace_id；统一错误过滤器（`{code,message,details,trace_id}`）；`/health`；Swagger / OpenAPI 生成；Zod 管道；CORS 与安全头 | A0-INF-01 | `GET /health` 返回 200；错误结构统一；OpenAPI 可导出且含错误码 | 1.0 | ✅ |
|
||||
| A0-BE-02 | Prisma 基线 | BE | Prisma client 封装；迁移基线；`outbox_events` / `idempotency_keys` / `system_configs` 骨架；ULID 主键、软删、时间字段约定 | A0-INF-02 | 迁移可升可回滚；字段命名与工程规范 05 一致；无跨模块表 | 0.5 | ✅ |
|
||||
| A0-SH-01 | shared 包基线 | SH | 错误码枚举（400xx–500xx）、权限点常量骨架与命名规范（`模块:动作`）、ULID、游标分页、时间与命名工具、通用 Zod schema | A0-INF-01 | 前后端同时引用成功；shared 不依赖任何业务包 | 0.5 | ✅ |
|
||||
| A0-FE-01 | Web 骨架 | FE | Vite 6 + React 19 + Router 7 + TanStack Query 5 + Zustand 5；`@douyinfe/semi-ui-19` + `react19-adapter`；路径别名；请求层（token 注入、401 刷新、统一错误提示） | A0-INF-01 | 页面可启动；路由可切换；请求层有单测 | 0.5 | ✅ |
|
||||
| A0-FE-02 | UI 包基线 | FE | Semi 二次封装（表格 / 查询表单 / 弹窗 / 空态 / 错误态 / 加载骨架）；`icons.ts` 统一出口（Remix Icon 语义名）；locale；主题 token | A0-FE-01 | 业务代码不直接引图标库、不内联 SVG；ESLint 可拦截违规引用 | 0.5 | ✅ |
|
||||
| A0-FE-03 | 布局与登录壳 | FE | 侧边导航（按模块分组）、顶栏（用户 / 任务角标占位）、面包屑、401 / 403 / 404 页、登录页静态壳 | A0-FE-01 | 布局可打开；403 页可演示；导航配置集中管理、可按权限过滤 | 0.5 | ✅ |
|
||||
| A0-QA-01 | 冒烟与报告 | QA | 健康检查 / 登录页 / OpenAPI 冒烟用例；覆盖率报告；CI 产物归档 | A0-INF-03 | CI 产出测试报告；3 条冒烟通过 | 0.5 | ✅ |
|
||||
|
||||
**本批门禁**：`pnpm format:check && pnpm lint && pnpm typecheck && pnpm test` 全绿；`pnpm ci:local` 全绿（含 build、test:int、openapi:export / diff、e2e）；api / web / worker 可启动；OpenAPI 快照入库；CI 流程已配置，Gitea 暂无 runner 时以本地 CI 为准。
|
||||
|
||||
@@ -596,17 +596,19 @@ PRD §7 把 **M-27（素材元素级拆解）** 与「自动字幕 → TTS 配
|
||||
|
||||
### 6.5 A4 数据字典与系统配置
|
||||
|
||||
> **执行状态：✅ 已完成（2026-11-04 开发完成 + 全部门禁 + A4 浏览器 e2e 通过）**。以下 7 项 WBS 全部交付并实测；实现记录、验收证据与遗留见 [A4 实施报告](./灵犀_A4数据字典与系统配置_实施报告_V0.1.md)。
|
||||
|
||||
**目标**：字典与配置成为唯一来源，杜绝前后端硬编码。**对应**：P-06、P-13（部分）、PRD §5.4.5；`R-10` / `R-01` / `R-26`；架构 §5.3 / §5.7。
|
||||
|
||||
| 编号 | 任务 | 端 | 内容与产出 | 依赖 | 验收要点 | EPD |
|
||||
| --- | --- | --- | --- | --- | --- | --- |
|
||||
| A4-BE-01 | 字典模型与三层合并 | BE | `dict_types` / `dict_items` 通用枚举表；类型 + 编码 + 名称 + 父编码 + 行业 + 排序 + 启用；编码不可改、名称可改；查询按"本行业 + 父行业 + 通用"三层合并 | A3-BE-01 | 一张表同时表达二级树与词表；编码修改被拒；三层合并结果有单测 | 1.0 |
|
||||
| A4-BE-02 | 系统配置与版本 | BE | `system_configs` 键值 + 版本 + 变更审计；命名规则、导出设置、通知开关、阈值（爆量 / 超时 / 上限）单一来源；前后端同源读取 | A0-BE-02 | 配置变更留前后值；阈值只有一处定义；前端上限读取配置接口 | 0.5 |
|
||||
| A4-BE-03 | 命名规则服务 | BE | `R-01` 占位符解析（行业 / 客户 / 方向 / 日期 / 序号），中文 / 字母 / 数字 / 下划线 / 短横线校验，同名自动加序号，≤ 100 字符 | A4-BE-02 | 占位符缺失报错；同名序号连续；规则可被导出 / 素材 / 脚本共用 | 0.5 |
|
||||
| A4-BE-04 | 字典快照 | BE | 字典项被引用时保存填写时快照；字典变更只影响新数据；历史统计按填写时解释（`R-10`） | A4-BE-01 | 改字典名称后历史数据不变；快照查询可复现 | 0.5 |
|
||||
| A4-FE-01 | 字典管理 | FE | 字典类型列表、条目树 / 词表双视图、行业作用域、排序、启停；编码只读 | A4-BE-04 | 编码不可编辑；树与词表可切换；影响范围提示 | 0.5 |
|
||||
| A4-FE-02 | 系统配置页 | FE | 命名规则、导出设置、通知、阈值配置；版本与变更记录 | A4-BE-02 | 保存前展示影响面；阈值修改有二次确认 | 0.5 |
|
||||
| A4-QA-01 | 合并 / 快照 / 同源用例 | QA | 三层合并、编码不可改、快照、阈值前后端一致 | A4-BE-04 | 用例全绿；改字典不影响历史 | 0.5 |
|
||||
| 编号 | 任务 | 端 | 内容与产出 | 依赖 | 验收要点 | EPD | 状态 |
|
||||
| --- | --- | --- | --- | --- | --- | --- | --- |
|
||||
| A4-BE-01 | 字典模型与三层合并 | BE | `dict_types` / `dict_items` 通用枚举表；类型 + 编码 + 名称 + 父编码 + 行业 + 排序 + 启用；编码不可改、名称可改；查询按"本行业 + 父行业 + 通用"三层合并 | A3-BE-01 | 一张表同时表达二级树与词表；编码修改被拒；三层合并结果有单测 | 1.0 | ✅ |
|
||||
| A4-BE-02 | 系统配置与版本 | BE | `system_configs` 键值 + 版本 + 变更审计；命名规则、导出设置、通知开关、阈值（爆量 / 超时 / 上限）单一来源；前后端同源读取 | A0-BE-02 | 配置变更留前后值；阈值只有一处定义；前端上限读取配置接口 | 0.5 | ✅ |
|
||||
| A4-BE-03 | 命名规则服务 | BE | `R-01` 占位符解析（行业 / 客户 / 方向 / 日期 / 序号），中文 / 字母 / 数字 / 下划线 / 短横线校验，同名自动加序号，≤ 100 字符 | A4-BE-02 | 占位符缺失报错；同名序号连续；规则可被导出 / 素材 / 脚本共用 | 0.5 | ✅ |
|
||||
| A4-BE-04 | 字典快照 | BE | 字典项被引用时保存填写时快照；字典变更只影响新数据；历史统计按填写时解释（`R-10`） | A4-BE-01 | 改字典名称后历史数据不变；快照查询可复现 | 0.5 | ✅ |
|
||||
| A4-FE-01 | 字典管理 | FE | 字典类型列表、条目树 / 词表双视图、行业作用域、排序、启停；编码只读 | A4-BE-04 | 编码不可编辑；树与词表可切换；影响范围提示 | 0.5 | ✅ |
|
||||
| A4-FE-02 | 系统配置页 | FE | 命名规则、导出设置、通知、阈值配置；版本与变更记录 | A4-BE-02 | 保存前展示影响面；阈值修改有二次确认 | 0.5 | ✅ |
|
||||
| A4-QA-01 | 合并 / 快照 / 同源用例 | QA | 三层合并、编码不可改、快照、阈值前后端一致 | A4-BE-04 | 用例全绿；改字典不影响历史 | 0.5 | ✅ |
|
||||
|
||||
**本批门禁**：字典三层合并可用；编码不可改；阈值只存一处且前后端一致；配置变更可审计。
|
||||
|
||||
|
||||
Reference in new issue
Block a user