Conventions
Conventions
Les règles de code, de nommage, de test et de git qui gardent le projet lisible et cohérent.
Vantablvck suit un ensemble de conventions simples, vérifiées autant que possible par l'outillage plutôt que par la discipline. L'objectif est qu'un contributeur qui arrive lise le code comme le reste du code, sans surprise.
Vue d'ensemble
- Types stricts. TypeScript strict, pas de
any, inférence au maximum. Validation Zod sur toute entrée. - Un fichier, une responsabilité. La route délègue au service, le service passe par les repositories Drizzle.
- Fichiers en kebab-case. La règle est appliquée par Biome, les fichiers imposés par les frameworks sont exemptés.
- Tests sur la logique pure. Le runner Bun, la logique métier isolée dans
packages/core. - Commits conventionnels. Sans trailer de co-auteur automatique, sur un flux de pull requests vers
Trunk.
Dans cette section
- Style de code : TypeScript, Zod, architecture en couches, Biome.
- Nommage : fichiers, identifiants, tables, enums.
- Tests : runner Bun,
packages/core, cible Nx. - Git : commits, branches, hooks.