Browse Source

docs: 新增知了数学2.0项目规划文档

包含系统架构设计、功能模块、人员分工、开发节奏(5阶段28工作日)、
内容规模与AI生产方案等完整规划,用于团队对齐2.0版本开发方向。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
gwd 1 month ago
parent
commit
2c50994d33
1 changed files with 286 additions and 0 deletions
  1. 286 0
      docs/知了数学2.0-项目规划.md

+ 286 - 0
docs/知了数学2.0-项目规划.md

@@ -0,0 +1,286 @@
+# 知了数学 2.0 — 项目规划
+
+## 一、背景
+
+现有系统存在几个核心问题:知识点体系不准确、题目质量差、多套系统维护成本高。2.0 版本产品逻辑全面升级,从"系统临时出题"转向"提前准备好高质量学案内容,业务点打印给学生使用",借此机会重建系统。
+
+**目标:** 2月27日 - 3月31日,完成核心系统,让业务点能用上 2.0 的学案体系。
+
+---
+
+## 二、系统整体设计
+
+### 改造前(5套系统,维护复杂)
+
+```
+内容系统(PHP) + 业务系统(Java) + 加盟系统(.NET) + OCR识别(Python) + 业务点前端(React)
+      ↑                ↑                                        ↑
+   各自独立数据库,语言不同,对接复杂
+```
+
+### 改造后(统一为1套核心系统)
+
+```
+┌──────────────────────────────────────────────────────┐
+│                    核心系统 S                          │
+│                                                        │
+│  管理后台(教研用)    业务接口(业务点+加盟门店用)      │
+│  · 知识点管理          · 学生/班级管理                  │
+│  · 学案内容编辑        · 学案打印                       │
+│  · AI出题 + 审核       · 成绩录入(拍照识别)           │
+│  · 摸底卷管理          · 学情查看                       │
+│                                                        │
+│                    统一数据库                            │
+└───┬──────────┬──────────┬──────────┬─────────────────┘
+    │          │          │          │
+ 业务点端   加盟门店系统  拍照识别   AI出题 + 学案打印
+ (过卫栋) (过卫栋)   (谢照迪)    (谢照迪)
+```
+
+**核心改变:**
+
+- 原来 5 套系统 → 合并为 1 套核心系统 + 3 个配套服务
+- 原来2个数据库 → 统一为 1 个数据库
+- 旧数据不迁移,全部重新开始(目前客户量少,处于内测期,6个月免费)
+
+---
+
+## 三、功能模块
+
+### 管理后台(教研团队使用)
+
+| 功能               | 说明                                                                                                                 |
+| ------------------ | -------------------------------------------------------------------------------------------------------------------- |
+| **知识点目录管理** | 管理三级知识点目录(如:数与式 → 有理数 → 正数与负数);标注难度等级(初中A/B两档,高中A/B/C三档)                   |
+| **智能学案编辑**   | 每份学案对应1个知识点;人工录入核心内容(知识精要+母题),其余由AI自动生成;同一组知识点的学案共享知识精要和巩固练习 |
+| **阶段学案编辑**   | 阶段综合测试,AI生成20道题,覆盖一组关联知识点                                                                       |
+| **AI出题 + 审核**  | 人工录入参考题后,AI自动生成变式题;教研人员逐题审核,通过后上线使用                                                 |
+| **摸底卷管理**     | 预先组好的模拟试卷:初中2套(A+B难度各1套)、高中3套(A+B+C难度各1套)                                               |
+
+### 业务点操作端(业务点人员使用)
+
+| 功能                   | 说明                                                               |
+| ---------------------- | ------------------------------------------------------------------ |
+| **学生/班级/教师管理** | 录入和管理学生信息、分班、分配教师                                 |
+| **生成学案**           | 智能学案(知识点)、阶段学案                                       |
+| **拍照识别答题卷**     | 学生做完纸质学案后,拍照上传,系统自动识别对错                     |
+| **查看学情**           | 查看学生知识点掌握情况(红/黄/绿热力图)、提分力统计,截图发给家长 |
+| **错题追练**           | 学案题目用完后,针对错题自动生成追练题                             |
+| **选择摸底卷**         | 从预组好的摸底卷中选择,打印给学生做摸底测试                       |
+
+---
+
+## 四、数据架构
+
+系统需要管理以下几类数据:
+
+| 类别           | 包含内容                                                           |
+| -------------- | ------------------------------------------------------------------ |
+| **教材与章节** | 教材版本(人教版等)、章节层级、章节与知识点的对应关系             |
+| **知识点**     | 三级目录结构、每个知识点的难度等级                                 |
+| **题目**       | 题干、选项、答案、解析、难度、题型、对应知识点                     |
+| **学案内容**   | 智能学案(7个模块的内容和题目)、阶段学案(20道测试题)            |
+| **摸底卷**     | 预组好的模拟试卷和卷内题目                                         |
+| **业务运营**   | 业务点(加盟门店)、教师、班级、学生                               |
+| **学习记录**   | 学案完成记录、每道题的对错、知识点掌握度、提分力、错题本、追练记录 |
+| **积分**       | 积分流水(预留,内测期免费)                                       |
+
+---
+
+## 五、人员分工
+
+| 人员                     | 负责内容                                                                   | 产出           |
+| ------------------------ | -------------------------------------------------------------------------- | -------------- |
+| **过卫栋**               | 核心系统开发 + 管理后台 + 业务点前端改造 + 整体架构设计                    | 核心系统       |
+| **谢照迪**               | AI出题服务 + 学案打印服务 + 拍照识别服务                                   | 三个配套服务   |
+| **李文屿**               | 整理知识点目录;准备出题样例和规范;验证AI出题质量;协调管理内容录入和审核 | 内容质量保障   |
+| **姚老师 + 文莉**        | 系统测试(第5阶段,5个工作日)                                             | 测试反馈       |
+| **新后端同事(待到岗)** | 可分担:加盟系统改造 / 管理后台部分页面 / 前端部分改造                     | 视到岗时间分配 |
+
+---
+
+## 六、开发节奏
+
+**总工期:2月27日(周四) - 3月31日(周一),每周休息1天(周日),共 28 个工作日**
+
+- 开发:23 个工作日(2/27 - 3/25)
+- 测试:5 个工作日(3/26 - 3/31)
+
+### 第 1 阶段(2/27 - 3/8,8个工作日):搭建基础 + 管理后台核心
+
+**过卫栋:**
+
+- 搭建核心系统框架和数据库
+- 搭建管理后台
+- 完成「知识点目录管理」功能
+- 完成「智能学案编辑」功能框架
+
+**谢照迪:**
+
+- 搭建 AI 出题服务(输入参考题 → 输出变式题)
+- 搭建学案打印服务,确定打印格式
+- 验证数学公式在打印件中的显示效果
+
+**李文屿:**
+
+- 整理完整的三级知识点目录(初中+高中)
+- 确定每个知识点的难度等级
+- 准备"通用知识精要样例"截图和出题规范
+- 验证 AI 生成知识精要和母题的质量,评估是否需要人工补录
+
+### 第 2 阶段(3/9 - 3/15,6个工作日):管理后台全部完成
+
+**过卫栋:**
+
+- 完成「阶段学案编辑」功能
+- 完成「AI出题 + 审核流程」功能
+- 完成「摸底卷管理」功能(初中2套+高中3套)
+- 管理后台全部功能可用
+
+**谢照迪:**
+
+- AI 出题服务可以被管理后台正常调用
+- 学案打印服务可以生成基础学案PDF
+- 拍照识别服务适配新系统格式
+
+**李文屿:**
+
+- 开始在管理后台录入知识点目录
+- 持续验证AI生成的知识精要和母题质量,协调安排审核
+
+### 第 3 阶段(3/16 - 3/22,6个工作日):业务点功能
+
+**过卫栋:**
+
+- 完成业务点端的学生/班级/教师管理
+- 完成学案选择和打印功能
+- 完成拍照录入成绩功能
+- 改造业务点前端,对接新系统
+
+**谢照迪:**
+
+- 完善打印服务(支持所有学案类型和摸底卷)
+- 拍照识别功能联调
+
+**李文屿:**
+
+- 协调安排人员审核 AI 生成的题目
+
+### 第 4 阶段(3/23 - 3/25,3个工作日):学情功能 + 全面联调
+
+**过卫栋:**
+
+- 完成知识点掌握判定和提分力计算
+- 完成学情热力图展示
+- 完成错题追练功能
+- 加盟系统对接新数据库
+- 所有功能串通测试
+
+**谢照迪:**
+
+- 所有服务联调
+- 部署线上环境
+
+### 第 5 阶段(3/26 - 3/31,5个工作日):测试 + 上线
+
+**姚老师 + 文莉:**
+
+- 管理后台功能测试(知识点、学案、AI出题、摸底卷)
+- 业务点操作流程测试(学案打印、拍照录入、学情查看)
+- 完整业务流程回归测试
+
+**过卫栋:**
+
+- 修复测试发现的问题
+- 正式部署上线
+
+**新后端同事(如已到岗):**
+
+- 分担前端改造或加盟系统改造
+
+---
+
+## 七、内容规模与生产计划
+
+### 每份智能学案包含什么
+
+| 模块     | 数量  | 谁来做       | 备注                      |
+| -------- | ----- | ------------ | ------------------------- |
+| 知识精要 | 10 个 | 人工或AI生成 | 同一组知识点的学案共享    |
+| 巩固训练 | 30 道 | AI 自动生成  | 同一组知识点的学案共享    |
+| 母题示范 | 2 道  | 人工或AI生成 | 每份学案独有              |
+| 学以致用 | 2 道  | AI 自动生成  | 基于每道母题生成2个变式题 |
+| 知识回顾 | 2 道  | AI 自动生成  | 每份学案独有              |
+| 进阶练习 | 8 道  | AI 自动生成  | 每份学案独有              |
+
+### 总量一览
+
+| 内容           | 数量   | 说明                                               |
+| -------------- | ------ | -------------------------------------------------- |
+| 知识点阶段分组 | 311 组 | 初中 108 组 + 高中 203 组                          |
+| 智能学案       | 780 份 | 初中 309 份 + 高中 471 份,每份对应1个知识点       |
+| 阶段学案       | 311 份 | 每份 20 道测试题,AI 生成                          |
+| 摸底卷         | 5 套   | 初中2套(A+B难度各1套),高中3套(A+B+C难度各1套) |
+
+### 内容生产方案
+
+知识精要和母题是所有内容的"种子",有两种生产方式:
+
+**方案A:人工录入(兜底方案)**
+
+找人手工录入知识精要和母题,工作量如下:
+
+| 内容     | 怎么算                 | 数量         |
+| -------- | ---------------------- | ------------ |
+| 知识精要 | 311 组 × 每组 10 个    | 3,110 个     |
+| 母题     | 780 份学案 × 每份 2 道 | 1,560 道     |
+| **合计** |                        | **4,670 项** |
+
+**方案B:全AI生成(优先尝试)**
+
+优化 prompt 后,提供一份"通用知识精要样例"截图(10题示范),让 AI 参照样例格式和质量标准,直接为每个知识点生成知识精要和母题,无需人工逐条录入。如果 AI 生成质量达标,可省去全部人工录入工作。
+
+> 建议:先用方案B试跑几个知识点,李文屿评估质量。如果效果好,全部用AI生成;如果部分知识点效果不好,再针对性用方案A补充。
+
+**AI 自动生成的其余内容(谢照迪的 AI 服务):**
+
+| 内容                 | 怎么算                            | 数量             |
+| -------------------- | --------------------------------- | ---------------- |
+| 巩固训练             | 311 组 × 每组 30 道               | 9,330 道         |
+| 母题变式(学以致用) | 780 份 × 每份 2 道母题 × 2 个变式 | 3,120 道         |
+| 知识回顾             | 780 份 × 每份 2 道                | 1,560 道         |
+| 进阶练习             | 780 份 × 每份 8 道                | 6,240 道         |
+| 阶段测试             | 311 份 × 每份 20 道               | 6,220 道         |
+| 摸底卷               | 5 套 × 约 100 道                  | 约 500 道        |
+| **AI 合计**          |                                   | **约 26,970 道** |
+
+### 内容生产流程
+
+```
+第1步:李文屿 准备"通用知识精要样例"截图 + 出题规范
+                              ↓
+第2步:AI 服务 按样例批量生成知识精要 + 母题(约 4,670 项)
+        ↓ 质量不达标的部分 → 安排人工补录
+                              ↓
+第3步:AI 服务 基于知识精要和母题,批量生成其余题目(约 26,970 道)
+                              ↓
+第4步:李文屿 协调安排人员在管理后台审核(通过 / 打回重新生成)
+                              ↓
+第5步:审核通过的内容上线,业务点即可使用
+```
+
+**总内容量约 3.2 万项,目标是尽量全部由 AI 生成,人工只做审核。**
+
+内容生产是持续性工作,不需要一次性全部完成。系统先上线,内容按知识点分批生成、分批审核、分批上线。
+
+---
+
+## 八、风险与应对
+
+| 风险                        | 应对措施                                                         |
+| --------------------------- | ---------------------------------------------------------------- |
+| 内容生产量大(约 3.2 万项) | 优先尝试全AI生成方案,人工只做审核;分批上线,先做核心知识点     |
+| AI 生成的题目质量不稳定     | 李文屿提前验证出题效果,持续优化;所有AI题目必须人工审核后才上线 |
+| 新后端同事到岗时间不确定    | 过卫栋先推进核心功能,到岗后再分担                               |
+| 数学公式打印显示问题        | 谢照迪第1阶段就验证打印效果,有问题及早调整                      |
+| 测试时间只有5天             | 开发过程中充分自测,测试阶段聚焦核心业务流程                     |