1
1
mirror of https://github.com/theoludwig/p61-project.git synced 2024-07-17 07:00:12 +02:00
p61-project/docs/CONVENTIONS.md

2.0 KiB

Conventions développement informatique

Linting/Formatting/Tests

Le code est formaté grâce à Prettier et vérifié grâce à ESLint et à TypeScript pour s'assurer que le code respecte les bonnes pratiques de développement, et détecter en amont les possibles erreurs.

Nous utilisons également Jest pour les tests automatisés.

# Lint
npm run lint:prettier
npm run lint:eslint
npm run lint:typescript

# Test
npm run test

Une pipeline CI (.gitlab-ci.yml) est en place pour vérifier que le code respecte ces bonnes pratiques et que les tests passent.

GitFlow

Le projet suit la convention GitFlow reposant sur 2 branches principales:

  • main: Contient le code de la dernière version stable et déployé en production.
  • staging: Contient le code en cours de test avant déploiement en production, Quality Assurance (QA).
  • develop: Contient le code en cours de développement. Les nouvelles fonctionnalités et les correctifs de bugs sont fusionnés ici.

Chaque nouvelle fonctionnalité ou correctif de bug est développé dans une branche dédiée à partir de develop, nommée feat/<nom-de-la-fonctionnalité> ou fix/<nom-du-bug>. Une fois le développement terminé, une merge request est créée pour demander une revue de code, et une fois validée, la branche est fusionnée dans develop, puis supprimée.

Convention des commits

Les commits respectent la convention Conventional Commits et Semantic Versioning pour la gestion des versions et des releases en fonction des commits.

Les commits doivent être atomiques c'est à dire qu'il respecte 3 règles:

  • Ne concerne qu'un seul sujet (une fonctionnalité, une correction de bug, etc.).
  • Doit avoir un message clair et concis.
  • Ne doit pas rendre de dépôt "incohérent" (bloque la CI du projet).