📜 Historique du Projet EGS — Gallois Sisal (A → Z)¶

Document de référence retraçant l'ensemble du parcours projet, les issues rencontrées et résolues, et les décisions clés. Dernière mise à jour : 23 juin 2026

🎯 Résumé en une page¶

EGS (Établissements Gallois Sisal) est un producteur-exportateur premium de fibres de sisal basé à Amboasary-Atsimo, Madagascar, fondé en 1945. Le projet vise à refondre complètement le site web gallois-sisal.com pour transformer une simple vitrine en outil stratégique (génération de leads B2B, communication ESG/impact, attractivité talents).

• Client : EGS — Karen Raza (karen.raza@gallois-sisal.com), Candie Techer
• Agence : Riake — Andrianina Mahery (PM), Mickaël Kay (coordinateur), Fenohery Fanomezanirina (UX/UI + intégration)
• Repo officiel (actuel) : https://github.com/Gallois-sisal/egs (privé) — monorepo consolidé
• Site prod : https://gallois-sisal.com (page de garde « Site en construction »)
• Staging : https://staging.gallois-sisal.com
• Stack finale : Astro (SSR) + EmDash CMS + design Pencil/Penpot → déployé via Coolify sur VPS
• Tracker : 22 issues GitHub (8 fermées, 14 ouvertes) réparties sur 4 milestones
• Statut : Phase 1 (consolidation monorepo) ✅ terminée · Phase 2 (intégration design) en cours

📅 Chronologie complète¶

Phase 0 — Cadrage commercial (Août – Octobre 2025)¶

Décision initiale : Stack WordPress + Breakdance + WooCommerce (quiz interactif de diagnostic de grade).

Phase 1 — UX Research (Novembre 2025) ✅¶

Livrables (conservés dans docs/documentation/src/docs/03_Conception_UX/) : - Mindmap, Personas, Empathy Maps, Journey Maps, Service Blueprint - User Flows, Storyboards, Sitemap, Wireframes, Prototype - Usability Report

Jalon : ✅ Validation UX (GO UI)

Phase 2 — Design UI & Prototypage (Décembre 2025 – Janvier 2026) ✅¶

Direction artistique validée : premium, riche, immersif — vidéos hero, palette vert profond / blanc / tons terreux, typo Overused Grotesk.

Phase 3 — Intégration V1 : WordPress (Janvier – Mars 2026) ✅¶

Pages V1 intégrées : Accueil (V1 + V2), À propos, L'équipe, Nos produits, Les impacts, Transition, Nous contacter.

Phase 4 — Retours client & corrections design (Mars – Avril 2026) 🔄¶

Réunion de suivi 23/03/2026 avec EGS — directives de refonte graphique.

Les 10 retours majeurs d'EGS¶

Directives design actées¶

• 1 seule typographie uniforme (Overused Grotesk)
• Max 2–3 couleurs cohérentes
• Logo retiré des pages de contenu
• Photos réduites et harmonisées
• Objectif : épuré, classe, moderne, original — mais cohérent

Phase 5 — Pivot technique : WordPress → Astro (Mai – Juin 2026) 🔄¶

⚡ Décision stratégique majeure : abandon de la stack WordPress/Breakdance/WooCommerce au profit d'Astro (SSR) + EmDash CMS. Le code WordPress historique est conservé dans apps/wordpress/ (DDEV) mais n'est plus la voie de livraison.

Raisons du pivot : - Performance (Astro = statique/SSR ultra-léger vs. WordPress lourd) - Conformité pixel-perfect aux nouvelles maquettes Pencil/Penpot - Déploiement simplifié via Coolify (pas de runtime PHP/MySQL à maintenir) - Maintenance réduite côté client

Stack actuelle (apps/web/) :

Astro 6.3 (SSR via @astrojs/node)
├── React 19 (composants interactifs)
├── GSAP + Lenis (animations/scroll smooth)
├── EmDash CMS (headless, collections Pages + Posts, SQLite)
├── Agentation (feedback visuel → issues, dev/staging)
└── Pencil/Penpot (design source : Design/egs.pen)

