需求分析文档.md 19 KB

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

版本信息

版本 日期 作者 变更说明
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,已完成功能与待完成功能分离。后续随开发进展持续更新。