lovife
63aec55329
一期范围：学校收集 + 自主认定（4 类材料全部有实测样本） - 主 PRD 190KB：125 条 FR / 21 条 VAL / 20 张表 DDL / 121 个接口 - 功能逻辑卷 88KB：不含代码模块 - 接口设计 116KB：58 个错误码 / 12 个 VO - 核心模块设计：M1 命名 / M2 压缩 / M3 识别 / M4 门禁 / M5 校验 / M6 导出 - 开发任务拆解：100 任务 / 387 人日 / 15 周 - 验收测试清单：36 条 Golden 断言 / 111 条功能验收 - PostgreSQL DDL：已在 PG 16.15 实测零错误 - 交互原型 31 屏：学生端 11 / 班主任端 9 / 管理端 11
11 KiB
11 KiB
交付计划与进度
项目：数据信息填报系统（填报通 / CollectFlow） 起始：2026-09-28 状态：进行中
一、当前已交付
| # | 交付物 | 版本 | 状态 |
|---|---|---|---|
| — | 主 PRD（含库表设计、接口清单、15 条校验规则、18 张表 DDL） | V2.3 | ✅ |
| — | 功能逻辑卷（纯功能运转逻辑，不含库表/接口/代码） | V1.9 | ✅ |
| — | PostgreSQL 建表脚本 | — | ✅ 已在 PG 16 实测通过 |
| — | 学生端原型（11 屏） | V1.2 | ✅ 含「申请加入名单」 |
| — | 班主任端原型（9 屏） | V1.1 | ✅ |
| — | 管理端 PC 原型（11 屏） | V1.2 | ✅ 含表单设计器/材料规则/整理器/申请审批 |
二、待执行计划
排序原则：先解阻塞，再补设计，最后备交付。 客户确认链是最长的外部依赖，必须最先发出去。
阶段一 · 打通确认链
| # | 任务 | 产出 | 为什么这个顺序 | 状态 |
|---|---|---|---|---|
| P1 | 客户与认定机构确认函 | 01-客户与机构确认函.md |
外部依赖最长。5 项高优先级阻塞开发（300dpi 能否接受、名单外的人怎么办、社会收集名单从哪来…），越早发出越早回来 | ✅ |
| P2 | 需求追溯矩阵 | 02-需求追溯矩阵.md |
自审：把 PRD 需求 ↔ 原型屏 ↔ 库表 ↔ 接口 逐条对应，找出说了没做/做了没说的缺口。放在接口文档之前，避免接口漏做 | ✅ |
| P2.5 | 管理端补充原型（矩阵审计追加） | 追加到 admin-web.html |
矩阵发现 3 个 P0/P1 复杂交互页面未出原型：表单设计器、材料规则配置、历史整理器。不画出来开发必理解偏 | ✅ |
阶段二 · 补齐技术设计
| # | 任务 | 产出 | 说明 | 状态 |
|---|---|---|---|---|
| P3 | 接口设计（OpenAPI） | 03-接口设计.md |
PRD §8 已有 96 个接口清单，但缺完整请求/响应字段定义。补齐后前端可 mock、后端可并行开工。含补追溯矩阵发现的 21 个缺口 | ✅ |
| P4 | 核心模块设计说明 | 04-核心模块设计说明.md |
6 个模块的伪代码级说明：M1 命名 / M2 压缩 / M3 识别 / M4 门禁 / M5 校验 / M6 导出；含依赖图、开发顺序、Golden 基线 | ✅ |
阶段三 · 交付准备
| # | 任务 | 产出 | 说明 | 状态 |
|---|---|---|---|---|
| P5 | 开发任务拆解（WBS） | 05-开发任务拆解.md |
8 个里程碑拆到可派工粒度（94 个任务 / 380 人日 / 工期 14 周），含关键路径、8 项风险、团队配置、3 个客户演示点 | ✅ |
| P6 | 验收测试清单 | 06-验收测试清单.md |
29 条 Golden 断言（可直接自动化）+ 85 条功能验收 + 20 条异常边界 + 9 项性能 + 12 项安全 + 签署表 | ✅ |
| P7 | 文档导航（README） | ../README.md |
统一入口：按角色读法、三分钟看懂产品、关键决策速查、快速上手 | ✅ |
三、执行记录
| 时间 | 任务 | 结果 |
|---|---|---|
| 2026-09-28 | 立计划 | 7 项，分三阶段 |
| 2026-09-28 | P1 确认函 | 完成 01-客户与机构确认函.md：23 项待确认按拍板方分 4 组（认定机构 6 / 客户业务 9 / 商务法务 5 / 内部技术 7）；每项给出建议默认值，客户不回复也能推进；附 9 条已闭环决策表防止反复讨论 |
| 2026-09-28 | P2 追溯矩阵 | 完成 02-需求追溯矩阵.md。审计发现：① 修正统计口径——实际 115 条 FR（83 P0/29 P1/3 P2）+ 17 条 VAL，此前漏算加粗编号；② 10 个接口缺口（报考范围、整理器、字典、日志、消息中心、订阅额度、审核撤回、任务暂停…）；③ 管理端 10 个原型页面缺口，其中表单设计器为 P0；④ 4 个疑似需求问题中 3 个是脚本正则缺陷、1 个为真（已补 FR-616）；⑤ 追加 P2.5 补 3 个复杂交互页面原型 |
| 2026-09-28 | P2.5 补充原型 | 管理端 admin-web.html 由 7 屏扩至 10 屏：⑧表单设计器（字段库/画布/属性三栏 + 条件规则行，内置字段带锁不可删）⑨材料规则配置（材料清单侧栏 + 命名模板 + 档位选择 + 来源引导语）⑩历史数据整理器（用真实实测数字：475MB→37MB、59 项命名违规、仅 1 项需人工）。四份原型全部通过结构校验 |
| 2026-09-28 | P6 验收测试清单 | 完成 06-验收测试清单.md（25KB / 518 行）。把 P4 的 15 项基线转成 29 条可自动化断言 G-01~G-29；另含 3 条端到端主流程（32 步）、20 条异常边界、85 条功能验收、6 条视觉、9 项性能、12 项安全；含里程碑签署表与 7 条 Go/No-Go 条件；点出 3 个易漏盲区（Windows 解压中文名 / 并发绑定临界窗口 / 「无」是合法值） |
| 2026-09-28 | 客户回执 | 客户确认全部 23 项按建议执行，需求冻结。识别出唯一功能增量 B1（申请加入名单），其余 22 项零改动 |
| 2026-09-28 | D7 降级 | 重新评估「文件名识别真实准确率」这个待办：因输出命名取自名册、归属靠证件号反查名册、识别有槽位兜底、失败一律放行，该指标不影响任何交付项。降级为「上传页引导文案校准」——班主任在群里问两句即可，取消样本索取。至此全部外部数据依赖清零 |
| 2026-09-28 | 一期范围收窄 | 客户确认「先做学校内的填报流程」→ 一期只做学校收集 + 自主认定（4 类材料全部有实测样本）；社会收集 / 社会评价 / 专项职业能力后置二期，数据结构与枚举保留不启用。D4 因此不再是待办。工期 −5 人日（392→387），关键路径不变仍 15 周 |
| 2026-09-28 | 移除联系方式展示 | 客户指出"学生本来就有班主任联系方式，不需要系统里面体现"。删除 GET /mp/roster/contact 接口 + 门禁失败页「联系老师」按钮，改为只保留两条系统内动作（重新填写 / 申请加入名单）。接口总数 122 → 121。纯文案提示保留（不涉及联系方式数据） |
| 2026-09-28 | 归属校验修正 | 客户指出"系统不存在名称错误"——纠正原设计中「把文件名不符自动按名册修正」的缺陷（会把传错的文件静默洗白）。改为 VAL-21 文件归属校验 + 阻断提交；判定优先级重排为 证件号反查名册 > OCR > 姓名（仅辅助）；姓名不再作为独立规则。另补全「社会评价」定义与 cert_type 第三取值 |
| 2026-09-28 | B1 落地 | 新增 FR-509 系列 10 条 / collect_join_request 表（PG 16 实测通过 + 部分唯一索引业务规则验证）/ 5 个接口 / 错误码 40037~40042 / 学生端 STEP 03B + 管理端 STEP 11 两屏原型 / F-509 验收项 19 条 / WBS 新增 6 个任务 |
| 2026-09-28 | P7 文档导航 | 完成 ../README.md（10KB）。按角色给出读法、三分钟看懂产品、13 条关键决策速查、目录结构与快速上手、数据基线、两条踩坑教训 |
| 2026-09-28 | P5 开发任务拆解 | 完成 05-开发任务拆解.md（27.6KB / 468 行）。94 个任务 / 380 人日 / 含缓冲 456，工期 14 周。关键结论：工期由关键路径（67 人日串行）决定，不能按人日总数摊人；压缩周期只能砍范围不能加人。含 3 个客户演示点（A 第 5 周 / B 第 10 周 / C 第 14 周）与 §9 可复现核算口径 |
| 2026-09-28 | P4 核心模块设计 | 完成 04-核心模块设计说明.md（54KB / 1218 行）。六个模块全部伪代码级：M1 命名（含证件号三源裁决表）、M2 压缩（五档+二分降质+二次有损防护）、M3 识别（四层递进+成本闸）、M4 门禁（并发绑定必须 UPDATE...WHERE bind_user_id IS NULL）、M5 校验、M6 导出（快照先固化+中文文件名编码）。校验中发现并修正三处真问题，见下条教训 |
| 2026-09-28 | P3 接口设计 | 完成 03-接口设计.md（102KB / 2626 行）。117 个接口全部字段级定义（PRD 原 96 + 新增 21）；新增 §2 枚举全集（含「无」的三条铁律）、§3 通用数据结构（12 个 VO，字段名与 DDL 列一一对应）、§15 错误码全集（50 个，新增 30）；自校验通过：模块表合计=声称=实际唯一数=117，无真重复，引用字段名 116 个全部存在于 DDL |
三、客户回执（2026-09-28）
客户全部 23 项按建议方案确认。 详见
01-客户与机构确认函.md的客户回执章节。
| 组 | 项数 | 需开发 | 结论 |
|---|---|---|---|
| A 认定机构 | 6 | 0 | 全部与现有设计一致（当初就按实测数据设计） |
| B 校方业务 | 9 | 1 | 仅 B1（申请加入名单通道） 是功能增量 |
| C 商务法务 | 5 | 0 | C1 小程序资质按建议推进 + H5 保底 |
| D 内部技术 | 7 | 0 | D4 已后置二期、D7 已降级清除；仅 D6（微信三条来源通道体积上限）需真机自测，无外部依赖 |
一期范围（客户确认后收窄）：只做 学校收集 + 自主认定（4 类材料全部有实测样本）。 社会收集 / 社会评价 / 专项职业能力后置二期，数据结构与枚举保留不启用。 ⇒ D4（社会评价样本）因此不再是待办；工期 392 → 387 人日，关键路径不变仍 15 周。
本次变更（V1）：新增 FR-509 系列（10 条）+ 1 张表（collect_join_request）+ 5 个接口 + 2 屏原型。
| 指标 | 变更前 | 变更后 |
|---|---|---|
| FR 总数 | 115 | 125 |
| 接口总数 | 117 | 121 |
| 库表 | 19 | 20 |
| VAL 规则 | 20 | 21（新增 VAL-21 归属校验） |
| 错误码 | 50 | 57 |
| 原型屏数 | 29 | 31 |
| 任务数 | 94 | 100 |
| 人日 | 380 | 392 → 387（一期收窄 −5） |
| 工期 | 14 周 | 15 周 |
四、已知风险（跟踪中）
| # | 风险 | 影响 | 对策 |
|---|---|---|---|
| R1 | — | ✅ 已解除：客户确认全部 23 项按建议执行，需求已冻结 | |
| R2 | — | ✅ 已消除：一期范围收窄为「学校收集 + 自主认定」，不涉及那两类零样本材料（D4 已后置二期） | |
| R3 | VLM 选型未定 | 中 | P4 中把 VLM 抽成可替换接口，不绑定供应商 |
| R4 | 二期启动时缺少社会评价样本 | 中（二期） | 已在 PRD「一期范围声明」列出二期启动前必做 6 项；不阻塞一期 |