zhouyang.xie e54cf727e7 2.11.4 模块化重构 P4: 后端模块迁移(serve/gateway/cli/ops/windcms 共26件)+旧路径CLI与库兼容壳+接口文件改名避撞+安装根改用install_root; 版本表覆盖21条; 交付文档三件重出并核验通过 1 miesiąc temu
..
common e54cf727e7 2.11.4 模块化重构 P4: 后端模块迁移(serve/gateway/cli/ops/windcms 共26件)+旧路径CLI与库兼容壳+接口文件改名避撞+安装根改用install_root; 版本表覆盖21条; 交付文档三件重出并核验通过 1 miesiąc temu
README.md e54cf727e7 2.11.4 模块化重构 P4: 后端模块迁移(serve/gateway/cli/ops/windcms 共26件)+旧路径CLI与库兼容壳+接口文件改名避撞+安装根改用install_root; 版本表覆盖21条; 交付文档三件重出并核验通过 1 miesiąc temu
__init__.py 6076957aba 2.11.0 源码模块化重构 P0: 七个模块目录+接口层(common/app_x_guanlan/api.py)+模块边界门+四组件接入点接口+方案文档; 零行为变化 1 miesiąc temu

README.md

观澜 · 后端(app_backEnd/)

职责:组件服务(分析/振动/仿真/三维)、统一网关、运维控制台、重算编排与作业状态、CLI 与进程管理

允许依赖:app_common, app_ETL, app_algorithmModel, app_ontology

对外公开面:common/app_backEnd_guanlan/api.py —— 模块间调用只许走这里(scripts/module_boundary_audit.py 机器检查)。

当前实现落点(P4 已实体迁入):guanlan.py、scripts/{windscada_serve,guanlan_gateway,guanlan_ops,ops*}.py、src/windscada/{config,terms,i18n,lang,report_export}.py

迁移状态:P4 已完成(2026-09-22) —— 21 文件 / 10,482 行迁入本模块:cli.py(原根 guanlan.py)、serve.py(分析组件)、gateway.py、ops.py、service.py、start_hidden.py、ops_{launch,run,start_and_open,stop_keep_gateway}.py、windcms/{serve,orchestrator,llm,agent}.py 与config/terms/i18n/lang/report_export/deid/deid_public.py。入口路径(根 guanlan.py、scripts/<9 件>)与旧库路径全部留兼容壳;网关与 Nginx 的接入点契约改名为 gateway_contract.py(避免与真实现 gateway.py 撞名)。实逮并修掉三处:① 壳里 sys.path 插错层(scripts/ 的 parent 不是安装根);② serve/gateway 没有 main()(入口在 __main__ 守卫里直接起服务)⇒ 壳改为"有 main 调 main、没有就 runpy.run_path(run_name='__main__')";③ P0 的 gateway.py 接口契约与 P4 真实现撞名(真实现被挡在门外)。验收:服务起停 + 六条路由全 200(/、/detail/v2、/detail/api/fleet、/ops、/ops/api/state、/cms/、/sim/)。

依据:docs/重构方案_模块化_v0.1.md(用户令 2026-09-22:只重构目录与接口、零行为变化、逐版本可回滚)。