数据生命周期与页面对应关系
本页把从机台产生数据到网页展示、缓存、上传、备份和删除的阶段对应起来，帮助判断“数据现在在哪里”和“下一步应该看哪个页面”。
总体流程
text
产生 → 本地保存 → 选择上传目标 → 上传/暂存
→ 服务端处理 → 页面索引 → 统计/成绩/记录展示
→ 备份/导出 → 删除或保留任何阶段失败都可能表现为“成绩没有出现”，但处理方式不同。
阶段一：本地产生
机台完成游玩或内容操作后，先确认本地是否显示完成、退出是否正常、是否出现保存提示。机台本地完成不证明服务端已经接收。
出现本地保存失败时不要立刻清空缓存。记录时间、曲目/内容、提示和当前分支，等待网络恢复或使用上传缓存流程。
阶段二：上传目标
配方和账号策略可能决定数据进入哪一个目标：常规数据、专用范围或上传缓存。用户不要自行关闭保护开关，也不要把“本次仅保存到专用区域”理解成数据已经写入全部服务。
先查看网页配方、上传缓存和管理员给出的数据策略。跨环境游玩前下载当前缓存。
阶段三：服务处理
服务收到数据后可能经历验证、去重、转换和索引。网页响应成功只说明请求被处理，不等于记录已经在所有页面出现。
记录与成绩页面可能有不同的刷新和索引时间。恢复/上传后先读取列表，再等待一个同步周期，不要重复上传或重复游玩。
阶段四：页面索引
页面可能按以下方式索引：
- 主页显示聚合统计；
- 记录页按范围读取；
- 成绩页整理乐曲索引；
- 相片页先读取文件列表；
- 上传缓存页读取快照索引；
- 查卡页读取机台统计快照。
一个页面为空不代表其它页面也为空。反馈时写清楚具体页面和时间范围。
数据对象矩阵
| 对象 | 产生位置 | 中间状态 | 主要读取页 | 推荐留档 |
|---|---|---|---|---|
| 游玩记录 | 机台/账号 | 上传中、索引中 | 游玩记录 | 普通缓存 |
| 成绩 | 账号数据 | 转换/索引中 | 乐曲成绩 | 普通缓存 |
| 相片 | 机台/账号 | 文件列表/按需读取 | 相片页面 | 原图下载 |
| 上传快照 | 上传缓存 | 待上传/已上传 | 上传缓存 | 快照文件 |
| 配方 | 网页/机台账号 | 保存中/重启生效 | 配方页面 | 原始 JSON |
| 订单 | 机台账号 | 下载/校验/等待/安装 | 订单/健康 | 配置和状态 |
| 查卡统计 | 机台 | 采样/聚合 | 查卡页面 | 时间摘要 |
删除生命周期
删除动作至少分为：
- 清理浏览器缓存：只影响本地显示；
- 删除本地账号条目：只影响登录入口；
- 删除单张相片：服务端文件可能不可逆；
- 删除全部相片：高风险；
- 删除上传快照：服务端待上传对象被移除；
- 订单数据删除列表：可能影响机台磁盘内容。
删除前下载留档、确认范围和目标。超时后先读取列表，不要重放。
页面空状态判断
| 页面现象 | 可能原因 | 首步 |
|---|---|---|
| 主页统计空 | 统计权限/尚未生成 | 刷新账号和统计 |
| 记录为空 | 时间范围/账号/索引 | 清空筛选并回读 |
| 成绩为空 | 没有游玩或索引中 | 等待并查记录 |
| 相片为空 | 没有文件/账号不对 | 刷新文件列表 |
| 上传缓存为空 | 无快照/目标不同 | 区分普通备份 |
| 订单为空 | 权限/读取失败 | 刷新健康和配置 |
备份点安排
推荐在这些时间点留档：
- 正常使用前；
- 大版本更新前；
- 订单保存前；
- 恢复前；
- 恢复后验收通过；
- 事故发现后；
- 回滚完成后。
每个备份标记账号、时间、版本和来源，不要混合不同账号或不同机台。
同步延迟反馈
反馈同步问题应包含：
- 数据产生时间；
- 机台/账号别名；
- 当前分支/订单；
- 本地提示；
- 上传缓存是否有对象；
- 网页首次读取时间；
- 当前页面结果；
- 已尝试刷新/上传次数。
不要发送完整缓存或 Token。管理员需要原始文件时，使用受保护渠道。