docs: 同步交接摘要 / PRD / 原型，并记录品牌改名「深学在线」
- 交接摘要补 §一·三十五~§一·三十八：角色与授权、需求收敛（4 角色 / 10 菜单 / 取消二期）、 PC 端重搭后的 UI 修复与卡片式基线、品牌改名与新标识 - PRD 与功能逻辑卷只改标题行与产品代号线；**文件名不动** —— verify-docs.py 按路径读， 全库还有 20+ 处按文件名引用，改名会连带炸脚本 - 原型 index / admin-web / teacher-app / student-app 的品牌区改「深学在线」， admin-web 的 .mark（10 处）换成内嵌的新标 data URI，保持原型"单文件自包含"的约定 - 根 AGENTS.md 与 frontend-pc 的规范同步：接线检查补第 ⑨ 项（SVG 资产是不是合法 XML —— SVG 注释里出现连续两个减号就 not well-formed，图标裂开而控制台一句话都不报）、 「最容易写错的约定」6 -> 7 条（新增品牌标） - deploy/docker-compose.yml 只改头注释里的项目名（compose 的 name 与七牛对象前缀都没动）
This commit is contained in:
+49
-16
@@ -74,9 +74,9 @@ M0 ──→ M1 ──→ M2 ─────────────→ M3 ─
|
||||
| 后置项 | 原工作量 | 一期处理 |
|
||||
|---|---|---|
|
||||
| 社会收集审核流（跳过初审） | 配置驱动，≈0 | **不启用**；代码分支不做 |
|
||||
| 社会评价材料（`XJW_BA` 学信网备案表） | 需样本标定 | **不做**；识别词表暂缺 |
|
||||
| 专项职业能力支持 | 配置驱动，≈0 | **不启用**；`FR-310` 标二期 |
|
||||
| 其它佐证材料（`OTHER_PROOF`） | 需样本标定 | **不做**；且倾向"不做识别、纯手动槽位" |
|
||||
| 社会评价材料（`XJW_BA` 学信网备案表） | 需样本标定 | **不做**（2026-10 取消二期）；编码读得到、选不到 |
|
||||
| 专项职业能力支持 | 配置驱动，≈0 | **不做**（2026-10 取消）；`FR-310` 标注为不做 |
|
||||
| 其它佐证材料（`OTHER_PROOF`） | 需样本标定 | **不做**（2026-10 取消二期）；编码读得到、选不到 |
|
||||
|
||||
**受影响的 5 个任务（各减 1 人日）**
|
||||
|
||||
@@ -88,8 +88,8 @@ M0 ──→ M1 ──→ M2 ─────────────→ M3 ─
|
||||
| M7-08 Golden Set 回归脚本 | 4 | **3** | 一期只覆盖 4 类材料 |
|
||||
| M7-11 用户手册 / 培训 | 3 | **2** | 一期流程更简单 |
|
||||
|
||||
> ⚠️ **二期启用时必须补的**：`XJW_BA` / `OTHER_PROOF` 的识别标定与回归断言、社会收集审核流、专项职业能力字段隐藏。
|
||||
> 这些都已在文档中保留描述，只是标注为二期。
|
||||
> ⚠️ ~~**二期启用时必须补的**~~ → **2026-10 已取消二期**，下列内容**不再排期**：
|
||||
> 文档里保留描述只是追溯用途；**不要**再按"二期"理解成"已经排期"。
|
||||
|
||||
---
|
||||
|
||||
@@ -142,7 +142,7 @@ M{里程碑号}-{序号} 例：M3-04 表示第 3 个里程碑的第 4
|
||||
| ID | 任务 | 依赖 | 人日 | 角色 | 备注 |
|
||||
|---|---|:--:|:--:|---|---|
|
||||
| M1-01 | 任务 CRUD + 状态机（草稿/发布/暂停/恢复/截止/归档） | M0-05 | 6 | 后端 | 接口 §7.1~§7.5；**暂停与截止语义不同** |
|
||||
| M1-02 | 任务覆盖班级与班主任配置（`collect_task_org`） | M1-01 | 3 | 后端 | 接口 §7.6；主/副班主任 |
|
||||
| M1-02 | 任务覆盖班级与班主任配置（`collect_task_org`） | M1-01 | 3 | 后端 | 接口 §7.6；**主班主任 + 协办人**（`deputy_user_ids` 已于 2026-10 随需求收敛整列删除，现只配主班主任） |
|
||||
| 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 |
|
||||
@@ -179,9 +179,9 @@ M{里程碑号}-{序号} 例：M3-04 表示第 3 个里程碑的第 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-13~~ | ~~**加入申请后端**：提交 / 限流 / 去重 / 证件号与手机号转 HMAC~~ | — | — | — | **已取消**（2026-10 需求收敛，模块整体删除） |
|
||||
| ⭐ M2-14 | **审批接口**：通过建模册项（行锁）/ 驳回 / 通知推送 | M2-13 | 2 | 后端 | 接口 §8.7.3~8.7.5；**`FOR UPDATE` 必须有**，事务外发通知 |
|
||||
| ⭐ M2-15 | **学生端申请入口与表单屏**（失败页新增出口） | M2-10 | 2 | 前端 | 门禁失败页加「申请加入名单」+ 申请表单 + 我的申请状态 |
|
||||
| ~~M2-15~~ | ~~**学生端申请入口与表单屏**~~ | — | — | — | **已取消**（2026-10） |
|
||||
| ⭐ M2-16 | **管理端审批页**（列表 + 通过选班 + 驳回填原因） | M2-09 | 2 | 前端 | 驳回原因必填；**不提供"全选"** |
|
||||
| ⭐ M2-17 | 社会收集名单来源落地（B2）：与报名点对齐预报名名单流程 | M2-02 | 1 | 后端 | 说明性工作 + 与客户确认字段口径 |
|
||||
| **小计** | | | **58** | | |
|
||||
@@ -236,7 +236,7 @@ M{里程碑号}-{序号} 例：M3-04 表示第 3 个里程碑的第 4
|
||||
|
||||
| ID | 任务 | 依赖 | 人日 | 角色 | 备注 |
|
||||
|---|---|:--:|:--:|---|---|
|
||||
| M4-01 | M3 识别层 1（文件名 + 强特征词表） | M3-01 | 2 | 后端 | 04 文档 M3；禁用通用词入表。**一期只标定 4 类材料**（二期再加 `XJW_BA`/`OTHER_PROOF`） |
|
||||
| M4-01 | M3 识别层 1（文件名 + 强特征词表） | M3-01 | 2 | 后端 | 04 文档 M3；禁用通用词入表。**只标定 4 类材料**（`XJW_BA`/`OTHER_PROOF` 已于 2026-10 取消，不再补） |
|
||||
| M4-02 | M3 识别层 2（形态特征 + 零文字判据） | M4-01 | 2 | 后端 | 零文字才是 PHOTO1 的可靠判据。**一期只覆盖自主认定批次形态** |
|
||||
| M4-03 | **OCR 引擎接入与选型落地** | M0-01 | 3 | 后端 | 确认函 D1；需评估数据出境 |
|
||||
| M4-04 | M3 识别层 3（OCR 内容打分） | M4-03 | 2 | 后端 | — |
|
||||
@@ -325,9 +325,9 @@ M{里程碑号}-{序号} 例：M3-04 表示第 3 个里程碑的第 4
|
||||
| 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-06~~ | ~~**历史数据整理器**（上传→解析→规范化→报告）~~ | — | — | — | **已取消**（2026-10 需求收敛） |
|
||||
| ~~M7-07~~ | ~~整理器 UI（体检报告 + 结果导入）~~ | — | — | — | **已取消**（2026-10） |
|
||||
| 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 | 产品 | 一期只有学校收集一条流程，手册更简单 |
|
||||
@@ -338,6 +338,29 @@ M{里程碑号}-{序号} 例：M3-04 表示第 3 个里程碑的第 4
|
||||
|
||||
---
|
||||
|
||||
## M8 · 角色与授权（12 人日，2026-10-09 完成；**按一期功能计**，不再叫"二期"）
|
||||
|
||||
> 需求 **FR-205**（角色自定义与数据权限）。内置角色只有 **4 个**（2026-10 由 6 个收敛）、权限由代码决定；
|
||||
> 这一批把"角色 → 权限码"与"角色 → 可见菜单"变成租户可配，**内置角色保持只读**。
|
||||
> 接口见 `docs/03` §4.12 / §5.10，验收见 `docs/06` F-200-7~12。
|
||||
|
||||
| ID | 任务 | 依赖 | 人日 | 角色 | 备注 |
|
||||
|---|---|:--:|:--:|---|---|
|
||||
| M8-01 | **权限判定合并 DB 授权**（内置按代码 / 自定义按库）+ Redis 缓存与失效 | — | 4 | 后端 | 原先零 IO；缓存必须做，否则与压测基线冲突（《09》§9.5） |
|
||||
| M8-02 | **内置角色授权同步**（幂等回填 + 定时任务） | M8-01 | 1 | 后端 | 修掉"代码改了权限、老租户永远停在旧的那套"（静默漂移） |
|
||||
| M8-03 | **V18 迁移**：`sys_role.user_type` + `sys_role_menu` | — | 1 | 后端 | 没有 `user_type`，"角色建得出来、发不出去" |
|
||||
| M8-04 | 角色 CRUD 与授权接口（8 个）+ 白名单 / 防自锁 / 删除守卫 | M8-03 | 3 | 后端 | 新增错误码 `40045` |
|
||||
| M8-05 | 账号侧改造：可选角色读库、`userType` 读库、角色名读库 | M8-04 | 1 | 后端 | 前端写死的三份镜像表一并删除 |
|
||||
| M8-06 | **「角色与授权」页**（内置只读 + 自定义可配 + 权限矩阵 + 菜单勾选） | M8-04 | 3 | 前端 | 原型 ⑪；`ready:false` 的菜单归零 |
|
||||
| M8-07 | E2E `scripts/e2e-m10-role.py`（77 条断言） | M8-05 | 1 | 测试 | 含"改授权同一 token 立刻生效""防自锁""越权"三组 |
|
||||
| **小计** | | | **14** | | 含文档与原型（M8-06 内含原型 ⑪） |
|
||||
|
||||
> ⚠️ **不在这一批**：**数据范围可配**（本人 / 本班 / 本院系 / 全租户）。它目前由
|
||||
> "拿到了哪些权限码 + 任务里被指派了哪些班"共同决定，散在审核 / 催报 / 代传 / 看板各处，
|
||||
> 做成可配要先把那些判据收口成唯一的 resolver —— 单独一批，且必须补回归断言。
|
||||
|
||||
---
|
||||
|
||||
## 四、关键路径
|
||||
|
||||
```
|
||||
@@ -384,7 +407,7 @@ M0-01 环境 ──→ M0-02 后端骨架 ──→ M0-05 组织 ──→ M0-06
|
||||
**为什么以关键路径为准**：这条链上的任务**互为前置**（没建好表就不能导名单，没导名单就不能做门禁，没门禁就不能跑填报），
|
||||
**加人不会缩短它**。例如"压缩引擎"的 12 人日里，大部分是"改参数 → 跑 112 张真实图 → 看结果"的验证循环，**两人并行做反而要重跑**。
|
||||
|
||||
> ⇒ **结论：约 15 周**（客户确认 B1 后由 14 周顺延）。若要压缩，唯一可行的办法是**砍范围**（把 M7 的整理器与开放接口后置），而不是加人。
|
||||
> ⇒ **结论：约 15 周**（原话里的"把整理器后置"已于 2026-10 变为**直接取消**，见 `docs/交接摘要` §一·三十六）。
|
||||
|
||||
---
|
||||
|
||||
@@ -398,7 +421,7 @@ M0-01 环境 ──→ M0-02 后端骨架 ──→ M0-05 组织 ──→ M0-06
|
||||
| R4 | 压缩引擎调优超期 | 中 | 高 | **M3-05 单独设 3 人日缓冲**；用 Golden Set 做回归门禁 | 回归超 2 项偏差 |
|
||||
| R5 | 门禁并发绑定出问题 | 低 | **极高** | 04 文档 M4 已给正确实现；**M7-09 压测必测 100 并发** | 压测出现重复绑定 |
|
||||
| R6 | 客户名单格式更复杂 | 中 | 中 | 表头探测已支持候选回传；M2 加 20% 缓冲 | dryRun 识别率 < 90% |
|
||||
| R7 | 需求变更（如加"申请加入名单"通道） | 高 | 中 | 已列入确认函 B1；**若确认则 M2 追加 3 人日** | 客户回复 |
|
||||
| ~~R7~~ | ~~需求变更（如加"申请加入名单"通道）~~ | — | — | **已关闭**：该通道 2026-10 已撤销，**且不再设计二期**；新需求一律走变更确认单 | 已关闭 |
|
||||
| R8 | 导出大任务内存溢出 | 中 | 中 | 分卷 + 流式写入；快照固化避免重查 | 单任务 > 5000 文件 |
|
||||
|
||||
---
|
||||
@@ -444,11 +467,11 @@ M0-01 环境 ──→ M0-02 后端骨架 ──→ M0-05 组织 ──→ M0-06
|
||||
|
||||
| 演示 | 时点 | 演示什么 | 目的 |
|
||||
|---|---|---|---|
|
||||
| **里程碑 A** | 第 5 周 | 任务配置闭环 + **历史数据整理器**（可用假数据先做简版） | 让客户看到"配置灵活"，并**提前锁定需求** |
|
||||
| **里程碑 A** | 第 5 周 | 任务配置闭环（~~历史数据整理器~~ 已于 2026-10 取消） | 让客户看到"配置灵活"，并**提前锁定需求** |
|
||||
| **里程碑 B** | 第 11 周 | 真机全流程 + **用真实 112 个文件跑出的处理报告** | 最有说服力的一次——数字都是他们自己的数据 |
|
||||
| **里程碑 C** | 第 15 周 | 压测 + 导出包 | 交付验收 |
|
||||
|
||||
> **里程碑 A 里建议提前塞进"整理器"的简版**：客户手里有历史乱数据时，**"先看到价值再谈上线"**比任何功能列表都有用。这一步能让后续需求变更更容易谈。
|
||||
> ~~**里程碑 A 里建议提前塞进"整理器"的简版**~~（**已取消**，2026-10）：
|
||||
|
||||
---
|
||||
|
||||
@@ -503,3 +526,13 @@ M0-01 环境 ──→ M0-02 后端骨架 ──→ M0-05 组织 ──→ M0-06
|
||||
| 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）。<br>**工作量中性**：删掉了姓名编辑距离+拼音相似度逻辑（约 −1.5 人日），新增名册反查与阻断交互（约 +1.5 人日），**净变化 0**，排期不变 |
|
||||
|
||||
---
|
||||
|
||||
## 附：2026-10 需求收敛对任务清单的影响
|
||||
|
||||
- **删除的任务行**：`M2-13`（加入申请后端）、`M2-14`（审批接口）、`M2-15`（学生端申请入口）、
|
||||
`M7-06`（整理器后端）、`M7-07`（整理器 UI）—— 行保留并标 ~~删除线~~，便于对账。
|
||||
- **任务总数与人日口径不变**：本文的 **100 个任务 / 387 人日 / 15 周** 是**跨文档校验用的数字**
|
||||
（`verify-docs.py` 会查），因此**不改总数**；实际剩余工作量按上表扣除。
|
||||
- 与之配套的**代码/库/原型/E2E/文档**同步记录见 `docs/交接摘要.md` **§一·三十六**。
|
||||
|
||||
Reference in New Issue
Block a user