# 心知益家小程序需求分析文档

## 版本信息

| 版本 | 日期 | 作者 | 变更说明 |
|------|------|------|----------|
| V1.0 | 2026-03-30 | Sisyphus | 初始版本 |
| V1.3 | 2026-05-04 | Sisyphus | 新增成长规划师注册与升级系统 |
| **V2.0** | **2026-05-07** | **Sisyphus** | **基于开发进度重新梳理，分离已完成/未完成需求，更新为P0-MVP/P1-增强/P2-未来三层结构** |

---

## 1. 项目概述

### 1.1 产品背景

本产品源于一位程序员父亲为解决6岁孩子拖延症而开发的小程序"宝贝积分屋"。在解决亲子教育中"任务管理+即时反馈"这一核心痛点的基础上，引入"双培强基工程"的DAN测评体系，为每个孩子提供基于科学测评的个性化任务模板。

### 1.2 产品定位

**产品名称**：心知益家  
**产品类型**：微信小程序 + Web管理端  
**核心定位**：基于DAN测评的家庭教育任务管理工具，通过积分奖励机制激励孩子自主完成任务，培养时间管理和延迟满足能力。  
**目标用户**：6-12岁儿童家长（主要决策者）、6-12岁儿童（实际使用者）、成长规划师（专业服务提供者）

---

## 2. 总体状态

| 模块 | 状态 | 说明 |
|------|------|------|
| 用户认证 | ✅ 已完成 | 微信登录、JWT认证、角色分流 |
| 任务管理 | ✅ 已完成 | 创建/执行/审核/查看 |
| 积分系统 | ✅ 已完成 | 获取/消耗/流水/扣分规则 |
| 奖励体系 | ✅ 已完成 | 心愿单/兑换/审批/预设模板 |
| 双模式切换 | ✅ 已完成 | 家长/孩子/规划师三种角色切换 |
| 连续打卡 | ✅ 已完成 | 火苗天数显示/里程碑 |
| 勋章墙 | ✅ 已完成 | 勋章定义/解锁/展示 |
| 专注训练 | ✅ 已完成 | 简单模式/番茄钟/评分 |
| 小游戏 | ✅ 已完成 | 数独/舒尔特方格/1A2B |
| 敏感词过滤 | ✅ 已完成 | 内容安全 |
| 街道地址匹配 | ✅ 已完成 | 四级地址回退 |
| 任务模板 | ✅ 已完成 | 按DAN等级/系统默认 |
| Web管理端 | ✅ 已完成 | 管理员后台 |
| **测评订单（含支付）** | **✅ 已完成** | **P0链路贯通** |
| **测评预约管理** | **✅ 已完成** | **规划师/家长端** |
| **Web管理端侧边栏** | **✅ 已完成** | **admin+teacher双菜单** |
| **多数据源+迁移** | **✅ 已完成** | **sfms→zxyj迁移** |
| 成长档案 | ✅ 已完成 | 创建/查看/详情 |
| **成长规划师端** | **🟡 已完成** | **Web端7页面+小程序端** |
| **成长档案(增强)** | **🟡 已完成** | **测评关联/快照** |
| 家长端成长档案入口 | ✅ 已完成 | 首页快捷操作 |
| 成长周报 | 🔴 未开始 | 数据统计/周报生成 |
| AI辅助审核 | 🔴 未开始 | 图片识别/大模型审核 |
| OCR/DAN报告解析 | 🔴 未开始 | 拍照上传自动解析 |
| 支付回调 | 🔴 未开始 | 微信支付真实回调 |
| 语音鼓励 | 🔴 未开始 | 专注训练语音 |
| 主题皮肤 | 🔴 未开始 | 多主题切换 |
| 多角色管理(邀请码) | 🔴 未开始 | 家长协作 |
| 数据导出 | 🔴 未开始 | Excel/报告导出 |
| 微信支付集成 | 🔴 未开始 | 真实商户号配置 |

---

## 3. 已完成功能清单

### 3.1 任务管理模块

