操作者手册¶

状态：✅ 核心流程已实现；🟡 部分边界待补；⚙️ 配置驱动

本手册面向终端用户，按日常操作流程组织。每个子文档包含：操作入口、逐步步骤、涉及配置、涉及代码文件、常见问题。

流程总览¶

销售计划 Excel
     │
     ▼
[04a 导入] ──异常──► [04b2 校正队列] ──放行──► 回到主表
     │
     ▼
[04b 查询与补充] ◄──字段编辑/合同信息复制
     │
     ▼
[04c 编号]（自动/手动/年月前缀）
     │
     ├──► [04d 合格证打印] ──► [04i 打印历史]
     │
     ├──► [04e 报告生成]（质保书/试压/材质）
     │
     └──► [04f 导出]（Excel/Access）
                 │
                 ▼
          [04g WebDAV 同步] ──► 远程备份

[04h 基础字典维护] 支撑上述全流程（材质/型号/口径/BOM）

子文档¶

文档	流程	状态	操作入口
04a-import-flow.md	销售计划导入	✅	GUI: 导航「计划导入」/ CLI: `import-sales-plan`
04b-query-flow.md	查询与字段补充	✅	GUI: 导航「查询与补充」/ CLI: `quick-query`
04b2-correction-queue.md	校正队列	✅	GUI: 导航「校正队列」
04c-numbering-flow.md	自动/手动编号	✅	GUI: 查询页工具栏 / CLI: `auto-number`
04d-print-flow.md	合格证生成与打印	✅	GUI: 查询页「打印」/ CLI: `print-cert`
04e-report-flow.md	报告生成	✅	GUI: 导航「报告生成」/ CLI: `report-gen`
04f-export-flow.md	Excel / Access 导出	🟡	GUI: 导航「输出」/ CLI: `export-excel`
04g-sync-flow.md	WebDAV 远程同步	✅	CLI: `db-sync push/pull/status`
04h-base-data.md	基础字典维护	✅	GUI: 导航「基础数据维护」
04i-history-archive.md	打印历史与发货归档	✅	GUI: 导航「打印历史」

GUI 主界面导航¶

主窗口（views/main_window.py）采用左侧导航栏 + 右侧 QStackedWidget 布局。导航按钮通过 actions/registry.py 的 nav.* action 派发到 _nav_* 方法：

导航按钮	action	目标视图
计划导入	`nav.import`	`ImportPage`
查询与补充	`nav.query`	`QueryView`
输出	`nav.output`	`OutputView`
打印历史	`nav.history`	`HistoryView`
报告生成	`nav.report`	`ReportView`
校正队列	`nav.correction_queue`	`CorrectionQueueView`
基础数据维护	`nav.lookup_tables`	`LookupTablesDialog`
系统设置	`nav.settings`	`SettingsView`

action 派发机制¶

所有工具栏按钮、右键菜单项、导航按钮统一通过 actions/registry.py 的 dispatch(view, action_name, item) 派发：

ui.yaml 中声明 action: <name>
REGISTRY 中注册 ActionSpec(name, method)
视图实现对应 method
点击时调用 dispatch(view, name, item) → getattr(view, method)(item?)

配置驱动的动态 action（如 set_status_待生产）经前缀通用 action（set_status）承接，无需为每个状态值单独注册。