今日行动 · 统一高低保真查看页

公共页面与结算

今日行动公共页面与结算 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. 验收条件

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