# 墙面俯卧撑 PRD

## 1. 行为配置

| 字段 | 类型 | 值与规则 |
|---|---|---|
| catalogKey / section | string | `wall_pushup` / `wall-pushup` |
| taskId | string | `lib:BODY-006`；科学及动作条目键 |
| behaviorId / variantId | string或null | `family:push-up` / `lib:BODY-006:minute-v1`；null不能提交正式完成 |
| behaviorName / categoryId | string | 墙面俯卧撑 / physical_capacity |
| durationLabel | string | `40秒`；只在入口显示预计时间，不作为动作量、保持预算、视频正式长度或结算条件 |
| deviceRequirements | array | []；视频跟练，不申请相机或动作权限 |
| illustration | 资源引用 | 统一页wall-pushup行为配图 |
| science.shared | string | 激活胸大肌与上肢肌群，提升上肢力量储备与核心躯干稳定度。 |
| science.completion | string | 生物力学测算表明，立姿靠墙推撑约需克服相当于体重 30% 至 40% 的地面反作用力，在大幅降低腰椎负荷的同时，有效募集胸大肌、前锯肌与肱三头肌。刚才的推墙控制，正是在安全调用上肢推撑肌群。 |
| steps | string[] | 下列顺序常驻展开 |
| rewardType / rewardAmount | enum / integer | energy（元气） / 12；真实增加量仅从奖励回执读取 |

`steps`：

1. 面对牢固墙面，约一臂距离，双掌胸高贴墙、手指朝上，把手机固定在看得到的位置。
2. 缓慢屈肘靠近墙面，背保持直，再缓慢推回原位。
3. 一次靠近与推回合为1次，单组共5次，不增加组数或组间休息。
4. 最后一次完整推回原位后，放松站稳；不适时停止。

| 动作及播放配置 | 类型 | 值与校验 |
|---|---|---|
| sets / repsPerSet | integer | 1 / 5 |
| cycleDefinition | string | 靠近墙面→完整推回原位；推回后1周期结束 |
| holdMs / restBetweenSetsMs | integer | 0 / 0；不新增停留或组间休息 |
| mediaSource | 资源引用或null | null；正式业务必填，完整人物、支撑物、动作接触点和终帧 |
| cueTimeline | object[]或null | null；正式业务必填；每项含cueId、phase、startMs、endMs、字幕与配音；侧别及示范次数仅在本项阶段适用时携带；按正式媒体起止时间回填，不以入口预计时间补齐 |
| completionPolicy | object或null | null；正式业务必填，含policyId、所需独立完成证据及服务校验；不得默认播放结束等于身体完成 |
| previewMode | enum | keyframes；只查看下列视频占位与字幕锚点，不创建正式会话或产生完成资格 |

`businessReady`仅在身份、动作预算、正式媒体、完整时间轴和completionPolicy全部校验通过时为true；否则禁用业务开始与完成。媒体时轴必须连续、有限、无重叠倒序，覆盖完整回位收尾；区间前闭后开，末尾由媒体自然结束事件处理。关键帧预览不提供黑屏定时器，不用示例剪辑秒点形成身体剂量。

## 2. 页面、字段与操作位置

