's'

docs/ARCHITECTURE.md

@@ -0,0 +1,45 @@
+# Live Platform 四层架构
+
+## 分层
+
+| 层 | 职责 | 代码/路径 |
+|----|------|-----------|
+| Core OS | 用户、SSH、mDNS、Wi‑Fi、WebTTY、Docker、systemd、日志 | `scripts/linux/install_hub.sh` 及系统包 |
+| Infra Service | ShellCrash、Caddy、Netdata、SRS、Neko、ws-scrcpy、FRP、WireGuard 占位 | `services/*`、`scripts/linux/service_ctl.sh` |
+| Business | 无人直播 douyinyoutube（FFmpeg/HDMI/推流），可脱离控制台运行 | 仓库根业务脚本、`install-live.sh` |
+| Web Console | 仅通过 API 与配置中心「控制」，不实现业务算法 | `web.py`、`web-console`、`/hub/*` API |
+
+## 配置中心
+
+- 安装目标：`/opt/live/config/`
+- 默认模板：`live-platform/config/defaults/`
+- 文件：`system.json`、`network.json`、`services/*.json`、`business/*.json`
+- 生成兼容层：`live-platform/tools/render_stack_env.py` → `/opt/live/generated/system-stack.env`（供现有 shell 读取，逐步淘汰分散 `.env`）
+
+## 一键脚本（幂等）
+
+| 脚本 | 作用 |
+|------|------|
+| `./install-core.sh` | 同步 JSON → `/opt/live/config`，生成 env，调用 `install_hub.sh`（无业务） |
+| `./install-live.sh` | 仅业务模块，调用 `install_business.sh` |
+| `./doctor.sh` | 网络、端口、adb、ffmpeg、docker、API 健康检查 |
+
+## API
+
+- `GET /hub/dashboard`：快照 + 服务 + 安卓 + 直播进程状态
+- `GET /hub/config`：配置中心只读聚合
+- `POST /hub/business/douyinyoutube`：业务元数据（如抖音 URL 声明）
+- 既有：`/service_action`、`/android/*`、`/process_monitor`、`/save_url_config` 等
+
+## 前端
+
+- `/`：`LiveControlApp` 产品壳（总览、服务、直播、安卓、网络、设置）
+- `/console`：高级遗留控制台（全功能）
+- 开发：`middleware` 将 `/hub` 代理到本机 FastAPI
+
+## live.local（无端口验收）
+
+- **`install_hub.sh` 末尾**执行 **`install_live_edge_proxy`**：安装/启用 **`live-edge.service`（Caddy）**，将 **`http://live.local`（:80）** 反代到 **`127.0.0.1:${PORT}`**（默认 8001）。
+- **Homepage** 默认改绑 **`HOMEPAGE_PORT=3080`**，避免与 Caddy 抢 80。
+- 仅更新反代：`sudo bash scripts/linux/reinstall_live_edge.sh`
+- `ENABLE_LIVE_EDGE_PROXY=0` 可关闭（`system-stack.env`）。