refactor: 架构重组 — doc/bot → core/infra，新增 Agent 调度模块

- src/doc/ 拆分为 src/core/extraction/, matching/, validation/（核心业务逻辑）
- src/bot/ 重命名为 src/infra/browser/（浏览器自动化基础设施）
- fill_consumable_doc.py → src/infra/documents/consumable.py
- 新增 Agent 调度模块：coordinator.py, events.py, session.py，重构 orchestrator.py
- 更新 AGENTS.md、README.md 及所有子目录 README

README.md

@@ -18,20 +18,40 @@
 ├── src/
 │   ├── __init__.py                 # 包初始化 / 日志器
 │   ├── config.py                   # 配置加载
-│   ├── bot.py                      # 浏览器自动填报
+│   ├── exceptions.py               # 异常定义
 │   ├── pipeline.py                 # CLI 流程编排
+│   ├── pipeline_core.py            # CLI/Web 公共管道逻辑
 │   ├── main.py                     # CLI 入口
-│   ├── doc/                        # 文档处理模块
-│   │   ├── extractor.py            # 编排入口：串联 PDF 读取 → LLM 提取 → 分类
-│   │   ├── pdf.py                  # PDF 图片渲染（PyMuPDF，供多模态 LLM 使用）
-│   │   ├── llm_extractor.py        # LLM 信息提取
-│   │   ├── matcher.py              # 数据匹配与校验
-│   │   ├── invoice.py              # 发票类型常量、分类逻辑、CSV 读写工具
-│   │   ├── fill_consumable_doc.py  # 将 CSV 填入易耗品出库单（Word COM）
-│   │   ├── prompt.py               # LLM 提示词模板
-│   │   └── prompts/                # 提示词模板文件
-│   └── web/
-│       ├── app.py                  # Web 服务入口
+│   ├── agent/                      # Agent 调度模块
+│   │   ├── orchestrator.py         # 总调度入口
+│   │   ├── coordinator.py          # 校验-修正循环
+│   │   ├── session.py              # 状态机与会话数据
+│   │   └── events.py               # SSE 事件发射
+│   ├── core/                       # 核心业务逻辑
+│   │   ├── extraction/             # 信息提取
+│   │   │   ├── extractor.py        # 编排入口：串联文件扫描 → 提取 → 分类
+│   │   │   └── llm_extractor.py    # LLM 多模态信息提取
+│   │   ├── matching/               # 金额匹配
+│   │   │   └── matcher.py          # 支付记录与发票关联
+│   │   └── validation/             # 校验模块
+│   │       └── validator.py        # 声明式校验器
+│   ├── infra/                      # 基础设施层
+│   │   ├── browser/                # 浏览器自动化
+│   │   │   ├── base.py             # BaseBot 基类
+│   │   │   ├── travel.py           # 差旅报销填报流程
+│   │   │   └── normal.py           # 普通报销填报流程
+│   │   ├── documents/              # 文档处理
+│   │   │   ├── invoice.py          # 发票数据模型 + CSV 工具
+│   │   │   ├── pdf.py              # PDF 图片渲染
+│   │   │   └── consumable.py       # 易耗品出库单填写（Word COM）
+│   │   └── llm/                    # LLM 接口
+│   │       ├── prompt.py           # 提示词加载
+│   │       └── prompts/            # 提示词模板文件
+│   └── web/                        # Web 界面模块
+│       ├── app.py                  # Flask 应用入口
+│       ├── routes.py               # 路由定义
+│       ├── pipeline_web.py         # Web 管道逻辑
+│       ├── sse_handler.py          # SSE 日志流处理
 │       ├── templates/
 │       │   ├── index.html          # PC 端主页
 │       │   └── mobile_upload.html  # 移动端扫码上传
@@ -48,6 +68,66 @@
 └── *.pdf / *.jpg / *.png           # 发票 PDF 或图片（CLI 模式，放在 scripts/data/）
 ```
 
+## 声明式校验器
+
+`src/core/validation/validator.py` 采用**规则配置与校验引擎分离**的设计模式，支持声明式定义校验规则：
+
+### 设计特点
+
+| 特性 | 说明 |
+|------|------|
+| **声明式配置** | 校验规则以数据结构形式定义，无需编写代码 |
+| **统一路径定位** | 使用 `path` 统一定位字段，如 `["basic_info", "travel_purpose"]` |
+| **自定义校验函数** | 支持为字段定义自定义校验逻辑（日期格式、正数检查等） |
+| **数组元素校验** | 支持校验数组字段的最小元素数量及每个元素的必填字段 |
+| **向后兼容** | 支持简单格式 `["field1", "field2"]` 和详细格式 `{"path": [...], "custom_check": ...}` |
+
+### 规则配置示例
+
+```python
+# 差旅报销校验规则
+TRAVEL_VALIDATION_RULES = {
+    "fields": [
+        {"path": ["basic_info", "travel_purpose"], "description": "出差事由"},
+        {"path": ["basic_info", "start_date"], "custom_check": _is_valid_date},
+    ],
+    "arrays": [
+        {
+            "path": ["payment_methods"],
+            "min_items": 1,  # 至少1条支付记录
+            "element_fields": [
+                {"path": ["card_date"], "description": "刷卡日期"},
+                {"path": ["card_amount"], "custom_check": _is_positive_number},
+            ],
+        },
+    ],
+}
+```
+
+### 校验规则类型
+
+| 规则类型 | 用途 | 关键字段 |
+|----------|------|----------|
+| `fields` | 顶层单值字段校验 | `path`, `custom_check`, `check_empty` |
+| `arrays` | 数组字段校验 | `path`, `min_items`, `element_fields` |
+
+### 内置校验函数
+
+- `_is_valid_date(value)` — 检查日期格式是否为 `YYYY-MM-DD`
+- `_is_positive_number(value)` — 检查值是否为正数
+
+### 扩展自定义校验
+
+```python
+# 定义自定义校验函数
+def check_vehicle_type(value):
+    valid_types = ["飞机", "火车", "汽车", "打车"]
+    return isinstance(value, str) and value.strip() in valid_types
+
+# 在规则中使用
+{"path": ["vehicle_type"], "custom_check": check_vehicle_type}
+```
+
 ## 数据流
 
 ```mermaid
