AlpiMonitor — Documentation architecturale¶

Plateforme de démonstration technique sur les données ouvertes fédérales suisses, en deux domaines : hydrologie (Rhône valaisan et bassin de la Borgne) et énergie (tarifs d'électricité de l'ElCom). Cette documentation suit la structure arc42 adaptée en 10 sections — voir la navigation en haut de page. Stack + choix + deploy cadré par ADR-011.

Démo live¶

• Application : alpimonitor.fr — SPA Vue 3 : accueil, hydrologie sur /hydrologie (carte Leaflet + drawer + chart D3 24 h), énergie sur /energie.
• API + observabilité : api.alpimonitor.fr/api/v1/status — JSON, expose IngestionRun.lastRun + compteurs journée.
• Design system : storybook.alpimonitor.fr — 54 stories + 5 MDX.
• Repository : github.com/sodigitaljeremy/alpimonitor.

Production auto-déployée sur push main via Coolify + VPS Hetzner (§7 Vue de déploiement).

Tags et phases livrées¶

• v1.0.0-crealp (2026-04-22) — Première version publiée : landing live, ingestion LINDAS temps réel, 7 stations cartographiées, Lighthouse Desktop 96/100/100/100.
• v1.1.0-refactor (2026-04-23) — Design system + architecture : Storybook exhaustif, façades feature-grouped, lib/ domain-scoped, 173 tests, règle « aucun consumer prod hors façades » enforced (ADR-010).
• v1.2.0-ai à v1.6.0-docs (2026-06-04 → 2026-06-05) — Couche IA additive : narration, observabilité LLM, détection d'anomalie statistique, chat sur données structurées, puis documentation finale (ADR-012).
• v2.0.0-energy (2026-09-27) — Domaine énergie : tarifs ElCom, positionnement, trajectoire, décomposition (ADR-013).

Guide de lecture¶

Deux parcours recommandés selon le temps disponible.

Parcours rapide (30 s)¶

1. §1 Introduction et objectifs — pitch + 4 objectifs + personas.
2. §3 Contexte et périmètre — diagramme contexte + interfaces externes + in/out scope.
3. §9 Index ADR — tableau des 14 ADR avec statut et 1-line résumé.
4. Le repo GitHub pour échantillonner le code.

Parcours lecteur approfondi¶

1. §1 Introduction et objectifs.
2. §4 Stratégie de solution — choix top-level + data flow.
3. §5 Vue des blocs de construction + sous-pages frontend / backend / persistence.
4. §6 Vue d'exécution — 3 scénarios sequence (ingestion, sélection UI, health).
5. §7 Vue de déploiement + 4 post-mortems incidents.
6. §9 ADR 001-014 pour le détail des décisions.
7. §10 Risques et dette — non-scope, dette assumée, backlog, constats de production.

Source de cette documentation¶

Site généré par MkDocs + thème Material, sources Markdown dans docs/ du repo. Diagrammes rendus en Mermaid inline (C4 Structurizr SVG prévus pour une phase ultérieure). Voir docs/README.md pour le setup local.