wang259797/lingxi
1
0 Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

docs(plan): 标注 A0 阶段完成状态
ci / 质量门禁 (push) Canceled after 0s
Details

Browse Source 
背景：A0 工程骨架与契约基线已完成并通过全部门禁。
改动：开发计划状态改为执行中；M0 批次总览增加状态列并标注 A0 已完成；
A0 WBS 增加状态列与完成说明；回写执行证据与环境/范围偏差。
影响面：仅 M0 进度标注，不改变范围与验收口径。
回滚方式：还原本文件至上一提交。
验证：format:check 通过；A0 门禁与本地 CI 全绿见 A0 实施报告。
This commit is contained in:
Stev_Wang committed 2026-11-02 20:27:22 +08:00
1 parent 2f200fc9d9
commit f0d218bd99
1 file changed
+35 -28
Download Patch File Download Diff File Expand all files Collapse all files
docs/开发计划/灵犀_信息流素材生产平台_开发计划_V0.1.md
+35 -28
View File
@@ -10,7 +10,7 @@
| 文档名称 | 灵犀 · 信息流素材生产平台 项目开发计划 | | 文档名称 | 灵犀 · 信息流素材生产平台 项目开发计划 |
| 版本 | V0.1（初稿，待评审） | | 版本 | V0.1（初稿，待评审） |
| 日期 | 2026-11-02 | | 日期 | 2026-11-02 |
| 状态 | 待产品 / 技术负责人评审；评审通过后作为建仓与批次执行的依据 | | 状态 | **执行中**：A0 工程骨架与契约基线已完成（2026-11-02）；A1 待启动 |
| 需求基线 | PRD V1.6（[灵犀-信息流广告素材一站式生产平台PRD.md](../PRD/灵犀-信息流广告素材一站式生产平台PRD.md)） | | 需求基线 | PRD V1.6（[灵犀-信息流广告素材一站式生产平台PRD.md](../PRD/灵犀-信息流广告素材一站式生产平台PRD.md)） |
| 技术基线 | 技术架构 V0.4（[灵犀_信息流素材生产平台_技术架构_V0.1.md](../技术架构/灵犀_信息流素材生产平台_技术架构_V0.1.md)）+ `AGENTS.md` V1.0 + `docs/工程规范/` V1.0 | | 技术基线 | 技术架构 V0.4（[灵犀_信息流素材生产平台_技术架构_V0.1.md](../技术架构/灵犀_信息流素材生产平台_技术架构_V0.1.md)）+ `AGENTS.md` V1.0 + `docs/工程规范/` V1.0 |
| 覆盖范围 | **M0 任务级；M1–M4 迭代级 + 任务组级；M5 预研边界（不排期）** | | 覆盖范围 | **M0 任务级；M1–M4 迭代级 + 任务组级；M5 预研边界（不排期）** |
@@ -22,6 +22,7 @@
| 版本 | 日期 | 修订内容 | | 版本 | 日期 | 修订内容 |
| --- | --- | --- | | --- | --- | --- |
| V0.1 | 2026-11-02 | 初稿：全项目 M0–M4 开发计划（M0 十二批次任务级 WBS；M1–M4 迭代 + 任务组 WBS；M5 预研边界）、七个管理模块专项、前后端并行与联调机制、质量门禁、风险与验收、待确认事项 | | V0.1 | 2026-11-02 | 初稿：全项目 M0–M4 开发计划（M0 十二批次任务级 WBS；M1–M4 迭代 + 任务组 WBS；M5 预研边界）、七个管理模块专项、前后端并行与联调机制、质量门禁、风险与验收、待确认事项 |
| V0.1（进度回写） | 2026-11-02 | A0 工程骨架与契约基线完成：批次总览增加状态列、A0 WBS 标注完成、回写执行证据与偏差；不改变原计划范围与验收口径 |
### 0.2　引用约定 ### 0.2　引用约定
@@ -372,23 +373,25 @@ flowchart LR
### 5.2　M0 批次总览 ### 5.2　M0 批次总览
| 批次 | 主题 | 依赖 | EPD | 参考工期 | 并行波次 | 退出条件（摘要） | | 批次 | 状态 | 主题 | 依赖 | EPD | 参考工期 | 并行波次 | 退出条件（摘要） |
| --- | --- | --- | --- | --- | --- | --- | | --- | --- | --- | --- | --- | --- | --- | --- |
| **A0** | 工程骨架与契约基线 | — | 6 | 4–5 日 | W0 | lint / typecheck / test / CI 全绿；三依赖可起；api / web / worker 可启动；OpenAPI 可导出 | | **A0** | ✅ 已完成 | 工程骨架与契约基线 | — | 6 | 4–5 日 | W0 | lint / typecheck / test / CI 全绿；三依赖可起；api / web / worker 可启动；OpenAPI 可导出 |
| **A1** | 身份认证与用户管理 | A0 | 6 | 4–5 日 | W1 | 登录 / 刷新 / 登出；用户生命周期；路由权限；权限三态用例 | | **A1** | 未开始 | 身份认证与用户管理 | A0 | 6 | 4–5 日 | W1 | 登录 / 刷新 / 登出；用户生命周期；路由权限；权限三态用例 |
| **A2** | 角色权限与数据范围 | A1 | 5.5 | 4–5 日 | W2 | 角色可配；SoD 命中拒绝；特殊权限默认关闭；范围过滤生效 | | **A2** | 未开始 | 角色权限与数据范围 | A1 | 5.5 | 4–5 日 | W2 | 角色可配；SoD 命中拒绝；特殊权限默认关闭；范围过滤生效 |
| **A3** | 客户与行业目录 | A1 / A2 | 7 | 4–5 日 | W2 | 行业 / 客户 / 客户组可用；唯一性；状态只读；字段审批 | | **A3** | 未开始 | 客户与行业目录 | A1 / A2 | 7 | 4–5 日 | W2 | 行业 / 客户 / 客户组可用；唯一性；状态只读；字段审批 |
| **A4** | 数据字典与系统配置 | A3 | 4 | 3–4 日 | W3 | 三层合并；编码不可改；阈值同源；配置版本 + 审计 | | **A4** | 未开始 | 数据字典与系统配置 | A3 | 4 | 3–4 日 | W3 | 三层合并；编码不可改；阈值同源；配置版本 + 审计 |
| **A5** | 审计与日志 | A1 / A4 | 4 | 3–4 日 | W2–W3 | 关键操作全留痕；不可篡改；导出自身审计 | | **A5** | 未开始 | 审计与日志 | A1 / A4 | 4 | 3–4 日 | W2–W3 | 关键操作全留痕；不可篡改；导出自身审计 |
| **A6** | 任务中心与队列骨架 | A0 / A1 | 6 | 4–5 日 | W2–W3 | 提交 → SSE → 完成 / 失败；幂等；取消 / 重试 | | **A6** | 未开始 | 任务中心与队列骨架 | A0 / A1 | 6 | 4–5 日 | W2–W3 | 提交 → SSE → 完成 / 失败；幂等；取消 / 重试 |
| **A7** | AI 配置与调用底座 | A0 / A1 / A5 | 6 | 4–5 日 | W3 | 四层配置；Mock 调用；密钥不泄露；账本可查 | | **A7** | 未开始 | AI 配置与调用底座 | A0 / A1 / A5 | 6 | 4–5 日 | W3 | 四层配置；Mock 调用；密钥不泄露；账本可查 |
| **B0** | 行业包与表单设计器 | A3 / A4 | 8 | 6–7 日 | W4 | 电商行业包 v1；七项校验；双人发布；快照 | | **B0** | 未开始 | 行业包与表单设计器 | A3 / A4 | 8 | 6–7 日 | W4 | 电商行业包 v1；七项校验；双人发布；快照 |
| **B1** | 资产与模板最小集 | A3 / A5 | 6.5 | 5–6 日 | W4 | 15 类资产；引用保护；PSD 图层校验 | | **B1** | 未开始 | 资产与模板最小集 | A3 / A5 | 6.5 | 5–6 日 | W4 | 15 类资产；引用保护；PSD 图层校验 |
| **B2** | 要素卡与脚本模板 | B0 | 4.5 | 4–5 日 | W5 | 动态表单渲染；要素卡检索；模板版本 | | **B2** | 未开始 | 要素卡与脚本模板 | B0 | 4.5 | 4–5 日 | W5 | 动态表单渲染；要素卡检索；模板版本 |
| **B3** | 导出骨架与归档 | B1 / B2 | 5 | 4–5 日 | W6 | E-01~E-03；命名规则；审计；签名 URL | | **B3** | 未开始 | 导出骨架与归档 | B1 / B2 | 5 | 4–5 日 | W6 | E-01~E-03；命名规则；审计；签名 URL |
**合计**：12 个批次，68.5 EPD，6–7 周（含 25% 缓冲与 M0 末集成缓冲）。 **合计**：12 个批次，68.5 EPD，6–7 周（含 25% 缓冲与 M0 末集成缓冲）。
> **A0 进度（2026-11-02）**：✅ 已完成。10/10 项 WBS 通过；本批门禁 `format:check / lint / typecheck / test / build / test:int / openapi:export / openapi:diff / e2e` 与本地 CI `pnpm ci:local` 全绿；`/health`、`/api/docs`、web 布局与登录壳、worker 启动均实测通过。实现记录与偏差见 [A0 实施报告](./灵犀_A0工程骨架与契约基线_实施报告_V0.1.md)。环境适配：本地 PG/Redis 复用已有 Docker、对象存储使用公网 RustFS、种子仅 `system_configs`（`Q-A0-01`）、Gitea 暂无 runner 时以 `pnpm ci:local` 为准。
### 5.3　批次依赖图 ### 5.3　批次依赖图
```mermaid ```mermaid
@@ -498,23 +501,27 @@ PRD §7 把 **M-27（素材元素级拆解）** 与「自动字幕 → TTS 配
### 6.1　A0 工程骨架与契约基线 ### 6.1　A0 工程骨架与契约基线
> **执行状态：✅ 已完成（2026-11-02）**。以下 10 项 WBS 全部交付并实测；验收证据、环境差异与待确认项见 [A0 实施报告](./灵犀_A0工程骨架与契约基线_实施报告_V0.1.md)。
**目标**：一次建对仓库、工具链、CI 与契约管线，避免后续每个批次各修一遍。 **目标**：一次建对仓库、工具链、CI 与契约管线，避免后续每个批次各修一遍。
**对应**：技术架构 §10.1；`AGENTS.md` §3 / §5 / §6；工程规范 01–03 / 06 / 09。 **对应**：技术架构 §10.1；`AGENTS.md` §3 / §5 / §6；工程规范 01–03 / 06 / 09。
| 编号 | 任务 | 端 | 内容与产出 | 依赖 | 验收要点 | EPD | | 编号 | 任务 | 端 | 内容与产出 | 依赖 | 验收要点 | 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-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-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-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-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-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-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-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-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-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-QA-01 | 冒烟与报告 | QA | 健康检查 / 登录页 / OpenAPI 冒烟用例；覆盖率报告；CI 产物归档 | A0-INF-03 | CI 产出测试报告；3 条冒烟通过 | 0.5 ✅ |
**本批门禁**：`pnpm lint && pnpm typecheck && pnpm test` 全绿；`pnpm compose:up` 三依赖健康；api / web / worker 可启动；OpenAPI 快照入库；CI 在 PR 上可阻断。 **本批门禁**：`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 为准。
> **环境与范围偏差**：本地 PG / Redis 复用已有 `docker-postgres-1` / `docker-redis-1`；S3 使用公网 RustFS（单桶 `lingxi-dev`）；超管 / 角色 / 字典 / 电商行业包种子依赖 A1–A4 的表，A0 仅种子 `system_configs`，已登记为 `Q-A0-01` 并在 A0 报告中说明。
### 6.2　A1 身份认证与用户管理 ### 6.2　A1 身份认证与用户管理