💧 Saints Peyres

L'opérateur du barrage (Laetis) publie une mesure du niveau d'eau toutes les 20 minutes environ sur une API publique (data.niv-eau.fr). Soit ~72 mesures par jour.

Notre serveur interroge cette API toutes les 20 minutes pour récupérer les nouvelles mesures et les stocker dans la base. Si l'API ne renvoie rien pour un jour donné (panne capteur, maintenance), on retente pendant 7 jours, puis on marque le jour comme "définitivement blanc" pour ne plus interroger inutilement.

mNGF = « mètre NGF », pour Nivellement Général de la France. C'est le système d'altitude officiel français. Le zéro de référence (0 mNGF) correspond au niveau moyen de la mer à Marseille (mesuré par le marégraphe de Marseille, qui sert de point de repère depuis 1897).

Donc quand on dit « le lac est à 666,97 mNGF », ça veut dire que la surface de l'eau au niveau du barrage se trouve à 666,97 m au-dessus du niveau de la mer. Ce n'est pas la profondeur du lac (qui est variable selon où on se trouve).

Comme la région du Tarn est déjà en altitude, le niveau du lac varie typiquement entre 633 m (minimum historique, automne 2022) et environ 670 m en eaux hautes. C'est l'information brute publiée par Laetis (l'opérateur du barrage).

Pour rendre la donnée plus parlante au quotidien, on peut basculer l'affichage vers d'autres référentiels (voir question suivante).

Le niveau brut (en mNGF, voir ci-dessus) est précis mais peu intuitif. L'app propose 3 référentiels d'affichage interchangeables dans la section « Affichage du niveau » plus haut. La donnée stockée reste toujours la même (mNGF), on change juste la manière de l'afficher.

• Altitude (mNGF) — la valeur brute. Bien pour comparer dans le temps long, pas très parlant au jour le jour.
• Sous le ponton — combien d'eau il y a sous la coque du bateau. Calculé à partir d'une calibration faite par l'admin (sur le bateau, on note le niveau actuel ET la profondeur indiquée par le sondeur ; l'app déduit le mNGF qui correspond au « 0 m sous la coque »). Exemple : si l'app indique 2,30 m sous la coque, ça veut dire qu'il reste 2,30 m d'eau sous le bateau au ponton (potentiellement négatif si le lac descend sous le ponton — il faut alors déplacer le bateau).
• Depuis le minimum historique — combien de mètres au-dessus du plus bas niveau jamais enregistré. Le minimum est calculé automatiquement (la valeur la plus basse de toute la base de données). Garanti positif (sauf nouveau record bas).

Le réglage est personnel (stocké dans le navigateur, comme le thème). Tu peux switcher quand tu veux, ça n'affecte pas les autres utilisateurs. L'étalonnage du ponton, lui, est partagé entre tous (c'est dans l'admin).

Principe : on prend le niveau de la dernière mesure connue (le « niveau actuel ») et on le soustrait au niveau d'il y a exactement N×24 h.

Exemple concret — si la dernière mesure date du 16 mai 23:40 et vaut 666.91 m :

• VS Hier compare à la mesure du 15 mai 23:40 (donc même heure)
• VS il y a 3 jours compare à la mesure du 13 mai 23:40
• VS il y a une semaine compare à la mesure du 9 mai 23:40

Comme l'API publie une mesure toutes les 20 minutes, on a en général exactement la mesure de 23:40 à J-7 (ou à 1 minute près). Si pour une raison ou une autre il n'y a pas de mesure pile à cette heure-là (trou de données ponctuel), on prend la mesure la plus récente strictement avant (donc 23:20, ou à défaut 23:00, etc.).

