Soliguide

👋 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.

Le site public
0 %
0 composants repris sur 52
Applications
0
déjà en place ici
Briques partagées
0
le design, les images, l'API

🧭 Par où commencer ?

Chaque section répond à une question précise. Choisis celle qui ressemble à la tienne.

🌍 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

FrontendAngular 17 · sans rendu serveurOuvrir ↗À retirer
WidgetAngular 17En service
APINode.js · NestJS · MongoDBOuvrir ↗En service
API publique v2NestJS · Fastify · ZodCible
Suggestions de rechercheNode.js · module de l'APIEn service
Location APINestJSEn service
SoliHubNestJS · Prisma · PostgreSQL · AngularEn service
commonTypeScript · 529 fichiersEn service
taxonomyGénérateur d'icônes · 280 SVGEn service
design-systemSvelteÀ retirer

Demain, ce qu'on construit11 briques

Site publicAstro · SSRCible
DocumentationAstro · statiqueEn service
Widgetà déciderCible
Web-appAstroCible
routesTypeScript · middleware AstroCible
legalMarkdown par paysCible
uiCSS · registre de composantsCible
Identification des personnessolution à choisirCible
Back-officeAngular · inchangéCible
Chaîne de fabricationGitHub ActionsCible
api-clientGénéré depuis l'OpenAPICible

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 sertOù c'est rangéÉtat