Ver Fonte

feat: 更新需求文档(V1.2)

需求变更:
1. 任务分类 TASK-005: P1 → P0
2. POINT-002: 提前完成奖励 → 超额完成奖励(家长制定规则)
3. POINT-009: 积分每月清零 → 积分不清零,可设置有效期
4. REWARD-001A: 家长填写所需积分后心愿进奖励库 (P0)
5. REWARD-002A: 家庭奖励库 (P0)
6. REWARD-002B: 多孩子心愿单隔离 (P0)
7. DAN测评模块重构:
   - 测评数据来自接口(非拍照上传)
   - 作为测评记录,不作为孩子基本信息
   - 与任务、心愿平行(P1)
   - 删除手动录入、图片上传等需求
Sisyphus há 5 meses atrás
pai
commit
ef3488b417
2 ficheiros alterados com 52 adições e 104 exclusões
  1. 25 80
      系统测试/.test-sync.json
  2. 27 24
      需求分析/需求分析文档.md

+ 25 - 80
系统测试/.test-sync.json

@@ -1,93 +1,38 @@
 {
 {
-  "timestamp": "2026-04-09T22:55:00.000Z",
-  "version": "V1.1",
-  "totalRequirements": 148,
+  "timestamp": "2026-04-10T00:00:00.000Z",
+  "version": "V1.2",
+  "totalRequirements": 156,
   "summary": {
   "summary": {
-    "P0": 28,
-    "P1": 45,
+    "P0": 32,
+    "P1": 48,
     "P2": 20
     "P2": 20
   },
   },
   "changes": {
   "changes": {
     "added": [
     "added": [
-      {
-        "id": "TASK-012A",
-        "description": "打卡支持照片上传",
-        "priority": "P0",
-        "module": "任务管理"
-      },
-      {
-        "id": "TASK-012B",
-        "description": "打卡支持视频上传",
-        "priority": "P0",
-        "module": "任务管理"
-      },
-      {
-        "id": "TASK-012C",
-        "description": "打卡支持录音上传",
-        "priority": "P0",
-        "module": "任务管理"
-      },
-      {
-        "id": "TASK-012D",
-        "description": "打卡支持文字描述",
-        "priority": "P0",
-        "module": "任务管理"
-      },
-      {
-        "id": "TASK-012E",
-        "description": "打卡支持倒计时功能(开始任务时启动倒计时)",
-        "priority": "P0",
-        "module": "任务管理"
-      },
-      {
-        "id": "TASK-012F",
-        "description": "倒计时结束时语音提醒",
-        "priority": "P0",
-        "module": "任务管理"
-      },
-      {
-        "id": "MODE-008",
-        "description": "孩子账号停用功能",
-        "priority": "P0",
-        "module": "双模式切换"
-      },
-      {
-        "id": "MODE-009",
-        "description": "停用的孩子不可登录且不可被切换",
-        "priority": "P0",
-        "module": "双模式切换"
-      },
-      {
-        "id": "MODE-010",
-        "description": "指导师注册与审核",
-        "priority": "P2",
-        "module": "双模式切换"
-      }
+      {"id": "TASK-005", "description": "设置任务分类(学习类/生活类/运动类/其他)", "priority": "P0", "module": "任务发布"},
+      {"id": "REWARD-001A", "description": "家长填写所需积分后心愿进入奖励库", "priority": "P0", "module": "奖励体系"},
+      {"id": "REWARD-002A", "description": "家庭奖励库(多个家长都可调整)", "priority": "P0", "module": "奖励体系"},
+      {"id": "REWARD-002B", "description": "多孩子心愿单隔离", "priority": "P0", "module": "奖励体系"}
     ],
     ],
     "modified": [
     "modified": [
-      {
-        "id": "MODE-006",
-        "oldDescription": "角色权限区分(管理员/普通家长)",
-        "newDescription": "角色权限区分(管理员/普通家长/孩子)",
-        "oldPriority": "P2",
-        "newPriority": "P0"
-      }
+      {"id": "POINT-002", "oldDescription": "提前完成获得额外积分(默认+1分)", "newDescription": "超额完成获得额外积分(提前或超质完成,家长制定规则)", "oldPriority": "P0", "newPriority": "P0"},
+      {"id": "POINT-009", "oldDescription": "积分每月清零(每月1日00:00重置)", "newDescription": "积分不清零,可设置积分有效期(按任务设置)", "oldPriority": "P0", "newPriority": "P0"},
+      {"id": "DAN-001", "oldDescription": "拍照/上传DAN测评报告图片", "newDescription": "通过接口获取DAN测评数据", "oldPriority": "P1", "newPriority": "P1"},
+      {"id": "DAN-002", "oldDescription": "大模型解析报告内容,提取DAN等级", "newDescription": "测评记录存储与历史查看", "oldPriority": "P1", "newPriority": "P1"},
+      {"id": "DAN-003", "oldDescription": "解析DAN等级(A1/A2/A3/B1/B2/B3/B4/B5/B6)", "newDescription": "测评记录与任务模板关联", "oldPriority": "P1", "newPriority": "P1"},
+      {"id": "DAN-004~DAN-017", "description": "DAN测评模块重新编号,测评数据来自接口", "oldPriority": "P1", "newPriority": "P1"}
     ],
     ],
     "removed": []
     "removed": []
   },
   },
   "requirements": [
   "requirements": [
-    {"id": "TASK-001", "description": "家长可创建任务,设置任务名称", "priority": "P0"},
-    {"id": "TASK-002", "description": "设置任务积分值(1-10分,默认2分)", "priority": "P0"},
-    {"id": "TASK-003", "description": "设置任务截止时间(精确到分钟)", "priority": "P0"},
-    {"id": "TASK-012A", "description": "打卡支持照片上传", "priority": "P0"},
-    {"id": "TASK-012B", "description": "打卡支持视频上传", "priority": "P0"},
-    {"id": "TASK-012C", "description": "打卡支持录音上传", "priority": "P0"},
-    {"id": "TASK-012D", "description": "打卡支持文字描述", "priority": "P0"},
-    {"id": "TASK-012E", "description": "打卡支持倒计时功能(开始任务时启动倒计时)", "priority": "P0"},
-    {"id": "TASK-012F", "description": "倒计时结束时语音提醒", "priority": "P0"},
-    {"id": "MODE-006", "description": "角色权限区分(管理员/普通家长/孩子)", "priority": "P0"},
-    {"id": "MODE-008", "description": "孩子账号停用功能", "priority": "P0"},
-    {"id": "MODE-009", "description": "停用的孩子不可登录且不可被切换", "priority": "P0"},
-    {"id": "MODE-010", "description": "指导师注册与审核", "priority": "P2"}
+    {"id": "TASK-005", "description": "设置任务分类(学习类/生活类/运动类/其他)", "priority": "P0"},
+    {"id": "POINT-002", "description": "超额完成获得额外积分(提前或超质完成,家长制定规则)", "priority": "P0"},
+    {"id": "POINT-009", "description": "积分不清零,可设置积分有效期(按任务设置)", "priority": "P0"},
+    {"id": "REWARD-001A", "description": "家长填写所需积分后心愿进入奖励库", "priority": "P0"},
+    {"id": "REWARD-002A", "description": "家庭奖励库(多个家长都可调整)", "priority": "P0"},
+    {"id": "REWARD-002B", "description": "多孩子心愿单隔离", "priority": "P0"},
+    {"id": "DAN-001", "description": "通过接口获取DAN测评数据", "priority": "P1"},
+    {"id": "DAN-002", "description": "测评记录存储与历史查看", "priority": "P1"},
+    {"id": "DAN-003", "description": "测评记录与任务模板关联", "priority": "P1"}
   ]
   ]
-}
+}

