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:
+10
-10
@@ -2,7 +2,7 @@
|
||||
|
||||
> 用途：把 PRD 的每条需求对上「**原型 / 库表 / 接口 / 验收**」四个交付面，找出**说了没做**和**做了没说**。
|
||||
> 生成日期：2026-09-28
|
||||
> 审计范围：**125 条 FR**（92 P0 / 30 P1 / 3 P2）+ **21 条 VAL 校验规则** + **121 个接口** + **20 张表**
|
||||
> 审计范围：**125 条 FR**（92 P0 / 30 P1 / 3 P2）+ **21 条 VAL 校验规则** + **119 个接口**（2026-10 收敛后的口径；原 129 = 121 + 角色与授权 8）+ **20 张表**
|
||||
> 结论：**主流程全覆盖。第三节的 10 个接口缺口已于 P3 补齐（共新增 21 个接口）；配置类页面缺口见 3.2**
|
||||
|
||||
---
|
||||
@@ -12,7 +12,7 @@
|
||||
| 模块 | 条数 | P0 | 库表 | 接口 | 原型 | 判定 |
|
||||
|---|:--:|:--:|:--:|:--:|:--:|:--:|
|
||||
| FR-100 租户与组织 | 5 | 5 | ✅ | ✅ | ❌ | ⚠️ 缺平台运营端原型 |
|
||||
| FR-200 账号与角色 | 6 | 5 | ✅ | ✅ | ❌ | ⚠️ 缺登录页与用户管理页 |
|
||||
| FR-200 账号与角色 | 6 | 5 | ✅ | ✅ | ⚠️ | ⚠️ 缺登录页与用户管理页；**FR-205 角色自定义已落地**（`docs/03` §4.12 / §5.10，页面 `frontend-pc/src/views/role/`；2026-10 起按**一期功能**计，不再叫"二期"）——其中「数据权限可配」**不做** |
|
||||
| FR-300 收集任务 | 12 | 9 | ✅ | ✅ | ⚠️ | ✅ 暂停接口已补（P3） |
|
||||
| FR-400 动态表单 | 8 | 6 | ✅ | ✅ | ❌ | ⚠️ **缺表单设计器原型** |
|
||||
| FR-500 名单管理 | 24 | 21 | ✅ | ✅ | ✅ | ✅ **全覆盖**（含客户确认新增的 FR-509 系列 10 条） |
|
||||
@@ -23,7 +23,7 @@
|
||||
| FR-1100 数据看板 | 5 | 2 | ✅ | ✅ | ✅ | ✅ **全覆盖** |
|
||||
| FR-1200 系统管理 | 6 | 5 | ⚠️ | ✅ | ❌ | ⚠️ 接口已补（P3），原型仍缺 |
|
||||
| FR-1300 SaaS 计费 | 4 | 2 | ⚠️ | ⚠️ | ❌ | ⚠️ 缺平台运营端 |
|
||||
| FR-1400 历史整理器 | 6 | 0 | ✅ | ❌ | ❌ | ❌ **三面全缺**（P1，本轮未做） |
|
||||
| ~~FR-1400 历史整理器~~ | ~~6~~ | ~~0~~ | — | — | — | **已取消**（2026-10 需求收敛：模块/表/接口/页面全部删除） |
|
||||
| **FR-700 校验引擎** | — | — | ✅ | ✅ | ✅ | ✅ 以 VAL-01~21 实现，三端均有体现 |
|
||||
|
||||
**图例**：✅ 完整覆盖 ⚠️ 部分覆盖 ❌ 未覆盖
|
||||
@@ -55,7 +55,7 @@
|
||||
| # | 缺口 | 对应需求 | 影响 | 建议接口 |
|
||||
|:--:|---|---|---|---|
|
||||
| I1 | **报考范围读取与确认** | FR-307~311 | 管理端④整屏无数据来源 | `GET/PUT /api/v1/tasks/{id}/plan-scope` |
|
||||
| I2 | **历史数据整理器** | FR-1401~1406 | §5.14 六条需求**完全无接口** | `POST /api/v1/cleanup/jobs` 等 5 个 |
|
||||
| ~~I2~~ | ~~**历史数据整理器**~~ | — | **已取消**（2026-10） | — |
|
||||
| I3 | **字典管理** | FR-1201 | 学历/等级/补考科目等下拉项无法维护 | `GET/POST/PUT /api/v1/dicts` |
|
||||
| I4 | **操作日志** | FR-1202 | 审计留痕无法查询 | `GET /api/v1/logs/operations` |
|
||||
| I5 | **登录日志** | FR-1203 | 同上 | `GET /api/v1/logs/logins` |
|
||||
@@ -75,14 +75,14 @@
|
||||
|:--:|---|---|:--:|---|
|
||||
| P1 | **表单设计器** | FR-401~408 | 高 | ⚠️ **必须补**——拖拽式字段编排是 P0，且交互复杂，光靠文字描述开发必理解偏 |
|
||||
| P2 | **材料规则配置**（命名模板编辑器） | FR-601~609 | 高 | ⚠️ **建议补**——管理端②只做了"试跑"，配置界面本身没画 |
|
||||
| P3 | 历史数据整理器 | FR-1401~1406 | 中 | 建议补（差异化获客功能，客户演示时最吸睛） |
|
||||
| ~~P3~~ | ~~历史数据整理器~~ | — | — | **已取消**（2026-10 需求收敛） |
|
||||
| P4 | 登录页 | FR-201 | 低 | 可略 |
|
||||
| P5 | 组织与用户管理 | FR-103、203~206 | 中 | 可略（标准 CRUD） |
|
||||
| P6 | 任务列表与详情 | FR-301~306 | 中 | 建议补简版（克隆、二维码、暂停） |
|
||||
| P7 | 通知模板管理 | FR-1001~1002 | 低 | 可略 |
|
||||
| P8 | 字典管理 | FR-1201 | 低 | 可略 |
|
||||
| P9 | 操作日志查询 | FR-1202~1203 | 低 | 可略 |
|
||||
| P10 | 平台运营端（租户/套餐/计费） | FR-101~102、1301~1304 | 中 | 建议二期做（一期客户是学校，不关心平台运营） |
|
||||
| P10 | 平台运营端（租户/套餐/计费） | FR-101~102、1301~1304 | 中 | **不做**（2026-10：不再设计二期；平台运营端只保留租户开通与用量） |
|
||||
|
||||
### 3.3 需求条目本身的核查
|
||||
|
||||
@@ -118,7 +118,7 @@
|
||||
规则引擎（命名/压缩/识别） ████████████████████ 100%
|
||||
配置类页面 ██████░░░░░░░░░░░░░░ 30%
|
||||
平台运营 ░░░░░░░░░░░░░░░░░░░░ 0%
|
||||
历史整理器 ░░░░░░░░░░░░░░░░░░░░ 0%（仅库表）
|
||||
~~历史整理器~~ ░░░░░░░░░░░░░░░░░░░░ 已取消（2026-10）
|
||||
```
|
||||
|
||||
### 必须行动的 3 项
|
||||
@@ -136,7 +136,7 @@
|
||||
|
||||
| # | 任务 | 产出 | 理由 |
|
||||
|---|---|---|---|
|
||||
| **P2.5** | **管理端补充原型**：表单设计器 + 材料规则配置 + 整理器 | 补充到 `admin-web.html` | 追溯矩阵发现的缺口，三者都是**复杂交互、不画会理解偏**的页面 |
|
||||
| **P2.5** | **管理端补充原型**：表单设计器 + 材料规则配置 + ~~整理器~~（该屏已于 2026-10 删除） | 补充到 `admin-web.html` | 追溯矩阵发现的缺口，三者都是**复杂交互、不画会理解偏**的页面 |
|
||||
|
||||
---
|
||||
|
||||
@@ -156,9 +156,9 @@
|
||||
| FR-1100 | FR-1101 ~ 1105 | 5 | 看板 |
|
||||
| FR-1200 | FR-1201 ~ 1206 | 6 | 系统管理 |
|
||||
| FR-1300 | FR-1301 ~ 1304 | 4 | 计费 |
|
||||
| FR-1400 | FR-1401 ~ 1406 | 6 | 整理器 |
|
||||
| ~~FR-1400~~ | ~~FR-1401 ~ 1406~~ | ~~6~~ | **已取消**（2026-10） |
|
||||
| **合计** | | **125** | **92 P0 / 30 P1 / 3 P2** |
|
||||
|
||||
**校验规则**：VAL-01 ~ VAL-21（21 条，编号连续；18~20 为 P4 补充，**21 为客户确认后补充的归属校验**）
|
||||
**接口**：**121 个已定义**（原 96 + 补齐 21 + 客户确认新增 5 − 客户要求移除 1，见 `03-接口设计.md`）
|
||||
**接口**：**119 个已定义**（2026-10 收敛：原 129 = 96 + 补齐 21 + 客户确认新增 5 + 角色与授权 8 − 移除 1；现减去**加入申请 5 个**与**历史整理器 5 个** = **119**，补齐 21 → 16），见 `03-接口设计.md` §4.12 / §5.10
|
||||
**库表**：**20 张**完整 DDL + 4 张"从略"标准表
|
||||
|
||||
Reference in New Issue
Block a user