# SportCorico — Release Guides

Guides utilisateur publiés à chaque mise à jour majeure de SportCorico.
**En prod :** https://release-guides.sportcorico.com/

Un guide = un dossier daté (`AAAA-MM-JJ/`) contenant une page HTML autonome.
CSS, JS, logo et favicon sont **mutualisés à la racine** pour ne pas avoir à les redupliquer à chaque release.

---

## Créer un nouveau guide — pas à pas

### 1. Préparer le brief

```bash
cd sportcorico-release-guides
mkdir -p 2026-XX-XX/screens
```

Dans ce nouveau dossier, déposer :

- **`release_note.md`** — la liste des changements, organisée par thématique.
  Une thématique = un titre `##`. Une ligne `-` par changement.

  ```markdown
  # Changements et nouveautés - MAJ JJ/MM/AAAA

  ## Thématique 1
  - Changement 1
  - Changement 2

  ## Thématique 2
  - Changement 3
  ```

- **`screens/`** — un sous-dossier par thématique, contenant les captures.
  Nom des fichiers libre mais explicite. Mix desktop / mobile accepté.

  ```
  screens/
  ├── thematique-1/
  │   ├── ecran-config.png
  │   └── ecran-resultat.png
  ├── thematique-2/
  │   └── ...
  ```

- **Le hash du commit Flutter de départ** — celui à partir duquel ces nouveautés ont été codées sur l'app.
  Indispensable pour que Claude croise les commits et comprenne le contexte.
  Le récupérer via `git log` sur `sportcorico-flutter-app` (le dernier commit avant la branche/work de cette release).

### 2. Demander à Claude de générer le guide

Une fois le brief prêt, ouvrir Claude Code et lui demander quelque chose comme :

> Génère le guide HTML de la release 2026-XX-XX (dossier `2026-XX-XX/`).
> Hash Flutter de départ : `abc1234`.

Claude va :
1. Lire `release_note.md`
2. Analyser **chaque capture** dans `screens/`
3. Croiser avec les commits Flutter depuis le hash fourni
4. Générer un `index.html` dans le dossier de la release, qui hérite du style commun

Il n'y a aucun build à lancer — le HTML produit est directement utilisable.

### 3. Tester en local

Double-clic sur le `index.html` généré, ou :

```bash
open 2026-XX-XX/index.html
```

### 4. Déployer

```bash
git add 2026-XX-XX/
git commit -m "Release 2026-XX-XX"
git push

# Sur le serveur
ssh ubuntu@serveur
cd sites/release-guides.sportcorico.com && git pull
```

Caddy sert le contenu directement, **pas besoin de redémarrer**.
URL : `https://release-guides.sportcorico.com/2026-XX-XX/`

---

## Structure du dossier

```
sportcorico-release-guides/
├── README.md                ← ce fichier
├── CLAUDE.md                ← détails techniques pour Claude
├── styles.css               ← style mutualisé (à modifier prudemment, impacte tous les guides)
├── app.js                   ← JS mutualisé (lightbox, scrollspy, FAB mobile)
├── logo-sportcorico.svg     ← logo blanc du header
├── favicon.png              ← favicon
└── AAAA-MM-JJ/
    ├── index.html
    ├── release_note.md
    └── screens/
```

## Hébergement

Servi en statique par Caddy depuis `/home/ubuntu/sites/release-guides.sportcorico.com`.
Bloc Caddyfile :

```caddy
release-guides.sportcorico.com {
    root * /home/ubuntu/sites/release-guides.sportcorico.com
    encode zstd gzip
    file_server browse
    try_files {path} {path}/ /index.html
}
```

Pour les détails plus techniques (composants CSS dispo, règles de rédaction, etc.), voir `CLAUDE.md`.