🤝 Guide de Handoff — Reprise par EGS¶

Ce document explique comment l'équipe EGS va reprendre la main sur son site web après livraison. Écrit pour des utilisateurs non-techniques. Audience : Karen Raza, Candie Techer, et toute personne chez EGS qui administrera le site. Date : 23 juin 2026 · Auteur : Fenohery Fanomezanirina (Riake)

📖 Sommaire¶

La navigation détaillée (table des matières) est disponible dans la barre latérale droite du site.

1. Ce que vous recevez
2. Les accès à récupérer
3. Administrer le contenu (CMS)
4. Mettre à jour une image ou un texte simple
5. Gérer le formulaire de contact
6. Déploiements : comment sortent les mises à jour
7. Maintenance courante
8. Que faire en cas de problème
9. Formation & accompagnement
10. Glossaire

1. 📦 Ce que vous recevez¶

À la clôture du projet, EGS dispose de :

⚠️ Important : Le code source (Gallois-sisal/egs) et l'hébergement vous appartiennent. Ce repo consolide les 10 anciens repos de votre org GitHub. Riake reste disponible pour le support (période de garantie) mais vous êtes autonome.

2. 🔑 Les accès à récupérer¶

Riake vous remettra de manière sécurisée (pas par email en clair) :

Comptes principaux¶

Sécurité — bonnes pratiques¶

• 🔐 Ne jamais partager les mots de passe par email/WhatsApp — utiliser un gestionnaire de mots de passe (Bitwarden, 1Password)
• 🔐 Activer la 2FA (authentification à 2 facteurs) sur GitHub et Coolify
• 🔐 Sauvegarder les accès dans un coffre-fort numérique partagé EGS
• 🔐 Gérer les collaborateurs : inviter les membres EGS dans l'org GitHub Gallois-sisal

3. 📝 Administrer le contenu (CMS)¶

Qu'est-ce que EmDash ?¶

EmDash est le CMS (système de gestion de contenu) headless du site. Il vous permet de modifier les textes et images sans toucher au code. Les données sont stockées dans une base SQLite (data.db).

Collections disponibles¶

Comment éditer une page (workflow prévu)¶

1. Se connecter à l'interface EmDash (URL communiquée)
2. Ouvrir la collection Pages
3. Cliquer sur la page à modifier
4. Éditer le texte / remplacer l'image dans l'éditeur visuel
5. Cliquer Publier
6. ✅ Le changement apparaît sur le site en quelques minutes

⚠️ Statut actuel (23/06/2026) : EmDash est configuré mais son utilisation par EGS est à valider avec Mickaël (issue Phase 2). Deux options : - Option A : EGS utilise EmDash pour tout le contenu éditable → formation requise - Option B : Le contenu reste statique dans le code Astro → mises à jour par Riake/dev (change request)

4. 🖼️ Mettre à jour une image ou un texte simple¶

Cas A — Si EmDash est activé¶

→ Voir section 3

Cas B — Sans CMS (contenu dans le code)¶

Pour changer une photo par exemple :

1. Préparer l'image au format .webp (optimisée, < 500 Ko idéalement)
2. La placer dans apps/web/public/images/
3. Demander à un développeur de mettre à jour la référence dans la page .astro correspondante
4. Commit + push → déploiement automatique

💡 Pour les petits changements ponctuels (changer un titre, une adresse), Riake peut le faire dans le cadre du support. Pour les mises à jour fréquentes, EmDash est recommandé.

Où sont les assets ?¶

