dashboard/.qoder/repowiki/knowledge/zh/Luxsin 音频设备管理后台（前后端单体仓库）/编码规范.md

• 后端路由按领域拆分为独立文件（如 routes/models.js、routes/ota.js），并在 routes/index.js 中统一注册，控制器内直接操作 Sequelize model。
• 每个业务模块配套一个 validators/<module>.js，使用 zod schema 对入参进行结构化校验，路由层在执行业务前调用 validator。
• 对外部依赖（S3、Redis、Meilisearch、squiglink）统一收敛到 services/ 目录下的单一 client 文件，路由层不直接调用 SDK。
• 前端 API 调用按领域拆分到 src/api/*.js，统一通过 src/utils/request.js 封装的 axios 实例发起，携带 JWT 与基础路径。
• 前端视图按功能域划分目录（views/brand/、views/model/、views/ota/ 等），复杂页面内部再细分 components/ 与 composables/。