数据生命周期

本页说明从数据产生、上传、缓存、展示到删除的大致生命周期。具体保留时间和字段范围可能随服务版本变化，页面返回结果是最终依据。

数据产生

数据可能来自：

• 账号登录和设置；
• 机台游玩记录；
• 相片和头像；
• 配方修改；
• 订单/更新状态；
• 成绩评论和内容反馈。

不同数据使用不同账号权限，用户不能通过普通账号查看机台管理员数据。

数据上传

上传可能在退出、保存、网络恢复或手动点击时发生。网络不稳定时，页面或机台可能先生成缓存，再等待后续上传。

上传失败不等于本地数据一定丢失；先查看上传缓存和网页备份，再决定是否重试。

侧载/测试数据的目标范围

侧载或测试内容可能使用与常规内容不同的数据目标和索引范围。页面提示“保存到专用范围”时，网页汇总、常规记录和成绩页不一定立即显示同样的结果；这不自动表示数据损坏。

使用者应把以下状态分开记录：

状态	说明
本地已保存	机台完成一局并保留了本地数据
已进入上传缓存	页面可以看到待上传快照
已上传	服务接受了本次快照
已索引	记录/成绩页面可以查询到
汇总可见	首页或统计页已经重新计算

若要避免超前或测试内容进入不适用的常规范围，只使用当前页面提供的用户侧数据策略开关，并先保存原值。不要根据聊天里的旧规则手工添加配置字段，不要把同一份缓存重复上传到多个范围，也不要用修改备份 JSON 的方式转换数据目标。

缓存层

缓存的作用是短期保存待同步或可恢复的数据。缓存可能：

• 受时间或容量限制；
• 与普通备份字段不同；
• 只属于当前账号；
• 在服务清理策略下过期；
• 在删除操作后不可恢复。

需要长期保存时，使用网页下载的备份文件，而不是只依赖页面当前显示。

展示层

网页会把原始数据转换成统计卡片、图表、成绩卡、相片缩略图和订单状态。展示层可能：

• 对达成率做单位转换；
• 对时间做本地化显示；
• 对空字段隐藏区域；
• 对大列表分页或懒加载；
• 对图片创建本地临时 URL。

如果页面显示与 API 原始值不同，保存原始响应并按对应文档理解单位，不要直接把网页文本当作原始数据。

删除与覆盖

删除相片

删除单张或全部相片通常不可逆。浏览器缓存里仍可能暂时存在缩略图，但这不代表服务端文件可以恢复。

删除上传缓存

删除快照会从上传缓存列表移除对应项目。删除前下载留档并确认索引名称。

恢复缓存

恢复可能合并或覆盖部分账号数据。恢复前下载当前状态，恢复后检查记录、成绩、相片和设置。

覆盖订单配置

示例订单按钮和保存配置都可能替换当前编辑内容。打开替换确认框时，应先复制原 JSON；保存后记录操作时间和版本。

本地与远程清理

操作	影响本地浏览器	影响服务端
清理浏览器站点数据	是	否
清除相片缩略图缓存	是	否
删除相片	否	是
删除上传缓存	否	是
删除账号条目	是	通常否
退出 Token	当前会话	使 Token 失效

事故后的数据保全

发现数据异常时：

1. 停止删除、恢复和上传操作；
2. 下载当前缓存和上传缓存列表；
3. 保存错误消息、时间和版本；
4. 复制当前配方但遮挡敏感字段；
5. 联系管理员确认下一步；
6. 只在确认备份可用后执行恢复。