# Travailler en équipe

## Branches

| Branche | Usage | Création |
| --- | --- | --- |
| `main` | Production, protégée, uniquement via Pull Request | — |
| `develop` | Intégration continue des développements | Depuis `main` |
| `feature/<numéro>-<sujet>` | Nouvelle fonctionnalité | Depuis `develop` |
| `fix/<numéro>-<sujet>` | Correction non urgente | Depuis `develop` |
| `hotfix/<numéro>-<sujet>` | Correction urgente en production | Depuis `main` |

Le nom de branche est en minuscules, avec des tirets (`feature/42-alertes-snmp`).

## Pull Requests

1. Créer une branche dédiée, jamais pousser directement sur `main` ni `develop`.
2. Ouvrir une Pull Request vers `develop` (ou `main` pour un hotfix).
3. Remplir le modèle de PR et lier l'issue concernée.
4. Obtenir au moins une approbation.
5. Attendre le statut **tests** vert (job `tests` du pipeline Gitea).
6. Fusionner en squash ou merge commit, puis supprimer la branche.

## Protection de `main`

La branche `main` est protégée par le script `scripts/configure-gitea.sh` :

- push direct interdit ;
- une approbation obligatoire ;
- statut `tests` obligatoire ;
- fusion bloquée si la branche n'est pas à jour ou si une revue est rejetée.

Configurer les mêmes règles sur `develop` si l'équipe le souhaite.

## Règles de contribution

- Aucun secret, mot de passe, jeton, dump SQL, PDF ou donnée réelle dans le dépôt.
- Toute nouvelle variable d'environnement est documentée dans `.env.example`.
- Les migrations doivent rester compatibles avec l'ancienne version (rollback sans perte).
- Les tests doivent passer localement : `composer install`, `npm ci`, `php artisan test`.
- La documentation et le `CHANGELOG` fonctionnel (le cas échéant) sont mis à jour.
