feat: add slide generation script for CESIZen project, covering deployment and security aspects

2026-07-09 16:41:44 +02:00
parent 37a1079201
commit 867d744242
14 changed files with 1648 additions and 0 deletions
@@ -0,0 +1,97 @@
+# Migration vers Gitea & mise en place des outils (Bloc 3)
+
+Ce guide décrit la mise en place de **Gitea** comme plateforme unique de **versioning**, de
+**gestion des tickets** (maintenance) et d'**intégration continue** (Gitea Actions), ainsi que le
+raccordement au déploiement continu **Coolify**. Il sert de support à la démonstration de soutenance.
+
+> Instance utilisée : Gitea auto-hébergée. Dépôt cible : `https://<instance-gitea>/adam/cesizen`.
+
+---
+
+## 1. Migrer le dépôt GitHub → Gitea
+
+### Option A — Migration assistée (recommandée, conserve issues & historique)
+1. Se connecter à Gitea → **+ → Nouvelle migration → GitHub**.
+2. URL source : `https://github.com/AzmogEx/CesiZen.git`.
+3. Cocher : *Éléments à migrer* → dépôt Git, **Issues**, **Pull requests**, **Releases**, **Labels**, **Milestones**.
+4. Renseigner un jeton d'accès GitHub (lecture) si le dépôt est privé. Lancer.
+
+### Option B — Push manuel (miroir du code seul)
+```bash
+cd /chemin/vers/CesiZen
+git remote add gitea https://<instance-gitea>/adam/cesizen.git
+git push gitea --all      # toutes les branches
+git push gitea --tags     # tous les tags/releases
+# Faire de Gitea le dépôt de référence :
+git remote set-url origin https://<instance-gitea>/adam/cesizen.git
+```
+
+Vérifier ensuite que `.gitea/` (workflows + gabarits d'issues) est bien présent à la racine.
+
+---
+
+## 2. Activer l'intégration continue (Gitea Actions)
+
+1. **Côté serveur Gitea** : Actions doit être activé (`app.ini` → `[actions] ENABLED = true`).
+2. **Enregistrer un runner** (une fois) :
+   ```bash
+   # Récupérer le jeton dans Gitea → Administration → Actions → Runners
+   act_runner register --instance https://<instance-gitea> --token <TOKEN> \
+       --name cesizen-runner --labels ubuntu-latest:docker://node:20-bookworm
+   act_runner daemon
+   ```
+3. Le workflow **`.gitea/workflows/ci.yml`** se déclenche alors à chaque `push` / `pull request` et
+   exécute les 3 jobs : **backend** (PHPUnit + Pint), **frontend** (ESLint + Vitest), **mobile** (Jest).
+4. Une pastille verte/rouge s'affiche sur chaque commit et chaque PR (démo).
+
+---
+
+## 3. Configurer le ticketing (maintenance)
+
+### Labels à créer (Issues → Labels → « Créer un label »)
+| Label | Couleur | Usage |
+|---|---|---|
+| `type/incident` | rouge | Anomalie (maintenance corrective) — posé automatiquement par le gabarit |
+| `type/évolution` | bleu | Nouvelle fonctionnalité (maintenance évolutive) |
+| `gravité/bloquant` | #C8102E | Service inutilisable |
+| `gravité/majeur` | #E4801C | Service dégradé, contournement possible |
+| `gravité/mineur` | #F0C808 | Altération mineure |
+| `priorité/critique` · `priorité/forte` · `priorité/normale` | dégradé | Ordonnancement |
+| `statut/à-qualifier` · `statut/en-cours` · `statut/en-revue` · `statut/résolu` | gris→vert | Suivi Kanban |
+| `module/comptes` · `module/informations` · `module/tracker` · `module/infra` | vert | Domaine |
+
+Les **gabarits d'issues** sont déjà versionnés dans `.gitea/issue_template/` (`incident.yaml`,
+`evolution.yaml`) : ils apparaissent automatiquement au clic sur **« Nouvelle issue »**.
+
+### Milestones (= versions)
+Créer un jalon par version livrée : `v1.0`, `v1.1`, … Chaque issue/PR est rattachée à un jalon → suivi
+de l'avancement par version.
+
+### Tableau de bord Kanban (pilotage)
+Onglet **Projects → Nouveau projet** (type *Board*) avec les colonnes :
+`À qualifier` → `À faire` → `En cours` → `En revue (PR)` → `Résolu`.
+Les issues glissent d'une colonne à l'autre ; les labels de statut sont synchronisés.
+
+---
+
+## 4. Raccorder le déploiement continu (Coolify)
+
+Coolify build les images depuis le dépôt Git et redéploie à chaque nouveau commit sur `main` :
+
+1. Dans Coolify → application CESIZen → **Source** : pointer sur le dépôt Gitea (`main`).
+2. Activer le **webhook de déploiement** : Coolify fournit une URL de type
+   `https://<coolify>/api/v1/deploy?uuid=…&force=false`.
+3. Dans Gitea → dépôt → **Paramètres → Webhooks → Ajouter** : coller l'URL, événement *Push*, branche `main`.
+4. Résultat : `merge sur main` → CI verte → webhook → Coolify build + déploie en production
+   (`cesizen.cleanows.fr` / `api.cesizen.cleanows.fr`), avec migrations, seed et génération des
+   secrets automatisés par `backend/docker/entrypoint.sh`.
+
+---
+
+## 5. Script de démonstration (soutenance)
+
+1. **Versioning** : montrer l'arbre des commits Gitea, les branches, un tag de version.
+2. **CI** : ouvrir une PR triviale → montrer les 3 jobs qui tournent → pastille verte.
+3. **Ticketing** : créer une issue via le gabarit *incident*, la qualifier (labels + jalon),
+   la déplacer sur le board Kanban.
+4. **CD** : merger la PR → montrer le déploiement Coolify déclenché → rafraîchir le site en ligne.