certflow.services.workflow_service module

工作流服务 - 管理文档完成状态

提供标记文档完成、自动更新进度百分比、自动更新生产状态等功能。 自动升级规则由 config.yaml production_status.auto_upgrade 驱动。

class certflow.services.workflow_service.WorkflowService(session)

基类：object

工作流服务 - 管理文档完成状态

自动升级规则由 config.yaml production_status.auto_upgrade 配置驱动。 新增升级规则只需修改 YAML，无需改动代码。

参数:

session (Session)

mark_document_done(sale_plan_id, doc_type, file_path=None)

标记文档完成

参数:

• sale_plan_id (int) -- 销售计划 ID

• doc_type (str) -- 文档类型 (certificate/nameplate/test_report/warranty/scan)

• file_path (str | None) -- 文件路径（可选，预留扩展）

返回:

更新后的 SalePlan 对象，未找到则返回 None

返回类型:

SalePlan | None

mark_document_undone(sale_plan_id, doc_type)

撤销文档完成标记

参数:

• sale_plan_id (int) -- 销售计划 ID

• doc_type (str) -- 文档类型

返回:

更新后的 SalePlan 对象，未找到则返回 None

返回类型:

SalePlan | None

batch_mark_done(sale_plan_ids, doc_type)

批量标记文档完成

参数:

• sale_plan_ids (list[int]) -- 销售计划 ID 列表

• doc_type (str) -- 文档类型

返回:

N, "failed": M}

返回类型:

{"success"