今日行动公共页面与结算 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 |
读取奖励配置总表;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. 验收条件
| 操作或边界 |
通过条件 |
| 检查六类行为 |
脑力三类仅结算灵感,体力三类仅结算元气;金额与配置总表一致 |
| 进入详情 |
共用文案一致,方法直接展开,已完成状态仅并排“查看结果/再练一次” |
| 无设备行为开始 |
创建会话后直接进入执行,无额外准备或确认页 |
| 设备准备不满足 |
不进入动作计次,不累计有效保持,原因与恢复操作清晰 |
| 用户退出或应用中断 |
按单项清理和恢复规则处理,不在后台伪造完成 |
| 完成请求或奖励请求重复、超时、结果未知 |
沿用同一身份查询,不重复完成或发奖 |
| 重练与查看结果 |
本次表现和首次记录分开;首次回执不被覆盖,今日进度不增加 |
| 检查结果页 |
无游戏分、百分比及“科学收获”标题;资源区域只显示实际回执 |
| 手机视口 |
列表末项可实际滚到;必要动作和控件不被遮挡;返回始终可用 |