+ 27 - 24
需求分析/需求分析文档.md

@@ -71,7 +71,7 @@
 | TASK-002 | 设置任务积分值(1-10分,默认2分) | P0 |
 | TASK-002 | 设置任务积分值(1-10分,默认2分) | P0 |
 | TASK-003 | 设置任务截止时间(精确到分钟) | P0 |
 | TASK-003 | 设置任务截止时间(精确到分钟) | P0 |
 | TASK-004 | 设置任务重复周期(每日/每周/自定义) | P1 |
 | TASK-004 | 设置任务重复周期(每日/每周/自定义) | P1 |
-| TASK-005 | 设置任务分类(学习类/生活类/运动类/其他) | P1 |
+| TASK-005 | 设置任务分类(学习类/生活类/运动类/其他) | P0 |
 | TASK-006 | 支持任务备注/说明 | P2 |
 | TASK-006 | 支持任务备注/说明 | P2 |
 | TASK-007 | 预设任务模板快速创建 | P1 |
 | TASK-007 | 预设任务模板快速创建 | P1 |
 
 
@@ -124,7 +124,7 @@
 | 需求编号 | 功能描述 | 优先级 |
 | 需求编号 | 功能描述 | 优先级 |
 |----------|----------|--------|
 |----------|----------|--------|
 | POINT-001 | 完成任务获得基础积分 | P0 |
 | POINT-001 | 完成任务获得基础积分 | P0 |
