# 今日行动公共页面与结算 PRD

## 1. 入口与详情

主流程：上级活动页→今日行动→行为详情→设备准备（按需）→执行→结果→今日行动。

| 字段 | 类型 | 规则 |
|---|---|---|
| catalogKey | string | 行为配置键；用于页面、素材及单项规则映射，不代替完成去重身份 |
| sourceRoute | 路由引用 | 从上级活动页进入时保存；今日行动左上返回原上级页面 |
| dailyBehaviorIds | string[] | 服务返回的每日10个不同行为身份及顺序；开发查看页的全库分类不改变每日推荐数量 |
| selectedDate | string，`YYYY-MM-DD` | 当前查看的业务日期；默认服务端今天，切换日期时加载对应记录 |
| behaviorId | string | 服务完成去重身份；正式开始前必填 |
| variantId | string | 行为呈现及规则配置身份；正式开始前必填 |
| behaviorName | string | 用户可读名称 |
| categoryId | enum | `attention / memory / logic / relaxation / physical_capacity / agility` |
| durationLabel | string | 单一预计用时，如`45秒`；不含“约”“最长”、范围或试玩后缀，不参与执行计时 |
| illustration | 资源引用 | 行为卡片和详情配图；保持必要动作、图形或物品完整可辨 |
| science.shared | string | 入口与详情共用的同一段文案 |
| science.completion | string | 完成结果正文；不显示“科学收获”标题 |
| steps | string[] | 具体方法，按顺序常驻展开 |
| deviceRequirements | array | 所需设备、权限与准备要求；为空时不出现准备页 |
| rewardType | enum | 脑力为`inspiration`（灵感），体力为`energy`（元气） |
| rewardAmount | integer或null | 读取[奖励配置总表](https://fuguang-design.pages.dev/daily-island/prd/rewards.html)；null不表示0，未配置时禁止产生奖励事务 |
| completionPolicy | 规则配置 | 单项自然结束、参与或动作完成条件；播放进度、正确数量与业务资格分别处理 |
| enabled | boolean | 正式列表是否允许开始；身份、必要动作参数、素材或完成条件缺失时为false |

| 今日行动区域 | 内容与位置 |
|---|---|
| 页首 | 左返回上级活动页，标题“今日行动”，下方“完成 3 项行动” |
| 日期条 | 业务日期及当日记录状态 |
| 行为列表 | 纵向滚动；卡片左配图，文字区上行左名称、右预计用时，下行共用文案；右侧资源图标和完成状态 |
| 底部进度 | 服务返回的`completedCount/3`与三个进度位，不遮挡列表末项 |

| 详情区域 | 内容与位置 |
|---|---|
| 页首 | 左返回今日行动，标题行为名称；已完成时显示首次完成时间 |
| 内容区 | 配图→“行为说明”及`science.shared`→“怎么做”及`steps`；内容超高可滚动，方法不折叠 |
| 底部固定区 | 依据下表显示主操作；正文不得被按钮遮挡 |

| 详情状态 | 底部操作及去向 |
|---|---|
| 今日未完成，进度小于3，配置有效 | 无设备准备：“开始行动”；有设备准备：“准备开始”。创建会话成功后进入对应页 |
| 开始请求处理中 | 开始按钮禁用，避免重复创建会话；成功后跳转，失败原位显示原因并可重试 |
| 今日未完成，进度为3 | 禁用按钮“今天已完成 3 项行动” |
| 今日已完成 | 并排双按钮：左“查看结果”，右“再练一次” |
| 奖励处理中或待查询 | 仍使用上述双按钮；查询奖励只在结果页回执区域提供 |
| 配置无效或行为关闭 | 禁用按钮“暂不可用”，显示影响开始的具体原因 |

返回列表保持滚动位置，刷新完成记录、奖励状态与今日进度。

| 日期及卡片状态 | 显示与操作 |
|---|---|
| 当日完成0项 | 日期位空心圆 |
| 当日完成1—2项 | 日期位半圆 |
| 当日完成3项 | 日期位带勾实心圆；当前选中日期另有描边 |
| 历史日期已完成行为 | 只读详情，显示所选业务日及首次完成时间；仅提供“查看当日完成结果”，无开始或重练 |
| 历史日期未完成行为 | 卡片置灰且不可点击 |
| 未来日期 | 显示日期数字，不提供行为开始入口 |
| 返回今天 | 恢复今日列表的滚动位置、完成状态与可操作入口 |
| 当日已完成且奖励未到账 | 卡片显示“已完成 · 奖励处理中”或“已完成 · 奖励待查询”，资源图标变暗；进入详情后由“查看结果”查询 |

## 2. 设备准备与执行容器

| 准备状态 | 画面、操作及去向 |
|---|---|
| 无设备要求 | 直接进入执行；局内倒数属于执行状态 |
| 未授权 | 说明本行为所需权限；“开启摄像头”调用系统授权；返回行为详情 |
| 拒绝授权 | 显示当前权限状态；提供系统设置入口及返回详情 |
| 入镜不满足 | 根据单项规则提示距离、站位、关键部位或手机摆放；不累计次数或保持时间 |
| 就绪 | 必要部位与支撑关系可见；“开始练习”进入执行 |
| 相机不可用 | 显示原因，提供重试和返回详情 |

| 执行区域 | 固定职责 |
|---|---|
| 左上 | “退出” |
| 右上 | 声音开关及单项必要控制；静音不隐藏字幕、提示、正误或状态 |
| 标题 | 行为名称 |
| 当前提示 | 脑力统一在标题下、玩法区上方；体力提示按单项定义的安全区显示，不能遮挡动作和必要支撑物 |
| 主画面 | 单项玩法、相机反馈或视频；不把技术参数、研究过程或版本信息放入用户画面 |
| 进度区 | 仅显示单项定义的轮次、次数、阶段或剩余时间；字段为空时隐藏 |

正确数量只显示实际数量，不转换为游戏分、百分比或资源金额。身体动作计次必须符合单项完整周期；计时和动画不得自行补算动作。没有识别或确认信号时，只能显示“示范进度”或“引导结束”。

## 3. 退出、中断与重练

| 条件 | 确认层与处理 | 去向 |
|---|---|---|
| 未满足单项完成条件，点退出 | 标题“结束本次行动？”；正文“结束后，本局进度将清除。”；左“继续行动”，右“结束本次” | 继续按单项恢复点返回执行；结束清本局并返回今日行动 |
| 重练中退出 | 同上，正文追加“首次完成记录保持不变。” | 只清本次会话，不覆盖首次表现、完成记录或回执 |
| 自然结束但参与不足，在收束中退出 | 沿未完成退出确认；不提交完成事件 | 继续恢复剩余收束，结束返回列表 |
| 已满足单项完成条件，在收束中退出 | 标题“本局已结束”；正文“本局练习结果已保留，可以继续查看。”；左“继续行动”，右“查看完成结果” | 继续恢复剩余收束；查看结果读取或查询同一请求 |
| 未完成时进入后台、锁屏或系统终止 | 按单项规则结束并清理本次过程，不在后台计超时、补动作或记完成 | 回前台返回列表，重新开始创建新会话 |
| 已满足完成条件后发生系统中断 | 保存本局表现及同一完成请求；不重新提交第二次完成 | 回前台进入结果并查询原会话 |
| 已完成详情点再练一次 | 标题“重复练习提醒”；正文“今天已完成此行动。再练不会重复获得奖励，今日进度保持{completedCount}/3。”；左“取消”，右“继续练习” | 取消回详情；继续创建新会话并按单项所需准备或倒数重新开始 |

退出确认期间冻结玩法计时和输入。记忆行为遮住执行区观察内容；体力行为按单项规则先回到安全姿势，恢复时不自动续算未确认的保持或动作周期。弹层内限定焦点，关闭后返回原操作区域。不额外提供独立暂停按钮。

## 4. 完成记录

| 字段 | 类型 | 生成与约束 |
|---|---|---|
| businessDate | string，`YYYY-MM-DD` | 服务返回的业务日期；同一会话始终沿用开始时的业务日 |
| sessionId | string | 每次开始或重练生成新值；同一会话重试和查询沿用原值 |
| repeatSession | boolean | 当日该行为已完成时为true；不新增当日名额或奖励 |
| naturalCompleted | boolean | 单项自然结束时置true；主动提前退出不满足自然结束 |
| qualified | boolean | 根据单项完成条件生成，不由资源动画、页面结束或分数推断 |
| completionStatus | enum或null | 未发首次完成请求为null；发出后`pending`；确定成功为`success`，确定失败为`failed`，结果无法确定为`unknown` |
| completionId | string或null | 服务确认唯一首次完成后返回；确认前为null |
| completedAt | 带时区的ISO 8601时间或null | 服务确认首次完成时返回 |
| completedBehaviorIds | string[] | 服务返回的当日去重完成集合 |
| completedCount | integer，0—3 | 由当日去重完成集合及每日名额规则返回；正确次数不参与计算 |
| failureReason | string或null | 服务返回的可展示失败原因；无失败时为null |
| firstResult | object或null | 当日首次完成的会话、完成身份、时间、本局表现及完成时进度；重练不得覆盖 |
| firstResult.completedCountAtCompletion | integer，1—3 | 确定首次结果标题；后续完成其他行为不改变该值 |

单项满足完成条件时，按同一`sessionId`提交一次完成事件，包含业务日、行为身份、呈现身份及该单项定义的完成证据。重试保持幂等，不重新开始练习。重练只保存本次表现并关联首次记录，不重新创建首次奖励事务。

服务端校验当日行为去重及最多3个不同行为名额；同一行为不同呈现共用`behaviorId`。同一业务日只允许一个进行中的会话。完成记录成功、奖励处理中时，行为仍为已完成；奖励失败不抹除已成功的完成记录。

## 5. 结果与奖励

结果依次展示四层：完成信息与本局表现、资源回执、今日进度、返回今日行动。完成正文不另加“科学收获”标题。

| 结果状态 | 顶部标题与内容 | 资源及进度 |
|---|---|---|
| 完成提交处理中或结果未知 | “完成状态确认中”、行为名、本局实际表现、完成正文 | 资源“待确认”，提供“查询完成状态”；不预填到账量，不提前增加进度 |
| 首次确认完成，当日第1或第2项 | “行动完成”、行为名、本局实际表现、完成正文 | 显示实际资源回执与服务返回进度 |
| 首次确认完成，当日第3项 | “今日目标已完成”、行为名、本局实际表现、完成正文 | 显示实际回执与3/3 |
| 自然结束但参与不足 | “本次未完成”、单项原因及本局表现 | 不显示完成正文或本次奖励；进度不增加，提供“返回今日行动” |
| 完成提交明确失败 | “本次未完成”、可展示失败原因及本局表现 | 不显示本次奖励；刷新服务实际进度 |
| 重练完成 | “本次练习完成”、本次表现及完成正文 | 首次回执＋“本次新增0”；今日进度不变 |
| 从已完成详情查看结果 | 首次完成时的标题、表现及完成正文 | 查询首次`completionId`的当前回执；显示当前业务日进度 |

| 奖励字段 | 类型 | 规则 |
|---|---|---|
| rewardType | enum | `inspiration / energy`，分别显示“灵感／元气” |
| rewardStatus | enum或null | `pending / success / failed / unknown`；尚无完成记录时为null，与完成状态分开 |
| rewardReceipt | object或null | 实际资源类型、增加量、到账目标标识及事务结果；由服务返回 |
| rewardReceipt.amount | integer，≥0 | 实际增加量；不能用配置金额或玩法表现替代 |

| rewardStatus | 回执区域内容与操作 |
|---|---|
| `success` | 实际增加量＋“已到账”；隐藏查询入口 |
| `pending` | “奖励处理中”＋“查询奖励状态”；查询原`completionId` |
| `failed / unknown` | “奖励待查询”＋“查询奖励状态”；不创建新事务 |

“查询完成状态”使用原`sessionId`；“查询奖励状态”使用原`completionId`。查询只刷新相应区域，不重开行为。任何结果状态下，“返回今日行动”立即可用，动效不阻塞返回。

## 6. 验收条件

| 操作或边界 | 通过条件 |
|---|---|
| 检查六类行为 | 脑力三类仅结算灵感，体力三类仅结算元气；金额与配置总表一致 |
| 进入详情 | 共用文案一致，方法直接展开，已完成状态仅并排“查看结果／再练一次” |
| 无设备行为开始 | 创建会话后直接进入执行，无额外准备或确认页 |
| 设备准备不满足 | 不进入动作计次，不累计有效保持，原因与恢复操作清晰 |
| 用户退出或应用中断 | 按单项清理和恢复规则处理，不在后台伪造完成 |
| 完成请求或奖励请求重复、超时、结果未知 | 沿用同一身份查询，不重复完成或发奖 |
| 重练与查看结果 | 本次表现和首次记录分开；首次回执不被覆盖，今日进度不增加 |
| 检查结果页 | 无游戏分、百分比及“科学收获”标题；资源区域只显示实际回执 |
| 手机视口 | 列表末项可实际滚到；必要动作和控件不被遮挡；返回始终可用 |
