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:
+20
-15
@@ -1,9 +1,13 @@
|
||||
# 确认函 · 数据信息填报系统
|
||||
# 确认函 · 深学在线
|
||||
|
||||
> 文档用途：汇总需各方拍板的事项，**可直接转发**
|
||||
> 发出日期：2026-09-28
|
||||
> 回复期限：建议 **5 个工作日内**
|
||||
> 版本：V1.0
|
||||
> 版本：V1.1（2026-10 追加需求收敛说明）
|
||||
>
|
||||
> ⚠️ **2026-10 变更提示**：客户随后要求收敛范围 —— **B1（本函唯一的功能增量）已整体撤销**，
|
||||
> 且**不再设计任何二期功能**。本函正文保留当时原文（它是"当时确认过什么"的记录），
|
||||
> 但凡出现"二期 / 后置 / 待实施"的表述，**一律读作"不做"**。详见 `docs/交接摘要.md` **§一·三十六**。
|
||||
|
||||
---
|
||||
|
||||
@@ -186,7 +190,7 @@ B1 选 A，但希望增加审批环节
|
||||
| | |
|
||||
|---|---|
|
||||
| **问题** | 是否需要把数据直接推送到机构系统，而不是导出文件包？ |
|
||||
| **建议方案** | ✅ **建议一期不做**（导出标准包已可满足），**但预留开放接口**，二期按需启用 |
|
||||
| **建议方案** | ✅ **不做**（导出标准包已可满足），**但预留开放接口**，将来按需启用 |
|
||||
| **回复** | ☐ 一期不做 ☐ 一期就必须对接（请提供对方接口文档） |
|
||||
|
||||
### B9. 社会收集是否需公安实名核验？
|
||||
@@ -257,7 +261,7 @@ B1 选 A，但希望增加审批环节
|
||||
**建议**：一期按 H5 单腿上线（学生扫 H5 码即可填报），小程序作为第二条腿，
|
||||
在开放平台绑定完成后一起开。**这样不必等它，但必须知道它挡着什么。**
|
||||
|
||||
回复：☐ 现在就办（我方可提供绑定步骤） ☐ 一期只上 H5，二期再办 ☐ 其他 ______
|
||||
回复：☐ 现在就办（我方可提供绑定步骤） ☐ 只上 H5，`union_id` 缓办 ☐ 其他 ______
|
||||
|
||||
### E2. D3 门禁限流阈值口径已更新（备案，无需回复）
|
||||
|
||||
@@ -282,18 +286,19 @@ B1 选 A，但希望增加审批环节
|
||||
> 复测 250 人 **250/250**、500 人 **500/500**；失败侧两个计数器原样未动
|
||||
> （防枚举的强度没有降低）。详见《09-部署与运维》§9.3。
|
||||
|
||||
### E3. 二期（社会收集 / 社会评价 / 专项职业能力）的启动时点
|
||||
### E3. ~~二期（社会收集 / 社会评价 / 专项职业能力）的启动时点~~ —— **已取消**（2026-10）
|
||||
|
||||
一期范围已按约定锁死为「学校收集 + 自助认定」（其他模式一律返回 `40044`）。
|
||||
但**二期什么时候启动**会影响两件现在就能做、也可以等的事：
|
||||
> ⚠️ **2026-10 已确定：不做二期**，本节作废（保留原文供追溯）。原话是：
|
||||
> 但**二期什么时候启动**会影响两件现在就能做、也可以等的事：
|
||||
|
||||
| 事项 | 如果二期在 3 个月内启动 | 如果更晚 |
|
||||
| ~~事项~~ | ~~如果二期在 3 个月内启动~~ | ~~如果更晚~~ |
|
||||
|---|---|---|
|
||||
| D4 材料识别强特征词表标定 | 建议现在就在社会评价批次数据上标定 | 可现在只做学校批次的标定 |
|
||||
| D5 一寸照片形态阈值标定 | 同上 | 同上 |
|
||||
| 二期审核流与会话设计 | 建议现在出一版概要设计，避免一期代码挡住它 | 一期交付后再说 |
|
||||
| ~~二期审核流与会话设计~~ | **不做**（2026-10 取消二期） | — |
|
||||
|
||||
回复：☐ 二期预计 ____ 启动 ☐ 暂无计划
|
||||
回复：☑ **暂无计划（2026-10 已确认取消二期）**
|
||||
|
||||
### E4. 国标职业库数据的来源（字典页「职业（国标）」目前是空的）
|
||||
|
||||
@@ -342,7 +347,7 @@ B1 选 A，但希望增加审批环节
|
||||
|
||||
| # | 确认结论 | 落地动作 | 状态 |
|
||||
|:--:|---|---|:--:|
|
||||
| **B1** | **选 A：增加「申请加入名单 → 管理员审批」通道** | ⚠️ **需开发**：新增 FR-509 系列 + 1 张表 + 4 个接口 + 2 屏原型 | 🔨 **待实施** |
|
||||
| ~~**B1**~~ | ~~选 A：增加「申请加入名单 → 管理员审批」通道~~ → **已撤销**（2026-10 需求回退）：该通道、表、接口、学生端页面与错误码已全部删除 | ⚠️ **需求回退，建议补变更确认单**：名单外的人改由老师在任务里**手工加人**；系统内不展示联系方式 | ❌ **已撤销** |
|
||||
| B2 | 社会收集名单**由报名点/机构维护预报名名单**，导入后开放；**填报期内可随时追加** | 已一致：FR-508 追加导入；补充说明写入 PRD §5.5 | ✅ 已一致 |
|
||||
| B3 | **字段三分类**：姓名/证件号/报考三项锁定，其余可核对修改并留痕 | 已一致：FR-502b + `changed_fields` 机制 | ✅ 已一致 |
|
||||
| B4 | **不加手机号验证码** | 无需改动（当前门禁即姓名+证件号） | ✅ 已一致 |
|
||||
@@ -352,8 +357,8 @@ B1 选 A，但希望增加审批环节
|
||||
| B8 | **一期不对接机构系统，预留开放接口** | 已一致：§14 开放接口已设计但不启用 | ✅ 已一致 |
|
||||
| B9 | **不做公安实名核验** | 无需改动 | ✅ 已一致 |
|
||||
|
||||
> **结论：B 组 9 项中 8 项零改动，仅 B1 需开发。**
|
||||
> B1 的建议是我方主动提出的（原需求只有"只提示"），客户采纳后**这是一次功能增量**，已按 §变更记录 追加设计与排期。
|
||||
> **结论：B 组 9 项中 8 项零改动；B1 曾是我方主动提出的功能增量、客户采纳后已开发，但于 2026-10 随需求收敛整体撤销。**
|
||||
> ⚠️ 它是本函里**唯一的功能增量**，因此这次撤销属**需求回退**，建议补一张变更确认单。
|
||||
|
||||
### C 组 · 商务法务（5 项）
|
||||
|
||||
@@ -372,7 +377,7 @@ B1 选 A，但希望增加审批环节
|
||||
| D1 | OCR 引擎选型（腾讯云/百度/本地） | ⏳ M2 结束前定 |
|
||||
| D2 | VLM 抽成可替换接口，不绑定供应商 | ✅ 已按此设计（04 文档 M3 §3.6） |
|
||||
| D3 | 门禁限流：openid 10 次/小时、IP 20 次/分钟 | ✅ 已实现口径 |
|
||||
| D4 | **需索取「社会评价」批次的原始材料样本** | ✅ **已后置为二期**（一期只做学校收集 + 自主认定，不涉及社会评价材料） |
|
||||
| D4 | **需索取「社会评价」批次的原始材料样本** | ✅ **已作废**（2026-10 取消二期，不再需要该样本） |
|
||||
|
||||
#### D4 补充说明：为什么需要「社会评价」的样本
|
||||
|
||||
@@ -404,8 +409,8 @@ B1 选 A，但希望增加审批环节
|
||||
| 退而求其次 | **10~20 份**，但**必须覆盖「学信网备案表」和「各类佐证材料」**（这两类现在零样本） |
|
||||
| 特别注意 | 记录**材料来源与格式**——社会人员可能直接从学信网下载 **PDF**（而非拍照/扫描）。若是，`file_types` 白名单、预览、压缩策略都要跟着调整 |
|
||||
|
||||
> ✅ **已后置为二期**（2026-09-28 客户确认）：一期范围收窄为「**学校收集 + 自主认定**」，材料只有 4 类（一寸照片 / 身份证 / 学籍表 / 工作证明），**全部有 112 个真实文件实测**。
|
||||
> 因此 D4 **不再是待办、也不阻塞任何里程碑**。待二期做「社会评价」时再索取即可。
|
||||
> ✅ **已作废**（2026-10 取消二期；2026-09-28 曾收窄为「**学校收集 + 自主认定**」），材料只有 4 类（一寸照片 / 身份证 / 学籍表 / 工作证明），**全部有 112 个真实文件实测**。
|
||||
> 因此 D4 **不是待办、也不阻塞任何里程碑**；由于二期已取消，**该样本不再需要索取**。
|
||||
| D5 | 一寸照片形态阈值用真实样本标定 | ✅ 已有实测（984×1378，5:7） |
|
||||
| D6 | **微信三条来源通道体积上限需真机实测** | ⏳ 待测 |
|
||||
| D7 | ~~文件名规则在"学生原始乱名"上测真实准确率~~ | ✅ **已降级为文案校准**（不需样本） |
|
||||
|
||||
Reference in New Issue
Block a user