zhouyang.xie 9deaf268c4 2.15.1 算法服务消缺: 入口接统一日志(prefix_stdout algorithm -> logs/algorithm.log, 日志门禁转绿) + 端点登记表按实测收口(撤 availability 与 span 参数) + 模块入口支持 run --cmd service + README 算法服务一节; 文档/版本表同步		1 주 전
..
app_common_guanlan	9deaf268c4 2.15.1 算法服务消缺: 入口接统一日志(prefix_stdout algorithm -> logs/algorithm.log, 日志门禁转绿) + 端点登记表按实测收口(撤 availability 与 span 参数) + 模块入口支持 run --cmd service + README 算法服务一节; 文档/版本表同步	1 주 전
common	26f1eca47f 2.13.0 P9 源码目录结构变更: 实现包上提模块根(app_X/app_X_guanlan)+旧前缀别名(同名同体)+每模块 common/configs/data/README.MD/install-run-uninstall 包装+配置双根(app_ETL/app_frontEnd configs 下放, 取用口多根+单源+owner); 修文档构建器死循环(落单反引号)并支持代码栅栏	1 주 전
configs	26f1eca47f 2.13.0 P9 源码目录结构变更: 实现包上提模块根(app_X/app_X_guanlan)+旧前缀别名(同名同体)+每模块 common/configs/data/README.MD/install-run-uninstall 包装+配置双根(app_ETL/app_frontEnd configs 下放, 取用口多根+单源+owner); 修文档构建器死循环(落单反引号)并支持代码栅栏	1 주 전
data	26f1eca47f 2.13.0 P9 源码目录结构变更: 实现包上提模块根(app_X/app_X_guanlan)+旧前缀别名(同名同体)+每模块 common/configs/data/README.MD/install-run-uninstall 包装+配置双根(app_ETL/app_frontEnd configs 下放, 取用口多根+单源+owner); 修文档构建器死循环(落单反引号)并支持代码栅栏	1 주 전
README.md	26f1eca47f 2.13.0 P9 源码目录结构变更: 实现包上提模块根(app_X/app_X_guanlan)+旧前缀别名(同名同体)+每模块 common/configs/data/README.MD/install-run-uninstall 包装+配置双根(app_ETL/app_frontEnd configs 下放, 取用口多根+单源+owner); 修文档构建器死循环(落单反引号)并支持代码栅栏	1 주 전
__init__.py	6076957aba 2.11.0 源码模块化重构 P0: 七个模块目录+接口层(common/app_x_guanlan/api.py)+模块边界门+四组件接入点接口+方案文档; 零行为变化	2 주 전
install.bat	899d17147f 2.14.0 分别打包: pack_dist --module(四模块各自成包, 真实依赖闭包=全模块) + MODULE_PACKAGE.json 标记 + 模块 install/run/uninstall 双模 + app_common bootstrap.py(独立装/检/跑/卸) + --verify --module; 根 VERSION 镜像纳入版本门; 文档与版本表同步	1 주 전
install.sh	899d17147f 2.14.0 分别打包: pack_dist --module(四模块各自成包, 真实依赖闭包=全模块) + MODULE_PACKAGE.json 标记 + 模块 install/run/uninstall 双模 + app_common bootstrap.py(独立装/检/跑/卸) + --verify --module; 根 VERSION 镜像纳入版本门; 文档与版本表同步	1 주 전
run.bat	899d17147f 2.14.0 分别打包: pack_dist --module(四模块各自成包, 真实依赖闭包=全模块) + MODULE_PACKAGE.json 标记 + 模块 install/run/uninstall 双模 + app_common bootstrap.py(独立装/检/跑/卸) + --verify --module; 根 VERSION 镜像纳入版本门; 文档与版本表同步	1 주 전
run.sh	899d17147f 2.14.0 分别打包: pack_dist --module(四模块各自成包, 真实依赖闭包=全模块) + MODULE_PACKAGE.json 标记 + 模块 install/run/uninstall 双模 + app_common bootstrap.py(独立装/检/跑/卸) + --verify --module; 根 VERSION 镜像纳入版本门; 文档与版本表同步	1 주 전
uninstall.bat	899d17147f 2.14.0 分别打包: pack_dist --module(四模块各自成包, 真实依赖闭包=全模块) + MODULE_PACKAGE.json 标记 + 模块 install/run/uninstall 双模 + app_common bootstrap.py(独立装/检/跑/卸) + --verify --module; 根 VERSION 镜像纳入版本门; 文档与版本表同步	1 주 전
uninstall.sh	899d17147f 2.14.0 分别打包: pack_dist --module(四模块各自成包, 真实依赖闭包=全模块) + MODULE_PACKAGE.json 标记 + 模块 install/run/uninstall 双模 + app_common bootstrap.py(独立装/检/跑/卸) + --verify --module; 根 VERSION 镜像纳入版本门; 文档与版本表同步	1 주 전

观澜 · 公共层（`app_common/`）

职责：路径真源、版本真源、日志、进程与静默启动、入口引用闭合、控制台输出、运行态作业文件、产物派生台账

允许依赖：（无：公共层不得依赖任何业务模块）

对外公开面：common/app_common_guanlan/api.py —— 模块间调用只许走这里（scripts/module_boundary_audit.py 机器检查）。

当前实现落点（P1 已实体迁入）：src/{paths,version,logfile,proc,entry_refs,console,opsjob,derived_manifest,tabfmt}.py

迁移计划：P1：把上述 9 个平台件实体迁到本目录，旧路径留转发壳。

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

安装部署与运行

本系统是单包离线交付：解压到无空格无中文路径 → 安装 → 自检 → 启动（一套安装，七个模块共用一份 .venv）。本模块目录里的脚本只是入口包装，内部调安装根的统一入口，保证"进模块目录也能装/跑/卸"：

动作	Windows	Linux/macOS	内部实际调用
安装	`install.bat`	`sh install.sh`	安装根 `install.bat` / `install.sh`（建 `.venv`、装依赖、自检、注册服务）
运行	`run.bat`	`sh run.sh`	安装根 `start.bat`（Windows）／`python guanlan.py serve`（跨平台）
卸载	`uninstall.bat`	`sh uninstall.sh`	安装根 `uninstall.bat` / `uninstall.sh`

目录约定（P9，2026-09-28 用户令）：

app_common/
  common/               模块内通用插件/组件（旧导入前缀的兼容别名在此保留一个版本）
  configs/              本模块专属配置域（共用单件在安装根 configs/）
  data/                 模块相关数据件（运行期数据在安装根 data/、outputs/）
  app_common_guanlan/                观澜在本模块的实现包（模块间调用只许经其中的 api.py）
  README.MD             本文件（职责 / 公开面 / 安装部署与运行）
  install.bat|sh  uninstall.bat|sh  run.bat|sh

自检与打包：安装根 check.bat（=python guanlan.py check）、pack.bat / sh pack.sh （打包 + 开箱验证：页面 5/5 + 卸载核验）。

README.md

观澜 · 公共层（app_common/）

安装部署与运行

观澜 · 公共层（`app_common/`）