03-child.md 5.3 KB

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

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

统一口径:新版不再使用「孩子」概念做数据隔离,而是「能登录用户 / 不能登录用户」。 能登录用户: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