Architecture — Livre Grandes Voies (L'escalade en grandes voies)

MAJ : 2026-06-28 · Projet : PUB-LivreGV · Skill : pub-livre-gv · Type : publication (VitePress / PDF) Schémas (pages web) : schemas/pub-livre-gv_architecture.html (vue architecte) · schemas/pub-livre-gv_fonctionnement.html (comment ça marche).

1. Vue d'ensemble

Manuel technique et pédagogique sur l'escalade en grandes voies, co-rédigé via le pipeline multiagent fwk-editorial et publié selon une double chaîne : un site VitePress déployé sur Vercel et un export PDF (pandoc + XeLaTeX). Le contenu réel à la racine compte 39 chapitres (P1-Ch01 → P9-Ch39) répartis en 9 parties en entonnoir, plus des pages auxiliaires 00-*.md (le SKILL v3.29 mentionne encore « 35 chapitres / 8 parties » — écart à harmoniser).

2. Stack & structure

• Sources : chapitres P{N}-Ch{NN}-{slug}.md + intros P{N}-intro.md à la racine ; auxiliaires 00-index.md, 00-preambule.md, 00-comment-lire.md, 00-sommaire.md, 00-manips.md, 00-contact.md, 00-auteur.md ; annexes (annexes/), temoignages/.
• Système d'ancres explicites (v3.18) : {#ch-N}, {#sec-X-Y}, {#sec-X-Y-Z} ; références croisées toujours cliquables (URLs relatives /parties/...).
• Site VitePress : _export/site/ (package.json, public/, node_modules). Palette rouge magma + bleu Verdon + vert émeraude ; typo Outfit/Inter/JetBrains Mono.
• Composants Vue locaux (_export/site/.vitepress/theme/components/) : HeroEscalade, ChapitreHero, PartieCard/PartieGrid, Stat/StatGrid, Respiration, ImmersionPhoto, PortfolioPartie, ConclusionChapitre, ParcoursLivre, RecitTerrain, PhotoMosaique, FicheManip, StoryboardDeplie, CinematiqueSixPhases. Règle : ni <table> HTML ni Mermaid dans VitePress (cassent le build).
• Config : _export/site/.vitepress/config.js + rewrites (P{N}-Ch{NN} → /parties/partieN/chapitre-NN.html). vercel.json à la racine. Référence opérationnelle : _skill/_source/LECONS-VITEPRESS.md.
• Ressources : _ressources/schemas/ (.mmd), _ressources/images/ (illustrations, escalade, manips).

3. Chaîne de production / export

• Rédaction : pipeline fwk-editorial (agents rédaction/critique/cohérence/lecture/recherche/synthèse), piloté par _meta/_strategie.md, _meta/plan-editorial.md, _meta/_config.json.
• Web : build VitePress → déploiement Vercel (push.ps1, push-session.ps1, deploy-philippe-mussatto.ps1).
• PDF : _export/pdf/assemble_livre_gv.py (pandoc + XeLaTeX) ; schémas rendus dans _export/pdf/_schemas_rendered/ ; sorties livre-gv_v1.pdf, livre-gv_v2.html/.md.
• Modules META utilisés (via uses) : export-vercel, export-vitepress, export-pdf, schemas, platform-github, platform-dropbox.

4. Choix structurants

Décision	Raison
Séparation 3 rôles des pages d'entrée (home / préambule « je » / comment-lire / sommaire) v3.28	Éviter la dilution de la voix « je » et créer une vraie progression
Composants Vue dédiés au lieu de <table>/Mermaid pour les schémas séquentiels	Ces patterns cassent le build VitePress
Ancres explicites systématiques + liens croisés cliquables	Navigabilité numérique du livre
Certains fichiers interdits à l'Edit tool (config.js, 00-index.md, 00-comment-lire.md)	Troncature FUSE/Dropbox en fin de fichier casse le build Vercel
Marqueur (⊕) en suffixe H3 plutôt que badge <Niveau>	Portable web + PDF

5. Dépendances (uses) & artefacts

• uses : fwk-editorial (pipeline éditorial) ; meta-system (modules export/platform/schemas).
• Livrables : site VitePress sur Vercel ; PDF (_export/pdf/) ; relectures tracées (_rapports/relectures/ : ETAT-COURANT, REGISTRE R-001→R-180, DECISIONS, METHODE) ; récits terrain (_matiere/recits-terrain-source.md, 30 récits).

6. Points ouverts / à faire

• Harmoniser le SKILL (« 35 chapitres / 8 parties ») avec le contenu réel (39 chapitres P1→P9, 9 parties).
• Schéma d'architecture à créer (aucun présent dans _doc/).
• Vague de relecture P5 (Ch.16–19) : 110 entrées 🟠 à appliquer ; P6–P9 non encore relus (état au SKILL daté 23 mai 2026 — à reconfirmer).
• Vigilance permanente : troncature/null-bytes Dropbox sur fichiers longs et blobs git (§6.6/6.8/6.10 du SKILL).
• Statut module export-vitepress vs platform-github : déploiement décrit côté skill, schéma de chaîne complète (à compléter).