guanlan-src/README_先读我.txt

观澜·如东样板 v2 0.2.0 — 单包全量离线应用 (Windows / Linux / macOS)

<PY> = Windows 的 .venv\Scripts\python.exe, 或 Linux·macOS 的 .venv/bin/python;
       命令里路径写 / 即可两平台通用; Windows 也可以只双击 .bat, 不必敲命令。

一、安装 (约 10 分钟; 安装目录不要有空格和中文)
  Windows : 解压到 D:\guanlan\app → 双击 install.bat        (自动选 Python → 建 .venv → 包内轮子离线装依赖)
  Linux   : 解压到 /opt/guanlan  → sh install.sh            (麒麟 V10 / 统信 UOS 20 / Ubuntu / CentOS / macOS;
                                                            多版本机器: GUANLAN_PY=/usr/bin/python3.11 sh install.sh)
  没装 Python 的机器也能装: 包内有便携运行时(Windows / Linux x86_64 / Linux aarch64), 安装脚本自动用。
  离线边界: Windows 侧包内带全部轮子, 完全离线可装; **Linux·macOS 侧包内没带轮子**, install.sh 会自动
  改为联网安装 —— 要离线装就把对应平台轮子放进 wheels/linux_x86_64 或 wheels/macos_arm64 再装。
  模型(可选, 只影响问答与本地审核页): ollama pull qwen3:8b / deepseek-r1:14b / bge-m3

二、启动 / 停止
  Windows : 双击 check.bat 全绿 → 双击 start.bat (自动开浏览器)    停止: 双击 stop.bat
  Linux   : <PY> guanlan.py check → <PY> guanlan.py serve           停止: <PY> guanlan.py stop
  三个入口: 门户 http://127.0.0.1:28084/ · 工作台 /detail/ · 运维控制台 /ops

三、运维控制台 /ops — 一个按钮一件事: 停/启服务 · 执行重算 · 清除产物
  按钮按真实状态启用(不能做的灰, 后端也拒绝, 直接打 API 返回 409); "启动服务"起来后自动打开门户;
  "停止组件服务"保留控制台本身; 同时刻只允许一个动作, 页面上有进度/退出码/日志尾巴。
  清除产物 = 挪到 _products_off(可恢复), 不动 data/raw、release、logs。(控制台与重算链只用标准库, 两平台同源)

四、换数据后重算 (一条命令; 控制台点"执行重算"等价)
  <PY> scripts/place_raw_data.py --src <现场包目录> --scope full      放数据(同尺寸自动跳过, 可反复跑)
  <PY> scripts/rebuild_all.py [--skip-scada] [--src <现场包目录>]     默认含 SCADA 侧约 15 分钟;
       只换台账类数据加 --skip-scada(约 2 分钟); --dry-run 只看计划; 完事自动重启组件服务。
  算成功判据: /detail/ 左栏「系统维护」两屏, 或 <PY> -m src.ontology.maintenance
  本包锚点: 报警 39211 · 工单 5876 · 油样 404 · temp_monthly 19494 · 本体 9702 对象(审计 0 问题)

五、必读 (如实)
  · 页面的数来自 outputs/rudong 下的产物, 产物由 data/raw 下的原始件算出来(下一级目录名=场站名, 扫描辨识)。
  · 随包里有一批产物**没有生成端**(pitch_daily、pc_monthly_bins、CMS/TCM 链等), 重算后由随包件补齐;
    逐件来源见 outputs/rudong/_provenance.json (raw-derived 20 件 / shipped 568 件)。
  · 某页没数据: 先看控制台「最近一次动作」的退出码与 logs/, 再看 docs/重算缺口与补件清单_v0.1.md。

包内含: 程序与配置 / 如东分析产物(含 _provenance.json 来源台账) / 门户与仿真 / 三维资产 release/viewer /
        治理清单交付件 release/如东(客户交付物勿外传) / 离线依赖轮子 / 便携运行时

详细说明: docs/说明书_观澜如东样板v2_v0.2.md · docs/重算操作手册_v0.1.md
          docs/数据目录结构与落位约定_v0.2.md · docs/重算缺口与补件清单_v0.1.md · _修复记录_20260911/README.md