generated from gilles/template-webapp
57 lines
3.1 KiB
Markdown
57 lines
3.1 KiB
Markdown
# Processus de développement
|
||
|
||
Ce document standardise le workflow de dev pour faciliter la collaboration.
|
||
Il sert de référence aux agents et aux contributeurs.
|
||
|
||
---
|
||
|
||
## Légende des zones
|
||
- `<A REMPLIR - PROJET> (exemple: à personnaliser — a supprimer)` : à compléter par toi selon le projet.
|
||
- `<A COMPLETER PAR AGENT>` : à compléter par un agent spécialisé architecture / dev.
|
||
|
||
---
|
||
|
||
## 1. Branches
|
||
- Convention de nommage : `feature/REQ-XXX-description`, `fix/bug-description`, `docs/update-xxx`, `refactor/module-name` <!-- complété par codex -->
|
||
- Branches protégées : `main` (production-ready) <!-- complété par codex -->
|
||
- Politique de merge : Squash merge vers main, fast-forward interdit, historique linéaire privilégié <!-- complété par codex -->
|
||
|
||
## 2. Commits
|
||
- Convention : Conventional Commits (feat/fix/docs/refactor/test/chore), format: `type(scope): message` en français <!-- complété par codex -->
|
||
- Granularité attendue : 1 commit par changement logique, 1 feature complète par PR avec tests associés <!-- complété par codex -->
|
||
|
||
## 3. Pull Requests
|
||
- Template PR : Titre court (<70 car), description avec ## Changements, ## Tests, ## Checklist, référence REQ-XXX <!-- complété par codex -->
|
||
- Relectures requises : Aucune (projet solo), possibilité de review par Claude Code avant merge <!-- complété par codex -->
|
||
- Checklist obligatoire : `docs/PR_CHECKLIST.md`
|
||
|
||
## 4. CI/CD
|
||
- Pipeline minimal : Gitea Actions avec steps: lint (ruff, eslint) → test (pytest, vitest) → build (Docker images) → optionnel deploy <!-- complété par codex -->
|
||
- Vérifications bloquantes : Lint sans erreur, tests unitaires passent, build Docker réussit, couverture >70% sur nouveau code <!-- complété par codex -->
|
||
|
||
## 5. Releases
|
||
- Versioning : Semver (semantic versioning) v0.x.y pour pré-release, v1.0.0 pour première version stable, tags Git annotés <!-- complété par codex -->
|
||
- Tagging : Tag après merge dans main, format `vX.Y.Z`, signé GPG si possible <!-- complété par codex -->
|
||
- Release notes : `product/RELEASE_NOTES.md`
|
||
|
||
## 6. Qualité
|
||
- Definition of Done : Feature implémentée + tests unitaires + tests intégration API + documentation mise à jour (si impact) + CI passe <!-- complété par codex -->
|
||
- Tests obligatoires : Tests unitaires sur logique métier (services/), tests intégration sur endpoints API, couverture minimum 70% <!-- complété par codex -->
|
||
- Mises à jour doc : Obligatoire si changement API (OpenAPI), architecture (ADR), ou contrats (data_model.md) <!-- complété par codex -->
|
||
|
||
## 7. Hotfix / Urgence
|
||
- Procédure : Branche `hotfix/description` depuis main, fix minimal, tests rapides, merge direct main, tag patch version <!-- complété par codex -->
|
||
- Responsables : Développeur principal (projet solo), pas de process complexe pour mono-utilisateur <!-- complété par codex -->
|
||
|
||
---
|
||
|
||
## Références d’environnement (issues de `outils_dev_pref.md`)
|
||
- Hébergement Git : Gitea
|
||
- URL serveur Git : https://gitea.maison43.duckdns.org/
|
||
- Utilisateur Git : gilles
|
||
- Timezone : Europe/Paris
|
||
- Langue : francais
|
||
- Réseau local : 10.0.0.0/22
|
||
- Passerelle : 10.0.0.1
|
||
|
||
--- |