feat: enable GH Pages stable plus deploy externe Vercel/Netlify

docs/github-pages-deploy.md

@@ -1,68 +1,115 @@
-# Déploiement GitHub Pages (Astro studio stack)
+# Deploiement GitHub Pages (site statique + module Lab interactif)
 
-## Prérequis
-- Dépôt Git connecté à GitHub (`git remote -v` non vide).
-- Dépendances installées (`npm install`).
-- Build local OK (`npm run build`).
-- Workflow présent: `.github/workflows/deploy-pages.yml`.
-- Fichiers publics en place:
-  - `public/robots.txt`
-  - `public/sitemap.xml`
-  - `public/assets/og-cover.jpg`
-- GTM configuré via variable `PUBLIC_GTM_CONTAINER_ID` (par défaut actuel: `GTM-5SLM67QF`).
+## 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 > dépôt > **Settings** > **Pages**.
+1. GitHub > depot > **Settings** > **Pages**.
 2. Dans **Build and deployment**:
    - **Source**: `GitHub Actions`
 3. Enregistrer.
 
-## Déploiement
-1. Push sur `main` (ou lancer `workflow_dispatch`).
-2. Vérifier le workflow **Deploy Astro to GitHub Pages**.
-3. Attendre l'URL de déploiement dans le job `deploy`.
+## Pipeline deploiement
+Workflow: **Deploy Static Site + Lab to GitHub Pages**
 
-## Commandes locales
-- Dev: `npm run dev`
-- Typecheck: `npm run typecheck`
-- Build prod: `npm run build`
-- Storybook: `npm run storybook`
+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`
 - Storybook build: `npm run storybook:build`
+- Preflight complet pages: `npm run preflight:pages`
+- Build externe Astro (avec `/lab` inclus): `npm run build:external`
 
-## Instrumentation GTM + GA4
-1. Créer/associer un conteneur GTM et propriété GA4.
-2. Vérifier `PUBLIC_GTM_CONTAINER_ID` utilisé au build/deploy.
-3. Publier le conteneur GTM.
-4. Vérifier GA4 Realtime et DebugView.
+## Déploiement externe Astro (Vercel/Netlify)
 
-### Contrat d'événements (`dataLayer`)
+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
+- 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`
+  - 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.
+
+## 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_project`
 - `outbound_linkedin_contact`
 - `outbound_malt_contact`
-- `outbound_bandcamp_project`
 - `outbound_bandcamp_contact`
+- `outbound_github_contact`
 
-Paramètres:
+### 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>`
+- `destination=<domaine|ancre|path>`
 
-Conversions recommandées:
-- Primaire: `outbound_linkedin_contact`
-- Secondaire: `outbound_malt_contact`
+## 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/`
 
-## Vérification post-déploiement
-- URL publique chargée sans erreur.
-- Sections et ancres (`#a-propos`, `#projets`, `#contact`) OK.
-- `https://electron-rare.github.io/robots.txt` accessible.
-- `https://electron-rare.github.io/sitemap.xml` accessible.
-- OG/Twitter image OK (`/assets/og-cover.jpg`).
-- GA4 Realtime + DebugView remontent les events et paramètres.
-- Aperçu social validé (LinkedIn Post Inspector / Facebook Debugger).
-
-## Traçabilité
-- Mettre à jour `evidence/manifest.json`.
-- Ajouter artefacts dans `artifacts/*/<date>/` à chaque itération.
+## Notes de routage module C
+- Le module lab utilise `HashRouter` pour compatibilite hebergement statique (GitHub Pages).
+- Routes attendues:
+  - `/lab/` (overview)
+  - `/lab/#/signals`
+  - `/lab/#/prototypes`