d786b8ee96
新增文档： - docs/ARCHITECTURE.md - 系统架构设计 - docs/DEVELOPMENT.md - 开发指南 - docs/TUTORIAL.md - 使用教程（导航+快速上手+API参考） 新增测试： - tests/test_all.py - 自动化测试脚本 - 省份简称识别（5个） - 方案检查（5个用例） - 所有测试通过 - tests/cases/hunan-578.md - 湖南测试用例 - tests/cases/zhejiang-630.md - 浙江测试用例 测试结果：所有6个测试用例通过 - 湘/浙/鲁/粤/鄂简称识别 - 湖南错误版方案检测 - 湖南修正版方案通过 - 浙江错误模式检测 - 山东正确方案通过 - 未提供省份处理
4.2 KiB
4.2 KiB
测试用例 - 湖南
错误版方案（用于验证检测能力）
bad_hunan_plan = """
湖南578分考生志愿方案
本次共填报45个学校志愿：
志愿01：江西财经大学，会计学
志愿02：长沙理工大学，财务管理
志愿03：山东财经大学，会计学
...
录取概率：
志愿01 35%
志愿02 45%
志愿03 50%
...
投档后如果不服从调剂，会被退到下个志愿。
所有会计学专业都要求物理+化学+生物选科。
参考2024年录取数据。
"""
预期检测结果
- 🔴 致命错误：2个
- E001 志愿单位错误（"45个学校"）
- E003 投档后规则错误（"退到下个志愿"）
- 🟡 严重错误：3个
- S001 主观概率
- S002 选科一刀切
- S003 位次数据年份错误
- 🟢 一般警告：1个
- W005 风险提示缺失
修正版方案（用于验证基础合规）
good_hunan_plan = """
湖南2026高考志愿填报方案（578分）
考生信息：
- 分数：578分
- 2025年参考位次：约26,800名
- 选科：物理+化学+生物
- 兴趣类型：C型（常规型）
本次共填报45个院校专业组志愿。
每个院校专业组最多6个专业+1个组内专业服从。
院校专业组示例：
志愿01：江西财经大学-会计学类组
- 6个专业：会计学/审计学/财务管理/资产评估/工商管理/经济学
- 选科要求：物理+化学
- 2025年参考位次：~20,000
数据来源：2025年湖南物理类一分一段表
2026年位次待官方公布（6月25日出分后）
风险提示：
- 退档原因：不服从调剂、单科不达标、体检受限
- 本科批设置2次征集志愿
- 一次投档，退档进入征集
"""
预期检测结果
- 🔴 致命错误：0个
- 🟡 严重错误：0-1个
- 🟢 一般警告：1-2个
完美版方案（理想标准）
perfect_hunan_plan = """
湖南2026高考志愿填报方案（578分）
【考生信息】
- 姓名：李明
- 考生号：******
- 分数：578分
- 2025年参考位次：约26,800名
- 2026年位次：待官方公布
- 选科：物理+化学+生物
- 兴趣类型：C型（常规型）
- 体检结果：正常（无色盲/色弱/视力异常）
- 学业水平：合格
【院校代码】
- 江西财经大学：10407
- 长沙理工大学：10536
- 湖南工商大学：10540
- 湖北经济学院：11600
【专业代码】
- 会计学：120203K
- 财务管理：120204
- 审计学：120207
- 金融学：020301
- 经济学：020101
【45个院校专业组志愿】
（每组最多6个专业+1个组内专业服从）
志愿01：江西财经大学-会计学类组
- 院校代码：10407
- 选科要求：物理+化学
- 6个专业：会计学(120203K)/审计学(120207)/财务管理(120204)/
资产评估(120208)/工商管理(120201K)/经济学(020101)
- 2025年参考位次：~20,000
- 组内专业服从：是
（...其余志愿类似格式...）
【数据来源】
- 2025年湖南物理类一分一段表
- 各院校2025年招生章程
- 阳光高考网：https://gaokao.chsi.com.cn/
【2026年参考】
- 招生计划：6月15-20日公布
- 实际位次：6月25日出分后确定
【风险提示】
1. 退档原因（按概率）：
- 不服从组内调剂（最常见）
- 单科分数不达标（英语/数学）
- 体检受限（色盲、色弱、视力、身高）
- 性别限制（部分专业）
2. 投档规则：分数优先、遵循志愿、一次投档
3. 征集志愿：本科批2次征集
【填报时间】
- 6月25日左右：公布成绩
- 6月29日-7月2日：填报本科批志愿
- 7月中旬：查询录取结果
- 7月下旬：征集志愿
【填报承诺书】
本人已认真阅读并理解上述志愿方案，自愿按此方案填报。
考生签名：__________
家长签名：__________
日期：2026年6月____日
"""
预期检测结果
- 🔴 致命错误：0个
- 🟡 严重错误：0个
- 🟢 一般警告：0-1个（最多只有轻微建议）
运行测试
# 保存错误版到文件
cat > /tmp/test_bad_hunan.md << 'EOF'
[bad_hunan_plan内容]
EOF
# 检查
python3 ~/.local/bin/gaokao-checker /tmp/test_bad_hunan.md
# 预期看到2-3个致命错误