claude code

docs/WORKFLOW.md

@@ -12,36 +12,36 @@ Il sert de référence aux agents et aux contributeurs.
 ---
 
 ## 1. Branches
-- Convention de nommage : <A COMPLETER PAR AGENT>
-- Branches protégées : <A REMPLIR - PROJET> (exemple: main — a supprimer)
-- Politique de merge : <A COMPLETER PAR AGENT>
+- 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 (ex: conventional commits) : <A COMPLETER PAR AGENT>
-- Granularité attendue : <A REMPLIR - PROJET> (exemple: 1 feature par PR — a supprimer)
+- 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 : <A COMPLETER PAR AGENT>
-- Relectures requises : <A REMPLIR - PROJET> (exemple: 1 review — a supprimer)
+- 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 (lint/test/build) : <A COMPLETER PAR AGENT>
-- Vérifications bloquantes : <A COMPLETER PAR AGENT>
+- 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 = versionnage sémantique) : <A COMPLETER PAR AGENT>
-- Tagging : <A COMPLETER PAR AGENT>
+- 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 (définition de terminé) : <A REMPLIR - PROJET> (exemple: tests + doc — a supprimer)
-- Tests obligatoires : <A COMPLETER PAR AGENT>
-- Mises à jour doc : <A REMPLIR - PROJET> (exemple: si impact sur l’API — a supprimer)
+- 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 : <A COMPLETER PAR AGENT>
-- Responsables : <A REMPLIR - PROJET> (exemple: lead dev — a supprimer)
+- 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 -->
 
 ---
 
@@ -54,9 +54,4 @@ Il sert de référence aux agents et aux contributeurs.
 - Réseau local : 10.0.0.0/22
 - Passerelle : 10.0.0.1
 
----
-
-## Exemple (a supprimer)
-- Branches : `main`, `develop`, `feat/*`, `fix/*`.
-- Commits : Conventional Commits.
-- CI : lint + tests + build.
+---