Corrige la CSP (autorise Tailwind CDN) + guide Gitea Actions

- SecurityHeaders: autorise cdn.tailwindcss.com dans script-src/style-src
  (sinon le style du site est bloqué en production)
- docs/05-mise-en-place-gitea-actions.md: guide d'installation du runner

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs/05-mise-en-place-gitea-actions.md

@@ -0,0 +1,148 @@
+# 05 — Mise en place de Gitea Actions (CI/CD)
+
+Guide d'installation du moteur d'automatisation (CI/CD) pour le dépôt.
+Contexte : **Gitea en Docker / docker-compose**, accès **SSH** au serveur.
+
+Gitea Actions nécessite deux choses :
+1. **Activer** la fonctionnalité Actions dans Gitea.
+2. Enregistrer au moins un **runner** (`act_runner`) qui exécute les workflows.
+
+---
+
+## Étape 1 — Activer Actions dans Gitea
+
+Se connecter en SSH au serveur, puis se placer dans le dossier du `docker-compose.yml`
+**de Gitea** (⚠️ celui de Gitea, pas celui de l'application Laravel).
+
+### Option A (recommandée) — via variable d'environnement
+
+Dans le service Gitea du `docker-compose.yml`, ajouter la variable :
+
+```yaml
+services:
+  server:            # nom du service Gitea (peut s'appeler "gitea")
+    image: gitea/gitea:latest
+    environment:
+      - GITEA__actions__ENABLED=true
+    # ... reste de la configuration inchangé
+```
+
+Puis recharger Gitea :
+
+```bash
+docker compose up -d
+```
+
+### Option B — via le fichier app.ini
+
+Éditer le fichier `app.ini` (dans le volume Gitea, souvent
+`./gitea/gitea/conf/app.ini`) et ajouter :
+
+```ini
+[actions]
+ENABLED = true
+```
+
+Puis redémarrer : `docker compose restart`.
+
+### Vérification
+
+Dans l'interface web du dépôt, un onglet **« Actions »** doit apparaître.
+
+---
+
+## Étape 2 — Obtenir un jeton d'enregistrement du runner
+
+Deux niveaux possibles :
+
+- **Niveau instance** (runner partagé par tous les dépôts) :
+  `Site Administration → Actions → Runners → Create new Runner`.
+- **Niveau dépôt** (runner dédié au projet) :
+  `Dépôt → Settings → Actions → Runners → Create new Runner`.
+
+Copier le **jeton (registration token)** affiché.
+
+---
+
+## Étape 3 — Lancer un runner (act_runner) en Docker
+
+Créer un dossier de travail sur le serveur, par exemple `~/gitea-runner`, avec un
+fichier `docker-compose.yml` :
+
+```yaml
+services:
+  runner:
+    image: gitea/act_runner:latest
+    container_name: gitea_runner
+    restart: always
+    environment:
+      GITEA_INSTANCE_URL: "https://gitea.sam-coffre.duckdns.org"
+      GITEA_RUNNER_REGISTRATION_TOKEN: "COLLER_LE_JETON_ICI"
+      GITEA_RUNNER_NAME: "runner-docker-1"
+      # Images utilisées pour `runs-on: ubuntu-latest`
+      GITEA_RUNNER_LABELS: "ubuntu-latest:docker://catthehacker/ubuntu:act-latest"
+    volumes:
+      - ./data:/data
+      - /var/run/docker.sock:/var/run/docker.sock
+```
+
+> Le montage de `/var/run/docker.sock` permet au runner de créer les conteneurs
+> qui exécutent chaque job. L'image `catthehacker/ubuntu:act-latest` fournit un
+> environnement compatible `ubuntu-latest` (Node, outils de base).
+
+Démarrer le runner :
+
+```bash
+cd ~/gitea-runner
+docker compose up -d
+docker compose logs -f runner   # doit afficher "runner registered successfully"
+```
+
+Le runner apparaît alors en vert dans `Settings → Actions → Runners` du dépôt.
+
+---
+
+## Étape 4 — Ajouter les secrets de déploiement
+
+Dans `Dépôt → Settings → Actions → Secrets`, créer :
+
+| Secret | Valeur |
+|--------|--------|
+| `SSH_HOST` | IP ou domaine du serveur de production |
+| `SSH_USER` | utilisateur SSH (ex. `sam`) |
+| `SSH_PRIVATE_KEY` | clé privée SSH autorisée sur le serveur |
+| `SSH_PORT` | port SSH (ex. `22`) |
+
+> Générer une paire de clés dédiée au déploiement :
+> `ssh-keygen -t ed25519 -C "gitea-deploy" -f deploy_key`
+> puis ajouter `deploy_key.pub` dans `~/.ssh/authorized_keys` du serveur, et
+> coller le contenu de `deploy_key` (clé privée) dans le secret `SSH_PRIVATE_KEY`.
+
+---
+
+## Étape 5 — Déclencher et vérifier
+
+Un simple push sur `master` déclenche les workflows :
+
+```bash
+git commit --allow-empty -m "test: déclenche la CI"
+git push
+```
+
+Dans l'onglet **Actions** du dépôt :
+- le workflow **CI** (`ci.yml`) exécute Pint puis PHPUnit ;
+- le workflow **CD** (`deploy.yml`) déploie via SSH.
+
+Une exécution en vert constitue une **preuve idéale à intégrer au dossier** (capture d'écran).
+
+---
+
+## Dépannage rapide
+
+| Symptôme | Cause probable / solution |
+|----------|---------------------------|
+| Pas d'onglet Actions | Actions non activé (Étape 1) ou Gitea non redémarré |
+| « No runner available » | Runner non enregistré / hors ligne (Étape 3) |
+| `ubuntu-latest` introuvable | Label non défini → variable `GITEA_RUNNER_LABELS` |
+| `actions/checkout` échoue | Le serveur doit accéder à github.com (Gitea proxy les actions) |
+| Déploiement SSH refusé | Vérifier la clé dans `authorized_keys` et les secrets SSH_* |