数据生命周期

本文件保证“遗忘”不仅是视觉效果,也是系统事实。

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. 恢复语义

系统从故障恢复时:

  1. 读取当前权威世界时间;
  2. 丢弃已经超过 purge_after 的数据;
  3. 不向客户端返回已经超过 render_expires_at 的数据;
  4. 重建仍有效事件的空间索引;
  5. 恢复环境调度,但不补演用户错过的动物动画。

9. 验收条件

数据生命周期合格必须满足:

  • 过期痕迹无法通过普通 API 查询;
  • 清理后无法从缓存重新出现;
  • 服务重启不会让痕迹寿命重置;
  • 备份恢复不会复活已经遗忘的痕迹;
  • 日志中不存在完整真实轨迹;
  • 不存在稳定的公开用户历史索引。