╔══════════════════════════════════════════════════════════════════════════════╗ ║ 配置分类功能 - 架构图解 ║ ╚══════════════════════════════════════════════════════════════════════════════╝ ┌─────────────────────────────────────────────────────────────────────────────┐ │ 目录结构 │ └─────────────────────────────────────────────────────────────────────────────┘ 程序目录/ │ ├── configs/ ◄─── 配置分类根目录 │ │ │ ├── 600泵/ ◄─── 分类1 │ │ ├── default.json ◄─── 配置文件 │ │ └── template.docx ◄─── 模板文件 │ │ │ └── 1000泵/ ◄─── 分类2 │ ├── default.json │ └── template.docx │ ├── config_category.py ◄─── 核心管理模块 ├── config_category_widget.py ◄─── UI组件 └── ui_main.py ◄─── 主程序 ┌─────────────────────────────────────────────────────────────────────────────┐ │ 工作流程 │ └─────────────────────────────────────────────────────────────────────────────┘ 1. 程序启动 │ ├─► 扫描 configs/ 目录 │ │ │ ├─► 发现 "600泵" 分类 │ │ ├─ default.json ✓ │ │ └─ template.docx ✓ │ │ │ └─► 发现 "1000泵" 分类 │ ├─ default.json ✓ │ └─ template.docx ✓ │ └─► 显示分类选择器 │ └─► 加载默认分类配置 2. 用户选择分类 │ ├─► 保存当前配置 │ ├─► 加载新分类配置 │ ├─ 读取 default.json │ └─ 加载 template.docx │ └─► 更新UI显示 3. 用户修改配置 │ └─► 自动保存到当前分类 └─ configs/当前分类/default.json 4. 用户开始实验 │ └─► 使用当前分类的配置 5. 用户生成报告 │ └─► 使用当前分类的模板 ┌─────────────────────────────────────────────────────────────────────────────┐ │ UI布局 │ └─────────────────────────────────────────────────────────────────────────────┘ ┌─────────────────────────────────────────────────────────────────────┐ │ Docx 报告生成器 [_][□][X] │ ├─────────────────────────────────────────────────────────────────────┤ │ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌────────┐│ │ │ 开始工单 │ │ 开始记录 │ │ 结束记录 │ │ 配置 ││ │ └──────────────┘ └──────────────┘ └──────────────┘ └────────┘│ │ │ │ 配置分类: [600泵 ▼] [刷新] ✓ 配置和模板已就绪 │ │ └─────────┘ │ │ │ │ │ ├─ 600泵 │ │ └─ 1000泵 │ │ │ │ ┌─────────────────────────────────────────────────────────────┐ │ │ │ │ │ │ │ 实验历史记录 │ │ │ │ │ │ │ └─────────────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────┘ ┌─────────────────────────────────────────────────────────────────────────────┐ │ 数据流 │ └─────────────────────────────────────────────────────────────────────────────┘ ConfigCategoryManager │ ├─► scan_categories() │ │ │ └─► 返回: [ConfigCategory, ConfigCategory, ...] │ ├─► get_category(name) │ │ │ └─► 返回: ConfigCategory │ └─► create_category(name, config, template) │ └─► 返回: ConfigCategory ConfigCategoryWidget │ ├─► 显示分类列表 │ ├─► 用户选择分类 │ │ │ └─► 发出信号: category_changed(name, config_path, template_path) │ └─► MainWindow 接收信号 │ ├─► 加载配置: AppConfig.load(config_path) │ ├─► 加载模板: template_path │ └─► 更新UI ┌─────────────────────────────────────────────────────────────────────────────┐ │ 核心类 │ └─────────────────────────────────────────────────────────────────────────────┘ ConfigCategory ├─ name: str # 分类名称 ├─ path: Path # 分类目录路径 ├─ config_path: Path # 配置文件路径 └─ template_path: Path | None # 模板文件路径 ConfigCategoryManager ├─ base_dir: Path # 基础目录 ├─ config_root: Path # 配置根目录 (configs/) │ ├─ scan_categories() → List[ConfigCategory] ├─ get_category(name) → ConfigCategory | None ├─ get_category_names() → List[str] ├─ create_category(...) → ConfigCategory └─ delete_category(name) → bool ConfigCategoryWidget (QWidget) ├─ category_combo: QComboBox # 分类下拉框 ├─ info_label: QLabel # 状态标签 │ ├─ category_changed: Signal # 分类改变信号 │ ├─ get_current_category() → ConfigCategory | None ├─ set_category(name) → bool └─ has_categories() → bool ┌─────────────────────────────────────────────────────────────────────────────┐ │ 使用场景 │ └─────────────────────────────────────────────────────────────────────────────┘ 场景1: 切换设备类型 ──────────────────── 用户: 选择 "600泵" 系统: 加载 configs/600泵/default.json 加载 configs/600泵/template.docx 更新UI显示 结果: 所有操作使用600泵的配置 场景2: 添加新分类 ──────────────────── 用户: 创建 configs/新设备/ 目录 复制 default.json 和 template.docx 点击 "刷新" 按钮 系统: 扫描目录 发现新分类 添加到下拉框 结果: 可以选择新分类 场景3: 修改配置 ──────────────────── 用户: 修改配置参数 系统: 自动保存到 configs/当前分类/default.json 结果: 配置保存到正确的分类文件 场景4: 生成报告 ──────────────────── 用户: 点击 "生成报告" 系统: 使用 configs/当前分类/template.docx 使用 configs/当前分类/default.json 中的配置 结果: 生成使用正确模板和配置的报告 ┌─────────────────────────────────────────────────────────────────────────────┐ │ 优势对比 │ └─────────────────────────────────────────────────────────────────────────────┘ 之前 现在 ──────────────────────────────────────────────────────── 单一 default.json → 多个分类配置 手动选择模板 → 自动关联模板 手动替换配置文件 → UI一键切换 配置容易混淆 → 完全隔离 管理困难 → 目录结构清晰 ┌─────────────────────────────────────────────────────────────────────────────┐ │ 快速开始 │ └─────────────────────────────────────────────────────────────────────────────┘ 步骤1: 初始化 ───────────── $ python setup_config_categories.py ✓ 创建 configs/ 目录 ✓ 创建 600泵 分类 ✓ 创建 1000泵 分类 步骤2: 验证 ───────────── $ python test_config_category.py ✓ 扫描到 2 个分类 ✓ 所有配置文件有效 ✓ 所有模板文件存在 步骤3: 集成 ───────────── 参考: 配置分类集成指南.md 集成代码示例.py 步骤4: 使用 ───────────── 1. 启动程序 2. 选择分类 3. 正常使用 ╔══════════════════════════════════════════════════════════════════════════════╗ ║ 完成！ ║ ╚══════════════════════════════════════════════════════════════════════════════╝