Files
..

⑤.7 模板配置台(Template Console)内核引擎

父 EPIC:#9「⑤.7 模板配置台 Template Console」 子 issue:#62 / #63 / #64 / #65 / #66 / #67(同一 feature 分支 feature/issue-62,单 PR 关联全部 6 个 issue)

配置台是一个无代码、配置驱动的内核能力,让实施工程师(而非开发者)按现场调 模板:点位字典、模型超参、RAG、驾驶舱布局全部在配置台编排,预览确认后发布版本, 再把版本推送给内核(edge-gateway / rag-kb / model-framework)生效。本目录是配置台 的纯标准库核心引擎(不是 Web 前端——前端由 cockpit 渲染本引擎产出的结构化输出)。

为什么放在 core/?

配置台是跨模板通用的内核能力(RBAC / 配置存储 / 版本 / 推送契约服务于所有行业 模板:氯化 ti-cl4、树脂 resin、…),与 core/edge-gateway、core/rag-kb、 core/model-framework 同级,而非属于某个具体模板,故置于 core/template-console/。

6 个子任务映射

issue 模块 职责
#62 rbac.py 三级 RBAC(管理员 admin / 行业工程师 engineer / 只读 readonly),角色继承、has_permission(resource, action) 带理由判定、细粒度收窄
#63 point_importer.py 点位字典 CSV 导入 + 自动校验页面。复用 core/edge-gateway/point_dict 校验器(量纲/数据类型/采样率/重复点号/协议),增加 OPC 节点格式校验、表头列序校验、模板级量纲收窄(resin/ti)、行级结果聚合
#64 config_store.py 配置项 CRUD(模型超参 / RAG / 布局三类),文件系统版本化 JSON 存储,list/get/upsert/delete + 按类别校验,原子写,快照 snapshot/restore
#65 preview.py 预览渲染引擎:布局(widget 卡片 + 网格占用率/越界/重叠检测)/ 告警(规则渲染 + 模拟触发评估)/ NL 查询(模板 → 示例问句)。对齐 iAOP-cockpit-layout-v1 widget 类型
#66 release.py 版本发布 + 回滚点。基于 config_store 快照的 Release,semver 单调递增校验,publish 固化快照、rollback 恢复快照(不删历史、回滚事件可追溯)
#67 push_channel.py 配置台↔内核配置推送契约。PushManifest(版本/快照/SHA256 校验和),PushChannel 模拟推送(写 manifest 到内核 inbox)、幂等(同版本不重复推送)、retract 撤回、verify 完整性校验

设计原则(对齐 PRD「可解释可溯源」与既有内核范式)

  • 纯标准库零运行时依赖:不 import pyyaml/numpy/pandas。需要哈希用 hashlib, JSON 用 json,CSV 用 csv。
  • dataclass + Enum + 类型注解 + 中文 docstring,与 core/data-bus、 core/edge-gateway 风格一致。
  • 可解释性:关键决策都带 meaning / reason 字段(RBAC 判定理据、配置项修改 原因、发布 changelog、回滚事件、推送日志),便于审计与配置台展示。
  • 复用而非重造:#63 直接复用 core/edge-gateway/point_dict(schema/loader/validator), 只增加配置台专属校验维度,避免与内核点位字典机制漂移。

目录结构

core/template-console/
├── __init__.py            # 包入口(导出 RBAC 公共 API)
├── rbac.py                # #62 三级 RBAC
├── point_importer.py      # #63 点位字典 CSV 导入+校验
├── config_store.py        # #64 配置项 CRUD 存储
├── preview.py             # #65 预览渲染引擎
├── release.py             # #66 版本发布+回滚
├── push_channel.py        # #67 配置推送契约
├── _sanity_check.py       # 离线基本校验(跑全部测试 + 冒烟)
├── README.md              # 本文件
└── tests/
    ├── _bootstrap.py      # 挂载 template_console 包 + 暴露 edge-gateway/point_dict
    ├── test_rbac.py
    ├── test_point_importer.py
    ├── test_config_store.py
    ├── test_preview.py
    ├── test_release.py
    └── test_push_channel.py

运行测试

# 嵌入式 Python(无 pip/pyyaml)
/c/gitea/python312/python.exe -m unittest discover \
    -s core/template-console/tests -p "test_*.py" -v

# 离线基本校验(跑全部测试 + 冒烟)
/c/gitea/python312/python.exe core/template-console/_sanity_check.py

数据流(配置台典型用例)

实施工程师导入点位字典(#63) ─┐
行业工程师调模型超参/RAG/布局(#64) ─┼─▶ 预览确认(#65) ─▶ 管理员发布版本(#66)
                            │                                    │
                            │                                    ▼
                            └──────────────────── 配置推送内核(#67) ─▶ edge-gateway/rag-kb/...
全程受三级 RBAC(#62) 权限管控;每次变更可解释、可溯源、可回滚。