-| POINT-002 | 提前完成获得额外积分(默认+1分) | P0 |
+| POINT-002 | 超额完成获得额外积分(提前或超质完成,家长制定规则) | P0 |
 | POINT-003 | 专注训练满分获得额外积分 | P1 |
 | POINT-003 | 专注训练满分获得额外积分 | P1 |
 | POINT-004 | 连续打卡奖励机制 | P1 |
 | POINT-004 | 连续打卡奖励机制 | P1 |
 | POINT-005 | 手动调整积分(家长操作,需密码) | P2 |
 | POINT-005 | 手动调整积分(家长操作,需密码) | P2 |
@@ -137,7 +137,7 @@
 | POINT-007 | 每天最多扣5分(破产保护) | P0 |
 | POINT-007 | 每天最多扣5分(破产保护) | P0 |
 | POINT-008 | 扣分功能按年龄配置:6岁以下默认关闭,6岁及以上默认开启 | P0 |
 | POINT-008 | 扣分功能按年龄配置:6岁以下默认关闭,6岁及以上默认开启 | P0 |
 | POINT-008A | 家长可手动调整扣分开关(覆盖年龄默认配置) | P0 |
 | POINT-008A | 家长可手动调整扣分开关(覆盖年龄默认配置) | P0 |
-| POINT-009 | 积分每月清零(每月1日00:00重置) | P0 |
+| POINT-009 | 积分不清零,可设置积分有效期(按任务设置) | P0 |
 | POINT-010 | 过期未领取时积分退还 | P0 |
 | POINT-010 | 过期未领取时积分退还 | P0 |
 
 
 ---
 ---
@@ -149,7 +149,10 @@
 | 需求编号 | 功能描述 | 优先级 |
 | 需求编号 | 功能描述 | 优先级 |
 |----------|----------|--------|
 |----------|----------|--------|
 | REWARD-001 | 孩子可添加想要的奖励到心愿单 | P0 |
 | REWARD-001 | 孩子可添加想要的奖励到心愿单 | P0 |
+| REWARD-001A | 家长填写所需积分后心愿进入奖励库 | P0 |
 | REWARD-002 | 奖励设置名称、所需积分、分类 | P0 |
 | REWARD-002 | 奖励设置名称、所需积分、分类 | P0 |
+| REWARD-002A | 家庭奖励库(多个家长都可调整) | P0 |
+| REWARD-002B | 多孩子心愿单隔离 | P0 |
 | REWARD-003 | 奖励分类:物质类/精神类/特权类(支持家长自定义分类) | P0 |
 | REWARD-003 | 奖励分类:物质类/精神类/特权类(支持家长自定义分类) | P0 |
 | REWARD-003A | 家长可自定义奖励分类名称和图标 | P1 |
 | REWARD-003A | 家长可自定义奖励分类名称和图标 | P1 |
 | REWARD-004 | 进度条显示(已攒积分/所需积分) | P0 |
 | REWARD-004 | 进度条显示(已攒积分/所需积分) | P0 |
@@ -263,39 +266,39 @@
 
 
 ---
 ---
 
 
-### 4.9 DAN测评模板模块
+### 4.9 DAN测评记录模块
 
 
-#### 4.9.1 测评数据管理
+DAN测评是测评记录,不作为孩子的基本信息,与任务、心愿平行。
+
+#### 4.9.1 测评数据获取
 
 
 | 需求编号 | 功能描述 | 优先级 |
 | 需求编号 | 功能描述 | 优先级 |
 |----------|----------|--------|
 |----------|----------|--------|
-| DAN-001 | 拍照/上传DAN测评报告图片 | P1 |
-| DAN-002 | 大模型解析报告内容,提取DAN等级 | P1 |
-| DAN-003 | 解析DAN等级(A1/A2/A3/B1/B2/B3/B4/B5/B6) | P1 |
-| DAN-004 | 手动录入DAN测评报告结果(备选方案) | P2 |
-| DAN-005 | 测评数据存储与历史查看 | P2 |
+| DAN-001 | 通过接口获取DAN测评数据 | P1 |
+| DAN-002 | 测评记录存储与历史查看 | P1 |
+| DAN-003 | 测评记录与任务模板关联 | P1 |
 
 
 #### 4.9.2 等级与任务映射
 #### 4.9.2 等级与任务映射
 
 
 | 需求编号 | 功能描述 | 优先级 |
 | 需求编号 | 功能描述 | 优先级 |
 |----------|----------|--------|
 |----------|----------|--------|
