# 开发任务拆解与排期（WBS） > 版本：V1.0　|　日期：2026-09-28 > 读者：项目经理、技术负责人、全体开发、测试 > 依据：《数据信息填报系统PRD.md》V2.3+、《03-接口设计.md》、《04-核心模块设计说明.md》 --- ## 一、说明 ### 1.1 怎么用这份文档 | 角色 | 用法 | |---|---| | 技术负责人 | 按 §3 的任务表派工；关注 §4 关键路径与 §5 风险 | | 开发 | 认领任务 ID，从备注里取对应文档章节 | | 测试 | 按 §7 的里程碑验收标准准备用例 | | 项目经理 | 按 §6 团队配置排人；按 §7 卡节点 | ### 1.2 估算口径 | 项 | 说明 | |---|---| | 单位 | **人日**（1 人日 = 1 名熟练工程师 6~7 小时有效产出） | | 已含 | 自测、单元测试、联调、Code Review 返工 | | 不含 | 需求变更、外部依赖等待、生产事故处理 | | 缓冲 | **每个里程碑独立加 20% 缓冲**，不合并到总缓冲 | | 依据 | 有明确设计文档支撑的任务按下限估；**无设计文档的任务（外部依赖/选型）按上限估** | ### 1.3 前置假设 | # | 假设 | 若不成立的影响 | |:--:|---|---| | 1 | 微信小程序主体资质齐备 | **阻断上线**，见确认函 C1 | | 2 | 认定机构书面接受 300dpi 输出 | 需重调压缩参数，影响 M3（+3 人日） | | 3 | OCR 引擎可在 M2 结束时选定 | 影响 M4（+5 人日延期） | | 4 | VLM 选型可延后至 M4 中期 | 影响小（M3 层 1/2 已能跑通） | | 5 | 单租户数据量 < 5000 人 / 任务 | 超需额外分页与异步优化（+5 人日） | | 6 | 客户名单格式与实测样本同构 | 表头探测需扩样本，影响 M2（+3 人日） | ### 1.4 里程碑总览 ``` M0 ──→ M1 ──→ M2 ─────────────→ M3 ──→ M4 ──→ M5 ──→ M6 ──→ M7 基础 任务 名册+门禁 填报 识别 审核 导出 收尾 设施 配置 主流程 校验 闭环 交付 上线 │ │ │ │ │ │ │ └───────┴────────┴─────────────────┘ └───────┴──────┘ ▲ 里程碑A：可演示"配置→收集" ▲ 里程碑B：可演示"全流程闭环" （第 5 周末） （第 11 周末） ▲ 里程碑C：可上线（第 15 周末） ``` ### 1.5 工作量汇总 | 里程碑 | 内容 | 人日 | 含缓冲 | 关键角色 | |:--:|---|:--:|:--:|---| | **M0** | 基础设施与账号体系 | 40 | 48 | 后端 + 前端 | | **M1** | 任务与配置闭环 | 44 | 53 | 前端（设计器重） | | **M2** | 名册与门禁 | 58 | 70 | 后端（算法重）+ **新增 B1** | | **M3** | 填报主流程 | 71 | 85 | **后端（引擎重）** | | **M4** | 识别与校验 | 34 | 41 | 后端 + 算法 | | **M5** | 审核闭环 | 56 | 67 | 前端 + 小程序 | | **M6** | 导出与交付 | 32 | 38 | 后端 | | **M7** | 收尾与上线 | 52 | 62 | 全员 | | | **合计** | **387** | **464** | | --- ## 一·五、一期范围（客户确认后收窄） > **一期只做「学校收集 + 自主认定」一条流程。** 详见 PRD「一期范围声明」。 | 后置项 | 原工作量 | 一期处理 | |---|---|---| | 社会收集审核流（跳过初审） | 配置驱动，≈0 | **不启用**；代码分支不做 | | 社会评价材料（`XJW_BA` 学信网备案表） | 需样本标定 | **不做**；识别词表暂缺 | | 专项职业能力支持 | 配置驱动，≈0 | **不启用**；`FR-310` 标二期 | | 其它佐证材料（`OTHER_PROOF`） | 需样本标定 | **不做**；且倾向"不做识别、纯手动槽位" | **受影响的 5 个任务（各减 1 人日）** | 任务 | 原 | 现 | 减少原因 | |---|:--:|:--:|---| | M4-01 识别层 1（强特征词表） | 3 | **2** | 一期只标定 4 类材料 | | M4-02 识别层 2（形态特征） | 3 | **2** | 一期只覆盖自主认定批次形态 | | M5-01 待审列表 | 4 | **3** | 一期只有一条审核流 | | M7-08 Golden Set 回归脚本 | 4 | **3** | 一期只覆盖 4 类材料 | | M7-11 用户手册 / 培训 | 3 | **2** | 一期流程更简单 | > ⚠️ **二期启用时必须补的**：`XJW_BA` / `OTHER_PROOF` 的识别标定与回归断言、社会收集审核流、专项职业能力字段隐藏。 > 这些都已在文档中保留描述，只是标注为二期。 --- ## 二、任务编号规则 ``` M{里程碑号}-{序号} 例：M3-04 表示第 3 个里程碑的第 4 个任务 ├─ 依赖：前置任务 ID，可并行则写"—" ├─ 人日：见 1.2 口径 └─ 备注：指向对应文档章节，开发直接翻过去 ``` --- ## 三、任务拆解 ## M0 · 基础设施与账号体系（40 人日） > **目标**：能登录、能建组织、能建用户。这是所有后续任务的地基。 | ID | 任务 | 依赖 | 人日 | 角色 | 备注 | |---|---|:--:|:--:|---|---| | M0-01 | 环境搭建：PG 16 / Redis / OSS / 对象存储策略 / 日志采集 | — | 3 | 后端 | 执行 `db/schema-postgresql.sql`（已实测） | | M0-02 | 后端项目骨架：分层、统一响应、异常处理、多租户拦截器 | M0-01 | 3 | 后端 | 接口设计 §1.3 | | M0-03 | 前端项目骨架：PC 管理端 + 小程序，路由/请求封装/权限指令 | — | 3 | 前端 | — | | M0-04 | CI/CD 与多环境（dev/test/prod）发布流水线 | M0-02 | 2 | 后端 | — | | M0-05 | 租户/组织 CRUD（后端） | M0-02 | 4 | 后端 | 接口 §6.1~§6.4 | | M0-06 | 用户与角色 CRUD（后端，含批量导入） | M0-05 | 4 | 后端 | 接口 §5.6~§5.9 | | M0-07 | PC 登录鉴权（含图形验证码、失败锁定） | M0-06 | 3 | 后端 | 接口 §5.1 | | M0-08 | 小程序登录 + 手机号绑定 | M0-02 | 2 | 后端 | 接口 §5.3 | | M0-09 | 管理端整体框架：布局/导航/表格/表单组件库 | M0-03 | 5 | 前端 | 参照 `admin-web.html` 视觉 | | M0-10 | 组织与用户管理页 | M0-09 | 4 | 前端 | — | | M0-11 | 登录页 + 权限菜单渲染 | M0-09 | 3 | 前端 | — | | M0-12 | 小程序框架与首页骨架 | M0-03 | 2 | 前端 | 参照 `student-app.html` | | ⭐ M0-13 | **H5 扫码填报保底方案技术预研**（C1 风险对策） | M0-03 | 2 | 前端 | 若小程序资质受阻，H5 可保底上线；**只预研不开发** | | **小计** | | | **40** | | | **M0 验收标准（可演示）** - [ ] 能开通租户 → 建组织树 → 导入 42 个用户 → 各角色登录看到不同菜单 - [ ] 跨租户访问被拦截 - [ ] `schema-postgresql.sql` 在测试环境零错误执行 --- ## M1 · 任务与配置闭环（44 人日） > **目标**：管理员能配出一个完整任务（含表单与材料规则），但还不能收集。 | ID | 任务 | 依赖 | 人日 | 角色 | 备注 | |---|---|:--:|:--:|---|---| | M1-01 | 任务 CRUD + 状态机（草稿/发布/暂停/恢复/截止/归档） | M0-05 | 6 | 后端 | 接口 §7.1~§7.5；**暂停与截止语义不同** | | M1-02 | 任务覆盖班级与班主任配置（`collect_task_org`） | M1-01 | 3 | 后端 | 接口 §7.6；主/副班主任 | | M1-03 | 表单 schema 版本化存储与冲突检测 | M1-01 | 4 | 后端 | 接口 §7.9；`baseVersion` 冲突返回 40025 | | M1-04 | 材料项定义 CRUD | M1-01 | 4 | 后端 | 接口 §7.10；28 个字段 | | M1-05 | 规则模板保存与应用 | M1-04 | 3 | 后端 | 接口 §7.13 | | M1-06 | 填报二维码 / 短链生成 | M1-01 | 2 | 后端 | 接口 §7.12 | | M1-07 | **表单设计器**（字段库/画布/属性三栏，内置字段锁定） | M0-09 | 8 | 前端 | 原型 STEP 08；内置字段不可删 | | M1-08 | 条件显示规则配置 UI | M1-07 | 3 | 前端 | 三条级联：补考/在校生/专项 | | M1-09 | **材料规则配置**（命名模板编辑器 + 档位选择） | M0-09 | 6 | 前端 | 原型 STEP 09；档位下拉写明适用条件 | | M1-10 | 任务向导与任务列表/详情页 | M1-07 | 5 | 前端 | 7 步向导 | | **小计** | | | **44** | | | **M1 验收标准** - [ ] 配出一个任务：21 个内置字段 + 2 个扩展字段 + 4 个材料项 + 3 条条件规则 - [ ] 已发布任务改表单 → 自动升版本，旧填报单不受影响 - [ ] 内置字段删除按钮**不可点**（前后端双重校验） --- ## M2 · 名册与门禁（58 人日） > **目标**：能导入真实名单、能聚合报考范围、学生能通过门禁进来。 | ID | 任务 | 依赖 | 人日 | 角色 | 备注 | |---|---|:--:|:--:|---|---| | M2-01 | **表头探测算法**（扫前 10 行 + 已知列名打分 + 候选回传） | M1-01 | 4 | 后端 | 04 文档 M1；**实测表头在第 1 行和第 6 行都有** | | M2-02 | 名册导入 + 体检报告（证件号校验位/重复行/必填缺失） | M2-01 | 5 | 后端 | 接口 §8.1；`dryRun` 模式 | | M2-03 | 名册追加导入（按证件号去重合并）与变更留痕 | M2-02 | 3 | 后端 | FR-506/508 | | M2-04 | 报考范围聚合（按职业/工种/等级分组） | M2-02 | 4 | 后端 | 接口 §7.7；**不存在计划文件** | | M2-05 | 报考范围一致性体检（5 类 issue） | M2-04 | 3 | 后端 | 含 `SCOPE_LEVEL_MIXED` 等 | | M2-06 | **门禁匹配引擎**（限流/规范化/匹配/原子绑定） | M0-08 | 6 | 后端 | 04 文档 M4；**并发绑定走 UPDATE...WHERE** | | M2-07 | 姓名形近字/同音字确认流程（含 confirmToken） | M2-06 | 2 | 后端 | FR-504c | | M2-08 | 名册导入 UI（表头可视化 + 错行定位 + dryRun 确认） | M1-10 | 5 | 前端 | 原型 ③ | | M2-09 | 报考范围确认 UI（分组 + 体检提示 + 排除操作） | M1-10 | 4 | 前端 | 原型 ④；**必须全覆盖校验** | | M2-10 | 学生端门禁屏 + 统一失败页 + 形近字确认弹层 | M0-12 | 5 | 前端 | 原型 ①②③ | | M2-11 | 学生端"我的任务列表" | M0-12 | 3 | 前端 | 接口 §9.1 | | M2-12 | 班主任端班级看板 | M0-12 | 4 | 前端 | 接口 §10.1；**完成率=已提交率 82%** | | ⭐ M2-13 | **加入申请后端**：提交 / 限流 / 去重 / 证件号与手机号转 HMAC | M2-06 | 3 | 后端 | 接口 §8.7.1~8.7.2；**不存明文**；`40037/40038/40039` 三个分支 | | ⭐ M2-14 | **审批接口**：通过建模册项（行锁）/ 驳回 / 通知推送 | M2-13 | 2 | 后端 | 接口 §8.7.3~8.7.5；**`FOR UPDATE` 必须有**，事务外发通知 | | ⭐ M2-15 | **学生端申请入口与表单屏**（失败页新增出口） | M2-10 | 2 | 前端 | 门禁失败页加「申请加入名单」+ 申请表单 + 我的申请状态 | | ⭐ M2-16 | **管理端审批页**（列表 + 通过选班 + 驳回填原因） | M2-09 | 2 | 前端 | 驳回原因必填；**不提供"全选"** | | ⭐ M2-17 | 社会收集名单来源落地（B2）：与报名点对齐预报名名单流程 | M2-02 | 1 | 后端 | 说明性工作 + 与客户确认字段口径 | | **小计** | | | **58** | | | **M2 验收标准** - [ ] 导入真实名单 `24中技数控1班`（28 人）：正确识别表头在第 **6** 行 - [ ] 导入官方空白模板（表头第 **1** 行）：也能正确识别 - [ ] 体检检出：证件号校验位失败 **1 例**、重复 **1 例** - [ ] 门禁：正确通过 / 错误统一提示 / 形近字确认 / **并发 100 请求抢同一名册项恰好 1 个成功** - [ ] 报考范围：3 组，其中专项职业能力组标 `NEED_REVIEW` --- ## M3 · 填报主流程（71 人日）⚠️ 最重里程碑 > **目标**：学生能真实走完"选文件 → 处理 → 填写 → 提交"。**两个核心引擎在这里落地。** | ID | 任务 | 依赖 | 人日 | 角色 | 备注 | |---|---|:--:|:--:|---|---| | M3-01 | **M1 命名规范化引擎**（分层步骤 + 幂等） | M2-02 | 6 | 后端 | 04 文档 M1；**建议最先做，纯函数好测** | | M3-02 | 证件号抽取（18/15 位 + 形近字替换 ≤2 位） | M3-01 | 2 | 后端 | 替换次数上限是硬约束 | | M3-03 | 证件号三源裁决（文件名/名册/OCR） | M3-02 | 3 | 后端 | 含 `NEED_HUMAN` 不自动改 | | M3-04 | 姓名一致性与形近字纠错 | M3-01 | 2 | 后端 | 复用 M2-07 的相似度算法 | | M3-05 | **M2 压缩引擎**（五档 + EXIF + 二分降质 + 二次有损防护） | M0-01 | 12 | 后端 | 04 文档 M2；用 112 个真实文件回归 | | M3-06 | 体积下限保护 + 强制压缩标记 + 抽检清单 | M3-05 | 3 | 后端 | FR-616、VAL-20 | | M3-07 | 文件直传：upload-token + 秒传 + 端侧压缩提示 | M0-01 | 4 | 后端 | 接口 §9.5 | | M3-08 | 文件处理接口（同步 + 异步 + 进度轮询） | M3-07 | 4 | 后端 | 接口 §9.6 | | M3-09 | 批量处理（多材料一次提交） | M3-08 | 2 | 后端 | 接口 §9.7 | | M3-10 | 表单填写页（预填标注 + 三态只读/可改/留痕 + 级联） | M1-07 | 8 | 前端 | 原型 ④；`changedFields` 高亮 | | M3-11 | 草稿自动保存与并发冲突提示 | M3-10 | 3 | 前端 | 每 15 秒 | | M3-12 | 材料上传页（三来源 + 槽位 + 多选 + 进度） | M0-12 | 6 | 前端 | 原型 ⑤⑥；**无拍照入口** | | M3-13 | 处理结果卡（命名前后对比 + 体积压缩率 + 分步明细） | M3-08 | 5 | 前端 | 原型 ⑦ | | M3-14 | 进度与问题清单页 | M3-13 | 4 | 前端 | 接口 §9.12 | | M3-15 | 提交校验与阻断展示（blocking/warnings 分流） | M3-14 | 5 | 前端 | 接口 §9.10；`canForceSubmit` | | M3-16 | 提交 / 撤回 | M3-15 | 2 | 前端 | — | | **小计** | | | **71** | | | **M3 验收标准（用真实数据）** - [ ] **回归基线全部命中**：命名违规 **59**、双扩展名 **56**、体积超标 **31** - [ ] 压缩后 28 张 A4 扫描件：**均值 ≈806KB、最大 ≤831KB、0 张强制压缩** - [ ] 证件号异常 **5 例**（自动 3 + 人工 2） - [ ] 学生能在一台手机上完整走完 4 类材料的上传与提交 - [ ] 提交时的阻断清单能定位到**具体某人的某项材料** --- ## M4 · 识别与校验（34 人日） > **目标**：材料自动归类、问题自动发现。**识别失败必须放行。** | ID | 任务 | 依赖 | 人日 | 角色 | 备注 | |---|---|:--:|:--:|---|---| | M4-01 | M3 识别层 1（文件名 + 强特征词表） | M3-01 | 2 | 后端 | 04 文档 M3；禁用通用词入表。**一期只标定 4 类材料**（二期再加 `XJW_BA`/`OTHER_PROOF`） | | M4-02 | M3 识别层 2（形态特征 + 零文字判据） | M4-01 | 2 | 后端 | 零文字才是 PHOTO1 的可靠判据。**一期只覆盖自主认定批次形态** | | M4-03 | **OCR 引擎接入与选型落地** | M0-01 | 3 | 后端 | 确认函 D1；需评估数据出境 | | M4-04 | M3 识别层 3（OCR 内容打分） | M4-03 | 2 | 后端 | — | | M4-05 | VLM 接入 + 成本闸 + 触发率监控 | M4-03 | 4 | 后端 | 04 文档 3.6；**置信度 <0.8 不展示** | | M4-06 | 冲突判定与一键移动 | M4-02 | 3 | 后端 | **只提示不自动改位** | | M4-07 | 散图分拣模式 | M4-06 | 3 | 后端 | 唯一允许"建议落位"的场景 | | M4-08 | **M5 校验引擎**（20 条规则 + 7 阶段依赖） | M3-03 | 8 | 后端 | 04 文档 M5；**VAL 编号以 PRD 为准** | | M4-09 | 跨文件一致性判定（VAL-04 / VAL-19） | M4-08 | 3 | 后端 | 疑似串档转人工 | | M4-10 | 识别结果 UI（置信度展示 + 冲突卡片 + 一键移动） | M4-06 | 4 | 前端 | 学生端 ⑧ | | **小计** | | | **34** | | | **M4 验收标准** - [ ] 112 个真实文件：文件名层 **112/112**，形态层分流派 **≈99%** - [ ] 零文字判据命中一寸照片 - [ ] **"身份证号"四个字不会导致误判**（通用词禁入表） - [ ] 全黑图片：识别失败但**能提交** - [ ] VLM 触发率在 **2%~10%** 区间 --- ## M5 · 审核闭环（56 人日） > **目标**：班主任在手机上完成初筛，管理员在 PC 完成终审，全程可追溯。 | ID | 任务 | 依赖 | 人日 | 角色 | 备注 | |---|---|:--:|:--:|---|---| | M5-01 | 待审列表接口（红黄绿分级 + `batchApprovable` 服务端判定） | M4-08 | 3 | 后端 | 接口 §10.2。**一期只需处理学校收集一条审核流** | | M5-02 | 审核详情接口（含识别结果、变更字段、时间轴） | M5-01 | 3 | 后端 | 接口 §11.2；I10 缺口落点 | | M5-03 | 通过 / 驳回（含 redCount 拦截） | M5-02 | 3 | 后端 | **有红问题的单不允许通过** | | M5-04 | 批量通过（**只带绿色项，服务端强制**） | M5-03 | 2 | 后端 | 铁律；红黄一律跳过 | | M5-05 | 审核撤回（含"已导出不可撤"约束） | M5-03 | 2 | 后端 | 接口 §11.4 | | M5-06 | 代传材料（留痕 `source=4`） | M5-03 | 3 | 后端 | 学生端可见"由李老师代传" | | M5-07 | 待审卡片流（**只右滑通过**，左滑不绑定驳回） | M5-01 | 8 | 前端 | 原型 ②；`actionSource` 埋点 | | M5-08 | 学生详情页（材料预览 + 问题清单 + 变更高亮） | M5-02 | 6 | 前端 | 原型 ③ | | M5-09 | 驳回页（原因快选 + 二次确认 + 语音转文字） | M5-08 | 5 | 前端 | 原型 ⑤；**驳回必须点按钮** | | M5-10 | 一键通过确认页（列出将通过的名单） | M5-07 | 3 | 前端 | 原型 ④ | | M5-11 | 管理端终审列表与详情 | M5-02 | 5 | 前端 | 原型 ⑥ | | M5-12 | 通知：订阅消息 + 降级链（订阅→公众号→短信→站内信） | M0-08 | 6 | 后端 | 接口 §13.6；额度登记 | | M5-13 | 消息中心（学生端 + 教师端） | M5-12 | 4 | 前端 | 接口 §13.5 | | M5-14 | 催报（定向 + 一键 + 去重） | M5-12 | 3 | 后端 | `excludeRecentHours` 防骚扰 | | **小计** | | | **56** | | | **M5 验收标准** - [ ] 班主任在手机上：右滑通过 3 个、驳回 1 个（带原因）、一键通过剩余绿色项 - [ ] 一键通过时**红色项被自动跳过并回报原因** - [ ] 撤回一条已通过的记录 → 时间轴出现"撤回"记录 - [ ] **已导出打包的单不可撤回**（返回 40033） - [ ] 通知降级：额度耗尽时静默降级，学生端无异常提示 --- ## M6 · 导出与交付（32 人日） > **目标**：一键产出可直接上报的规范包。**有不合格文件就禁用导出按钮。** | ID | 任务 | 依赖 | 人日 | 角色 | 备注 | |---|---|:--:|:--:|---|---| | M6-01 | 导出前置检查（三类 blocking） | M4-08 | 4 | 后端 | 铁律；`canExport=false` | | M6-02 | **导出打包引擎**（快照固化 + 目录树 + 分卷 + 断点续传） | M6-01 | 10 | 后端 | 04 文档 M6；**先固化快照再打包** | | M6-03 | 中文文件名编码（Windows 解压不乱码） | M6-02 | 2 | 后端 | `entryNameEncoding` | | M6-04 | 汇总 Excel（严格对齐官方 21 列 A–U） | M6-02 | 4 | 后端 | 客户拿到就能用 | | M6-05 | 导出中心 UI（进度 + 结果 + 下载） | M6-02 | 3 | 前端 | 原型 ⑦ | | M6-06 | **目录树预览**（导出前可见最终交付形态） | M6-01 | 3 | 前端 | 原型 ⑦ 右侧 | | M6-07 | 导出包过期清理与重新导出（不重复计费） | M6-02 | 2 | 后端 | 默认 7 天 | | M6-08 | 开放接口（token / submissions / files / callback） | M6-04 | 4 | 后端 | 接口 §14；HMAC 加签 | | **小计** | | | **32** | | | **M6 验收标准** - [ ] 真实批次导出：**原始 475MB → ≈37MB**，目录树正确 - [ ] Windows 资源管理器解压**中文名不乱码** - [ ] 存在 1 个超标文件 → **导出按钮禁用**，并指出是"谁的哪一项" - [ ] 打包中途数据变化 → 产物与快照一致 - [ ] 汇总 Excel 可被官方模板**直接打开并对齐 21 列** --- ## M7 · 收尾与上线（52 人日） | ID | 任务 | 依赖 | 人日 | 角色 | 备注 | |---|---|:--:|:--:|---|---| | M7-01 | 数据看板（完成率/异常率/驳回率/平均时长 + 按工种统计） | M5-02 | 6 | 后端 | **`submitRate` 与 `passRate` 分开报** | | M7-02 | 数据看板 UI（含"来自正式列"标注） | M7-01 | 5 | 前端 | 原型 ⑤；走索引实时 | | M7-03 | 字典管理（6 个内置字典 + 租户自维护） | M0-05 | 4 | 后端 | **职业字典只做拼写校验，不强约束** | | M7-04 | 操作日志 + 登录日志（含敏感操作留痕） | M0-06 | 4 | 后端 | `VIEW_IDCARD_FULL` 单独留痕 | | M7-05 | 日志查询 UI | M7-04 | 2 | 前端 | — | | M7-06 | **历史数据整理器**（上传→解析→规范化→报告） | M6-02 | 8 | 后端 | 差异化获客功能 | | M7-07 | 整理器 UI（体检报告 + 结果导入） | M7-06 | 5 | 前端 | 原型 ⑩；`autoHandled: 90 / needManual: 1` | | M7-08 | **Golden Set 回归脚本**（15 项断言自动化） | M3-05 | 3 | 测试 | 04 文档附录 B 的基线。**一期只覆盖 4 类材料**，二期补 `XJW_BA`/`OTHER_PROOF` | | M7-09 | 压测与调优（门禁并发/上传并发/导出大任务） | M6-02 | 5 | 后端 | 重点关注 M4 并发绑定 | | M7-10 | 灰度发布 + 生产环境准备 + 数据迁移预案 | M7-09 | 5 | 全员 | — | | M7-11 | 用户手册 / 培训材料 / 客服话术 | M7-07 | 2 | 产品 | 一期只有学校收集一条流程，手册更简单 | | M7-12 | 定时任务（9 项，见 PRD 附录 E） | M6-07 | 3 | 后端 | 清理/催报/超时提醒/用量统计 | | **小计** | | | **52** | | | > 📌 **M7 含大量非编码工作**（培训、手册、灰度、压测），与前面纯开发里程碑性质不同。 --- ## 四、关键路径 ``` M0-01 环境 ──→ M0-02 后端骨架 ──→ M0-05 组织 ──→ M0-06 用户 ──→ M0-07 登录 │ ▼ M1-01 任务CRUD ──→ M2-01 表头探测 ──→ M2-02 名册导入 │ │ │ ▼ ▼ ▼ M1-07 表单设计器 M2-06 门禁引擎 M3-01 命名引擎 │ │ │ ▼ │ M3-05 压缩引擎 ★ │ │ ▼ ▼ M2-10 门禁UI M3-08 文件处理 │ ▼ M4-08 校验引擎 ──→ M5-03 审核动作 │ ▼ M6-01 前置检查 ──→ M6-02 打包引擎 ★ │ ▼ M7-09 压测 ──→ M7-10 上线 ``` **★ 两个最长的单点（合计 22 人日，且无法靠加人压缩）** | 任务 | 人日 | 为什么不能加人 | |---|:--:|---| | **M3-05 压缩引擎** | 12 | 图像参数调优是串行的验证循环，多人并行的收益是负的 | | **M6-02 打包引擎** | 10 | 依赖快照设计，拆开做反而要重写 | **关键路径总长**：约 **6 + 5 + 4 + 6 + 12 + 4 + 8 + 3 + 4 + 10 + 5 = 67 人日**，客户确认后 **+9**（申请通道 4 个任务落在 M2）⇒ **76 人日** **工期由关键路径决定，不能按人日总数摊人**： | 算法 | 结果 | 说明 | |---|---|---| | 总工作量摊人 | 456 人日 ÷ 8.5 人 ≈ **11 周** | ❌ 这是**下限**，实际达不到 | | **关键路径串行** | 76 人日 ≈ **15.2 周** | ✅ **这才是真实工期** | **为什么以关键路径为准**：这条链上的任务**互为前置**（没建好表就不能导名单，没导名单就不能做门禁，没门禁就不能跑填报）， **加人不会缩短它**。例如"压缩引擎"的 12 人日里，大部分是"改参数 → 跑 112 张真实图 → 看结果"的验证循环，**两人并行做反而要重跑**。 > ⇒ **结论：约 15 周**（客户确认 B1 后由 14 周顺延）。若要压缩，唯一可行的办法是**砍范围**（把 M7 的整理器与开放接口后置），而不是加人。 --- ## 五、风险与对策 | # | 风险 | 概率 | 影响 | 对策 | 触发信号 | |:--:|---|:--:|:--:|---|---| | R1 | 小程序教育类目资质未获批 | 中 | **极高** | **M0 就启动法务准备**；备选 H5 扫码填报可保底 | 第 2 周仍未提交类目 | | R2 | 认定机构不接受 300dpi | 低 | 高 | M3-05 预留参数可调；实测 28/28 达标是强证据 | 确认函 A1 回复 | | R3 | OCR/VLM 选型拖延 | 中 | 中 | M2 结束前必须定；**层 1/2 不依赖它，可先跑通** | 第 6 周未选型 | | R4 | 压缩引擎调优超期 | 中 | 高 | **M3-05 单独设 3 人日缓冲**；用 Golden Set 做回归门禁 | 回归超 2 项偏差 | | R5 | 门禁并发绑定出问题 | 低 | **极高** | 04 文档 M4 已给正确实现；**M7-09 压测必测 100 并发** | 压测出现重复绑定 | | R6 | 客户名单格式更复杂 | 中 | 中 | 表头探测已支持候选回传；M2 加 20% 缓冲 | dryRun 识别率 < 90% | | R7 | 需求变更（如加"申请加入名单"通道） | 高 | 中 | 已列入确认函 B1；**若确认则 M2 追加 3 人日** | 客户回复 | | R8 | 导出大任务内存溢出 | 中 | 中 | 分卷 + 流式写入；快照固化避免重查 | 单任务 > 5000 文件 | --- ## 六、团队配置建议 | 角色 | 人数 | 主要投入 | 峰值在第几周 | |---|:--:|---|---| | 技术负责人 | 1 | 架构、Code Review、M3 引擎 | 全程 | | 后端 | 3 | M0/M2/M3/M4/M6 | 第 5~10 周 | | 前端（PC） | 1.5 | M1 设计器、M5 终审、M7 看板 | 第 4~6 周、第 9~11 周 | | 前端（小程序） | 1 | M2 门禁、M3 填报、M5 审核 | 第 6~11 周 | | 测试 | 1 | Golden Set 回归、压测 | 第 8 周起 | | 产品/UI | 1 | 交互确认、文档、培训 | 第 1~3 周、第 13 周 | | **合计** | **8.5** | | | **建议的并行策略** | 阶段 | 并行方式 | |---|---| | 第 1~3 周 | 后端做 M0，前端同时搭框架（不等后端） | | 第 4~6 周 | 后端 M2 门禁与前端 M1 设计器**完全并行**（无依赖） | | 第 7~10 周 | **M3-05 压缩引擎单独占 1 人专职**，其余人做 M3 周边 | | 第 12~14 周 | M6/M7 并行；测试同步跑 Golden Set | | 第 15 周 | 全量回归 + 灰度 + 上线 | --- ## 七、里程碑验收与交付节奏 | 节点 | 时间 | 交付内容 | 验收方式 | |---|---|---|---| | **M0** | 第 3 周末 | 能登录、能建组织用户 | 内网演示 15 分钟 | | **M1** | 第 5 周末 | 能配出完整任务 | **里程碑 A**：向客户演示"配置→任务就绪" | | **M2** | 第 8 周末 | 能导入名单、能过门禁、能审批申请 | 用**真实名单**演示 | | **M3** | 第 11 周末 | 学生能完整填报提交 | **里程碑 B**：真机演示全流程 + Golden Set 回归 | | **M4** | 第 12 周末 | 识别与校验生效 | 112 个真实文件的识别报告 | | **M5** | 第 13 周末 | 审核闭环 | 班主任真机演示 + 管理端终审 | | **M6** | 第 14 周末 | 导出规范包 | 导出真实包并**用 Windows 解压验证** | | **M7** | 第 15 周末 | **可上线** | **里程碑 C**：压测报告 + 灰度 → 全量 | ### 建议的三个客户演示点 | 演示 | 时点 | 演示什么 | 目的 | |---|---|---|---| | **里程碑 A** | 第 5 周 | 任务配置闭环 + **历史数据整理器**（可用假数据先做简版） | 让客户看到"配置灵活"，并**提前锁定需求** | | **里程碑 B** | 第 11 周 | 真机全流程 + **用真实 112 个文件跑出的处理报告** | 最有说服力的一次——数字都是他们自己的数据 | | **里程碑 C** | 第 15 周 | 压测 + 导出包 | 交付验收 | > **里程碑 A 里建议提前塞进"整理器"的简版**：客户手里有历史乱数据时，**"先看到价值再谈上线"**比任何功能列表都有用。这一步能让后续需求变更更容易谈。 --- ## 八、给项目经理的三条提醒 | # | 提醒 | 原因 | |:--:|---|---| | 1 | **不要压缩 M3-05（压缩引擎）和 M6-02（打包引擎）的工期** | 这两个是唯一无法靠加人加速的任务，压缩工期只会换来质量债 | | 2 | **Golden Set 回归脚本要在 M7 之前就准备好**（M7-08 建议提前到 M4 结束） | 它是后续所有改动的安全网；等到上线前才做，等于全程裸奔 | | 3 | **确认函里的 B1（名单外的人怎么办）要在 M2 开始前拿到答复** | 它决定 M2 要不要多做一条审批流；M2 一旦开工，改动的代价是 3 人日变 6 人日 | --- ## 九、核算口径（可复现） 本文档所有数字均**逐任务求和**得出，非估算。核算方法： ``` ① 读 §3 各里程碑表格，正则匹配每行 `| M\d-\d+ | ... | 人日 | 角色 | 备注 |` ② 按里程碑求和 → 与标题括号内数字比对 ③ 汇总到 §1.5 → 与（含缓冲）列比对 ④ 缓冲 = 各里程碑人日 × 1.2 后四舍五入 ``` **核算结果（2026-09-28）** | 里程碑 | 任务数 | 人日 | 含缓冲（×1.2） | |:--:|:--:|:--:|:--:| | M0 | 13 | 40 | 48 | | M1 | 10 | 44 | 53 | | M2 | 17 | 58 | 70 | | M3 | 16 | **71** | **85** | | M4 | 10 | 34 | 41 | | M5 | 14 | 56 | 67 | | M6 | 8 | 32 | 38 | | M7 | 12 | 52 | 62 | | **合计** | **100** | **387** | **464** | > ⚠️ **注意**：初稿的 §1.5 汇总表曾出现"先填汇总、后填任务明细"造成的错位，已按逐任务求和值修正。 > **任何人改动任务明细后，必须重跑一遍核算**——这是本文档唯一的自校验手段。 > > **本次变更（客户确认 B1 后）**：新增 **6 个任务**（M0-13、M2-13~17），**+12 人日**；工期由 14 周顺延至 **15 周**。 > > **一期范围收窄后**：**−5 人日**（社会收集 / 社会评价 / 专项职业能力后置；省下的主要是测试与联调成本），**关键路径不变，仍 15 周**。 --- ## 变更记录 | 版本 | 日期 | 变更 | |---|---|---| | V1.0 | 2026-09-28 | 首版。8 个里程碑 M0–M7，共 **94 个任务**；合计 **380 人日**（含缓冲 **456**）；工期约 **14 周**（由关键路径决定）。含关键路径分析、8 项风险、团队配置与 3 个客户演示点。**全部人日为逐任务求和的实际值**，核算口径见 §9 | | **V1.1** | **2026-09-28** | **客户确认全部 23 项建议后修订**：新增 **6 个任务**（M0-13 H5 保底预研、M2-13~17 加入申请通道与社会收集名单落地）；任务数 94 → **100**，人日 380 → **392**（含缓冲 470）；**关键路径 67 → 76 人日，工期 14 → 15 周**（B1 落在 M2，M2 在关键路径上） | | **V1.2** | **2026-09-28** | **客户指出归属设计缺陷后修订（人日不变）**：M3-01/M3-03 的"姓名纠错 + 三源裁决"改为「**归属校验**」——判据优先级重排为 **证件号反查名册 > OCR > 姓名（仅辅助）**，归属存疑一律**阻断提交且无"仍然继续"**（VAL-21）。
**工作量中性**：删掉了姓名编辑距离+拼音相似度逻辑（约 −1.5 人日），新增名册反查与阻断交互（约 +1.5 人日），**净变化 0**，排期不变 |