赛程字段字典
空值、未知与不适用为何必须分开
为三种缺值建立不同显示和校验规则。 本文给出可复核步骤、状态边界、脱敏记录方法与复核路径。
空白单元格可能表示尚未采集、来源没有提供、字段对这类赛事不适用，也可能只是系统错误。把这些情况都保存为空，会让读者误以为没有数据就是零或否定。图谱为缺值建立不同状态：缺失表示预期字段尚无值，UNKNOWN表示当前证据无法判断，不适用表示字段在既定结构中没有意义；每种状态都需要原因和时间。读者还能查看该状态由哪条规则产生以及何时计划复核，避免把临时缺口理解为永久结论。
本文只解释缺失、UNKNOWN与不适用三种缺值状态，不把任何一种状态推导为比赛取消、没有安排或记录不存在。示例仅用于验证字段语义；现实记录缺少来源或定义时保留原文和原因，不以零值、默认日期或待定文案补齐。
缺失表示字段应该存在但尚未取得
当数据合同要求开赛时间，却在采集材料中找不到对应值，状态为缺失。记录需说明检查过哪些位置、来源时间和下次复核计划。缺失不是空字符串；数据库保存状态枚举，值字段保持空，页面用尚未取得显示。编辑不能填零点、今天日期或上一场时间来满足必填验证。
来源稍后补值时创建字段更新，旧缺失状态保留在历史。若发现字段其实不属于该赛事结构，再通过定义修订将其改为不适用，而不是直接删除缺口。缺失数量可以用于质量报告，但不能被解释成赛事没有安排。采集器若只取得页面骨架或字段所在区域不可见，记录检查过的位置、页面版本与取得时间；这种空白观察仍属于缺失，不能因抓取失败改成不适用。
- 缺失字段拥有检查记录
- 不使用默认时间补空
- 补值保留历史状态
- 缺失统计不解释赛事事实
UNKNOWN用于无法可靠判断的情况
两个来源给出不同时间、图片裁切掉年份、时区无法确认或队伍角色含糊时，值状态为UNKNOWN。它说明材料存在但不足以选择答案。编辑并列原值、冲突原因和复核问题，不通过多数票或较晚时间自动决定。对外导出应返回显式未知，而不是省略字段让消费端自行猜测。
未知可以长期存在，直到取得可追溯的新证据。复核到期不会把UNKNOWN改成缺失，因为两者成因不同。若安全边界阻止继续采集，原因写无法安全复核；不能为了消除未知而登录、提交资料或绕过保护。同一字段存在互相冲突的原值时，证据卡还保存各自对象范围和时间精度；冲突解决前，搜索、筛选和提醒都读取UNKNOWN而不是任选一项。
- 冲突值使用UNKNOWN
- 导出显式表达未知
- 到期不改变缺值类型
- 补证不突破安全边界
不适用必须由结构定义支持
某赛事没有轮次概念、某状态下结束原因字段不被使用，才可以标不适用。决定来自赛事结构或字段合同版本，而不是来源恰好没有写。记录保存定义号和适用条件；没有结构证据时不能选择不适用，只能缺失或UNKNOWN。
结构升级可能让原先不适用的字段变成需要填写，系统创建定义变更并重新评估相关记录。历史页面仍显示当时合同，避免用新规则倒算旧数据。统计时不适用项不进入完整率分母，UNKNOWN和缺失则分别计数。合同规则必须说明不适用的结构条件和生效版本。赛事格式改变时重新评估相关字段，但历史页继续引用当时合同，避免把新规则倒灌到旧记录。
- 不适用引用定义版本
- 来源没写不等于不适用
- 结构变化触发重评
- 完整率分母排除不适用
展示层避免空白和零值混淆
字段卡使用文字标签与说明图标，空值区域不留成白块。缺失显示尚未取得，UNKNOWN显示无法判断，不适用显示该结构不用此字段。颜色只是辅助，读屏器能读出完整状态。零是一个真实数值，只有来源明确给出且定义允许时才能保存。
列表筛选允许按三种状态查找，排序把它们放在明确分组，不默认排到末尾后消失。搜索摘要不把未知时间写待定开赛，结构化数据也不生成空日期。移动端窄屏仍保留状态文字，不能只剩问号。API返回状态、原因和原始材料，导出增加语义列，禁止把UNKNOWN转成零、空数组或一九七零年日期。窄屏和读屏输出也必须读出完整原因。
- 空值区域有明确文字
- 零值需要真实来源
- 筛选保留三类状态
- 结构化数据不造空日期
验证规则按字段类型区分
时间字段缺年份与缺时区属于不同未知原因；队伍字段缺实体与角色含糊也应分开。校验器返回字段路径、状态、原因代码和需要的证据，不只给必填错误。编辑可以保存待核草稿，但无法生成公开赛程卡。
批量导入遇到空字符串、破折号、斜线或零时，不直接映射。映射表先按来源版本解释这些符号；没有说明就保存原文并标UNKNOWN。程序更新映射后重新处理需创建新批次，旧解析结果留存，防止静默改变大量记录。迁移旧数据前先盘点破折号、斜线、空串、零值与待定词，按来源版本建立映射。无法判别的值进入人工队列，原始字符串与迁移批次继续可查。
- 未知原因细分到字段
- 待核草稿不能公开
- 符号映射依赖来源版本
- 重新解析生成新批次
合成案例检验三种语义
F三的开赛原文为空但合同要求时间，状态为缺失；F四写二十时却没有时区，原文保留，转换值UNKNOWN；F五属于没有轮次的结构，轮次不适用并引用定义V二。三条记录不能在导出中都变成空值，否则消费端会得到错误含义。
另一案例来源用横线表示尚未公布，映射表没有证据说明其含义。编辑保存横线原文并标UNKNOWN，不把它当零、取消或不适用。所有比赛号和版本号均为训练占位，构建流程排除演练数据。往返测试把导出结果重新导入，并在多语言、筛选和排序场景比较状态枚举与理由；三种缺值若在任一层合并，整批迁移判定失败。
- 三类缺值导出不同
- 原文符号得到保留
- 无映射时不猜语义
- 训练案例不进入公开源
审核缺值是否被下游正确继承
审核从数据库到页面、API、搜索摘要和缓存逐层检查同一字段，确认状态没有被框架转成空、零或默认文字。主客队关系任一方UNKNOWN时，组合卡必须阻断；时间不适用的记录则不显示倒计时。任何下游自行补值都视为严重错误。
方法页公开每种状态的定义、例子和不可推导内容。图谱只说明现有证据，不从空白判断比赛、队伍或平台状态。补证后用修订链更新，旧缺值继续可查。清楚保留未知比制造一张完整但错误的表格更重要。监控分别报告三种状态的数量与变更来源。某类突然下降先查默认值泄漏，突然上升先查采集或字典故障；质量摘要保留完整分母。抽查还确认零值仍作为真实数值参与计算，而三种缺值不会被放进同一个完整率分母。
- 状态贯穿所有输出层
- 关系未知阻断组合卡
- 下游禁止默认补值
- 补证通过修订链完成