Phase 6 — Consolidation monorepo (Juin 2026) ✅¶

Étape structurante : les 10 anciens repos de l'org GitHub Gallois-sisal ont été fusionnés en un monorepo unique. C'est le projet GitHub issue tracker officiel.

Anciens repos consolidés (org Gallois-sisal) : egs-agent, egs-agent-local, egs-frontend, egs-design, egs-dashboard, egs-admin-panel, egs-docs, egs-backend, egs-cms, infra-docs → tous importés (full history via git filter-repo) dans apps/, services/, docs/.

Traçabilité GitHub (issues #1 → #8, fermées) : | Issue | Action | |-------|--------| | #1 | Reorg en monorepo (web/ → apps/web/, + packages/, assets/, docs/) | | #2 | Merge chore/reorg-monorepo → main + résolution conflit Layout.astro/Agentation | | #3 | Restore deploy/ (nginx vhosts + landing + setup scripts) + .pi/RULE-EGS.md | | #4 | Consolidation des 10 repos (filter-repo, full history) | | #5 | Versioning assets Design (egs.pen + 79 image-import) | | #6 | Merge commits serveur origin/main (June 1) + résolution conflits path-move | | #7 | Push via VPS (contournement plafond réseau 364 Mo) | | #8 | Archive des 10 sources |

Incident (issue #22, ouverte, blocked) : lors de l'archive, egs-agent et egs-agent-local ont été supprimés (pas seulement archivés) de l'org GitHub. ✅ Aucune perte de code (historique complet préservé dans services/agent/ et services/agent-local/) — ⚠️ seules les métadonnées GitHub (issues/PRs/branch protection) sont perdues. Restauration possible via GitHub Support sous ~90 jours.

Voir la roadmap consolidation : issue #21

Phase 7 — Intégration design Pencil + polish (Juin 2026) 🔄¶

Commits récents (branche main) :

2e339e750 polish pass 2: eliminate pure #fff/#000 from all components
4ee2a01f9 fix(Valeurs): grid-template-cols typo → grid-template-columns (4-col grid)
e27a84ccd fix(navbar): align navigation order + labels with Pencil design
c2223adbf polish: remove slop tells (pure #fff→tokens, tint black, reduced-motion)
0026521d0 feat: intégration design Pencil (Prop 23/25/26/27/28) + sync CI/CD

🔧 Issues techniques rencontrés & résolus¶

1. Conflit Agentation × EmDash (SSR)¶

• Problème : NoMatchingRenderer au build — l'intégration EmDash consomme le renderer React au build time.
• Solution retenue : chargement Agentation dynamique côté client (apps/web/src/components/agentation-init.ts), conditionné par PUBLIC_AGENTATION !== "false". Résolu dans la consolidation (issue #2).

2. Collision build workspace¶

• Solution : package.json racine restreint aux workspaces apps/web + apps/ycode uniquement.

3. Fichier .fig > 100 Mo (limite GitHub)¶

• Solution : *.fig ajouté au .gitignore ; assets versionnés en .webp. ⚠️ Le .fig EGS-DS (487 Mo) est perdu pendant le filter-repo — issue #11 (blocked), récupération à étudier.

4. Plafond réseau GitHub (push 364 Mo)¶

• Problème : le push initial du monorepo consolidé dépassait la limite réseau.
• Solution : push effectué via le VPS (contournement) — issue #7.

5. CI/CD path¶

• Solution : working-directory: apps/web + cache-dependency-path appliqués aux workflows (ci.yml, deploy-prod.yml, deploy-staging.yml).

6. Page Impact illisible (retour client)¶

• Solution : page /impact recréée (Prop 28) — 568 lignes, 15 ODD, palette harmonisée.

📂 État des branches Git¶

Le monorepo consolidé vit sur deux remotes :

👥 Acteurs & rôles¶

🔗 Liens & ressources clés¶

Document maintenu par Fenohery — Riake. Pour l'état instantané, voir CURRENT-STATE.md.