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 形成本地→远端的标准化运维路径。