# Asterion VR — Refonte du site web 2026

Repo de la refonte d'**asterionvr.com** : nouveau site institutionnel B2B/B2G de la plateforme XR PROSERVE pour les forces de sécurité européennes (police, special forces, military, firefighters).

> **Stack** : WordPress 6.x + Bricks Builder (parent) + child theme custom `asterion-bricks` + WPML.
> **Cible** : Lighthouse 90+, WCAG 2.1 AA, mobile-first, RGPD-natif, hébergement français.

---

## Documents de référence

À lire dans cet ordre **avant tout travail technique** :

1. `BRIEF-Claude-Code.md` — brief de démarrage projet (13 sections, contraintes, conventions).
2. `Asterion-VR_Refonte-2026_Strategie-et-Contenu.pdf` — livrable 1 (84 p) : diagnostic, stratégie, sitemap, copy EN prête de toutes les pages.
3. `Asterion-VR_Refonte-2026_Design-Handoff-Specification.pdf` — livrable 2 (31 p) : tokens, composants UI, wireframes des 7 templates, motion, a11y.

Les `.txt` extraits des PDF sont gitignorés. Pour les régénérer :

```bash
pdftotext -layout "Asterion-VR_Refonte-2026_Design-Handoff-Specification.pdf" "design-handoff.txt"
pdftotext -layout "Asterion-VR_Refonte-2026_Strategie-et-Contenu.pdf" "strategie-et-contenu.txt"
```

(`pdftotext` est inclus dans Git for Windows : `C:\Program Files\Git\mingw64\bin\pdftotext.exe`.)

---

## Setup local (LocalWP + symlink Git)

### 1. Pré-requis

- **LocalWP** (https://localwp.com) configuré en mode `localhost` (Preferences → Advanced → Router Mode = `localhost`) pour cohabiter avec d'autres stacks locales (XAMPP, etc.).
- Site LocalWP créé : nom **Asterion 2026**, dossier `C:\Users\j_foucher\Local Sites\asterion-2026\`.
- ZIP des plugins commerciaux (chacun doit fournir les siens, depuis son propre compte) :
  - `bricks.X.Y.Z.zip` — depuis https://bricksbuilder.io
  - `sitepress-multilingual-cms.X.Y.Z.zip` — depuis https://wpml.org
  - À déposer dans `ThirdParty/` (gitignored).

### 2. Installer Bricks parent

1. Décompresser `ThirdParty/bricks.X.Y.Z.zip` dans `<LocalWP site>/app/public/wp-content/themes/`.
2. Activer Bricks dans WP Admin → Apparence → Thèmes.
3. Renseigner la license dans Bricks → License (depuis ton compte bricksbuilder.io).

### 3. Installer WPML

1. Dans WP Admin → Extensions → Ajouter → Téléverser, charger `ThirdParty/sitepress-multilingual-cms.X.Y.Z.zip`.
2. Activer le plugin et entrer la clé de license depuis ton compte wpml.org.

### 4. Symlink le child theme depuis ce repo vers LocalWP

Depuis une **PowerShell admin** :

```powershell
New-Item -ItemType SymbolicLink `
  -Path "C:\Users\j_foucher\Local Sites\asterion-2026\app\public\wp-content\themes\asterion-bricks" `
  -Target "C:\ASTERION\GIT\WP2026\wp-content\themes\asterion-bricks"
```

Puis dans WP Admin → Apparence → Thèmes, activer **Asterion Bricks** (le child theme).

---

## Approche

**Bricks-first, child theme minimaliste.** Le rendu de chaque page est piloté par Bricks Builder (Templates pour header/footer/archives + pages éditées dans le builder). Le child theme se contente d'apporter le design system (tokens CSS), Inter self-hosté (RGPD) et les Custom Post Types. Voir `wp-content/themes/asterion-bricks/README.md` pour le détail.

Une session de PHP-rendering plus traditionnelle a été archivée dans la branche Git `archive/session-2-php-templates` ainsi que dans `RESTART-PLAN.md` à la racine. Ne pas réintroduire ce pattern sans relire ces deux sources.

## Structure du repo

```
WP2026/
├── BRIEF-Claude-Code.md          # brief projet (lecture obligatoire)
├── README.md                     # ce fichier
├── RESTART-PLAN.md               # historique de la décision Bricks-first
├── MISSING-ASSETS.md             # tracking des visuels/medias manquants
├── *.pdf                         # 2 livrables stratégie + design (sources de vérité)
├── ThirdParty/                   # gitignored — ZIP plugins commerciaux
│   ├── bricks.*.zip
│   └── sitepress-multilingual-cms.*.zip
├── content-source/               # copy EN extrait du PDF (référence + génération)
│   ├── solutions-data.php
│   ├── industries-data.php
│   ├── technology-data.php
│   ├── editorial-data.php
│   ├── forms-data.php
│   └── README.md
└── wp-content/
    └── themes/
        └── asterion-bricks/      # child theme minimaliste, voir son README
            ├── style.css
            ├── functions.php
            ├── theme.json
            ├── README.md
            ├── inc/
            │   └── cpt.php
            └── assets/
                ├── css/
                │   ├── tokens.css     # design system, source de vérité
                │   └── utilities.css  # skip-link, sr-only, focus-visible
                ├── fonts/             # Inter Variable self-hosté
                └── img/
```

---

## Conventions

- **CSS** : préfixe `av-` (asterion-vr), nommage BEM-light, zéro hardcode (tout via tokens).
- **JS** : vanilla, defer, modules ES6 si nécessaire.
- **Images** : AVIF + WebP + JPG fallback, lazy-loading natif sauf hero.
- **Vidéos** : MP4 H.264 + WebM VP9, autoplay muted plays-inline loop, poster image.
- **Commits** : Conventional Commits (`feat:`, `fix:`, `chore:`, `style:`, `refactor:`, `test:`, `docs:`).
- **Branches** : `main` = stable, `feat/<scope>` = work in progress, merge après validation.

---

## Hors scope phase actuelle

Production (OVH/O2switch + Cloudflare), migration depuis Avada, plan 301, traduction FR (linguiste interne), création articles blog éditoriaux (post-launch).

---

## Contact

- **Client** : Jérôme Foucher — Asterion VR — jerome.foucher@asterionvr.com
- **Repo** : git.polymorph.fr (privé)