# 04b2 校正队列流程

> 状态：✅ 已实现

## 1. 操作入口

| 方式 | 入口 |
|------|------|
| GUI | 导航栏「校正队列」→ `CorrectionQueueView` |

校正队列用于隔离导入时校验失败或需人工干预的销售计划记录。

## 2. 涉及配置

| 配置文件 | 说明 |
|----------|------|
| `config/quarantine.yaml` | 隔离规则、放行条件 |

## 3. 涉及代码文件

| 层 | 文件 | 职责 |
|----|------|------|
| View | `views/correction_queue_view.py` | 队列视图 |
| View | `views/correction_flag_query_view.py` | 隔离标记查询 |
| Controller | `controllers/correction_queue_controller.py` | 编排 |
| Service | `services/correction_queue_service.py` | 入队/放行/删除逻辑 |
| Model | `models/quarantine_sale_plan.py` | 隔离队列表 |

## 4. 逐步流程

### 4.1 入队（自动）

导入流程中，`ImportGateService` 检测到校验失败的记录时，调用 `CorrectionQueueService` 将记录写入 `quarantine_sale_plan` 表，并标记隔离原因。

### 4.2 查看队列

1. 导航「校正队列」
2. 表格展示所有隔离记录，含原始字段 + 隔离原因
3. 支持按原因/日期/客户筛选

### 4.3 处理记录（右键菜单 / 工具栏）

| 操作 | action | 方法 | 说明 |
|------|--------|------|------|
| 编辑并放行 | `edit_and_release` | `on_edit_and_release_quarantine` | 弹窗编辑字段后放行回主表 |
| 直接放行 | `release` | `on_release_quarantine` | 不修改直接放行 |
| 删除 | `delete` | `on_delete_quarantine` | **危险操作**（红色按钮），永久删除 |
| 刷新 | `refresh` | `refresh` | 重新加载队列 |

### 4.4 放行后

记录从 `quarantine_sale_plan` 表移回 `sale_plan` 表，可在查询页正常查看。

## 5. action 派发

校正队列的 action 通过 `actions/registry.py` 注册（category="correction"），统一经 `dispatch(view, action_name, item)` 派发，item 为右键菜单项的上下文 dict。

## 6. CLI 支持

校正队列目前主要通过 GUI 操作；CLI 无直接命令，但可通过 `certflow clean-duplicates` 清理重复记录、`certflow check-consistency` 检查一致性辅助维护。