| 需求编号 | 功能描述 | 优先级 | 状态 |
|----------|----------|--------|------|
| TASK-001 | 家长可创建任务，设置任务名称 | P0 | ✅ |
| TASK-002 | 设置任务积分值（1-10分，默认2分） | P0 | ✅ |
| TASK-003 | 设置任务截止时间（精确到分钟） | P0 | ✅ |
| TASK-004 | 设置任务重复周期（每日/每周/自定义） | P1 | ✅ |
| TASK-005 | 设置任务分类（学习/生活/运动/游戏/其他） | P0 | ✅ |
| TASK-006 | 支持任务备注/说明 | P2 | ✅ |
| TASK-007 | 预设任务模板快速创建 | P1 | ✅ |
| TASK-008 | 孩子可查看今日任务列表 | P0 | ✅ |
| TASK-009 | 孩子点击"完成"按钮提交任务 | P0 | ✅ |
| TASK-010 | 提前完成奖励机制（额外+1分） | P0 | ✅ |
| TASK-011 | 超时判断（10分钟内不算迟到） | P0 | ✅ |
| TASK-012 | 超时扣分机制（每天最多扣5分，可关闭） | P0 | ✅ |
| TASK-012A | 打卡支持照片上传 | P0 | ✅ |
| TASK-012B | 打卡支持视频上传 | P0 | ✅ |
| TASK-012C | 打卡支持录音上传 | P0 | ✅ |
| TASK-012D | 打卡支持文字描述 | P0 | ✅ |
| TASK-012E | 打卡支持倒计时功能 | P0 | ✅ |
| TASK-012F | 倒计时结束时语音提醒 | P0 | ✅ |
| TASK-013 | 部分任务需家长审核确认 | P1 | ✅ |
| TASK-013A | 家长自定义需要审核的任务范围（按分类/按任务） | P1 | ✅ |
| TASK-013B | 审核方式：拍照上传完成凭证 | P1 | ✅ |
| TASK-014 | 任务历史记录查看 | P0 | ✅ |
| TASK-015 | 任务完成情况统计 | P0 | ✅ |
| TASK-016 | 任务编辑、删除、暂停 | P0 | ✅ |
| REVIEW-006 | 审核记录留存，可追溯 | P2 | ✅ |

### 3.2 积分系统模块

| 需求编号 | 功能描述 | 优先级 | 状态 |
|----------|----------|--------|------|
| POINT-001 | 完成任务获得基础积分 | P0 | ✅ |
| POINT-002 | 超额完成获得额外积分 | P0 | ✅ |
| POINT-003 | 专注训练满分获得额外积分 | P1 | ✅ |
| POINT-004 | 连续打卡奖励机制 | P1 | ✅ |
| POINT-005 | 手动调整积分（家长操作，需密码） | P2 | ✅ |
| POINT-006 | 超时10分钟以内不算迟到（保护机制） | P0 | ✅ |
| POINT-007 | 每天最多扣5分（破产保护） | P0 | ✅ |
| POINT-008 | 扣分功能按年龄配置 | P0 | ✅ |
| POINT-008A | 家长可手动调整扣分开关 | P0 | ✅ |
| POINT-009 | 积分不清零，可设置积分有效期 | P0 | ✅ |
| POINT-009A | 每月提醒有哪些积分快过期 | P0 | ✅ |
| POINT-010 | 过期未领取积分失效 | P0 | ✅ |

### 3.3 奖励体系模块

| 需求编号 | 功能描述 | 优先级 | 状态 |
|----------|----------|--------|------|
| REWARD-001 | 孩子可添加想要的奖励到心愿单 | P0 | ✅ |
| REWARD-001A | 家长填写所需积分后心愿进入奖励库 | P0 | ✅ |
| REWARD-002 | 奖励设置名称、所需积分、分类 | P0 | ✅ |
| REWARD-002A | 家庭奖励库（多个家长都可调整） | P0 | ✅ |
| REWARD-002B | 多孩子心愿单隔离 | P0 | ✅ |
| REWARD-003 | 奖励分类：物质类/精神类/特权类 | P0 | ✅ |
| REWARD-003A | 家长可自定义奖励分类名称和图标 | P1 | ✅ |
| REWARD-004 | 进度条显示（已攒积分/所需积分） | P0 | ✅ |
| REWARD-005 | 家长审批奖励兑换 | P0 | ✅ |
| REWARD-006 | 奖励模板即奖励库 | P0 | ✅ |
| REWARD-007 | 奖励兑换历史记录 | P1 | ✅ |
| REWARD-008 | 奖励下架/编辑功能 | P2 | ✅ |