@@ -73,21 +153,21 @@ flowchart TB
     MatchResult --> NormalLLM
     NormalLLM --> NormalInfo[(normal_info.json)]
 
-    TravelInfo -->|差旅基本信息| Bot_T[bot/travel.py<br/>差旅填报流程]
+    TravelInfo -->|差旅基本信息| Bot_T[infra/browser/travel.py<br/>差旅填报流程]
     TravelInfo -->|报销明细| Bot_T
     TravelInfo -->|支付方式| Bot_T
     TravelInfo -->|补助清单| Bot_T
     TravelInfo -->|附件清单| Bot_T
     Bot_T --> Submit_T[差旅报销提交]
 
-    NormalInfo -->|报销说明| Bot_G[bot/normal.py<br/>普通填报流程]
+    NormalInfo -->|报销说明| Bot_G[infra/browser/normal.py<br/>普通填报流程]
     NormalInfo -->|发票总数/金额| Bot_G
     NormalInfo -->|支付方式| Bot_G
     NormalInfo -->|附件清单| Bot_G
     Bot_G --> Submit_G[普通报销提交]
 
     General --> CSV[(invoice_summary.csv)]
-    CSV --> Fill[fill_consumable_doc]
+    CSV --> Fill[consumable.py]
     Fill --> Doc[易耗品、出库单.doc]
 ```
 
@@ -103,14 +183,14 @@ flowchart TB
 
 ### bot 模块架构
 
-`bot/` 包负责浏览器自动化填报，仅接收已提取的信息并执行填报操作，不承担信息提取职责：
+`infra/browser/` 包负责浏览器自动化填报，仅接收已提取的信息并执行填报操作，不承担信息提取职责：
 
 | 模块 | 职责 |
 |------|------|
-| `bot/base.py` | `BaseBot` 基类：浏览器生命周期、登录、导航、截图 |
-| `bot/travel.py` | 差旅填报流程：基本信息 → 差旅明细 → 支付方式 → 补助清单 → 附件上传 |
-| `bot/normal.py` | 普通填报流程：基本信息 → 总明细 → 支付方式 → 附件上传 |
-| `bot/__init__.py` | 入口函数：`run_bot()` / `run_bot_web()`，负责类型判断和流程路由 |
+| `infra/browser/base.py` | `BaseBot` 基类：浏览器生命周期、登录、导航、截图 |
+| `infra/browser/travel.py` | 差旅填报流程：基本信息 → 差旅明细 → 支付方式 → 补助清单 → 附件上传 |
+| `infra/browser/normal.py` | 普通填报流程：基本信息 → 总明细 → 支付方式 → 附件上传 |
+| `infra/browser/__init__.py` | 入口函数：`run_bot()` / `run_bot_web()`，负责类型判断和流程路由 |
 
 ## 环境要求
 
@@ -200,10 +280,10 @@ uv run python src/main.py -u 工号 -p 密码
 需已生成 `invoice_summary.csv`，且本机已安装 **Microsoft Word**：
 
 ```bash
-uv run python -m src.doc.fill_consumable_doc
-uv run python -m src.doc.fill_consumable_doc --csv invoice_summary.csv --doc "易耗品、出库单.doc"
-uv run python -m src.doc.fill_consumable_doc --config scripts/config.json  # 指定配置文件
-uv run python -m src.doc.fill_consumable_doc --no-backup   # 不生成 .doc.bak 备份
+uv run python -m src.infra.documents.consumable
+uv run python -m src.infra.documents.consumable --csv invoice_summary.csv --doc "易耗品、出库单.doc"
+uv run python -m src.infra.documents.consumable --config scripts/config.json  # 指定配置文件
+uv run python -m src.infra.documents.consumable --no-backup   # 不生成 .doc.bak 备份
 ```
 
 填写规则概要：