guanlan-src/configs/modules.yaml

# 观澜 · 模块登记表（用户令 2026-09-22：按算法/数据接入管理/前端/后端等模块重构，每模块一个目录）
#
# 这份表是**模块边界的单一真源**，由 scripts/module_boundary_audit.py 机器核对：
#   ① 每个模块目录的结构（common/<pkg>/{__init__,api}.py + README.md）必须在位；
#   ② 模块之间只许经对方 api.py 调用（不得直接 import 别的模块的实现包）；
#   ③ 依赖方向只能是 allow 里列的那些（不得反向、不得成环）；
#   ④ 公共层 app_common 不得依赖任何业务模块；
#   ⑤ 每个 api.py 的转发目标（P0 阶段指向既有实现）必须真实存在。
#
# 设计说明与分阶段迁移计划见 docs/重构方案_模块化_v0.1.md。
version: 1
layout:
  module_root: "app_<模块>"          # 每个模块一个目录
  common_dir: common                  # 跨模块可复用的公共组件层
  package_pattern: "app_<模块>_guanlan"  # 观澜在该模块的实现包
  public_face: api.py                 # 模块间调用只许走这里

modules:
  - name: app_common
    cn: 公共层
    resp: 路径真源/版本真源/日志/进程/入口引用/控制台输出/运行态作业文件/产物派生台账
    allow: []                         # 公共层不依赖任何业务模块
    impl_now: src/{paths,version,logfile,proc,entry_refs,console,opsjob,derived_manifest,tabfmt}.py
    phase: P1
    change_rate: 极少

  - name: app_ETL
    cn: 数据接入管理
    resp: 源件摄入（10 分钟/1 分钟/月度归档库/台账/振动）、放置与增量体检、标准仓、机型与场站契约、canonical 词典
    allow: [app_common]
    impl_now: src/windscada/{data,scada_source,slim,mdb_names}.py + scripts/rebuild_* 与 scada_* 等构建器
    phase: P2
    change_rate: 随现场数据形态
    plug_points: [TiDB community（标准仓读写）, MinIO（源件与产物对象存储）]

  - name: app_algorithmModel
    cn: 算法
    resp: 七系统判级矩阵、七镜头曲线、可靠性指标、控制参数一致性、融合面四源、振动与温度面、趋势与可用率
    allow: [app_common, app_ETL]
    impl_now: src/windscada/{taxonomy,audit}.py、perf/*、subsys/*、src/windcms/{report_std,tcm,knowledge,cross_review,audit_rules,pipeline}.py
    phase: P3
    change_rate: 最快

  - name: app_ontology
    cn: 本体与知识层
    resp: 对象库与码表摄入、机制链、决策台、检索索引、实机参数表、SOP 场景与验收状态机、本机模型闸
    allow: [app_common]
    impl_now: src/ontology/*、src/sop/*
    phase: P6
    change_rate: 中

  - name: app_backEnd
    cn: 后端
    resp: 组件服务、统一网关、运维控制台与重算编排、作业状态、CLI 与进程管理
    allow: [app_common, app_ETL, app_algorithmModel, app_ontology]
    impl_now: guanlan.py、scripts/{windscada_serve,guanlan_gateway,guanlan_ops,_ops_*}.py、src/windscada/{config,terms,i18n,lang,report_export}.py
    phase: P4
    change_rate: 慢
    plug_points: [Redis（按时间窗缓存与作业状态）, Nginx（统一入口与静态件）]

  - name: app_frontEnd
    cn: 前端
    resp: v2 工作台单页与交互、图表库、门户与静态件
    allow: [app_common]
    impl_now: src/windscada/ui/{app.js,charts.js,build.py,snapshot.py}、windscada_serve.py 内页面模板、release/portal.html、release/viewer/
    phase: P5
    change_rate: 中

  - name: app_qualityGate
    cn: 质量门与审计 + 打包安装
    resp: 审计器（反向呼应/页面归口/配置统一/日志/链路/可移植/安全）、交付文档三检、打包器与开箱验证、安装与卸载
    allow: [app_common, app_ETL, app_algorithmModel, app_ontology, app_backEnd, app_frontEnd]
    impl_now: scripts/{*_audit,check_*,detail_deps,page_fingerprint,pack_dist,pack_verify_entry,guanlan_uninstall,delivery_docs_*}.py、install.*、uninstall.*
    phase: P7
    change_rate: 慢