视频画面、字幕安全区、素材比例、时间轴、异常回位和播放控制继承[体力储备视频执行规范](https://fuguang-design.pages.dev/daily-island/prd/physical-capacity/)的“公共布局”“时间轴”“播放控制与结果去向”；本项动作量、字幕锚点和必填配置以下列字段为准。规范中的剪辑沟通示例秒点不作为正式时间轴或剂量。

| 页面 | 区域及顺序 | 字段与操作 |
|---|---|---|
| 今日行动 | 卡片 | 左配图；右名称与durationLabel，下方science.shared与元气图标；完成状态来自服务 |
| 行为详情 | 从上到下 | 返回、名称→配图→“行为说明”及science.shared→“怎么做”及steps→底部主操作；方法常驻展开 |
| 行为详情 | 底部固定区 | 配置有效时开始行动，请求中防重；配置缺项“暂不可开始”；今日已满3项禁用；已有当日记录左查看结果、右再练一次 |
| 执行A区 | 顶部公共控制 | 退出与声音开/关始终可用；关闭声音不隐藏字幕与示范进度 |
| 执行B区 | 中部主画面 | 视频占位标注“此处放视频”；使用人物和必要支撑物完整的关键帧，正式播放器替换占位后不显示开发标注 |
| 执行C区 | 视频下方安全区 | 同一时刻只显示一条当前字幕，最多两行；阶段切换原位替换，不遮挡手脚、接触点或支撑关系 |
| 执行D区 | 字幕下方 | 仅示范阶段或示范次数，不能称为用户完成次数；未知时长不显示倒数 |
| 结果 | 四层 | 引导播放结束事实或有效完成结果→真实元气回执→今日进度→立即可用的返回今日行动 |

公共入口、详情与执行容器遵循[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html)§1—2。无需设备准备或教程确认页。预览锚点如下，只有画面、字幕与阶段，未取得正式媒体时不生成播放时刻：

| 阶段锚点 | B区画面 | C区字幕 | D区示范进度 |
|---|---|---|---|
| setup | 面对牢固墙面，双掌胸高撑稳 | 面对墙面，双掌胸高撑稳 | 即将开始 |
| approach | 缓慢屈肘靠近，背保持直 | 缓慢靠近墙面，背保持直 | 示范第{rep}/5次 |
| pushback | 缓慢推回完整原位 | 缓慢推回原位 | 示范第{rep}/5次 |
| finish | 第5次推回后放松站稳 | 回到原位，放松站稳 | 示范收尾 |

左右按示范者身体标识；正面素材须写清观看对应关系，字幕换侧与实际画面同步。优先完整竖屏；其他比例也不得裁掉必要身体或支撑物。

## 3. 执行状态与判定

| phase | 进入条件与画面 | 处理与下一状态 |
|---|---|---|
| preview | 打开关键帧预览，显示视频占位及阶段字幕 | 仅切换锚点；无运行时钟、不计身体完成，不创建业务会话 |
| loading | 业务配置通过后加载正式媒体；首帧占位，字幕“视频加载中，请先保持舒适姿势” | 加载不计时；成功从首帧开始playing，失败进入error |
| error | “视频暂时无法播放” | 可重试或返回详情；不记完整播放，不提交完成 |
| playing | 按本项视频时间轴连续播放 | 画面、配音、字幕及示范进度共用mediaTimeMs；无逐次点击确认，按自然结束事件进入guideEnded |
| recover | 卡顿或退出继续后，字幕替换为“先回到站稳的姿势” | 停止媒体、配音及当前动作字幕；显示“重新开始 / 结束本次”；不自动续播或重播 |
| guideEnded | 完整媒体自然播放结束且最后回位收尾cue已结束；“引导播放结束” | 仅封存播放事实；按独立业务策略校验资格，未配置或不满足时不提交完成 |

setup→(approach→pushback)×5→finish→guideEnded。重复周期在同一视频位置连续推进，示范次数在完整推回后递增；不在靠近墙面的屈肘姿势结束。

| 运行字段 | 类型与范围 | 更新规则与用途 |
|---|---|---|
| phase | enum | preview / loading / error / playing / recover / guideEnded / result / quit |
| previewPhase | enum或null | 只指向本项关键帧锚点，不生成媒体或动作完成事件 |
| playbackRunId | string或null | 正式从首帧开始时生成；重新开始生成新的播放运行标识，半途记录不拼接为完整播放 |
| mediaTimeMs / mediaDurationMs | number或null，毫秒 | 由正式播放器读取；未知时长为null；加载、卡顿和暂停不累加 |
| cueId / subtitle / demonstrationProgress | string或null | 取媒体当前阶段；次数只是示范次数，回位后才切换到下次 |
| guideEnded / guideEndedAt | boolean / 带时区ISO时间或null | 同一playbackRunId完整自然结束仅记一次；拖动预览或重复ended事件不得补判 |
| qualified | boolean | 须由completionPolicy及其所需独立证据验证；未配置时false，不能直接取guideEnded |
| paused | boolean | 公共退出确认期间冻结视频、配音、字幕与时间轴 |

播放结束、身体完成、服务完成记录和资源到账分别记录。播放器位置与示范次数不能充当身体识别数据，不能据此创建实际完成或到账成功。

## 4. 结束、退出、中断与重练

| 触发 | 状态处理 | 可见操作与去向 |
|---|---|---|
| 点退出 | 同步停止视频、配音、字幕；先处理已经发生的媒体结束边界，再进入公共确认 | “结束本次行动？”；正文“先回到舒适姿势。结束后，本次播放进度将清除。”；左继续行动、右结束本次 |
| 退出确认选择继续 | 进入同一执行页recover，提示“先回到站稳的姿势” | “重新开始 / 结束本次”；不续接半途动作 |
| 卡顿 | 立刻停止媒体、配音与示范进度，进入recover | 同上；不让用户在动作姿势等待缓冲结束自动继续 |
| 恢复态重新开始 | 丢弃半途完整播放资格，从首帧开始新的playbackRunId | 播放对应站位准备和全部动作，不拼接前后片段 |
| 结束本次或不适 | 停止媒体并清除本次未完成过程；提示“先回到站稳的姿势” | 返回原今日行动列表；不要求补做，不提交本次完成 |
| 后台、锁屏或页面关闭 | 结束半途引导，不保留中途播放续接资格 | 回前台今日行动；再次进入从首帧开始，不补算后台时间 |
| 已获有效业务自然完成后退出或中断 | 保留原sessionId完成请求与表现 | 按公共§3进入结果并查询原请求，不重复提交或发奖 |
| 已有记录点再练一次 | 公共重复提醒，取消留在详情；继续创建新repeat session | 从首帧开始；当日首次记录、回执及今日进度不变 |

[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html)§3负责公共弹层、焦点与重练记录保护。本项播放恢复规则是先回位后用户决定重新开始或结束，不能用公共“继续”直接恢复身体动作片段。

## 5. 完成记录与结果字段

公共记录、首次去重、上限和奖励状态精确复用[公共页面与结算](https://fuguang-design.pages.dev/daily-island/prd/overall.html)§4—5：`businessDate、sessionId、repeatSession、completionId、completedAt、completionStatus、failureReason、rewardStatus、rewardReceipt、completedCount、firstResult、firstResult.completedCountAtCompletion`。

| 本项字段 | 类型 | 生成、读取及约束 |
|---|---|---|
| guideEndedAt | 带时区ISO时间或null | 仅正式媒体完整自然结束时生成；预览不生成 |
| playbackFact | object或null | mediaSource、playbackRunId、完整播放标记及终帧cue；不包含用户动作完成次数 |
| performance | string | 5次推墙示范的引导播放结束；只可描述实际播放事实 |
| completionPolicyId / sessionEvidence | string或null / object或null | 正式业务资格所需配置及独立证据，不能从播放器进度伪造 |
| qualified | boolean | 身份、策略或必要证据缺项时false；不提交completionId或奖励事务 |

| 结果条件 | 第一层 | 资源回执与今日进度 |
|---|---|---|
| 只有视频结束 | “引导播放结束”与本次播放事实；不显示以身体完成为前提的science.completion | 无本次有效完成和奖励；资源、进度无确认值显示“待确认”，已有服务进度如实保留，不增加 |
| 预览阶段结束 | 保留“视频占位／阶段预览”标识，不伪装完整播放或身体完成 | 不创建会话完成或奖励，不增加进度 |
| 资格有效且已提交完成 | completionStatus为pending或unknown时显示“完成状态确认中”、行为名、本局实际表现及science.completion；success时标题按公共§5 | pending／unknown时资源“待确认”，查询原sessionId，进度不增加；完成成功后显示实际奖励回执与服务进度 |
| completionStatus为failed | “本次未完成”、可展示失败原因及本局表现；隐藏science.completion | 不显示本次奖励；刷新服务实际进度，不自行增加 |
| 从已完成详情查看结果 | 首次有效完成记录的标题、表现与科学完成原文 | 查询首次completionId回执；显示服务当前业务日进度 |
| 重练且业务资格有效 | “本次练习完成”及本次表现，首次记录不覆盖 | 首次奖励回执＋本次新增0，进度不增加 |

仅播放结束不得先写“行动完成”再等待服务补验证。所有请求重试使用原sessionId，奖励查询使用原completionId，返回今日行动随时可用。

## 6. 验收条件

| 操作或边界 | 通过条件 |
|---|---|
| 动作量 | 只有单组5次，靠近加推回合为1次；不增加第二组、停留或休息 |
| 关键帧与收尾 | 站位、靠近、推回、收尾齐全；第5次完整推回后再结束 |
| 视频占位 | B区标明此处放视频；C/D区字幕和阶段位置明确；静态预览无假时钟、动作识别或业务完成 |
| 时间轴 | 正式媒体、字幕、配音同轴；不以入口预计秒数强拉或压缩动作；加载不计时 |
| 卡顿与退出继续 | 立即停止并提示本项回位；继续到recover，手动重开从首帧；不自动续播或拼接完成 |
| 系统中断 | 后台结束半途引导，回前台列表；新会话从首帧，不增加今日进度或到账 |
| 播放结束与结果 | 只记播放事实，无有效独立资格不显示身体完成文案、completionId或到账成功 |
| 科学与元气 | 两字段逐字匹配taskId；金额与总表一致；实际到账只用奖励回执 |
| 已完成关系 | 底部查看结果／再练一次并排；重练独立session，不覆盖首次记录；返回立即可用 |
