dashboard/.qoder/repowiki/knowledge/zh/耳机品牌与 OTA 升级管理平台（前后端编排）/耳机品牌与型号管理后端 API/编码规范.md

• 所有 API 返回统一 JSON 结构，包含 code（1:成功 / 0:错误 / 2:无数据）、msg 和 data 字段，由 utils/response.js 的 ApiResponse 生成。
• 受保护路由在各自文件顶部通过 router.use(authMiddleware) 全局启用 JWT 校验，仅健康检查等公开接口例外。
• 更新操作显式判断请求体字段是否为 undefined 或 'null' 字符串，区分“未提供”与“设为空”，避免覆盖现有值。
• 关键业务动作（登录、CRUD、权限拒绝）通过 logger.info/warn/error 记录到 logs/app.log，错误堆栈附带上下文信息。
• 环境变量集中通过 config/loadEnv.js 从仓库根目录 .env 加载，Docker 场景下由 compose env_file 注入而不覆盖已有变量。