仓库采用前后端分离、Docker Compose 编排的单体部署形态：
- `backend/src` 为 Express 应用，入口 `app.js` 通过 `routes/index.js` 聚合各业务路由（auth、brands、models、ota、blacklist、users 等），按 MVC 分层组织：`models/` 使用 Sequelize 定义数据模型并统一由 `models/index.js` 初始化连接；`services/` 封装外部依赖（S3、Redis EQ 缓存、Meilisearch、squiglink 曲线服务、OTA 存储）；`middleware/` 注入认证与请求体大小限制；`validators/` 用 zod 校验入参。
- `frontend/` 为 Vue 3 + Element Plus SPA，Vite 构建产物 `dist/` 由 Nginx 容器静态托管，并通过 `/api` 反向代理到后端 8000 端口；`src/api/` 按领域拆分 API 调用，`views/` 对应功能页面，`components/` 存放通用组件（TabsView、ChangePasswordDialog 等）。
- `frontend_v2/` 是基于 Soybean Admin 模板的重构分支，采用 pnpm workspace 多包结构（@soybeanjs/axios、hooks、scripts 等），尚未替换主前端。
- `autoeq/` 存放第三方测量 CSV/TXT 数据及日期归档，供 OTA 推送时读取频响曲线。
- 根级 `docker-compose.yml` 编排 backend（Node 22 Alpine 镜像）与 frontend（nginx:alpine）两个服务，共享 `audio-network` 网络，宿主机卷挂载 `/data/projects/source` 用于 X9 OTA 包本地存储。
- 部署脚本 `scripts/upload.sh` 负责将 dist、后端源码、compose 文件上传至服务器 `/data/project/dashboard/`，环境变量集中维护在根 `.env`。