CertFlow 文档
=============

CertFlow —— 阀门合格证打印管理系统（PySide6 + SQLAlchemy）。

本文档由 Sphinx + myst-parser 构建。正文源为 Markdown，位于 ``docs/`` 根目录；
API 参考由 ``sphinx-apidoc`` 自动生成于 ``docs/api/``。

.. toctree::
   :maxdepth: 2
   :caption: 使用指南
   :hidden:

   /01-quickstart
   /03-configuration
   /04-operator-guide

.. toctree::
   :maxdepth: 2
   :caption: 操作流程
   :hidden:

   /04a-import-flow
   /04b-query-flow
   /04b2-correction-queue
   /04c-numbering-flow
   /04d-print-flow
   /04e-report-flow
   /04f-export-flow
   /04g-sync-flow
   /04h-base-data
   /04i-history-archive

.. toctree::
   :maxdepth: 2
   :caption: 参考
   :hidden:

   /02-architecture
   /05-cli-reference
   /06-developer-guide
   /07-progress
   /08-todo

.. toctree::
   :maxdepth: 2
   :caption: API 参考
   :hidden:

   /api/modules

概述
----

- **快速开始**：:doc:`/01-quickstart`
- **系统架构**：:doc:`/02-architecture`
- **配置体系**：:doc:`/03-configuration`
- **操作手册**：:doc:`/04-operator-guide`
- **CLI 命令**：:doc:`/05-cli-reference`
- **开发者指南**：:doc:`/06-developer-guide`
- **实现进度**：:doc:`/07-progress`
- **待办事项**：:doc:`/08-todo`
- **API 参考**：:doc:`/api/modules`

状态标识
--------

- ✅ **已完成** — 功能完整，已纳入日常使用
- 🟡 **基本完成** — 核心可用，存在边界情况或扩展待补
- 🔴 **未完成** — 占位实现或未启动
- ⚙️ **配置驱动** — 行为由 ``config/*.yaml`` 控制