字段规则牌
队伍、时间、场地与状态字段的最小规则
按字段给出类型、格式和关系校验。 本文给出可复核步骤、状态边界、脱敏记录方法与复核路径。
一条赛事记录最少要让读者知道谁在比赛、何时开始、在哪里进行以及处于什么状态，但“字段里有字”不等于结构有效。队伍需要稳定标识和角色关系，时间需要原值、时区与精度，场地需要名称和地区边界，状态必须来自有定义的枚举。四组字段之间还要互相校验，才能阻止矛盾组合进入展示。最小结构不要求所有字段一次到齐，而要求每个缺口有状态。导入器先保存原始快照，再逐字段验证；单个场地待核不能抹去已核队伍与日期。页面版本应说明哪些栏位可用于排序、哪些只可阅读。
最小赛事记录不是四个必须非空的字符串，而是参与方、时间、场地与状态四组字段及各自证据状态。虚构记录M4只用于演练，现实值没有来源时保持UNKNOWN；缺时区不会套用读者本地偏移，未知场地也不借主队所在地补齐。原值、规范值、来源、规则、验证时间和空值原因分别保存。生命周期按版本处理：计划阶段可只有队伍与日期，后来新增具体时刻、场地或结果时创建事件，不用最终值覆盖早期计划。valid_at说明资料适用时点，recorded_at说明编辑何时记录；名称映射较晚完成也不会改写原名采集时间。场地变更保存old_venue与new_venue，状态变化连接前序。字段精度从日提升到分钟是补充而非纠错，展示时区换算也不改变业务原值。唯一键只防技术重复，两条相似资料身份仍不确定时建立候选集合。
为队伍字段建立角色和实体约束
主队与客队字段保存source_name、entity_id、role和映射版本。两个角色不能指向同一实体，除非赛制规则明确允许特殊演练；名称相同但实体未知时不自动合并。中立场比赛仍保留主客编排角色，不把场地属性写进队伍标识。
队伍映射失败时保留来源原名，entity_id为UNKNOWN，比赛记录可进入待核但不能汇总队史。青年队、女子队或预备队后缀缺失会改变实体边界，编辑不得从简称猜测。关系校验结果指出哪一侧未知，而不是删除整场资料。
- 队伍角色与实体分栏
- 同名不自动合并
- 映射失败保留来源原名
把时间值、时区和精度拆开
开始时间保存raw_time、timezone、precision、normalized_time和observed_at。来源只有日期时，precision为日，不能补成零点；来源有时刻无时区时，规范时间为UNKNOWN。夏令时与跨日转换使用明确时区规则和版本。导出与排序也读取precision和state，避免界面不补值而后台仍把日期当午夜。
计划时间、实际开始、结束与更新时间是不同事件，不共用一个字段。状态改变也不能无证据覆盖原计划。比较先后时只使用精度兼容且时区已知的值；否则关系校验为UNKNOWN，避免制造“结束早于开始”等假冲突。
- 时间原值时区精度分开
- 不同事件使用不同字段
- 时区未知不做先后比较
允许场地未知但验证已填关系
场地可合法为空，因为计划阶段可能尚未公布。已填值则保存venue_id、来源名称、地区、是否中立和映射证据。来源只给城市时不能创建具体体育场；venue_id保持UNKNOWN，location_precision写城市。
中立标记为真时，场地地区成为条件必填；中立状态未知则不触发强制填充。场地变更用事件记录旧值、新值和时间，不覆盖原计划。页面同时显示当前值和最后修订时间，避免读者把历史截图当最新安排。
- 场地允许合法未知
- 地区精度不得夸大
- 变更通过事件追加
让状态枚举携带事件语义
计划、延期、取消、中止、进行和结束等状态需要定义、触发证据、允许前序和后续动作。来源原文与规范状态并存。无法映射的文字不默认计划中，而是status_normalized为UNKNOWN并进入审核。
结束状态可能要求实际结束时间或结果字段，但规则必须说明哪些赛事适用。延期后恢复不是把状态改回计划而抹掉延期，应新增恢复事件指向前序。状态时间缺失时事件仍可保存，event_time为UNKNOWN。
- 状态枚举有定义与转移规则
- 无法映射不套默认状态
- 恢复事件指向前序
执行跨字段关系校验
关系检查包括主客不同、结束不早于开始、结束状态与结果一致、中立场与地区相容、状态与时间精度匹配。每条规则有rule_id和版本，失败卡列相关字段，不把所有问题归为格式错误。
证据不足导致无法判断时返回UNKNOWN，不等于通过。比如开始时区缺失，结束先后无法校验；系统应显示关系待核。批量运行保存规则版本与输入指纹，修订规则后可对比哪些记录状态变化。
- 关系规则拥有版本标识
- 不可判断返回UNKNOWN
- 批量校验保存输入指纹
用边界样例测试最小规则
测试组包含正常记录、场地未知、日期精度、同队冲突、无法映射状态和缺时区。每个样例声明预期的字段状态与错误码。虚构数据只服务规则验证，醒目标记为合成，不能流入公开赛事索引。
新增必填规则要先跑历史样本预览，确认不会把合法旧空值误判。测试失败保留运行号和差异。结构测试通过不证明来源值真实，事实层仍依赖来源和时间证据，两层状态在页面分开。契约测试还要让列表、详情、聚合和导出分别读取同一最小记录，验证各自按用途停止或降级。任何消费者擅自补主场、时刻或状态，都作为阻断缺陷。
- 测试覆盖合法空值与冲突
- 合成样本禁止进入公开索引
- 结构与事实状态分离
发布字段卡及其未知边界
公开卡列字段定义、类型、格式、关系、来源状态、规则版本、观察时间和空值含义。读者可以看到某个值为何不可计算，而不是只见红叉。没有现场证据的实例继续显示UNKNOWN，不把示例当当前记录。
独立图谱不保证实时完整，也不以队名或场地映射证明身份。任何更正通过修订链追加。规则卡更新时旧记录保留当时版本，重新校验结果另存，使页面变化能够区分资料修订与规则演进。最小字段还要通过删除测试验证：依次移除赛事标识、参赛方、计划时间和状态，观察哪些视图应停止发布，哪些视图可以带UNKNOWN继续展示。测试结论写入consumer_contract，不由前端临时决定。列表页需要的最小集合可能小于详情页，排名计算又会要求可核结果，因此“最小”必须绑定用途。对手一方待映射时，页面保留来源原名和候选状态，不复制另一队资料。计划时间只有日期精度时，排序按日期区间处理，不能补零点。状态与结果矛盾时，两者均进入复核，不能用其中一个覆盖另一个。验收沿计划、临近开赛、场地变更与结束四个版本重放同一虚构记录，确认早期日期、原队名与未知字段没有被后来的精确值覆盖。接口消费者必须读取state、valid_at、recorded_at和precision；会把null补成本地时间、主场或零分的旧客户端应收到版本错误。另用两条队伍与日期相似但身份未证实的材料测试去重。删除测试还要记录每个消费者的停止理由和允许保留的字段集合，避免同一空值在不同用途被解释成不同事实。
- 字段卡公开空值含义
- 示例不得冒充当前记录
- 未证实资料只形成候选关系，撤回保留审计版本，模糊匹配与唯一键均不得直接合并实体
