Code Standards
Topics:
- Naming conventions — files / classes / functions / paths / role / button / route names
- Vue style — SFC script order, template rules
- Backend style — enforced checklist (response, schema, API, CRUD, permissions, models)
Toolchain
| Concern | Tool | Command |
|---|---|---|
| Backend lint / format | Ruff (line 200, double-quote, rules E/F/I) | make fmt / make lint |
| Backend types | basedpyright (standard mode) | make typecheck |
| Backend tests | pytest | make test |
| Frontend lint | ESLint (@soybeanjs/eslint-config-vue) + oxlint | make web-lint |
| Frontend types | vue-tsc | make web-typecheck |
| Full stack | — | make check-all |
| Pre-commit hook | simple-git-hooks | auto-installed via cd web && pnpm install |
Pre-commit gate
bash
make check-allOr run only the side you touched: make check / make web-check.
Recommended VS Code setup
- Backend: install Charliermarsh.ruff + DetachHead.basedpyright
- Frontend: install Vue.volar + dbaeumer.vscode-eslint
- Auto-fix on save:
"editor.codeActionsOnSave": { "source.fixAll": "explicit" }