# Procédure de release et déploiement ## 1. Préparer une nouvelle version (Git Bash) ### Avant de committer - [ ] Vérifier que `config.local.php` n’est pas inclus (ignoré par git) - [ ] Tester en local : `php -S 127.0.0.1:8000 -t public` - [ ] Vérifier que les exports OVH (`ovh-*-export.csv`) ne sont pas trackés ### Commit et tag ```bash # 1. Ajouter les fichiers (hors .gitignore) git add . git status # Vérifier avant commit # 2. Commit git commit -m "Release v1.1.0 — description des changements" # 3. Créer le tag (ou utiliser le script) git tag -a v1.1.0 -m "Release v1.1.0" # 4. Pousser git push origin master git push origin v1.1.0 ``` **Alternative : script release** ```bash ./scripts/release.sh 1.1.0 # Puis : git push origin master && git push origin v1.1.0 ``` --- ## 2. Déploiement serveur (FileZilla / FTP) ### Prérequis - Compte FTP OVH (host, user, password) - `config.local.php` déjà présent sur le serveur (ne pas l’écraser) ### Checklist déploiement | Étape | Action | |-------|--------| | 1 | `composer install --no-dev --ignore-platform-req=ext-mbstring` (si dépendances modifiées) | | 2 | Envoyer `config/` → racine FTP (sans écraser `config.local.php`) | | 3 | Envoyer `src/` → racine | | 4 | Envoyer `templates/` → racine | | 5 | Envoyer `vendor/` → racine | | 6 | Envoyer contenu de `public/` → `www/` | ### Structure sur OVH ``` Racine FTP/ ├── config/ │ ├── config.php │ └── config.local.php ← Ne pas écraser ├── src/ ├── templates/ ├── vendor/ ├── storage/ ← Créé auto par l'app (outbox, logs, etc.) └── www/ ├── index.php ├── api/ └── assets/ ``` ### Après déploiement - [ ] Tester l’URL de production - [ ] Vérifier un parcours complet : landing → pack → quiz → résultats → PDF - [ ] Vérifier que `storage/` est accessible en écriture (chmod 755 ou 775) --- ## 3. Numérotation des versions - **MAJOR** (1.x.x) : changement majeur, rupture de compatibilité - **MINOR** (x.1.x) : nouvelles fonctionnalités, packs, endpoints - **PATCH** (x.x.1) : corrections, ajustements, doc Exemple : v1.0.0 → v1.1.0 pour ajout des packs v2 et endpoints analytics/excel.