为事件日志设计有序投影表面，支持追加与区间替换、来源追踪和增…

# 客服机器人事件投影表设计

一、表结构设计

核心表：event_projection

• event_id（主键）：全局唯一，建议 UUIDv7（含时间序，利于排序与分片）
• session_id：会话标识，索引字段
• seq_no：会话内单调递增序号（0~79 左右），配合 session_id 建联合唯一索引 (session_id, seq_no)
• event_type：user_msg / bot_msg / tool_call / escalation 等
• payload：JSONB，存事件内容
• schema_version：事件格式版本号，防止结构变更后回放错乱

二、来源追踪字段（关键）

• source_type：original / revised / system_patch
• source_event_id：修订事件指向被修改的原事件 ID
• revision_of_seq：被替换事件的 seq_no
• trace_id：整条修订链的根 ID，同一次修改产生的事件共享
• actor：修改发起者（user / admin / system）
• reason：修改原因说明

三、追加写设计

• 所有事件只追加，不物理删除、不覆盖
• 新事件 seq_no = 当前会话最大值 + 1
• 用数据库序列或分布式 ID 保证并发下序号不重复

四、区间替换设计

用户改历史消息时，采用“失效 + 重投影”模式：

1. 区间失效：将 [start_seq, end_seq] 区间事件打上 is_superseded = true 标记（或写入 superseded_by 字段），不删除

2. 写入替换事件：插入新的修正事件块，seq_no 继续递增，通过 source_event_id / trace_id 指回原区间

3. 视图投影：查询有效事件用 WHERE is_superseded = false ORDER BY seq_no

4. 原子性：失效 + 插入放同一事务，保证不出现“半替换”状态

五、回放验证机制

• 全量回放：按 seq_no 排序拉取全部事件（含失效），可还原任意时刻的完整时间线
• 修订链校验：沿 trace_id 拉链路，验证每个 revised 事件都能找到其 source_event_id，且版本号兼容
• 一致性校验：比对“原始区间事件”与“替换事件”的 schema_version 和 payload 结构是否匹配
• 快照辅助：每 N 条事件（如每 20 条）落一个投影快照，加速长会话回放

六、索引建议

• (session_id, seq_no) 唯一索引：区间查询与排序
• (trace_id)：修订链回溯
• (session_id, is_superseded, seq_no)：有效事件视图查询