apps/web/public/images/     ← photos du site (format .webp)
apps/web/public/fonts/      ← Overused Grotesk
apps/web/public/logos/      ← logos SVG
Design/images/              ← 79 assets source (à router vers public/, issue #10)

5. 📧 Gérer le formulaire de contact¶

⚠️ À FINALISER AVANT LANCEMENT (issue #15) — Le formulaire de /contact a actuellement action="#" (non connecté à un backend).

Ce qu'il faut décider¶

Quand un visiteur remplit le formulaire de contact, où va le message ?

Recommandation Riake : Service tiers type Formspree ou Resend — fiable, gratuit sous 50 messages/mois, aucune maintenance.

Champs du formulaire (déjà en place)¶

• Nom complet
• Adresse email
• Objet (liste déroulante)
• Message

6. 🚀 Déploiements : comment sortent les mises à jour¶

Le principe (automatique)¶

Vous modifiez le code → git push → mise à jour automatique du site

Règle d'or¶

Ne jamais pusher directement sur main sans tester sur dev d'abord.

Workflow recommandé pour EGS¶

1. Demander le changement (via EmDash si CMS, ou via dev si code)
2. Le changement est poussé sur dev → visible sur le staging
3. EGS valide sur le staging
4. Si OK → fusion dev → main → live en production

Voir l'état des déploiements¶

• Coolify dashboard : deploy.gallois-sisal.com → voir les logs, redéployer, gérer les variables
• GitHub Actions : github.com/Gallois-sisal/egs/actions → historique des builds
• GitHub Issues : github.com/Gallois-sisal/egs/issues → suivi des tâches (22 issues)

7. 🛠️ Maintenance courante¶

Tâches mensuelles (EGS ou support)¶

Sauvegardes¶

• Coolify gère des backups automatiques (à configurer/vérifier)
• Le code source est versionné sur GitHub (Gallois-sisal/egs) — sauvegarde permanente de l'historique
• Recommandation : backup mensuel de data.db (base EmDash) téléchargé localement

8. 🆘 Que faire en cas de problème¶

Le site ne s'affiche pas¶

1. Vérifier votre connexion internet
2. Tester depuis un autre appareil / réseau
3. Vérifier le statut Coolify : deploy.gallois-sisal.com
4. Si Coolify inaccessible → problème serveur → contacter le support

Une page affiche une erreur¶

1. Noter l'URL exacte + message d'erreur (capture d'écran)
2. Vérifier si ça reproduit sur staging.gallois-sisal.com
3. Créer une issue sur github.com/Gallois-sisal/egs/issues (ou signaler à Riake)

Le formulaire ne renvoie pas d'email¶

1. Vérifier les spams
2. Vérifier la configuration du service tiers (Formspree/Resend)
3. Signaler à Riake

Qui contacter¶

9. 🎓 Formation & accompagnement¶

Session de formation prévue¶

• Durée : ~2 heures
• Participants : Karen Raza + 1–2 personnes EGS
• Format : Visio + partage d'écran (ou présentiel Antananarivo)
• Animée par : Fenohery (Riake)

Programme de la formation¶

1. Tour du site (30 min) — chaque page, ses sections
2. Le CMS EmDash (45 min) — édition de contenu en live
3. Le formulaire de contact (15 min) — où vont les messages
4. Coolify dashboard (20 min) — voir l'état, redéployer
5. GitHub Issues (10 min) — comment signaler un besoin/bug

Documentation remise¶

• Ce dossier docs/ complet
• Guide d'administration (à finaliser avec EmDash)
• Accès et mots de passe (via coffre-fort sécurisé)

10. 📚 Glossaire¶

✅ Checklist de handoff (à cocher à la livraison)¶

• Site complet validé et déployé en production
• Accès GitHub Gallois-sisal/egs confirmés (membres EGS invités, 2FA activée)
• Accès Coolify communiqués (2FA activée)
• Accès CMS EmDash (si activé) + test d'édition
• Formulaire de contact fonctionnel (email test reçu)
• Certificat SSL valide (cadenas vert)
• Sauvegarde complète effectuée (data.db + repo)
• Documentation remise (ce dossier)
• Session de formation planifiée/réalisée
• Période de garantie démarrée
• Sign-off final signé par EGS

Ce guide sera ajusté selon les décisions finales (CMS, formulaire) actées avec Mickaël et EGS. Pour toute question : Fenohery Fanomezanirina — Riake.