dashboard/.qoder/repowiki/knowledge/zh/耳机品牌与 OTA 升级管理平台（前后端编排）/架构设计.md

- **服务编排**：`docker-compose.yml` 定义 `backend`（Node.js + Sequelize）和 `frontend`（Nginx 静态托管）两个服务，共用 `audio-network` 桥接网络，前端通过 Nginx 反向代理 `/api` 至后端。
- **配置边界**：根目录 `.env` 为唯一环境变量源，Compose 注入后端容器；`.env.example` 提供模板，禁止子模块各自维护环境文件。
- **存储契约**：宿主机 `/data/projects/source` 挂载至后端容器，作为 OTA 升级包的持久化共享卷，前后端以此路径为约定进行文件交互。
- **部署流水线**：`scripts/upload.sh` 基于 rsync/ssh 将前端构建产物、后端源码与编排文件增量推送至服务器，配合 `DEPLOY.md` 形成本地→远端的标准化运维路径。