数据生命周期

# 数据生命周期

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

## 1. 数据分类

| 数据 | 示例 | 保存方式 | 生命周期 |
|---|---|---|---|
| 世界配置 | seed、地形版本、规则版本 | 权威存储 | 长期 |
| 有限寿命事件 | 路径、动物经过、风力变化 | 事件存储 | 到相关痕迹全部失效 |
| 短暂在线状态 | 位置、朝向、心跳 | 内存或短 TTL 缓存 | 连接期间 |
| 派生视觉状态 | 透明度、粒子、LOD | 客户端内存 | 当前渲染帧或会话 |
| 运维指标 | 消息数量、错误率、延迟 | 聚合指标 | 按运维策略 |

运维指标不得包含足以重建个人完整路线的坐标序列。

## 2. 两阶段消失

每条痕迹至少具有两个时间点:

```text
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`;
- 原始坐标序列;
- 可以重放整段行走过程的请求体。

允许记录:

```text
事件类型
区域 ID
点数
消息字节数
处理结果
错误代码
耗时
```

调试环境如果必须记录样例 payload,必须使用人工生成的测试向量,不复制真实用户轨迹。

## 5. 缓存与备份

### 缓存

- 缓存条目的到期时间不得晚于对应数据的 `purge_after`。
- 删除权威数据时必须失效区域快照缓存。
- CDN 不缓存包含实时位置或未过期私人会话信息的响应。

### 备份

永久备份会让“真正遗忘”失效,因此:

- MVP 的痕迹事件存储不进入长期不可变备份;
- 如果基础设施必须做短期备份,其保留时间不得显著超过最长痕迹生命周期与故障恢复窗口之和;
- 恢复备份后必须立即按当前世界时间执行过期清理,不能让旧痕迹复活。

## 6. 分析边界

可以分析:

- 区域负载;
- 平均事件大小;
- 同时在线连接数;
- 路径提交拒绝率;
- 动物调度次数;
- 客户端性能档位。

默认不得分析:

- 某个人完整走过的路线;
- 某个人跨会话的访问模式;
- 哪些人曾经相遇;
- 用户是否回到自己以前的足迹;
- 基于路径建立兴趣或行为画像。

## 7. 删除任务

清理任务必须具备:

- 幂等性;
- 分批执行;
- 对区域索引、缓存和主记录的一致删除;
- 可观测的清理数量和失败数量;
- 不记录被删除的具体路径内容。

推荐流程:

```text
按 purge_after 查询过期记录
  → 删除空间索引
  → 删除事件主体
  → 失效区域缓存
  → 记录聚合清理指标
```

## 8. 恢复语义

系统从故障恢复时:

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

## 9. 验收条件

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

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