04i 打印历史与发货归档

状态:✅ 已实现

1. 操作入口

方式

入口

GUI

导航「打印历史」→ HistoryView

CLI

certflow mark-shipped / certflow record-shipment

2. 涉及配置

配置文件

关键字段

说明

config/sales_plan.yaml

发货字段

发货相关字段

3. 涉及代码文件

文件

职责

View

views/history_view.py

打印历史视图

Controller

controllers/history_controller.py

历史编排

Service

services/print_history_service.py

打印历史读取

Handler

handlers/shipped_export_handler.py

发货导出

Model

models/print_log.py

打印日志

Model

models/sale_plan_shipped.py

已发货归档表

Model

models/sale_plan_change.py

变更记录

Action

actions/registry.py

shipped_archive / shipped_export_delete

4. 逐步流程

4.1 查看打印历史

  1. 导航「打印历史」

  2. HistoryView 表格展示 print_log 记录(时间/操作员/记录/份数/结果)

  3. 支持按日期/客户/型号筛选

4.2 发货归档

在查询页右键菜单:

操作

action

说明

发货归档

shipped_archive

_shipped_archive,记录移入 sale_plan_shipped

发货导出后删除

shipped_export_delete

_shipped_export_delete

CLI:

certflow mark-shipped --plan-no CF2026080001
certflow record-shipment --plan-no CF2026080001 --date 2026-08-04 --carrier SF

4.3 变更记录

每次字段编辑/状态切换记录到 sale_plan_change 表,支持审计追溯。

5. 常见问题

  • 历史为空:确认之前执行过打印(打印日志由 PrintHistoryService 写入)

  • 发货后找不到记录:已归档到 sale_plan_shipped,在对应视图查询

  • 误操作删除shipped_export_delete 为危险操作,确认前会二次提示