dashboard/.qoder/repowiki/knowledge/zh/音频设备 CMS 管理系统（前后端全栈）/编码规范.md

• 前端样式集中在 src/styles/lux-theme.css，通过 :root CSS 变量定义色板、模糊半径、阴影层级，所有组件覆盖均以 .lux-shell .el-* 选择器限定作用域，不修改业务逻辑代码。
• 后端路由按资源拆分为独立文件（如 brands.js、models.js、ota.js），在 routes/index.js 中统一遍历注册，新资源只需新增路由文件并加入数组即可生效。
• 模型定义遵循 Sequelize 标准模式，并在 models/index.js 中集中 sync({ force: false })，避免在各路由中重复初始化连接。
• 请求参数校验统一放在 validators/ 目录下对应模块，使用 zod schema 描述后在路由 handler 中调用，保持路由层仅负责编排。
• 前端 API 调用集中在 src/api/ 下与后端资源一一对应的 JS 文件中，组件侧仅 import 函数而不直接写 axios 请求。