👋 Bienvenue dans soliguide-neo
Ce dépôt sert à refaire le site public de Soliguide. Voici pourquoi, en une phrase : quand une personne cherche de l'aide, elle tape sa question dans un moteur de recherche ou la pose à une IA. Si Soliguide n'apparaît pas dans la réponse, tout le travail des structures référencées ne sert à personne.
Or aujourd'hui, notre site est presque invisible pour ces robots. On a mesuré : sur les pages testées, aucune ne montre son contenu tant que le navigateur n'a pas exécuté son JavaScript. Les robots des IA, eux, n'en exécutent pas. Ils voient une page blanche. 😶
🎯 Les quatre objectifs
🔍 Être trouvé
Nos pages doivent remonter dans les moteurs de recherche. Pas « correctement » : de façon irréprochable. Une page qu'on ne trouve pas n'existe pas.
💬 Être cité
On laisse volontiers les IA lire nos données. En échange, elles doivent dire d'où vient l'information. Un horaire donné sans sa source est invérifiable, et le jour où il change, personne ne sait où aller le corriger.
📖 Être lisible partout
Notre public consulte le site sur des téléphones anciens, avec des connexions lentes, parfois avec un lecteur d'écran, souvent dans une autre langue que le français. Chaque page doit tenir dans ces conditions.
🔌 Une API plus simple
La nouvelle API publique doit être facile à utiliser, à maintenir et à faire évoluer. La complexité d'une API se paie trois fois : quand on l'écrit, à chaque intégration, et à chaque changement.
📊 Où on en est
Trois chiffres pour situer le chantier. Ils se mettent à jour tout seuls, parce qu'ils sont calculés à partir du code et jamais saisis à la main.
🧭 Par où commencer ?
Chaque section répond à une question précise. Choisis celle qui ressemble à la tienne.
L'architecture
Comment le produit est construit, aujourd'hui et demain ?
Toutes les briques de Soliguide : celles qui tournent en production, celles qu'on vise, et celles qu'on va éteindre.
- Les applications
- L'API
- Ce qui change
- Les deux dépôts
L'avancement
Où en est la reprise du site public ?
Page par page et composant par composant : ce qui est fait, ce qui est en cours, et ce qui attend encore.
- Les 9 pages
- Les 56 composants
- Qui prend quoi
- L'effort
Le design
À quoi ressemble Soliguide, et comment le reproduire ?
Les couleurs, les polices, les icônes, les images et tous les composants, montrés en vrai.
- Couleurs
- Polices
- Icônes
- Images
- Composants
Nos règles
Comment on code ici, et pourquoi si strictement ?
Ce qui est interdit, ce qui est obligatoire, et surtout l'outil qui vérifie chaque règle à notre place.
- Les interdits
- Les vérifications
- Les commandes
Les assistants
Comment l'IA nous aide sans faire n'importe quoi ?
Les consignes qu'on donne aux assistants pour qu'ils écrivent du code qui nous ressemble.
- Design
- Accessibilité
- Sécurité
- Référencement
🌍 Tout Soliguide d'un coup d'œil
Voici toutes les briques du produit. D'abord ce qui tourne aujourd'hui, ensuite ce vers quoi on va. Les briques grisées fonctionnent encore, mais on a décidé de ne plus y investir : à terme, elles s'éteindront.
Aujourd'hui, en production11 briques
Demain, ce qu'on construit11 briques
Pour savoir ce que fait chaque brique et ce qui va changer pour elle, va voirl'architecture.
📦 Ce qu'il y a dans ce dépôt
Le détail du code, pour celles et ceux qui vont y travailler. Cette liste est lue directement dans les fichiers du projet à chaque publication, elle ne peut donc pas être en retard sur la réalité : une brique ajoutée apparaît toute seule, et celles qui n'ont pas encore de documentation le disent franchement.
| Nom | À quoi ça sert | Où c'est rangé | État |
|---|