-| DAN-006 | A1等级(幼儿园小班)推荐任务模板 | P1 |
-| DAN-007 | A2等级(幼儿园中班)推荐任务模板 | P1 |
-| DAN-008 | A3等级(幼儿园大班)推荐任务模板 | P1 |
-| DAN-009 | B1等级(小学一年级)推荐任务模板 | P1 |
-| DAN-010 | B2等级(小学二年级)推荐任务模板 | P1 |
-| DAN-011 | B3等级(小学三年级)推荐任务模板 | P1 |
-| DAN-012 | B4等级(小学四年级)推荐任务模板 | P1 |
-| DAN-013 | B5等级(小学五年级)推荐任务模板 | P1 |
-| DAN-014 | B6等级(小学六年级)推荐任务模板 | P1 |
+| DAN-004 | A1等级(幼儿园小班)推荐任务模板 | P1 |
+| DAN-005 | A2等级(幼儿园中班)推荐任务模板 | P1 |
+| DAN-006 | A3等级(幼儿园大班)推荐任务模板 | P1 |
+| DAN-007 | B1等级(小学一年级)推荐任务模板 | P1 |
+| DAN-008 | B2等级(小学二年级)推荐任务模板 | P1 |
+| DAN-009 | B3等级(小学三年级)推荐任务模板 | P1 |
+| DAN-010 | B4等级(小学四年级)推荐任务模板 | P1 |
+| DAN-011 | B5等级(小学五年级)推荐任务模板 | P1 |
+| DAN-012 | B6等级(小学六年级)推荐任务模板 | P1 |
 
 
 #### 4.9.3 模板生成
 #### 4.9.3 模板生成
 
 
 | 需求编号 | 功能描述 | 优先级 |
 | 需求编号 | 功能描述 | 优先级 |
 |----------|----------|--------|
 |----------|----------|--------|
-| DAN-015 | 根据DAN等级生成推荐任务列表 | P1 |
-| DAN-016 | 家长可编辑/调整模板任务 | P1 |
-| DAN-017 | 一键启用模板生成今日任务 | P1 |
+| DAN-013 | 根据DAN等级生成推荐任务列表 | P1 |
+| DAN-014 | 家长可编辑/调整模板任务 | P1 |
+| DAN-015 | 一键启用模板生成今日任务 | P1 |
 
 
 ---
 ---
 
 
@@ -336,7 +339,7 @@
 
 
 ---
 ---
 
 
-## 6. DAN测评等级参考
+## 6. DAN测评等级参考(仅供参考)
 
 
 基于双培强基工程的DAN素质能力测评体系:
 基于双培强基工程的DAN素质能力测评体系:
 
 
@@ -361,7 +364,7 @@
 | 序号 | 确认项 | 确认内容 |
 | 序号 | 确认项 | 确认内容 |
 |------|--------|----------|
 |------|--------|----------|
 | CONF-01 | 技术栈 | Java后端(Spring Boot)+ MySQL |
 | CONF-01 | 技术栈 | Java后端(Spring Boot)+ MySQL |
-| CONF-02 | DAN测评对接 | 优先API对接,如无法实现则降级为手动录入 |
+| CONF-02 | DAN测评对接 | 通过接口获取测评数据,作为测评记录(不作为孩子基本信息) |
 | CONF-03 | 扣分机制 | 6岁以下默认关闭,6岁及以上默认开启,家长可手动调整 |
 | CONF-03 | 扣分机制 | 6岁以下默认关闭,6岁及以上默认开启,家长可手动调整 |
 | CONF-04 | 审核机制 | 家长自定义需要审核的任务范围,审核方式为拍照上传 |
 | CONF-04 | 审核机制 | 家长自定义需要审核的任务范围,审核方式为拍照上传 |
 | CONF-05 | AI辅助审核 | 新增AI辅助审核功能,判断任务完成质量 |
 | CONF-05 | AI辅助审核 | 新增AI辅助审核功能,判断任务完成质量 |