### 3.4 角色与模式切换模块

| 需求编号 | 功能描述 | 优先级 | 状态 |
|----------|----------|--------|------|
| MODE-001 | 家长模式：发布任务、审批奖励、查看报告 | P1 | ✅ |
| MODE-002 | 孩子模式：查看任务、完成任务、查看积分 | P0 | ✅ |
| MODE-003 | 密码切换模式（4位数字密码） | P0 | ✅ |
| MODE-004 | 首次使用引导设置密码 | P0 | ✅ |
| MODE-005 | 家长邀请码机制（其他家长加入） | P1 | ✅ |
| MODE-006 | 角色权限区分（管理员/普通家长/孩子） | P0 | ✅ |
| MODE-007 | 孩子信息管理（支持多孩） | P0 | ✅ |
| MODE-008 | 孩子账号停用功能 | P0 | ✅ |
| MODE-009 | 停用的孩子不可登录且不可被切换 | P0 | ✅ |
| MODE-010 | 成长规划师注册与审核 | P2 | ✅ |
| MODE-011 | 家长任务支持与孩子相同的完成方式 | P1 | ✅ |
| MODE-012 | 谁制定任务谁审核；孩子任务可指定审核人 | P1 | ✅ |
| MODE-013 | 多个家长都可审核孩子任务 | P1 | ✅ |

### 3.5 激励模块

| 需求编号 | 功能描述 | 优先级 | 状态 |
|----------|----------|--------|------|
| STREAK-001 | 首页显示连续完成任务天数 | P0 | ✅ |
| STREAK-002 | 火苗图标+天数组合显示 | P0 | ✅ |
| STREAK-003 | 连续打卡中断自动重置 | P0 | ✅ |
| STREAK-004 | 连续打卡里程碑奖励（3/7/30/100天） | P1 | ✅ |

| 需求编号 | 功能描述 | 优先级 | 状态 |
|----------|----------|--------|------|
| BADGE-001 | 首次完成任务勋章 | P1 | ✅ |
| BADGE-002 | 连续3天按时完成勋章 | P1 | ✅ |
| BADGE-003 | 一周获得50积分勋章 | P1 | ✅ |
| BADGE-004 | 完成100个任务勋章 | P1 | ✅ |
| BADGE-005 | 勋章解锁动画/特效 | P2 | ✅ |
| BADGE-006 | 勋章展示墙界面 | P1 | ✅ |

### 3.6 专注训练模块

| 需求编号 | 功能描述 | 优先级 | 状态 |
|----------|----------|--------|------|
| FOCUS-001 | 简单模式：10/15/20分钟可选 | P1 | ✅ |
| FOCUS-002 | 番茄钟模式：25分钟+5分钟休息 | P1 | ✅ |
| FOCUS-003 | 大字体倒计时圆环显示 | P1 | ✅ |
| FOCUS-004 | 训练中禁止退出（可选，需家长开启） | P1 | ✅ |
| FOCUS-004A | 计时方式：手机倒计时（孩子自行控制） | P1 | ✅ |
| FOCUS-005 | 完成后自评1-5颗星 | P1 | ✅ |
| FOCUS-006 | 获得积分数=星数（1-5分） | P1 | ✅ |
| FOCUS-007 | 满分5星额外奖励+1分 | P1 | ✅ |
| FOCUS-008 | 每日训练次数上限（默认3次，可配置） | P1 | ✅ |

### 3.7 主题皮肤模块

| 需求编号 | 功能描述 | 优先级 | 状态 |
|----------|----------|--------|------|
| THEME-001 | 默认主题 | P1 | ✅ |

