# Deploiement GitHub Pages (site statique + module Lab interactif)

## Prerequis
- Depot Git connecte a GitHub (`git remote -v` non vide).
- Dependances installees:
  - `npm install`
  - `npm --prefix apps/lab-interactif install`
- Build module lab OK (`npm run lab:build`).
- Workflow present: `.github/workflows/deploy-pages.yml`.
- Fichiers de publication racine presents:
  - `index.html`, `styles.css`, `script.js`
  - `assets/` (dont `assets/og-cover.jpg` + `assets/brand/*`)
  - `robots.txt`, `sitemap.xml`
  - favicons (`favicon*`, `apple-touch-icon.png`)

## Configuration GitHub Pages
1. GitHub > depot > **Settings** > **Pages**.
2. Dans **Build and deployment**:
   - **Source**: `GitHub Actions`
3. Enregistrer.

## Pipeline deploiement
Workflow: **Deploy Static Site + Lab to GitHub Pages**

Le job build:
1. installe les deps racine
2. installe les deps du module `apps/lab-interactif`
3. build le module interactif dans `lab/`
4. prepare un artifact `.pages-dist/` (site + assets + lab)
5. deploye via `actions/deploy-pages`

## Commandes locales utiles
- Home statique: `python3 -m http.server 4173`
- Lab dev: `npm run lab:dev`
- Lab build: `npm run lab:build`
- Tracking contract: `npm run tracking:check`
- Budget images critiques: `npm run image:budget`
- Storybook build: `npm run storybook:build`
- Preflight complet pages: `npm run preflight:pages`
- Build externe Astro (avec `/lab` inclus): `npm run build:external`

## Déploiement externe Astro (Vercel/Netlify)

Objectif: publier `dist/` généré par Astro pour une version hors GitHub Pages.

- Préparer les variables d’environnement:
  - `PUBLIC_SITE_URL=https://<votre-domaine-vercel-ou-netlify>/` (canonical + OG)
  - éventuellement `EXTERNAL_SITE_URL` comme alias pratique
- Note: `npm run build:external` échoue volontairement si aucune de ces variables n'est définie (protection anti-canonical erroné).
- Exécuter: `npm run build:external`
- GitLab/Netlify et Vercel détectent automatiquement `vercel.json` / `netlify.toml` :
  - `vercel`: `npm run build:external`
  - `netlify`: `npm run build:external`
- Le build externe inclut:
  - page Astro Home: `dist/index.html`
  - page `dist/robots.txt` et `dist/sitemap.xml` (générés selon `PUBLIC_SITE_URL`)
  - bundle Astro `_astro/`
  - `dist/lab/` (copié après `lab:build`) si `lab/` existe

## Notes de contrôle pour version externe
- Vérifier `https://<domaine-externe>/` après déploiement.
- Vérifier les ancres `/` : `#a-propos`, `#projets`, `#contact`.
- Vérifier que `canonical` correspond bien à `PUBLIC_SITE_URL`.
- Vérifier OG/Twitter preview via cache buster si nécessaire.
- Vérifier la présence de `/lab/` selon la stratégie produit.

## Déploiement externe FTP (OVH)

Hôte cible: `ftp://ecobsoleiq@ftp.cluster129.hosting.ovh.net:21/`
Utilisateur: `ecobsoleiq`

1. Build externe:
   - `PUBLIC_SITE_URL=https://<ton-domaine-externe>/ npm run build:external`
2. Préparer les identifiants (hors repo):
   - Copier `.env.ftp.example` vers `.env.ftp`
   - Remplacer `FTP_PASS=...` par le vrai mot de passe
   - Garder `FTP_REMOTE_DIR=/www` (recommandé OVH mutualisé)
   - `source .env.ftp` (ou exporter `FTP_PASS` / `FTP_HOST` en variable d'env)
3. Déploiement via script:
   - `FTP_PASS='<ton_mot_de_passe>' FTP_REMOTE_DIR='/www' npm run deploy:ftp`
   - ou, via fichier local: `source .env.ftp && npm run deploy:ftp`
   - version one-shot avec build externe: `npm run deploy:web:ftp`
3. Vérifier:
   - `https://<ton-domaine-externe>/`
   - `https://<ton-domaine-externe>/#a-propos`
   - `https://<ton-domaine-externe>/#projets`
   - `https://<ton-domaine-externe>/#contact`

Notes:
- Le script utilise `lftp`; installe-le si absent: `brew install lftp` ou `apt-get install lftp`.
- Le script refuse de synchroniser vers `/` par sécurité (utiliser `/www`).
- Si ton host pointe vers un sous-répertoire, ajuste `FTP_REMOTE_DIR` (ex: `/www/`).
- Aucune donnée sensible n’est hardcodée dans le script (mot de passe via `FTP_PASS` uniquement).

Exemple 1-liner (via fichier local `.env.ftp`):

```bash
PUBLIC_SITE_URL='https://example.com/' \
FTP_URL='ftp://ecobsoleiq@ftp.cluster129.hosting.ovh.net:21/' \
npm run build:external && source .env.ftp && npm run deploy:ftp
```

Exemple 1-liner (sans `.env.ftp`):
```bash
FTP_PASS='***' \
PUBLIC_SITE_URL='https://example.com/' \
FTP_HOST=ftp.cluster129.hosting.ovh.net \
FTP_USER=ecobsoleiq \
npm run build:external && npm run deploy:ftp
```

## Stratégie de déploiement duale (si besoin business)
- Production: GitHub Pages reste la version publiée courante (`index.html`, `styles.css`, `script.js`, `/lab/`).
- Complément: version web hors GitHub possible via build Astro dédié (`npm run build:external`), puis publication sur hôte dédié (Netlify/Vercel/custom).
- Contrat immuable: ancres `#a-propos`, `#projets`, `#contact`, labels CTA, et paramètres GA4 conservés entre versions.

## Contrat tracking GTM + GA4

### Container
- GTM: `GTM-5SLM67QF`

### Evenements principaux
- `cta_hero_projets`
- `cta_hero_contact`
- `cta_hero_profile`
- `outbound_linkedin_contact`
- `outbound_malt_contact`
- `outbound_bandcamp_contact`
- `outbound_github_contact`

### Evenements GitHub dedies
- `outbound_github_project_rtc_bl_phone`
- `outbound_github_project_zacus`
- `outbound_github_project_site`
- `outbound_github_lab_more`
- `cta_lab_interactif_open`

### Compat historique
- Les liens GitHub critiques conservent `data-track-legacy` pour pousser aussi les evenements legacy.

### Parametres obligatoires
- `event_category=engagement`
- `event_label=<nom_evenement>`
- `destination=<domaine|ancre|path>`

## Verification post-deploiement
- [ ] `https://electron-rare.github.io/` charge correctement
- [ ] `https://electron-rare.github.io/lab/` charge correctement
- [ ] Ancres core home (`#a-propos`, `#projets`, `#contact`) OK
- [ ] `robots.txt` accessible
- [ ] `sitemap.xml` accessible (inclut `/` + `/lab/`)
- [ ] OG/Twitter preview OK
- [ ] GA4 Realtime voit les events clics
- [ ] GA4 DebugView confirme `event_label` + `destination`
- [ ] Search Console: sitemap soumis + indexation `/` et `/lab/`

## Notes de routage module C
- Le module lab utilise `HashRouter` pour compatibilite hebergement statique (GitHub Pages).
- Routes attendues:
  - `/lab/` (overview)
  - `/lab/#/signals`
  - `/lab/#/prototypes`