修订追踪表
旧值、新值、字段、来源与原因的修订行
每次变化定位到单字段和证据来源。 本文给出可复核步骤、状态边界、脱敏记录方法与复核路径。
字段修订行一次只描述一个业务字段的变化，并同时保存旧值、新值、来源、原因、执行时间和复核状态。它不是一段“已更新资料”的笼统日志。把变化定位到record_id和field_path，才能检查是否误改队名、时间、场地或状态，也能在需要时生成精确反向修订。
当前没有真实修订，所有示例为合成，现场值UNKNOWN。把场地从UNKNOWN改为“甲体育场”只演示结构，不指现实场馆。没有source_ref或reason_code的变更保持提议态，不能进入公开值。编辑角色和复核角色分开记录，不虚构个人专家身份。单字段原则并不意味着忽略上下文。修改开赛时间时，预览必须读取结束时间、状态、时区和相关文章，但revision仍只写目标字段；由关系校验决定是否允许。结构化对象如场地包含id、名称和地区，若它们属于同一原子引用，可以作为一个字段对象修订，并在diff中逐属性展示，不能只写“场地已变”。文本值需要规范Unicode和换行后再比较，同时保留原始字节指纹，防止视觉相同却编码不同。修订时间使用系统审计时钟，来源观察时间另列。批准后若下游同步延迟，页面应显示业务值版本与索引版本，搜索仍旧时不宣称全站完成。一个revision被文章引用后，文章版本记录引用时间；未来撤销能准确找到受影响内容。编辑批注不进入业务reason，敏感个人信息不得放在说明中。权限控制按照字段风险配置，但权限高不等于证据更可信。定期审计随机抽修订，从当前值反查来源与审批，再用原输入重跑校验。
锁定记录版本和字段路径
创建修订前读取record_id、current_version和field_path；old_value由系统从该版本取得，不能手输。若提交时版本已变化，产生并发冲突，提议暂停，不覆盖后来修订。客户端提交request_id与输入指纹，超时重试返回同一修订结果而不重复写行。冲突卡并列两次提议的来源、规则和影响预览，复核者重新选择新基线后才能生成下一请求。
字段路径稳定指向业务值，而非界面标签。嵌套数组需包含元素标识，避免序号变化改错对象。记录无法确定时revision目标为UNKNOWN，禁止执行。
- 旧值由当前版本自动读取
- 并发变化触发冲突
- 字段路径使用稳定元素标识
保存新值的来源和时间边界
new_value旁保存source_ref、来源原文、发布时间、观察时间、适用赛季和证据指纹。来源只支持部分精度时，新值不得扩大精度。场地只有城市证据时不能写具体场馆。
来源失效或许可受限时记录状态。没有材料则source_ref为UNKNOWN，修订只作提议。编辑摘录或换算还需公式和规则版本，不能把编辑输出冒充原始值。
- 新值绑定来源和观察时间
- 不扩大来源精度
- 编辑转换披露规则公式
用原因代码说明变化性质
reason_code区分来源更正、解析修复、规范化、规则变化、冲突解决和撤销。原因决定影响检查。格式规范化通常不改变语义，冲突解决则需链接候选值。
“优化”或“更新”不是足够理由。复杂变更拆为多行，用batch_id关联。说明文字引用证据，不使用无来源的主观判断。原因不确定时保持UNKNOWN。
- 原因使用受控代码
- 复杂变化拆为单字段行
- 模糊理由不得批准
执行前预览关系和依赖影响
系统用old与new分别运行字段格式、跨字段关系和引用完整性校验。预览显示哪些失败消失、哪些新失败出现，以及依赖文章、统计、搜索和缓存的预计变化。
若新值导致结束早于开始、队伍错绑或规则范围不符，修订不执行。某项关系因UNKNOWN无法判断，风险栏显示并交复核者。预览结果和规则版本随提议保存。批准后若当前版本变化，旧预览立即过期；重新生成前不能沿用签字，避免审核对象和执行对象不同。预览摘要还要显示所有未决依赖及其页面影响。
- 新旧值分别运行校验
- 新逻辑失败阻止执行
- 未知关系在风险栏公开
通过双角色批准与原子写入
提交者准备来源和理由，复核者从新值回到原文，检查field_path与影响。高影响字段需第二角色批准。分歧时状态待审，不以投票数量决定事实。
执行采用原子事务：业务值、revision_id、校验结果和审计事件同时成功或全部回滚。下游重建可以异步，但状态显示待同步。部分失败不能被汇总成全部成功。任务重试必须读取已提交版本，不重新计算另一候选值。核账发现索引或页面落后时，只重放对应消费者，不手工修改业务记录。
- 提交复核角色分离
- 分歧保持待审
- 核心写入采用原子事务
执行后核对逐项结果
写入后重新读取字段，确认new_value、版本和修订行一致，再重跑相关规则。页面、API与导出抽样检查，不只看数据库。衍生统计保存使用的版本。
同步失败时修订本身可生效，但页面标待更新并建立任务。不得手工改缓存掩盖问题。结果包含成功、跳过、失败和UNKNOWN，任何失败都有可重试条件。验收从修订行、业务记录、事件队列、搜索文档、页面版本和缓存六处对账，版本号必须形成可解释序列。并发写入测试让两个提议基于同一base_version，确认第二个进入冲突而非覆盖。结构对象测试逐属性比较，撤销测试在后续合法变更存在时必须拒绝直接恢复。公开页面通过前后截图与接口快照证明只改变目标字段。
- 写入后重新读取核对
- 抽查页面接口和导出
- 同步失败明确显示
公开单字段修订的完整边界
页面可显示字段、旧值、新值、原因类别、来源状态、修订时间、复核状态和影响范围。敏感来源只展示必要摘要。最近修订不自动代表最正确。
单字段修订是一条带版本条件的事实交易，不是直接更新一列。请求包含record_id、base_version、field_path、old_state、old_value、new_state、new_value、source_ref、reason_code和requested_at；执行前比较当前版本、来源适用范围和字段规则，任何差异都生成冲突卡，不能让最后提交者获胜。结构化对象的原子边界由模式定义，例如场地名称与地区标识必须一起校验，其他关联字段另建修订。预览同时显示字符、语义与状态差异，以及排序、聚合、标题、结构化输出、搜索和缓存等消费者。事实版本与修订行先在同一提交中落地，后续重渲染和索引任务使用幂等键重试；部分任务失败时展示同步进度，不回滚已经安全提交的事实。验证器用相同来源、规则与输入指纹重建new_value，不能重建就进入待审。撤销创建引用original_revision_id的反向请求，并按当前版本重新计算依赖，历史行不会删除。事务演练在事实提交后、搜索更新前故意终止任务，重启时只重试未完成消费者，并以幂等键避免重复事件。两个不同候选同时使用相同base_version提交，预期一个成功、另一个生成可读冲突卡。权限样本覆盖越权字段、自我审批、重复请求和过期提议，UNKNOWN依赖在所有结果中继续可见。同步状态卡还要区分未排队、处理中、成功、可重试失败与永久失败，使部分消费者落后时不会被误报为事实事务回滚。
- 公开页列单字段旧新值
- 最近修改不等同最正确
- 终检从当前页反查修订、来源和规则，再从修订正查标题、正文、排序、聚合、结构化标记、搜索、缓存与历史页，任一旧值残留即失败
