校验失败箱
缺字段、格式错误与逻辑冲突的显示方式
三类失败使用不同状态和读者说明。 本文给出可复核步骤、状态边界、脱敏记录方法与复核路径。
缺字段、格式错误和逻辑冲突都可能让记录不可用，但修复路径完全不同。缺字段需要补材料或确认合法空值；格式错误需要定位解析位置；逻辑冲突需要同时查看多个字段和关系规则。若界面只显示一个红色“异常”，编辑会采取错误动作，读者也无法知道资料究竟缺了什么。
当前没有真实失败记录，全部示例为合成，现场状态UNKNOWN；start_time缺失、日期无法解析、结束早于开始分别用于演示三类卡片。每张卡保存failure_code、field_path、raw_value、rule_id、rule_version、detected_at、review_state和evidence，不生成默认修复值。展示失败时还需分清记录级与字段级影响。一个非关键图片说明缺失不应让整场记录标红；主队标识缺失却可能阻止赛程卡发布。规则卡定义severity_basis和blocks用途，页面说明“阻止排名计算”而不是笼统“严重”。同一字段可能先有格式失败，解析后又触发逻辑冲突，生命周期保留两个阶段，后者不能覆盖前者。错误码文案有版本，代码稳定，翻译变化不会让统计断裂。批量页面按类型、规则版本和处理状态筛选，总数旁注明数据范围。读屏用户能从卡片标题直接听到字段和问题，不依赖颜色。编辑提交补证时只附来源与观察时间，不直接填规范值；系统重新运行规则后决定状态。规则本身错误会让许多记录同批失败，异常聚类应提示规则维护者，但不能自动把所有失败撤回。规则修复后生成revalidation_batch，逐卡记录通过、仍失败或UNKNOWN。
把缺字段与合法空值分开
字段完全不存在、字段存在但值为空、字段合法不适用是三种状态。校验先读取要求规则和scope，再决定是否产生MISSING_FIELD。合法空值需null_reason，不适用需赛制依据。
规则范围未知时，不能断言字段缺失，状态为UNKNOWN。缺字段卡列需要的来源材料和当前适用条件。后来补值通过修订事件完成，旧卡标已处理而不删除。
- 不存在空值不适用分开
- 缺失判断先读取scope
- 补值通过修订链完成
为格式错误指出解析位置
格式卡保存原始字符串、预期语法、解析失败位置、字符编码、字段精度和解析器版本。日期二月三十日是语义无效，乱码可能是编码问题，两者错误码不同。
解析器无法识别不等于来源错误。原值进入隔离区，normalized_value为空。修复解析器后重新运行生成新事件，不能在卡片中手工改原文使红标消失。复现包保存输入指纹、字符编码、语言、解析器版本和最小失败片段；修复后用旧版本与新版本双跑，确认只改变预期字段，并把误报、漏报和仍不可解析的样本分别计数，结果进入回归集。
- 格式卡保留失败位置
- 原值不因解析失败被改写
- 解析器修复生成新事件
用多字段卡展示逻辑冲突
结束早于开始、主客实体相同、结束状态无结果都涉及关系。逻辑卡列所有field_path、各自值、时间精度、规则表达式和失败分支。不能把错误只挂在其中一栏。
任一参与字段UNKNOWN时，关系可能无法判断，应返回LOGIC_UNKNOWN而非冲突。规则本身缺来源也需标待核。读者从卡片能看到是字段间矛盾，不把它误解为格式问题。
- 逻辑卡列全部相关字段
- 参与值未知时不硬判冲突
- 规则来源状态同时展示
设计不同的颜色文字和动作
缺字段卡提供补证入口，格式卡提供原文和解析详情，逻辑卡提供关系图。颜色只是辅助，标题、图标与读屏文字明确类型。不能所有卡都放“自动修复”按钮。
动作权限也不同：补证可提交提议，解析修复由规则维护，逻辑冲突进入复核。任何动作先预览影响，不直接写业务值。无可执行动作时显示待核材料，而非空按钮。
- 三类卡提供不同动作
- 读屏文字直接说明类型
- 动作先预览影响
保存失败生命周期和修订关联
失败状态包括新建、待核、已确认、已处理、已撤回和重新出现。处理事件指向revision_id及新校验结果。规则变化导致旧失败不再适用，也以撤回原因记录。
同一字段重复失败不覆盖旧卡，使用occurrence连接。页面当前状态取最新有效事件，历史展开按时间显示。这样编辑能判断问题反复出现还是规则改变。规则升级造成的新失败应显示新旧版本差异，不能看成数据突然恶化。处理完成后，公开页、接口和导出的状态必须由同一事件版本驱动。
- 失败拥有明确生命周期
- 处理事件指向修订结果
- 重复失败不覆盖旧卡
用合成边界测试展示准确性
测试集包括字段缺失、合法空、格式失败、编码异常、两字段冲突和关系未知。预期卡片类型、错误码、动作和读屏文字全部断言。合成资料与公开索引隔离。
规则或界面更新后重跑截图测试，确认颜色、文字和详情仍对应。测试通过仅说明失败被正确分类，不证明现实资料正确。错误分类本身建立缺陷记录。测试矩阵覆盖桌面、窄屏、键盘操作、读屏、长文本与多语言原值，确保折叠或截断不会隐藏影响范围。另用接口快照核对可见提示、结构化字段和导出状态一致；页面说UNKNOWN而接口仍给旧值时阻止上线。修订后重新验证卡必须保留原失败入口，并清楚区分“规则已通过”和“事实已核”。
- 测试覆盖六种边界
- 校验错误码和读屏文案
- 合成资料隔离业务索引
公开失败原因而非真实性判断
读者视图显示字段、原值、失败类型、规则版本、检测时间、当前处理状态和UNKNOWN项。中性文字说明当前记录为何不可用于某项解释，不评价赛事真假。
失败界面要回答四件事：哪个字段失败、影响哪些用途、目前还能安全显示什么、需要哪类证据才能继续。字段卡保存来源原值、可公开上下文、规则名称与版本、检测时间和处理状态；堆栈、查询路径、凭据与个人标识只留在受控审计层。状态至少区分新发现、待补证、待规则复核、已修订、重新验证通过、仍失败和UNKNOWN，每次跳转都生成事件。记录级横幅汇总详情、排序、聚合或导出哪些用途受阻，字段级卡仍保留各自原因。有依赖的失败先修上游解析再重跑下游规则，避免一个根因产生多张假任务。结构化字段与可见页面使用同一状态，关键值未通过时删除或标未知，不能机器端继续输出默认值。界面用文字、图标、焦点顺序与读屏标签共同表达状态，移动折叠后仍显示字段名和下一步。验收样本覆盖长原文、空值、乱码、多语言、同字段连续失败、规则撤回、上游解析失败引发多个下游告警和修订后缓存未刷新。复核者分别查看桌面、移动、读屏、无脚本和结构化输出，核对字段名、受影响用途、原因与下一步一致，并确认没有内部路径、凭据或个人标识泄露。连续失败的同一字段只建立一个主事件并链接重复观察；若规则版本改变，再开新事件以区分资料问题和检测逻辑变化。
- 读者视图使用中性原因
- 失败不推导赛事真假
- 历史规则先影子运行；失败集中时先查解析器与规则版本，指标按独立记录、用途、待核时长和重复率统计，旧卡链接新事件
