背景：A6 全部 WBS 与门禁完成，按文档规范同批更新实现记录与计划状态。 改动： - 新增 docs/开发计划/灵犀_A6任务中心与队列骨架_实施报告_V0.1.md：范围与完成度、交付物、门禁结果、关键口径（202 / 幂等 / 取消重试 / SSE / 状态机 / 队列物理名 / Outbox 退避 / 前端预估 / 角标）、与计划差异、已知遗留与下一步。 - 开发计划：状态行与 A6 批次置为已完成、§6.7 增加执行状态与完成情况、§7.6 增加状态行、M0 清单勾选任务中心。 - README：索引新增 A6 报告，当前进度推进到 A7。 影响面：仅文档与索引；无代码行为变化。 回滚：撤销提交恢复文档。 验证：pnpm format:check 通过；报告中的门禁数据来自本批实际执行结果。
This commit is contained in:
Stev_Wang committed
1 parent
4825626bdf
commit
45467558ab
3 files changed
+167
-4
No files matched your search
@@ -10,7 +10,7 @@
|
||||
| 文档名称 | 灵犀 · 信息流素材生产平台 项目开发计划 |
|
||||
| 版本 | V0.1（初稿，待评审） |
|
||||
| 日期 | 2026-11-02 |
|
||||
| 状态 | **执行中**：A0 工程骨架与契约基线已完成（2026-11-02）；A1 身份认证与用户管理已完成（2026-11-03）；A2 角色权限与数据范围已完成（2026-11-03）；A3 客户与行业目录已完成（2026-11-04 最终验收）；A4 数据字典与系统配置已完成（2026-11-04）；A5 审计与日志已完成（2026-11-04）；下一步 A6 |
|
||||
| 状态 | **执行中**：A0 工程骨架与契约基线已完成（2026-11-02）；A1 身份认证与用户管理已完成（2026-11-03）；A2 角色权限与数据范围已完成（2026-11-03）；A3 客户与行业目录已完成（2026-11-04 最终验收）；A4 数据字典与系统配置已完成（2026-11-04）；A5 审计与日志已完成（2026-11-04）；A6 任务中心与队列骨架已完成（2026-11-05）；下一步 A7 |
|
||||
| 需求基线 | PRD V1.6（[灵犀-信息流广告素材一站式生产平台PRD.md](../PRD/灵犀-信息流广告素材一站式生产平台PRD.md)） |
|
||||
| 技术基线 | 技术架构 V0.4（[灵犀_信息流素材生产平台_技术架构_V0.1.md](../技术架构/灵犀_信息流素材生产平台_技术架构_V0.1.md)）+ `AGENTS.md` V1.0 + `docs/工程规范/` V1.0 |
|
||||
| 覆盖范围 | **M0 任务级；M1–M4 迭代级 + 任务组级；M5 预研边界（不排期）** |
|
||||
@@ -385,7 +385,7 @@ flowchart LR
|
||||
| **A3** | ✅ 已完成 | 客户与行业目录 | A1 / A2 | 7 | 4–5 日 | W2 | 行业 / 客户 / 客户组可用；唯一性；状态只读；字段审批 |
|
||||
| **A4** | ✅ 已完成 | 数据字典与系统配置 | A3 | 4 | 3–4 日 | 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 调用；密钥不泄露；账本可查 |
|
||||
| **B0** | 未开始 | 行业包与表单设计器 | A3 / A4 | 8 | 6–7 日 | W4 | 电商行业包 v1；七项校验；双人发布；快照 |
|
||||
| **B1** | 未开始 | 资产与模板最小集 | A3 / A5 | 6.5 | 5–6 日 | W4 | 15 类资产；引用保护；PSD 图层校验 |
|
||||
@@ -641,6 +641,8 @@ PRD §7 把 **M-27（素材元素级拆解）** 与「自动字幕 → TTS 配
|
||||
|
||||
**目标**：所有耗时操作走统一任务协议，前端有统一进度体验。**对应**：架构 §6.4 / §3.3；M-05；`D-02` / `D-08`。
|
||||
|
||||
> **执行状态：✅ 已完成（2026-11-05）**。以下 9 项 WBS 全部交付并实测；前端按用户选定 **方案 A · 经典管理台** 落地；实现记录、验收证据与遗留见 [A6 实施报告](./灵犀_A6任务中心与队列骨架_实施报告_V0.1.md)。
|
||||
|
||||
| 编号 | 任务 | 端 | 内容与产出 | 依赖 | 验收要点 | EPD |
|
||||
| --- | --- | --- | --- | --- | --- | --- |
|
||||
| A6-BE-01 | 任务协议与状态机 | BE | `media_tasks` / `media_items` 基表；状态机**对齐架构 §3.6 九态**（排队 / 生成中 / 部分失败 / 待预览 / 已勾选 / 已导出 / 已入库 / 失败 / 已取消），M0 先点亮排队 / 生成中 / 部分失败 / 失败 / 已取消，其余状态由 B3 / M1 点亮；提交返回 `{taskId, estimatedItems, estimatedCost, estimatedSeconds}`；`Idempotency-Key` 24 小时去重 | A0-BE-02、A0-SH-01 | 重复提交返回同一任务；缺预估字段拒绝提交；状态枚举与架构 §3.6 一致；流转有单测 | 1.0 |
|
||||
@@ -655,6 +657,8 @@ PRD §7 把 **M-27（素材元素级拆解）** 与「自动字幕 → TTS 配
|
||||
|
||||
**本批门禁**：提交 → SSE → 完成 / 失败闭环；幂等与取消生效；队列隔离；进度落库可恢复。
|
||||
|
||||
> **A6 完成情况（2026-11-05）**：9/9 项 WBS 全部 ✅。统一任务协议（架构 §3.6 九态 / 5 组 9 队列 / SSE 事件 / Outbox）、`media_tasks` / `media_items` / `task_events` 三表、提交（202 + Idempotency-Key 24h 去重 + 预估）、跨类型列表 / 详情（筛选 + 游标分页）、SSE（Last-Event-ID 续推 + 心跳 + 落库轮询）、取消（只影响未开始项）、仅重试失败项、BullMQ 九队列 / Outbox dispatcher / 演练 worker / 队列健康与 Prometheus 指标全部落地；前端按用户选定 **方案 A** 实现 `/material/tasks`、`/material/tasks/:id`，含可复用进度组件、顶栏全局角标与待处理失败信号、提交 / 取消 / 重试确认。门禁：`format:check / lint / typecheck` 全绿，单测 shared 197 / api 257 / web 238 / worker 27，`test:int` 92（含 media 12），`build` 8/8，`openapi:diff` 无破坏性变更，A6 浏览器 e2e 6/6（约 39s）。已知遗留：A5 审计导出仍待 B3 迁移、真实任务类型与产物待 B3 / M1、Prometheus/Grafana 未接真实告警、OTel 未接。实现记录与偏差见 [A6 实施报告](./灵犀_A6任务中心与队列骨架_实施报告_V0.1.md)。
|
||||
|
||||
### 6.8 A7 AI 配置与调用底座
|
||||
|
||||
**目标**：四层配置可管、密钥安全、Mock 可跑通、调用有账本。**对应**：P-08、PRD §5.4.4；`R-23`；架构 §2.6 / §7.7；`D-10` 前置。
|
||||
@@ -986,6 +990,7 @@ PRD §7 把 **M-27（素材元素级拆解）** 与「自动字幕 → TTS 配
|
||||
|
||||
| 项 | 内容 |
|
||||
| --- | --- |
|
||||
| 状态 | ✅ 已完成（2026-11-05）；实现记录见 [A6 实施报告](./灵犀_A6任务中心与队列骨架_实施报告_V0.1.md) |
|
||||
| 页面 | `/tasks`（跨类型任务中心）、`/tasks/:id`（进度 / 逐项 / 失败明细 / 重试 / 取消） |
|
||||
| 接口 | `POST /media-tasks`、`GET /media-tasks`、`/media-tasks/{id}`、`GET /media-tasks/{id}/events`（SSE）、`POST /media-tasks/{id}/cancel`、`POST /media-tasks/{id}/retry` |
|
||||
| 关键规则 | 提交必带 `Idempotency-Key`；必须返回预估条数 / 成本 / 时长，缺一不可提交；状态机统一；进度落库、进程重启不丢；取消只影响未开始项；重试只重失败项；队列分组隔离，视频积压不拖垮脚本 |
|
||||
@@ -1253,7 +1258,7 @@ infra/：compose、Nginx、监控、备份脚本占位
|
||||
- [x] 系统配置单一来源、阈值 / 上限同源、配置版本与变更记录可用；
|
||||
- [ ] 审计七类关键动作留痕、只读、导出留痕；
|
||||
- [ ] AI 四层配置 + Mock 全链路 + 密钥不回显；
|
||||
- [ ] 任务中心可查 / 可取消 / 可重试，幂等生效；
|
||||
- [x] 任务中心可查 / 可取消 / 可重试，幂等生效；
|
||||
- [ ] 行业包 v1（电商）草稿 → 校验 → 审核 → 发布；
|
||||
- [ ] 资产包上传 / 版本 / 停用 / 引用保护；
|
||||
- [ ] 要素卡与脚本模板可用，表单设计器 14 类字段可用；
|
||||
|
||||
Reference in new issue
Block a user