133 lines
5.8 KiB
Markdown
133 lines
5.8 KiB
Markdown
# RULES_SOURCE_OF_TRUTH
|
||
|
||
最后更新: 2026-06-18
|
||
真相源: 本文件是"规则"维度的入口索引。
|
||
设计上下文: `docs/DESIGN_RULES_TRUSTED_CLI_2026-06-16.md` §2
|
||
执行上下文: `docs/ACTIVE_EXECUTION_BOARD_2026-06-17.md` §1.1
|
||
|
||
---
|
||
|
||
## 1. 范围
|
||
|
||
本文件收敛以下四类信息:
|
||
|
||
- 国家级规则
|
||
- 省级规则
|
||
- 规则证据链
|
||
- 统一审计入口
|
||
|
||
---
|
||
|
||
## 2. 当前真相源路径
|
||
|
||
| 类别 | 路径 | 格式 | 写入方式 |
|
||
| ---------- | ------------------------------------------ | -------- | ------------------------------- |
|
||
| 国家级规则 | `rules/_truth/national.yaml` | YAML | 人工摘录 + 官方文件校对 |
|
||
| 省级规则 | `rules/_truth/province/<slug>.yaml` | YAML | 人工摘录 + 招生考试院校对 |
|
||
| 规则证据层 | `rules/_evidence/<prov>/<year>-<topic>.md` | Markdown | 待补建（设计层 Phase 1.5 要求） |
|
||
| 旧规则字典 | `scripts/gaokao-checker` `PROVINCE_RULES` | Python | 过渡期镜像，已迁移到 \_truth |
|
||
| 错误码字典 | `rules/errors/ERRORS.md` | Markdown | 人工维护 |
|
||
|
||
### 2.1 当前已落地范围（2026-06-18）
|
||
|
||
- 已落地 `rules/_truth/national.yaml`（国家级）
|
||
- 已落地 `rules/_truth/province/<slug>.yaml`（27 省，2026 版）
|
||
- 已落地 `data/rules/loader.py` `RuleLoader.from_truth_root`
|
||
- 已落地 `data/rules/audit_engine.py` `AuditEngine`
|
||
- 已落地 `data/rules/cli.py` `rules {status,verify,list,explain,scaffold-evidence}`
|
||
- 已落地 `scripts/migrate_province_rules_to_truth.py`（从 `PROVINCE_RULES` 一次性迁移）
|
||
- 已落地 `tests/test_rules_truth_phase1.py` + `tests/test_rules_cli_phase1.py`（部分）
|
||
|
||
### 2.2 尚未落地
|
||
|
||
- `rules/_evidence/<prov>/<year>-<topic>.md` 完整官方摘录 — 已落湖南 11 条样本 + 北京 11 条样本 + 江苏 11 条样本 + 浙江 11 条样本 + 上海 11 条样本 + 安徽 11 条样本 + 山东 11 条样本 + 广东 11 条样本 + 湖北 11 条样本 + 河北 11 条样本 + 海南 11 条样本 + 福建 11 条样本 + 四川 11 条样本 + 江西 11 条样本 + 甘肃 11 条样本 + 贵州 11 条样本 + 云南 11 条样本 + 辽宁 11 条样本 + 吉林 11 条样本 + 黑龙江 11 条样本 + 广西 11 条样本 + 青海 11 条样本 + 西藏 11 条样本 + 新疆 11 条样本 + 天津 11 条样本 + 河南 11 条样本 + 重庆 11 条样本 + national 1 条样本；重庆则依据《录取批次及志愿设置》《录取顺序是怎样安排的》、`2026-06-09` 考后时间节点安排与重庆市教委 `2025` 实施办法闭环 `11/11`，将 `batch` 从 `普通批` 修正为 `本科批`、`collection_count` 从 `1` 修正为动态机读口径 `null`，并确认 `专业+学校 / 96 / 无调剂 / 分数优先、遵循志愿、一次投档 / 3+1+2 / 750` 口径；当前 active 省份已无 evidence 缺口，剩余工作转为内蒙古 / 陕西 / 宁夏 3 省 truth 与 evidence 首次建档
|
||
- 逐省证据链审计报告 — 当前仍未启动
|
||
- 逐省 stale 规则的证据补建与人工复核流程
|
||
|
||
---
|
||
|
||
## 3. 数据模型
|
||
|
||
### 3.1 Rule（`data/rules/models.py`）
|
||
|
||
```python
|
||
Rule:
|
||
rule_id: str # e.g. "HUNAN.max_volunteers"
|
||
scope: "national" | "province"
|
||
province: str | None # 当 scope=province 时
|
||
year: int # 2026
|
||
title: str
|
||
description: str
|
||
severity: "fatal" | "critical" | "warning" | "info"
|
||
value: dict # 规则可机读形式
|
||
source_evidence_id: str # 证据链引用
|
||
effective_date: date
|
||
last_verified_at: datetime
|
||
version: str # "2026.1"
|
||
status: "active" | "draft" | "deprecated"
|
||
```
|
||
|
||
### 3.2 AuditIssue（`data/rules/models.py`）
|
||
|
||
```python
|
||
AuditIssue:
|
||
rule_id: str
|
||
severity: RuleSeverity
|
||
title: str
|
||
message: str
|
||
evidence_quote: str | None
|
||
suggestion: str | None
|
||
```
|
||
|
||
---
|
||
|
||
## 4. 接入策略
|
||
|
||
### 4.1 国家级
|
||
|
||
- **首选源**: 教育部 / 教育考试院公开规则文件
|
||
- **覆盖范围**: 平行志愿、一次投档、退档机制、体检要求等
|
||
- **接入节奏**: 年度全量 + 差异更新
|
||
|
||
### 4.2 省级
|
||
|
||
- **首选源**: 各省招生考试院/教育考试院 2026 招生工作通知
|
||
- **覆盖范围**: 27 省（与 `PROVINCE_RULES` 对齐）
|
||
- **接入节奏**: 月度差异更新
|
||
|
||
### 4.3 证据层
|
||
|
||
- **首选源**: 上述官方文件原文
|
||
- **存储格式**: Markdown 摘录 + 官方文件 URL
|
||
- **校验**: 每条规则必须能引用至少一个证据条目
|
||
|
||
---
|
||
|
||
## 5. 统一审计入口
|
||
|
||
- `gaokao-cli rules status --json` — 27 省 + national 状态摘要 + 版本/证据覆盖摘要 + stale 明细
|
||
- `gaokao-cli rules verify --json` — `national.yaml` + `province/` 完整性 + stale/evidence 检查
|
||
- `gaokao-cli rules list --province <p> --json` — 枚举某省已加载规则
|
||
- `gaokao-cli rules explain <rule_id> --json` — 输出某条规则与证据绑定
|
||
- `gaokao-cli rules scaffold-evidence [--province] --json` — 为缺失证据生成 `draft_template` 模板与索引
|
||
- `gaokao-cli doctor --json` — 会联动 `rules verify`，stale 规则会直接拉低总健康状态
|
||
- `gaokao-cli audit run --province <p> --plan <json> --truth-root <path> --catalog-root <path> --json` — 完整审计
|
||
|
||
---
|
||
|
||
## 6. 下一阶段（执行 Phase 1 收口后的 Batch 候选清单）
|
||
|
||
> 已在 Phase 1 / 1.5 中**完成**的事项不再列入"必须收口"清单。
|
||
|
||
- 内蒙古 / 陕西 / 宁夏 3 省 truth yaml 与证据层首建 — **Batch 4 候选**
|
||
- 逐省证据链审计报告 — **Batch 4 候选**
|
||
- 把其它 `3` 省 `draft_template` 真正补成官方摘录后完成人工复核 — **Batch 4 候选**
|
||
|
||
---
|
||
|
||
## 7. 风险
|
||
|
||
- 证据层未建导致规则可信度依赖 yaml 自描述
|
||
- 旧 `PROVINCE_RULES` 字典与新 `_truth` 字典需要保持同步过渡
|
||
- 月度刷新流程目前依赖人工 cron，未与 `gaokao-cli rules status` 联动
|