83 lines
4.9 KiB
Markdown
83 lines
4.9 KiB
Markdown
# ⑤.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
|
||
```
|
||
|
||
## 运行测试
|
||
|
||
```bash
|
||
# 嵌入式 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) 权限管控；每次变更可解释、可溯源、可回滚。
|
||
```
|