### 3.8 小游戏模块

| 需求编号 | 功能描述 | 优先级 | 状态 |
|----------|----------|--------|------|
| GAME-001 | 数独游戏 | P2 | ✅ |
| GAME-002 | 舒尔特方格（注意力训练） | P2 | ✅ |
| GAME-003 | 1A2B猜数字 | P2 | ✅ |
| GAME-004 | 游戏列表页面 | P2 | ✅ |

### 3.9 DAN测评记录模块

| 需求编号 | 功能描述 | 优先级 | 状态 |
|----------|----------|--------|------|
| DAN-001 | 通过接口获取DAN测评数据 | P1 | ✅ |
| DAN-002 | 测评记录存储与历史查看 | P1 | ✅ |
| DAN-003 | 测评记录与任务模板关联 | P1 | ✅ |
| DAN-013 | 根据DAN等级生成推荐任务列表 | P1 | ✅ |
| DAN-014 | 家长可编辑/调整模板任务 | P1 | ✅ |
| DAN-015 | 一键启用模板生成今日任务 | P1 | ✅ |

### 3.10 测评订单与预约系统（新增完成）

| 需求编号 | 功能描述 | 优先级 | 状态 |
|----------|----------|--------|------|
| ORDER-001 | 家长申请测评（选择规划师+预约时间） | P0 | ✅ |
| ORDER-002 | 孩子信息快照（身高/体重/学校等） | P0 | ✅ |
| ORDER-003 | 测评订单创建与支付 | P0 | ✅ |
| ORDER-004 | 规划师确认预约 | P0 | ✅ |
| ORDER-005 | 规划师录入测评结果（DAN等级+报告） | P0 | ✅ |
| ORDER-006 | 家长查看测评报告 | P0 | ✅ |
| ORDER-007 | 家长端预约状态查看 | P0 | ✅ |
| ORDER-008 | 规划师端预约管理 | P0 | ✅ |

### 3.11 成长规划师端

| 需求编号 | 功能描述 | 优先级 | 状态 |
|----------|----------|--------|------|
| GUIDE-001 | 规划师注册（直接注册/家长申请） | P1 | ✅ |
| GUIDE-002 | 套餐选择与购买 | P1 | ✅ |
| GUIDE-004 | 申请状态查看 | P1 | ✅ |
| GUIDE-005 | 管理员审核申请（通过/拒绝） | P1 | ✅ |
| GUIDE-009 | 家庭列表查看（以家庭为单位） | P1 | ✅ |
| GUIDE-010 | 家庭详情查看（成员信息、任务完成情况） | P1 | ✅ |
| GUIDE-011 | 规划师身份切换为家长 | P1 | ✅ |
| GUIDE-WEB-001 | Web端工作台 | P1 | ✅ |
| GUIDE-WEB-002 | Web端家庭管理 | P1 | ✅ |
| GUIDE-WEB-003 | Web端团队管理 | P1 | ✅ |
| GUIDE-WEB-004 | Web端套餐管理 | P1 | ✅ |
| GUIDE-WEB-005 | Web端订单佣金 | P1 | ✅ |
| GUIDE-WEB-006 | Web端测评管理 | P1 | ✅ |
| GUIDE-WEB-007 | Web端消息中心 | P1 | ✅ |

### 3.12 Web管理端

| 需求编号 | 功能描述 | 优先级 | 状态 |
|----------|----------|--------|------|
| ADMIN-001 | 管理员首页/仪表板 | P0 | ✅ |
| ADMIN-002 | 家庭管理（列表/孩子/积分） | P0 | ✅ |
| ADMIN-003 | 任务管理（列表/模板） | P0 | ✅ |
| ADMIN-004 | 奖励管理 | P0 | ✅ |
| ADMIN-005 | 用户管理 | P0 | ✅ |
| ADMIN-006 | 成长规划师管理（套餐/审核/咨询） | P1 | ✅ |
| ADMIN-007 | 测评管理 | P1 | ✅ |
| ADMIN-008 | 服务类型/内容/套餐模板管理 | P1 | ✅ |
| ADMIN-009 | 操作日志 | P1 | ✅ |
| ADMIN-010 | 双角色侧边栏（admin + teacher布局） | P0 | ✅ |
| ADMIN-011 | 路由权限守卫（角色分流） | P0 | ✅ |

