本文件保证“遗忘”不仅是视觉效果,也是系统事实。
1. 数据分类
| 数据 | 示例 | 保存方式 | 生命周期 |
|---|---|---|---|
| 世界配置 | seed、地形版本、规则版本 | 权威存储 | 长期 |
| 有限寿命事件 | 路径、动物经过、风力变化 | 事件存储 | 到相关痕迹全部失效 |
| 短暂在线状态 | 位置、朝向、心跳 | 内存或短 TTL 缓存 | 连接期间 |
| 派生视觉状态 | 透明度、粒子、LOD | 客户端内存 | 当前渲染帧或会话 |
| 运维指标 | 消息数量、错误率、延迟 | 聚合指标 | 按运维策略 |
运维指标不得包含足以重建个人完整路线的坐标序列。
2. 两阶段消失
每条痕迹至少具有两个时间点:
render_expires_at
purge_after
render_expires_at:规则判定痕迹进入forgotten的时间。从此不得向普通客户端返回。purge_after:工程缓冲结束时间。从此必须从权威存储、缓存和可重建日志中删除。
两者之间的缓冲只服务于:
- 清理任务重试;
- 客户端时钟校正;
- 区域缓存失效;
- 短暂故障恢复。
缓冲期不得用于产品回放、用户查询或数据分析。
3. 各类数据的清理规则
3.1 人类痕迹
- 到达
render_expires_at后不再进入区域快照。 - 到达
purge_after后删除路径点、来源会话关联及空间索引。 - 不建立永久“用户—轨迹”索引。
3.2 动物事件
- 动物模型离开视野后,调度事件仍需保留到其足迹全部过期。
- 足迹过期并经过缓冲期后,删除经过路径。
- 可以保留不含具体路径的聚合统计,例如某物种一天被调度多少次。
3.3 环境事件
- 环境事件结束后不能立即删除,因为尚存痕迹的衰减可能依赖它。
- 当所有可能受影响的痕迹都已过期并清理后,环境事件才可删除。
- 可以保留不含局部轨迹的气候聚合数据。
3.4 在线状态
- 心跳超时后从实时存在集合删除。
- 会话结束后不转存为公开历史。
- 为防滥用保留的安全标识必须与公开痕迹数据分离,并设置独立、明确的最短保留期。
4. 日志边界
应用日志不得记录:
- 完整路径 payload;
- 可长期关联用户的
presence_id; - 原始坐标序列;
- 可以重放整段行走过程的请求体。
允许记录:
事件类型
区域 ID
点数
消息字节数
处理结果
错误代码
耗时
调试环境如果必须记录样例 payload,必须使用人工生成的测试向量,不复制真实用户轨迹。
5. 缓存与备份
缓存
- 缓存条目的到期时间不得晚于对应数据的
purge_after。 - 删除权威数据时必须失效区域快照缓存。
- CDN 不缓存包含实时位置或未过期私人会话信息的响应。
备份
永久备份会让“真正遗忘”失效,因此:
- MVP 的痕迹事件存储不进入长期不可变备份;
- 如果基础设施必须做短期备份,其保留时间不得显著超过最长痕迹生命周期与故障恢复窗口之和;
- 恢复备份后必须立即按当前世界时间执行过期清理,不能让旧痕迹复活。
6. 分析边界
可以分析:
- 区域负载;
- 平均事件大小;
- 同时在线连接数;
- 路径提交拒绝率;
- 动物调度次数;
- 客户端性能档位。
默认不得分析:
- 某个人完整走过的路线;
- 某个人跨会话的访问模式;
- 哪些人曾经相遇;
- 用户是否回到自己以前的足迹;
- 基于路径建立兴趣或行为画像。
7. 删除任务
清理任务必须具备:
- 幂等性;
- 分批执行;
- 对区域索引、缓存和主记录的一致删除;
- 可观测的清理数量和失败数量;
- 不记录被删除的具体路径内容。
推荐流程:
按 purge_after 查询过期记录
→ 删除空间索引
→ 删除事件主体
→ 失效区域缓存
→ 记录聚合清理指标
8. 恢复语义
系统从故障恢复时:
- 读取当前权威世界时间;
- 丢弃已经超过
purge_after的数据; - 不向客户端返回已经超过
render_expires_at的数据; - 重建仍有效事件的空间索引;
- 恢复环境调度,但不补演用户错过的动物动画。
9. 验收条件
数据生命周期合格必须满足:
- 过期痕迹无法通过普通 API 查询;
- 清理后无法从缓存重新出现;
- 服务重启不会让痕迹寿命重置;
- 备份恢复不会复活已经遗忘的痕迹;
- 日志中不存在完整真实轨迹;
- 不存在稳定的公开用户历史索引。