home_stock/docs/WORKFLOW.md

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
• Branches protégées : main (production-ready)
• Politique de merge : Squash merge vers main, fast-forward interdit, historique linéaire privilégié

2. Commits

• Convention : Conventional Commits (feat/fix/docs/refactor/test/chore), format: type(scope): message en français
• Granularité attendue : 1 commit par changement logique, 1 feature complète par PR avec tests associés

3. Pull Requests

• Template PR : Titre court (<70 car), description avec ## Changements, ## Tests, ## Checklist, référence REQ-XXX
• Relectures requises : Aucune (projet solo), possibilité de review par Claude Code avant merge
• 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
• Vérifications bloquantes : Lint sans erreur, tests unitaires passent, build Docker réussit, couverture >70% sur nouveau code

5. Releases

• Versioning : Semver (semantic versioning) v0.x.y pour pré-release, v1.0.0 pour première version stable, tags Git annotés
• Tagging : Tag après merge dans main, format vX.Y.Z, signé GPG si possible
• 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
• Tests obligatoires : Tests unitaires sur logique métier (services/), tests intégration sur endpoints API, couverture minimum 70%
• Mises à jour doc : Obligatoire si changement API (OpenAPI), architecture (ADR), ou contrats (data_model.md)

7. Hotfix / Urgence

• Procédure : Branche hotfix/description depuis main, fix minimal, tests rapides, merge direct main, tag patch version
• Responsables : Développeur principal (projet solo), pas de process complexe pour mono-utilisateur

---

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

---