3. 环境回放概念

环境回放（Environment Replay）是报表系统在 Go 领域边界上实现确定性状态重建的核心机制。它通过记录、存储和重演环境变更序列，使任意时刻的报表运行上下文可被精确还原，从而支撑调试、审计、故障恢复与回归验证。

3.1 环境回放定义

环境回放是指：将报表运行过程中涉及的外部依赖（数据库快照、配置中心版本、缓存状态、远程 RPC 响应）以有序事件日志的形式持久化，并在需要时按时间轴重新执行这些事件，使目标环境恢复到历史某一时刻的完整状态。

3.2 回放触发条件

回放并非持续执行，而是由以下五类条件触发：

1. 显式触发：运维人员通过管理 API 或 CLI 发起回放请求，指定目标时间戳或事件 ID。
2. 故障恢复：报表节点崩溃后重启，自动回放最近 N 分钟的环境日志以恢复运行状态。
3. 调试模式：开发者在本地或预发环境开启调试开关，回放线上某次报表执行的完整上下文。
4. 回归验证：CI/CD 流水线在发布前回放历史环境快照，验证新代码对旧数据的兼容性。
5. 审计追溯：合规或安全事件触发，回放特定时间窗口的环境变更以定位问题根因。

3.3 回放状态机

每个回放任务遵循严格的状态转换模型，确保异常可观测、可恢复。状态机定义如下：

3.4 回放生命周期

一个完整的回放任务从创建到销毁经历以下阶段：

// ReplayTask 定义回放任务的核心结构
type ReplayTask struct {
    ID         string            // 全局唯一回放 ID
    TargetTime time.Time         // 目标回放时间点
    Scope      ReplayScope       // 回放范围（全量/增量）
    State      ReplayState       // 当前状态
    Events     []*ReplayEvent    // 待回放事件列表
    Snapshot   *EnvSnapshot      // 基线快照
    Result     *ReplayResult     // 回放结果
    CreatedAt  time.Time
    UpdatedAt  time.Time
}

// ReplayState 回放状态枚举
type ReplayState int

const (
    StatePending   ReplayState = 0
    StateRunning   ReplayState = 1
    StatePausing   ReplayState = 2
    StatePaused    ReplayState = 3
    StateCompleted ReplayState = 4
    StateFailed    ReplayState = 5
    StateCancelled ReplayState = 6
)

生命周期中，事件重演阶段耗时最长且最容易出错。Go 领域边界上的典型优化策略包括：

• 批量重演：将连续且无依赖的事件合并为批次，减少状态切换开销。
• 惰性校验：仅在回放完成后执行全量校验，重演过程中只做因果序检查。
• 增量快照：记录事件变更的 diff 而非全量状态，降低存储与加载成本。