Important : on compare à la même heure que celle de la dernière mesure (23:40 dans l'exemple). On ne fait jamais de moyenne sur la journée, et on ne compare jamais à une heure arbitraire (genre « la mesure du début de journée » ou « celle de midi »).

C'est la pente moyenne du niveau sur les 7 derniers jours, en mètres par jour.

Formule : (niveau actuel − niveau il y a 7 jours) / 7.

Exemple : si on est passé de 666.50 m il y a 7 jours à 666.91 m aujourd'hui, la tendance est de +0.41 / 7 = +0.059 m/j. Sur un mois ça ferait environ +1.77 m.

Tendance positive = le lac monte ; négative = il baisse. C'est cette pente locale qui sert aussi à colorer chaque segment du graph d'accueil (vert si ça monte, rouge si ça baisse).

Principe : on cherche le niveau qu'avait le lac à la même période de l'année il y a 1, 2 ou 3 ans.

Pourquoi pas exactement la même date ? Parce qu'une année plus tôt, il n'y a pas forcément de mesure pile au même jour ni à la même heure (panne API, jour blanc, etc.). Donc on ouvre une fenêtre de 7 jours centrée sur l'anniversaire (3 jours avant + 3 jours après) :

Exemple concret — si la dernière mesure est du 16 mai 2026 23:40 à 666.91 m, pour calculer « VS 2025 » on cherche dans la fenêtre 13 mai 2025 23:40 à 19 mai 2025 23:40 (soit 7 jours autour de l'anniversaire 16 mai 2025 23:40).

• S'il y a plusieurs mesures dans cette fenêtre, on prend celle dont la date/heure est la plus proche de l'anniversaire.
• S'il n'y a aucune mesure dans la fenêtre (jour blanc, etc.), on affiche « — ».

Idem pour VS 2024 (anniversaire le 16 mai 2024) et VS 2023 (16 mai 2023).

Graph « Tendance actuelle » (page d'accueil 💧) :
Toutes les mesures de la fenêtre choisie (1 j, 3 j, 7 j, 14 j, 30 j, 60 j, 90 j, 180 j ou 365 j), agrégées par tranches de temps. Plus la fenêtre est petite, plus les tranches sont fines (1 h pour 3 jours, 24 h pour 1 an).Chaque petit segment a sa propre couleur selon la pente locale (vert vif = ça monte vite, vert foncé = ça monte doucement, rouge foncé = ça baisse doucement, rouge vif = ça baisse vite).

Graph « Comparaison annuelle » (page 📈, haut) :
Pour chaque année sélectionnée, on prend une mesure par jour (la première mesure du jour, généralement vers 00:00-00:40). Toutes les années sont superposées sur un axe X normalisé à une année calendaire (1^er janv. → 31 déc.), pour voir d'un coup d'œil si le niveau actuel est "en avance" ou "en retard" par rapport aux années précédentes.

Graph « Historique depuis 2021 » (page 📈, bas) :
Une mesure par jour (la première) depuis le 7 juillet 2021 jusqu'à aujourd'hui, sur un axe X continu.La couleur change à chaque nouvelle année (palette 6 couleurs) pour repérer visuellement les cycles saisonniers (la même couleur revient tous les 6 ans).

Sous chaque graph, 3 mini-cases montrent le bilan d'eau sur la fenêtre choisie (1 j, 3 j, 7 j, etc.). Elles se recalculent automatiquement quand on change la fenêtre.

• Apporté (vert) — la somme de toutes les hausses entre 2 mesures consécutives sur la fenêtre. C'est l'apport naturel : pluie, sources, fonte.
• Soutiré (rouge) — la somme de toutes les baisses entre 2 mesures consécutives. Ça inclut surtout EDF qui turbineau barrage, plus l'évaporation et les petites fuites. On ne peut pas séparer la part EDF du reste sans accès à leurs chiffres de production.
• Net (vert si positif, rouge si négatif) — c'est apporté − soutiré, soit la différence simple entre le niveau du début de la fenêtre et celui de la fin. C'est la même valeur que « VS Hier » sur 1 j, « VS il y a 3 jours » sur 3 j, etc.

Exemple : sur 1 j, on peut avoir « Net +3 cm » mais en réalité +6 cm sont tombés et −3 cm ont été soutirés. Le net donne juste la photo finale, le bilan donne le détail des flux.

Une phrase IA est générée par GPT-5 selon une cadence configurable (voir plus bas), affichée en haut de la page d'accueil 💧. GPT reçoit la profondeur sous la coque, la tendance récente, le tirant d'eau, la marge de vigilance et les seuils définis par l'admin. Il rédige une phrase courte qui décrit la situation (en hausse / en baisse / stable, niveau de risque par rapport au tirant).

La phrase est stockée en base et servie statiquement à chaque visite (pas d'appel à OpenAI à chaque page load). Conséquence : elle reste identique entre 2 générations. L'âge de la phrase est affiché à droite du bandeau (« il y a X min / X h »), à ne pas confondre avec l'âge de la dernière mesure du lac qui est dans le bloc juste en dessous.

La cadence est réglable depuis le panel admin (section « 🤖 Phrases IA »). On définit :

• les mois de haute saison (défaut : mai → août) ;
• les heures de génération en haute saison (défaut : 06h, 10h, 14h, 18h — soit 4×/jour) ;
• les heures de génération en basse saison (défaut : 07h — soit 1×/jour) ;
• un kill switch global pour tout désactiver (économie API, ou phrase obsolète qui ne sert à rien en hiver) ;
• un bouton « Régénérer maintenant » qui force une génération immédiate sans attendre le prochain créneau.

Toutes les heures sont en heure de Paris (géré automatiquement, été comme hiver). Concrètement : le worker tourne toutes les heures à xx:55 et regarde la policy pour décider s'il génère ou s'il skip.

Pas de phrase IA = phrase trop ancienne ou jamais générée. Vérifier l'état dans la section "Monitoring" plus haut. En cas d'échec de génération (panne OpenAI, etc.), un petit point rouge ⚠️ apparaît sur l'icône ⚙️ du bas d'écran.