Aller au contenu

AlpiMonitor — Documentation architecturale

Tableau de bord hydrologique du bassin de la Borgne (Valais, Suisse), livrable de démonstration technique pour une candidature au poste de Développeur·se Front-End au CREALP. 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

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) — Livrable candidature initial : 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).

Guide de lecture

Deux parcours recommandés selon le temps disponible.

Parcours recruteur 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 11 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 + 3 post-mortems incidents.
  6. §9 ADR 001-011 pour le détail des décisions.
  7. §10 Risques et dette — non-scope candidature, dette assumée, backlog post-candidature.

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.