代码规范
每个分类的细节见各专题文档：
- 命名规范 — 文件 / 类 / 函数 / 路径 / 角色 / 按钮 / 路由名
- Vue 书写风格 — SFC script 顺序、模板规则
- 后端风格 — 强制约定清单（响应、Schema、API、CRUD、权限、模型）
工具链速览
| 项 | 工具 | 命令 |
|---|---|---|
| 后端 lint / format | Ruff（行宽 200，双引号，规则 E/F/I） | just fmt backend / just lint backend |
| 后端类型 | basedpyright（standard 模式） | just typecheck backend |
| 后端测试 | pytest | just test backend |
| 前端 lint | ESLint（@soybeanjs/eslint-config-vue）+ oxlint | just lint frontend |
| 前端类型 | vue-tsc | just typecheck frontend |
| 全栈一键 | — | just check |
| 提交前钩子 | simple-git-hooks | cd web && pnpm install 自动安装 |
提交前必跑
bash
just check只动了后端 / 前端时，可分别跑 just check backend / just check frontend。
VS Code 推荐配置
- 后端：装 Charliermarsh.ruff + DetachHead.basedpyright
- 前端：装 Vue.volar + dbaeumer.vscode-eslint
- 保存时自动 fix：在
.vscode/settings.json加"editor.codeActionsOnSave": { "source.fixAll": "explicit" }