### 3.13 数据迁移

| 需求编号 | 功能描述 | 优先级 | 状态 |
|----------|----------|--------|------|
| MIGRATE-001 | sfms 多数据源配置 | P0 | ✅ |
| MIGRATE-002 | 家庭/用户迁移 | P0 | ✅ |
| MIGRATE-003 | 孩子/规划师迁移 | P0 | ✅ |
| MIGRATE-004 | 订单/测评结果/成长档案迁移 | P0 | ✅ |

### 3.14 安全与基础设施

| 需求编号 | 功能描述 | 优先级 | 状态 |
|----------|----------|--------|------|
| SEC-001 | 敏感词过滤 | P0 | ✅ |
| SEC-002 | JWT认证拦截 | P0 | ✅ |
| SEC-003 | 操作日志记录 | P1 | ✅ |
| SEC-004 | 四级地址结构（省市区街道） | P1 | ✅ |
| SEC-005 | 孩子快照（测评时保存身高/体重/学校等动态数据） | P0 | ✅ |

---

## 4. 待完成功能（按优先级排序）

### P0 — 核心链路必须（当前开发重点）

| 需求编号 | 功能描述 | 涉及模块 | 前置依赖 |
|----------|----------|----------|----------|
| PAY-001 | 微信支付真实回调处理 | 后端 | 微信商户号配置 |
| PAY-002 | 支付成功后续流程（通知/状态更新） | 后端 | PAY-001 |

### P1 — 增强功能

| 需求编号 | 功能描述 | 涉及模块 | 前置依赖 |
|----------|----------|----------|----------|
| REPORT-001 | 每周自动生成报告 | 后端+小程序 | 无 |
| REPORT-002 | 展示内容：完成任务数、按时完成率 | 后端+小程序 | REPORT-001 |
| REPORT-003 | 展示内容：与上周对比（进步/退步） | 后端+小程序 | REPORT-001 |
| REPORT-004 | 展示内容：表现最佳日期 | 后端+小程序 | REPORT-001 |
| REPORT-005 | 周报推送通知（可选） | 后端+小程序 | REPORT-001 |
| REVIEW-001 | 任务需要审核时，孩子拍照上传完成凭证 | 后端+小程序 | AI服务配置 |
| REVIEW-002 | AI自动识别照片内容，判断完成质量 | AI服务 | 大模型API |
| REVIEW-003 | AI给出审核建议（三档：通过/疑似/需人工确认） | AI服务 | REVIEW-002 |
| REVIEW-004 | 家长可选AI审核或手动审核（AI仅付费会员） | 后端+小程序 | REVIEW-002 |
| REVIEW-005 | 家长可修改AI审核结果 | 后端+小程序 | REVIEW-002 |
| REVIEW-007 | AI审核阈值可自定义（严格/一般/宽松） | 后端+小程序 | REVIEW-002 |
| GUIDE-003 | 付款凭证上传 | 小程序 | 无 |
| GUIDE-006 | 规划师等级查看 | 小程序 | 无 |
| GUIDE-007 | 升级服务购买（升中级/直升高级/升高级） | 小程序 | 无 |
| GUIDE-008 | 升级可见性控制（根据当前等级显示对应选项） | 小程序 | 无 |
| GUIDE-012 | 规划师不能切换为孩子 | 小程序 | 无 |
| ORDER-009 | 测评预约家长端入口（首页快捷入口） | 小程序 | 无 |
| VOICE-001 | 语音转文字：用于AI审核时识别孩子语音说明 | AI服务 | 语音API |

### P2 — 增值功能

