实现进度
快照日期：2026-08-04
分支：src-clean
版本：0.0.1-alpha.1（见 config/config.yaml）
本文按模块记录实现完成度。每个模块标注 ✅/🟡/🔴 及关键文件位置。
1. 启动与装配
模块 |
状态 |
关键文件 |
说明 |
|---|
启动脚本 |
✅ |
start.sh
|
11 阶段：环境检查 → 依赖同步 → 调试库重建 → 启动 |
主入口 |
✅ |
src/certflow/main.py
|
QApplication + DB 初始化 + 主窗口 |
应用装配 |
✅ |
src/certflow/bootstrap.py
|
AppContext 统一会话/Service 装配
|
日志系统 |
✅ |
src/certflow/utils/logger.py
|
loguru，支持 debug_modules 黑名单 |
高 DPI 适配 |
✅ |
main.py
|
QT_AUTO_SCALE_FACTOR=1
|
2. CLI 命令（共 24 个）
命令 |
状态 |
文件 |
说明 |
|---|
import-sales-plan
|
✅ |
cli/commands/import_sales_plan.py
|
对齐 GUI 全部参数 |
auto-number
|
✅ |
cli/commands/auto_number.py
|
|
print-cert
|
✅ |
cli/commands/print_cert.py
|
|
export-excel
|
✅ |
cli/commands/export_excel.py
|
|
export-access
|
🟡 |
cli/commands/export_access.py
|
依赖 Access 驱动，跨平台受限 |
quick-query
|
✅ |
cli/commands/quick_query.py
|
|
stats
|
✅ |
cli/commands/stats.py
|
|
mark-shipped
|
✅ |
cli/commands/mark_shipped.py
|
|
record-shipment
|
✅ |
cli/commands/record_shipment.py
|
|
set-year-month
|
✅ |
cli/commands/set_year_month.py
|
|
batch-update
|
✅ |
cli/commands/batch_update.py
|
|
grade-import
|
✅ |
cli/commands/grade_import.py
|
|
import-certs
|
✅ |
cli/commands/import_certs.py
|
|
copy-cert-info
|
✅ |
cli/commands/copy_cert_info.py
|
|
check-consistency
|
✅ |
cli/commands/check_consistency.py
|
|
clean-duplicates
|
✅ |
cli/commands/clean_duplicates.py
|
|
backfill-supply-type
|
✅ |
cli/commands/backfill_supply_type.py
|
|
db-backup
|
✅ |
cli/commands/db_backup.py
|
|
db-sync
|
✅ |
cli/commands/db_sync.py
|
WebDAV push/pull/status |
db-reset
|
✅ |
cli/commands/db_reset.py
|
支持从基线库重建 |
bom
|
✅ |
cli/commands/bom_material.py
|
|
report-gen
|
✅ |
cli/commands/report_gen.py
|
|
watch
|
✅ |
cli/commands/watch.py
|
watchdog 监控目录自动导入 |
serve
|
🔴 |
cli/commands/serve.py
|
占位命令，Web 模块未实现 |
3. 业务流程模块（操作者视角）
详见 04-operator-guide.md 各子文档。
3.1 销售计划导入
子流程 |
状态 |
关键文件 |
|---|
Excel 读取（python-calamine） |
✅ |
handlers/styled_excel_importer.py
|
列映射解析 |
✅ |
services/sale_plan_service.py
|
撞键策略 |
✅ |
services/import_gate_service.py
|
隔离队列（quarantine） |
✅ |
services/correction_queue_service.py
|
占位目录预建（B0-4） |
⚙️ |
config/import.yaml create_placeholder_dirs，默认 OFF
|
VBA 风格导入 |
✅ |
services/db_source_adapter.py
|
3.2 查询与字段补充
子流程 |
状态 |
关键文件 |
|---|
多条件查询构建器 |
✅ |
services/query_builder.py、query_service.py
|
查询视图（表格 + 快查） |
✅ |
views/query_view.py
|
字段批量编辑 |
✅ |
controllers/query_controller.py
|
合同信息复制到合格证 |
✅ |
action copy_cert_info |
合格证字段编辑 |
✅ |
action edit_cert_fields / edit_certificate |
生产状态推断 |
✅ |
services/workflow_service.py（StatusInference）
|
配置驱动状态/供货类型切换 |
✅ |
actions/registry.py（set_status_* / set_supply_type_*）
|
3.3 校正队列
子流程 |
状态 |
关键文件 |
|---|
隔离入队 |
✅ |
services/correction_queue_service.py
|
编辑后放行 |
✅ |
views/correction_queue_view.py
|
删除 |
✅ |
action delete（danger） |
3.4 编号
子流程 |
状态 |
关键文件 |
|---|
自动编号 |
✅ |
services/cert_numbering.py、cert_numbering_policy.py
|
手动编号 |
✅ |
action manual_number |
编号复制 |
✅ |
action copy_number |
年月前缀设置 |
✅ |
action set_year_month |
编号格式模板 |
⚙️ |
config/numbering.yaml，支持 {prefix}{date}{seq} 占位符
|
3.5 合格证生成与打印
子流程 |
状态 |
关键文件 |
|---|
合格证记录生成 |
✅ |
services/certificate_service.py、certificate_number_service.py
|
合格证预览 |
✅ |
views/certificate_preview_painter.py
|
打印引擎 |
✅ |
services/cert_print_engine.py
|
打印服务 |
✅ |
services/certificate_print_service.py
|
打印队列 |
✅ |
controllers/print_queue_controller.py
|
打印机管理 |
✅ |
services/printer_manager.py、controllers/printer_controller.py
|
打印历史 |
✅ |
services/print_history_service.py、controllers/history_controller.py
|
双码（DN/PN）计算 |
✅ |
services/dn_service.py、pn_service.py、dual_code.py、pressure_calc_service.py
|
3.6 报告生成
子流程 |
状态 |
关键文件 |
|---|
质保书/试压/材质报告 |
✅ |
services/report_fill_service.py、report_output_service.py
|
BOM 零件牌号匹配 |
✅ |
services/bom_material_service.py、bom_part_classifier.py
|
BOM 富化 |
✅ |
services/report_bom_enricher.py
|
报告视图 |
✅ |
views/report_view.py、controllers/report_controller.py
|
报告模板 |
⚙️ |
config/report.yaml、config/templates/
|
迁移草稿区 |
🟡 |
services/report_migration/
|
3.7 导出
子流程 |
状态 |
关键文件 |
|---|
Excel 导出 |
✅ |
handlers/csv_export.py、handlers/excel_handler.py、handlers/excel_styler.py
|
发货导出 |
✅ |
handlers/shipped_export_handler.py
|
Access 导出 |
🟡 |
cli/commands/export_access.py
|
输出保护 |
✅ |
services/output_guard.py
|
3.8 同步与备份
子流程 |
状态 |
关键文件 |
|---|
WebDAV 同步（坚果云） |
✅ |
cli/commands/db_sync.py、main.py::setup_webdav_config
|
数据库备份 |
✅ |
cli/commands/db_backup.py
|
四库模型（A/B/C/D） |
✅ |
start.sh 阶段10
|
3.9 基础字典维护
子流程 |
状态 |
关键文件 |
|---|
材质牌号 |
✅ |
services/material_grade_service.py、views/material_grade_manager_view.py
|
型号参数映射 |
✅ |
services/model_param_mapping_service.py、views/model_param_mapping_manager_view.py
|
口径映射 |
✅ |
services/caliber_mapping_service.py、views/caliber_mapping_manager_view.py
|
BOM 物料 |
✅ |
controllers/bom_material_controller.py、views/bom_material_query_view.py
|
字典 CSV 同步 |
✅ |
services/dict_csv_sync.py
|
空库自动播种 |
✅ |
main.py::_maybe_seed_base_data → scripts/data/seed_base_data.py
|
3.10 历史与归档
子流程 |
状态 |
关键文件 |
|---|
打印历史视图 |
✅ |
views/history_view.py
|
发货归档 |
✅ |
action shipped_archive |
发货导出后删除 |
✅ |
action shipped_export_delete |
4. 配置体系
配置文件 |
状态 |
用途 |
|---|
config.yaml
|
✅ |
索引文件，!include 拼接子配置 |
paths.yaml
|
✅ |
路径配置（支持 ${ENV_VAR} 与 paths.local.yaml 覆盖） |
sales_plan.yaml
|
✅ |
销售计划字段定义 |
grouping.yaml
|
✅ |
订单分组规则 |
certificate.yaml
|
✅ |
合格证模板字段 |
numbering.yaml
|
✅ |
编号规则 |
import.yaml
|
✅ |
导入参数（含占位目录开关 B0-4） |
database.yaml
|
✅ |
数据库连接 |
sync.yaml
|
✅ |
WebDAV 同步 |
printer.yaml / print.yaml
|
✅ |
打印机与打印参数 |
report.yaml
|
✅ |
报告模板与命名 |
quarantine.yaml
|
✅ |
校正队列规则 |
production_status.yaml
|
✅ |
生产状态定义（驱动 set_status_*） |
field_rules.yaml
|
✅ |
字段校验规则 |
dictionaries.yaml
|
✅ |
字典表 |
ui.yaml
|
✅ |
UI 布局、action、导航按钮 |
其余（colors/export/output/...） |
✅ |
见 config/ 目录 |
配置加载器：src/certflow/config/loader.py、settings.py、models.py、paths_override.py。
5. 数据模型
全部位于 src/certflow/models/，共 17 个模型：
模型 |
状态 |
用途 |
|---|
sale_plan.py
|
✅ |
销售计划（核心表） |
sale_plan_shipped.py
|
✅ |
已发货归档 |
sale_plan_change.py
|
✅ |
变更记录 |
certificate.py
|
✅ |
合格证 |
print_job.py / print_log.py
|
✅ |
打印任务/日志 |
bom_material.py
|
✅ |
BOM 物料 |
material_grade.py
|
✅ |
材质牌号 |
model_param_mapping.py
|
✅ |
型号参数映射 |
caliber_mapping.py
|
✅ |
口径映射 |
param_auto_learn_log.py
|
✅ |
参数自动学习日志 |
quarantine_sale_plan.py
|
✅ |
隔离队列 |
report_template.py
|
✅ |
报告模板 |
unmatched_certificate.py
|
✅ |
未匹配合格证 |
vba_mapping.py
|
✅ |
VBA 字段映射 |
auto_number.py
|
✅ |
自动编号状态 |
base.py
|
✅ |
SQLAlchemy Base |
6. 测试与质量
项 |
状态 |
说明 |
|---|
单元测试 |
🟡 |
tests/unit，覆盖率由 --cov=src/certflow 统计
|
Qt 测试 |
🟡 |
pytest-qt，标记 qt，无头用 QT_QPA_PLATFORM=offscreen
|
层纯度门禁 |
✅ |
scripts/check_layer_purity.py
|
类型检查 |
✅ |
pyright（basic 模式）+ mypy |
Lint |
✅ |
ruff 0.15.15 |
CI |
✅ |
ci/ 目录，16 个 yml
|
pre-commit |
✅ |
start.sh 阶段7.5 自动安装
|
7. 打包与部署
项 |
状态 |
说明 |
|---|
PyInstaller |
✅ |
scripts/builder/
|
Nuitka |
✅ |
备选构建器 |
依赖组管理 |
✅ |
pyproject.toml 依赖组：dev/lint/typing/test/docs/build/...
|