certflow.bootstrap module

应用装配（Application Bootstrap / Composition Root）

阶段 B 的落地模块：把「数据库管理器从哪来、会话从哪来、Service 如何构造」 收口到单一的装配入口，消除散落在 BaseController / PrintQueueController 里的隐式 DatabaseManager() 兜底与建表副作用。

设计约束（来自 tests/conftest.py 的书面约定）： - 提供工厂 build_context(db_manager=None) -> AppContext。 - AppContext 至少暴露 .db_manager 与 .session 两个属性，

以兼容现有 app_context fixture 的调用方签名。

本模块刻意保持轻量：不做全局单例强制、不接管 Qt 对象、不 eager 创建有 副作用的 Service（如 PrinterManager 会起监控线程、 CertificatePrintService 构造期 os.makedirs）。这些仍以「按需 provider」 形式存在，未来逐 Controller 迁移时再逐一定义。

class certflow.bootstrap.AppContext(db_manager, session=None)

基类：object

应用装配上下文

持有唯一的 DatabaseManager 与一个可选预创建的会话，作为 Controller / Service 依赖的统一来源。

参数:

• db_manager (DatabaseManager)

• session (Session | None)

db_manager

数据库管理器实例（唯一权威来源）

session

预创建的数据库会话（由 build_context 打开， 调用方可直接使用；不使用时由 close() 释放）

get_session()

获取一个数据库会话

若已持有会话（构造时预创建，或外部赋值 ctx.session = ...）则复用之； 否则即时从 db_manager 新建。即时新建的会话由调用方负责 close()。

返回:

可用的 SQLAlchemy 会话

返回类型:

Session

get_service(service_cls, *args, **kwargs)

以本上下文会话为首个参数构造一个 Service 实例

收口「Service(self.session) 散落各处」的构造方式：调用方不再 直接触碰 self.session，而是统一经此工厂获取 Service，使 session 来源（默认上下文 / 注入的 db_manager）成为唯一权威。

仅适用于构造签名首个位置参数为 Session 的 Service；首个参数非 会话的 Service（如 PrinterService(printer_name)）不应走此工厂。

参数:

• service_cls (type) -- Service 类（如 CertificateService）

• *args (object) -- 透传给 Service 构造的额外位置参数（排在 session 之后）

• **kwargs (object) -- 透传给 Service 构造的关键字参数

返回:

构造好的 Service 实例

返回类型:

object

ensure_initialized()

确保数据库引擎与会话工厂已就绪

把「建表副作用」集中到此方法：仅在引擎尚未创建时才 init_db， 避免 BaseController 每次构造都触发建表/迁移。

返回类型:

None

close()

释放本上下文持有的资源

关闭并清空当前持有的会话（无论预创建还是外部赋值），再关闭 db_manager。会话所有权统一由本上下文在 close 时回收。

返回类型:

None

certflow.bootstrap.build_context(db_manager=None)

构建应用装配上下文

约定入口：应用启动时由 main.init_database_manager() 注入已初始化的 db_manager；测试 fixture 注入临时库 db_manager；二者皆无时惰性 创建一个默认 DatabaseManager()``（原本散落在 ``BaseController 的兜底 逻辑，现集中到此处单一来源）。

参数:

db_manager (DatabaseManager | None) -- 已配置（且按需 init_db）的数据库管理器；为 None 时惰性创建默认实例。

返回:

装配好的应用上下文

返回类型:

AppContext

certflow.bootstrap.get_default_context()

获取（惰性创建）进程内默认上下文

供 BaseController 等在没有显式/共享 db_manager 时统一取用， 替代原先各自 DatabaseManager() 的散落兜底。

返回:

进程内默认上下文

返回类型:

AppContext

certflow.bootstrap.reset_default_context()

重置进程内默认上下文

供测试 teardown 调用，避免跨用例污染（原 _shared_db_manager 类变量 的同类问题）。

返回类型:

None