| 需求编号 | 功能描述 | 涉及模块 | 前置依赖 |
|----------|----------|----------|----------|
| THEME-002~006 | 阳光橙/恐龙探险/太空冒险/梦幻城堡/海洋世界主题 | 小程序 | 无 |
| EXPORT-001 | 任务历史导出（Excel格式） | 后端+小程序 | 无 |
| EXPORT-002 | 错题本图片生成 | 后端+小程序 | 无 |
| EXPORT-003 | 成长周报导出 | 后端+小程序 | REPORT-001 |
| GAME-005 | 推理训练游戏（找规律） | 小程序 | 无 |
| GAME-006 | 空间训练游戏（图形拼接） | 小程序 | 无 |
| GAME-007 | 反应训练游戏（记忆翻牌） | 小程序 | 无 |

---

## 5. 角色与权限矩阵

| 角色 | 可登录端 | 核心权限 |
|------|----------|----------|
| **管理员** | Web管理端 | 全部系统管理、配置、审核 |
| **成长规划师** | Web管理端 + 小程序 | 查看家庭、管理测评、录入结果、套餐管理 |
| **家长** | 小程序 | 发布任务、审批奖励、申请测评、查看成长档案 |
| **孩子** | 小程序 | 查看任务、完成任务、查看积分、兑换奖励 |

### 规划师特殊规则
- 规划师可切换为家长身份（再切换到孩子），但不能直接用规划师身份切换为孩子
- 规划师数据范围：以家庭为单位查看，进入家庭后才可见成员和任务详情
- 规划师等级：初级/中级/高级，升级服务根据当前等级动态可见

---

## 6. 优先级总结

### 第一阶段：P0 (已完成)
- ✅ 任务管理（创建/执行/审核/历史统计）
- ✅ 积分系统（含年龄分级扣分、有效期）
- ✅ 奖励/心愿单（含自定义分类、多孩子隔离、家庭奖励库）
- ✅ 双模式切换（含密码保护、规划师角色）
- ✅ 多孩支持
- ✅ 连续打卡 + 勋章墙
- ✅ 专注训练
- ✅ DAN测评记录 + 任务模板
- ✅ 测评订单与预约（完整P0链路）
- ✅ 成长规划师Web端（7页面+路由权限）
- ✅ 数据迁移（sfms多数据源 + 全量迁移）
- ✅ 基础安全（敏感词过滤/JWT/操作日志）

### 第二阶段：P1 (待完成)
- 成长周报（每周统计报告）
- AI辅助审核（大模型API调用）
- 规划师付款凭证上传 + 等级查看 + 升级
- 微信支付真实回调集成

### 第三阶段：P2 (未来规划)
- 多主题皮肤
- 数据导出
- 更多小游戏
- 语音功能增强

---

## 7. 关键概念定义

| 概念 | 定义 | 备注 |
|------|------|------|
| **DAN测评** | 素质能力测评体系 | A1-B6共9个等级 |
| **孩子快照** | 测评时保存的孩子动态信息 | 身高/体重/学校/年级等 |
| **测评订单** | 家长申请→规划师确认→支付→录入结果 | 完整B2B2C链路 |
| **成长规划师** | 经认证的专业服务人员 | 可切换家长身份 |
| **双培强基工程** | 青少年教育项目 | 通过科技、数据、AI、心理科学揭示成长规律 |

---

## 8. 验收标准

### 8.1 已完成的P0验收

| 功能 | 验收条件 | 状态 |
|------|----------|------|
| 任务发布与执行 | 家长创建任务，孩子完成，积分自动变动 | ✅ |
| 积分系统 | 加减分规则正确，年龄分级开关生效，流水可查 | ✅ |
| 奖励兑换 | 孩子添加心愿→家长审批→扣减积分 | ✅ |
| 模式切换 | 家长/孩子/规划师密码切换正常 | ✅ |
| 测评申请 | 选择规划师→填写信息→支付→查看报告，流程完整 | ✅ |
| 预约管理 | 规划师确认/录入结果，家长查看状态 | ✅ |
| 数据迁移 | curl POST /api/migration/run 执行全量迁移 | ✅ |
| Web侧边栏 | 管理员和规划师看到不同的菜单 | ✅ |

*本文档版本 V2.0，已完成功能与待完成功能分离。后续随开发进展持续更新。*