§3 — Contexte et périmètre¶

3.1 Contexte système¶

AlpiMonitor est un système web autonome qui consomme des données publiques ouvertes et les restitue en lecture seule à un public web. Il n'est connecté à aucun CRM, aucun back-office tiers, aucune source privée.

Vue C4 niveau 1 (exportée depuis Structurizr) :

La même topologie en Mermaid inline, orientée flux plutôt que C4 :

graph LR
    User[Public web] -->|HTTPS| Web[alpimonitor.fr
SPA Vue 3]
    Recruiter[Relecteur technique] -->|HTTPS| Web
    Recruiter -->|HTTPS| Storybook[storybook.alpimonitor.fr
Design system]
    Web -->|REST JSON| API[api.alpimonitor.fr
Fastify]
    Cron[Cron interne 10 min] -->|SPARQL HTTP| LINDAS[LINDAS
OFEV/BAFU]
    Cron -->|Prisma SQL| DB[(PostgreSQL)]
    API -->|Prisma SQL| DB
    Web -->|HTTPS| OSM[OpenStreetMap
tuiles carto]
    GitHubApp[GitHub App
push main] -->|webhook| Coolify[Coolify
VPS Hetzner]
    Coolify -->|build+deploy| Web
    Coolify -->|build+deploy| API
    Coolify -->|build+deploy| Storybook

Sens de lecture : les flux descendants (utilisateur → système) sont synchrones au moment où l'utilisateur ouvre la page ; le flux LINDAS est asynchrone, déclenché par le cron interne toutes les 10 minutes ; le pipeline Coolify se déclenche à chaque push main.

3.2 Interfaces externes¶

Les sources non utilisées en v1 (MétéoSuisse SwissMetNet, GLAMOS temps réel, portail Web Hydro CREALP, Grande Dixence SA) sont tracées dans ADR-007 §Alternatives écartées et ADR-008 §Évolution future.

3.3 Périmètre (dans vs hors scope v1)¶

Dans le scope v1 — démontrable à l'URL publique¶

• Carte interactive Leaflet centrée sur le Rhône valaisan, 7 stations géolocalisées avec distinction LIVE (rempli primary) vs RESEARCH (hollow alpine) (ADR-005).
• Drawer fiche station au clic sur un marker LIVE — métadonnées + chart D3 24 h + lien vers la page Hydrodaten BAFU si la station est confirmée (§5 frontend).
• Graphique D3 24 h (ADR-006) avec tooltip hover, adaptatif largeur (mobile ↔ desktop).
• Ingestion LINDAS automatique toutes les 10 min (ADR-007) — upsert idempotent, archive JSON gzip, trace IngestionRun.
• Observabilité publique via /api/v1/status — lastRun, lastSuccessAt, healthyThresholdMinutes, compteurs journée. Badge live/stale/offline dans le hero.
• Design system Storybook — 15 composants présentationnels, 46 stories, 5 MDX (ADR-009).
• Transparence sourcing des stations RESEARCH via badge ASourcingBadge CONFIRMED/ILLUSTRATIVE (ADR-008).

Hors scope v1 — explicitement écarté¶

Ces features font partie du PRD initial mais ont été intentionnellement exclues du livrable candidature. Leur absence est un parti-pris assumé, tracé dans le PRD et défendable en entretien :

Un relecteur qui questionne "pourquoi X manque" doit pouvoir être renvoyé vers cette table + l'ADR ou la section PRD correspondante. Chaque exclusion est nommée et justifiée, pas oubliée.