03-child.md 12 KB

用户使用场景 · 孩子(Child)

来源:AGENTS.md(能登录/不能登录用户统一口径、双角色铁律:孩子端不能切家长)、API_REFERENCE.md、cfc-frontend/pages/*、黑盒方案 C-01~C-09。 关联用例:test-cases/child.md(TC-C-01~TC-C-25,含五维变化专项)。

统一口径:新版不再使用「孩子」概念做数据隔离,而是「能登录用户 / 不能登录用户」。 能登录用户:family_members.userId 非空且关联 User 有 openid;不能登录用户:由同家庭能登录用户代管其数据。 本文件「孩子」指被照护对象(通常为不能登录用户,由家长代管;也有能登录的子账号)。


场景 C-1:孩子端登录(无家长入口)

用户故事:作为孩子,我想用自己的账号进入专属界面,并且看不到任何切换家长的入口。

  • 角色:孩子(能登录用户)
  • 前置条件:已为孩子创建可登录账号(或由家长代管)。
  • 主流程
    1. 孩子独立登录 → 直接进入孩子端首页。
    2. 界面不出现「切换家长」入口(双角色铁律)。
  • 异常/边界:即便 URL 直接拼家长路由也被 role 校验拦截;不能登录用户无法自行登录,由家长代管。
  • 关联需求/设计:双角色铁律:直接登录的孩子端不能切换到家长端;role 由 @RequestAttribute("role") 判定。
  • 关联用例:TC-C-01

场景 C-2:执行任务并提交完成

用户故事:作为孩子,我想完成家长布置的任务并提交,以便获得积分。

  • 角色:孩子
  • 前置条件:家长已下发任务「睡前阅读」到孩子 B。
  • 主流程
    1. 打开待执行任务 → 点击「完成」提交。
    2. 任务状态变为「待家长审核」;完成动作写入记录。
  • 异常/边界:重复提交不重复计分;未到可执行时间/频率限制时提交被拦截。
  • 关联需求/设计:TaskController /api/tasks(完成/审核)。
  • 关联用例:TC-C-02

场景 C-3:玩小游戏并获得积分/能量

用户故事:作为孩子,我想玩舒尔特方格等小游戏,以便边玩边涨能量。

  • 角色:孩子
  • 前置条件:小游戏入口可见。
  • 主流程
    1. 打开舒尔特方格并完成。
    2. 得分按规则计算 → 积分/能量发放到账。
    3. 成绩入排行榜。
  • 异常/边界:中途退出不计分;作弊/异常分数被校验。
  • 关联需求/设计:cfc-frontend/pages/games/*、mini-games e2e。
  • 关联用例:TC-C-03

场景 C-4:创建并兑换心愿

用户故事:作为孩子,我想提心愿、审批通过后兑换奖励。

  • 角色:孩子(创建)/ 家长(审批)
  • 前置条件:孩子已创建心愿「乐高机器人」。
  • 主流程
    1. 创建心愿(名称 + 积分)→ 进入家长待审批。
    2. 家长通过后,孩子操作「兑换」。
    3. 兑换成功,积分扣减正确。
  • 异常/边界:积分不足兑换拦截;驳回后不可兑换。
  • 关联需求/设计:WishController /api/wishes。
  • 关联用例:TC-C-04, TC-C-05

场景 C-5:查看自己的五维能量

用户故事:作为孩子,我想看到自己的能量值变化,以便有成就感。

  • 角色:孩子
  • 前置条件:已有任务/打卡能量记录。
  • 主流程
    1. 进入个人能量页 → 显示个人能量值。
    2. 执行任务后能量有增量,流水可追溯。
  • 异常/边界:能量不为负;跨维度比例合理。
  • 关联需求/设计:EnergyController /api/energy。
  • 关联用例:TC-C-06

场景 C-6:只读查看健康报告

用户故事:作为孩子,我想查看家长上传的报告,但不应有权限编辑或删除。

  • 角色:孩子
  • 前置条件:家长已上传报告。
  • 主流程
    1. 打开报告列表 → 查看报告详情(菌群健康分/菌种/风险)。
    2. 界面无编辑/删除入口。
  • 异常/边界:直接调用删除接口应被 role 校验拒绝(403/401)。
  • 关联需求/设计:健康报告查看权限按角色隔离。
  • 关联用例:TC-C-07

场景 C-7:执行方案任务并打卡

用户故事:作为孩子,我想完成方案生成的训练任务并打卡,以便推进方案进度。

  • 角色:孩子
  • 前置条件:规划师已激活方案,生成「舒尔特方格训练」等任务。
  • 主流程
    1. 打开方案任务 → 完成并提交。
    2. 打卡成功 → 方案 completedDays +1。
  • 异常/边界:未完成任务打卡被拦截;重复打卡不重复计数(幂等)。
  • 关联需求/设计:健康打卡 HealthCheckinController/DailyCheckinController;方案进度字段。
  • 关联用例:TC-C-08

场景 C-8:查看勋章墙

用户故事:作为孩子,我想看已获得和未获得的勋章及进度。

  • 角色:孩子
  • 前置条件:已有部分成就记录。
  • 主流程
    1. 打开勋章墙 → 显示已获得/未获得勋章及进度。
  • 异常/边界:未解锁勋章不显示领取按钮;达到条件自动点亮。
  • 关联需求/设计:RewardController 勋章;管理端可创建勋章。
  • 关联用例:TC-C-09

场景 C-9:勋章解锁提醒(SC-C-10)

用户故事:作为孩子,我想在达成勋章条件时收到解锁提醒,以便及时获得正反馈。

  • 角色:孩子
  • 前置条件:已达成某项勋章条件(任务/打卡聚合)。
  • 主流程
    1. 达成条件 → 系统解锁勋章。
    2. 推送解锁提醒(站内消息/弹窗)。
  • 异常/边界:重复达成不重复发放(幂等);勋章来自任务/打卡聚合,数据缺失不误发。
  • 关联需求/设计:MedalController;推送。
  • 关联用例:TC-C-10

场景 C-10:成长记录查看(孩子视角)(SC-C-11)

用户故事:作为孩子,我想看自己的成长时间线,以便回顾进步。

  • 角色:孩子
  • 前置条件:已有成长记录。
  • 主流程
    1. 打开成长记录 → 时间线(任务/测评/报告/打卡)→ 只读。
  • 异常/边界:仅本人数据;数据缺失项跳过不报错。
  • 关联需求/设计:GrowthController。
  • 关联用例:TC-C-11

场景 C-11:饮食食谱查看(SC-C-12)

用户故事:作为孩子,我想看今日家庭食谱,以便知道吃什么。

  • 角色:孩子
  • 前置条件:家庭已有今日食谱。
  • 主流程
    1. 打开食谱页 → 当日三餐展示。
  • 异常/边界:无食谱显示空态(不白屏);忌口/过敏标注。
  • 关联需求/设计:饮食推荐。
  • 关联用例:TC-C-12

场景 C-12:AI 对话(孩子视角)(SC-C-13)

用户故事:作为孩子,我想问 AI 成长问题,以便得到适龄回答。

  • 角色:孩子
  • 前置条件:AI 服务可用。
  • 主流程
    1. 进对话 → 发送问题 → 多轮上下文回答。
  • 异常/边界:内容适龄过滤;LangGraph 不可用降级提示;敏感问题不泄露隐私。
  • 关联需求/设计:AIChatController;AiGateway。
  • 关联用例:TC-C-13

场景 C-13:任务驳回重做(SC-C-14)

用户故事:作为孩子,我想在被驳回后重做任务,以便修正后再次提交。

  • 角色:孩子
  • 前置条件:任务被家长/规划师驳回。
  • 主流程
    1. 查看驳回原因 → 重做 → 再次提交。
  • 异常/边界:驳回后可重做;重复提交幂等;超出次数限制提示。
  • 关联需求/设计:TaskController。
  • 关联用例:TC-C-14

场景 C-14:消息接收(SC-C-15)

用户故事:作为孩子,我想接收家长/规划师消息并标记已读,以便及时了解安排。

  • 角色:孩子
  • 前置条件:有未读消息。
  • 主流程
    1. 打开消息列表 → 查看 → 标记已读。
  • 异常/边界:越权消息不可见;分页正确。
  • 关联需求/设计:消息服务。
  • 关联用例:TC-C-15

场景 C-15:个人资料查看(受限)(SC-C-16)

用户故事:作为孩子,我想看自己的资料,以便了解账号信息。

  • 角色:孩子
  • 前置条件:已登录。
  • 主流程
    1. 打开资料页 → 只读展示(昵称/头像/生日)。
  • 异常/边界:敏感字段由家长代管;孩子端不可修改核心字段。
  • 关联需求/设计:AuthController。
  • 关联用例:TC-C-16

场景 C-16:退出登录(SC-C-17)

用户故事:作为孩子,我想安全退出,以便保护设备隐私。

  • 角色:孩子
  • 前置条件:已登录。
  • 主流程
    1. 点击退出 → 清除本地 token 与缓存 → 回登录页。
  • 异常/边界:退出后敏感缓存清除;退出后访问受保护接口 401。
  • 关联需求/设计:AuthController。
  • 关联用例:TC-C-17

场景 C-17:设备/账号绑定校验(SC-C-18)

用户故事:作为孩子,我想在异常设备登录时被校验,以便防冒用。

  • 角色:孩子
  • 前置条件:新设备登录。
  • 主流程
    1. 登录时设备校验 → 正常设备放行。
    2. 异常设备触发二次验证/限制。
  • 异常/边界:异常设备风控提示;绑定校验失败拒登录。
  • 关联需求/设计:AuthController;设备绑定。
  • 关联用例:TC-C-18

场景 C-18:查看家人/规划师消息通知(SC-C-19)

用户故事:作为孩子,我想收家人/规划师的通知,以便不遗漏安排。

  • 角色:孩子
  • 前置条件:有通知。
  • 主流程
    1. 打开消息/通知列表 → 查看 → 已读。
  • 异常/边界:越权消息不可见;分页。
  • 关联需求/设计:消息服务。
  • 关联用例:TC-C-19

场景 C-19:成长档案查看/家长代导出(SC-C-20)

用户故事:作为孩子,我想看自己档案并由家长代导出,以便合规留存。

  • 角色:孩子(导出需家长代办)
  • 前置条件:已有成长档案。
  • 主流程
    1. 打开档案页 → 只读查看。
    2. 导出需家长发起(未成年人受限)。
  • 异常/边界:未成年人导出受限,需家长代办;越权导出拒。
  • 关联需求/设计:GrowthController;数据导出(GDPR)。
  • 关联用例:TC-C-20

场景 C-20:舌诊/情绪自拍采集(孩子端)(SC-C-21)

用户故事:作为孩子,我想拍照上传舌苔,以便辅助健康评估。

  • 角色:孩子
  • 前置条件:拍照权限已授权。
  • 主流程
    1. 拍照/上传 → 识别情绪标签 → 关联测评。
  • 异常/边界:模糊/非照片拒绝;隐私标注不外露。
  • 关联需求/设计:舌诊情绪识别。
  • 关联用例:TC-C-21

场景 C-21:商城浏览/积分兑换(孩子端消费)(SC-C-22)

用户故事:作为孩子,我想用积分在商城兑换,以便用行动换奖励。

  • 角色:孩子
  • 前置条件:有足够积分;商品上架。
  • 主流程
    1. 浏览商品 → 选择积分兑换 → 扣减积分 → 兑换成功。
  • 异常/边界:积分不足拦截;重复兑换幂等;下架商品不可兑。
  • 关联需求/设计:MallController;积分体系。
  • 关联用例:TC-C-22

场景 C-22:意见反馈(孩子端)(SC-C-23)

用户故事:作为孩子,我想提交反馈,以便问题被听见。

  • 角色:孩子
  • 前置条件:已登录。
  • 主流程
    1. 提交反馈(内容/类型)→ 进入客服队列。
  • 异常/边界:内容适龄过滤;敏感信息脱敏;附件大小限制。
  • 关联需求/设计:客服;/api/feedback。
  • 关联用例:TC-C-23

注:SC-C-24(小游戏/任务得分触发五维增长)与 SC-C-25(方案任务打卡触发五维增长)属「五维指标变化专项」,完整叙事见 07-five-dimension.md(ED 专项),对应用例 TC-C-24 / TC-C-25。