Files
maximeandClaude Opus 5.5 f0990c16e6 Deliver Storage and Cellular in the mockups, with site figures and guides
The mockups now walk a list of domains (D-039): the support Home loads
every station in data/ and notifies each station x domain that is Orange
or Red; the client view becomes maquettes/user/summary.py, one System
Summary page per station with one block per measured domain. Storage
shows a free-space scale and the estimated full date; Cellular shows the
day's sends in words and a four-class signal scale.

HEADLINE moves into each day_color.py, with a Green sentence for the
client view. src/storage/final.py and src/cellular/final.py write the
site figures in English; the comparison pages reuse their panels. Each
domain gets a short two-layer guide in docs/<domaine>/guide/.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 16:05:26 +02:00

12 KiB
Raw Permalink Blame History

DAILY_LINK_STATE : état du lien 4G jour par jour

  • Statut : prototype en place (2026-10-13). État seul, sans verdict ; pas encore de cas annotés par l'expert.
  • Script : premier panneau de python3 src/cellular/all_analyses.py [CSV ou dossiers] (défaut : data/WEISSHORN/ et data/NORDEND/, D-032), qui écrit out/<STATION>_cellular.html et l'ouvre.
  • Code : src/cellular/link_state.py (run(), day_facts(), by_day()), bibliothèque standard uniquement, sans import du projet. Les séries viennent de common.stations.load_stations, qui charge link et last_sync comme la liste des échantillons de l'heure (D-031).

Question posée

Chaque jour, les envois de la station sont-ils tous arrivés, complets, avec le lien 4G actif ?

  • Lien avec la question du domaine (docs/cellular/domaine/point-de-depart.md) : des données qui arrivent est le premier service de la 4G. Ici, comme pour Energy, un envoi absent peut être l'anomalie elle-même.
  • Ce que l'analyse ajoute : elle ne dépend d'aucun seuil radio ni d'aucun historique ; elle vaut dès le premier jour d'installation, comme DAILY_BATTERY_STATE (D-018).

Principe

Le collecteur écrit link = up quand le contexte de données du modem a une adresse IP (get_modem_info, docs/aimsight/collecteur_system_info.py), et sync envoie un instantané toutes les 15 minutes, un message par métrique (cmd_sync). Deux de ces messages partent à chaque envoi, quel que soit l'état du modem : link (down si la lecture échoue) et last_sync (toujours le dernier). On compte, jour par jour, les envois reçus, les messages perdus dans un envoi reçu, et la valeur de link.

Les exports d'une version plus ancienne du collecteur (NORDEND) n'ont pas link : les envois se comptent alors sur last_sync seul, et ce qui dépend de link vaut None.

Calcul exact, pour chaque jour UTC d ayant au moins une ligne link (sinon last_sync) :

  1. Pour chaque heure, les listes des échantillons de link et de last_sync (vides ou None si rien n'est arrivé).
  2. n_up, n_down = nombre d'échantillons up et down du jour (None sans link). n_sends = envois reçus, doublons compris (le plus grand des deux comptes, heure par heure).
  3. n_missing = envois entiers perdus : somme, heure par heure, de SAMPLES_PER_HOUR − le plus grand des deux comptes (un envoi est arrivé si l'un de ses deux messages est arrivé ; jamais négatif : un doublon ne bouche pas le trou d'une autre heure).
  4. n_messages_lost = messages perdus dans un envoi arrivé : somme, heure par heure, de |compte link − compte last_sync|. None si l'une des deux séries manque.
  5. received_percent = (envois attendus − n_missing) / envois attendus, et up_percent = n_up / envois attendus, en %, avec envois attendus = SAMPLES_PER_HOUR × 24. None sur un jour coupé (moins de 24 heures).
  6. L'état se lit dans cet ordre (la première condition vraie l'emporte) :
Ordre Condition state Lecture
1 moins de 24 heures dans l'export None (UNKNOWN) jour coupé par l'export : le nombre d'envois attendus n'est pas connu
1 bis aucun envoi reçu avant ce jour (jour du premier envoi compris) None (UNKNOWN) début d'historique, pas une coupure (docs/domaine/pieges-des-donnees.md) ; calcul causal : seuls les jours ≤ d comptent
2 n_down ≥ 1 (jamais sans link) DOWN le modem a signalé le lien coupé au moins une fois, et cet envoi est quand même arrivé (remontée différée ou autre voie)
3 n_missing ≥ 1 ou n_messages_lost ≥ 1 MISSING des envois ou des messages manquent ; la cause n'est pas établie (lien, coupure d'énergie, réception côté serveur)
4 sinon UP tous les envois sont arrivés, lien actif

Sortie (contrat commun) : un point par jour.

  • t = dernière heure du jour présente dans la série.
  • value = received_percent, en % des envois attendus (None si l'état est UNKNOWN). Il se calcule avec ou sans link.
  • anomaly = None : état seul, sans verdict. L'état est dans facts.state.
  • facts = state, received_percent, up_percent, n_sends, n_up, n_down, n_missing, n_messages_lost, hours.

Constantes et sources

Constante Valeur Source
SAMPLES_PER_HOUR 4 Cadence observée, non documentée : un envoi toutes les 15 minutes, d'après last_sync (WEISSHORN : 900 ± 1 s dès le 01/09, sauf 4 intervalles, après une cadence irrégulière de 880 à 899 s du 19 au 31/08 ; NORDEND : 9 498 intervalles sur ~9 800). Ni le collecteur (cmd_sync est lancé de l'extérieur) ni la doc AIMsight ne la fixent ; la FAQ cite « one measurement every 15 minutes », mais c'est le rythme des acquisitions de la caméra, réglé par le client. À confirmer (docs/cellular/domaine/questions-pour-l-expert.md).
HOURS_PER_DAY 24 Jour UTC complet.

Graphique

  • En haut : received_percent par jour, placé à midi UTC (D-019), un marqueur par état (couleur, symbole et légende propres ; couleurs validées par le skill dataviz).
  • Site : le même panneau, en anglais (D-023), dans la figure du site src/cellular/final.py (historique complet du bloc Cellular de la vue client, D-039) ; la page de comparaison l'importe de là.
  • Dessous : les séries du modem, et le nombre d'envois reçus par heure (last_sync, sinon link), en barres.

Résultats (jeu de travail : WEISSHORN et NORDEND, D-032)

WEISSHORN (65 jours, avec link, du 09/08 au 13/10) :

  • 09/08 au 19/08 : UNKNOWN, début d'historique ; premier envoi le 19/08 à 09:00, avec link = down (le modem cherche le réseau).
  • 20/08 : DOWN, fin de la mise en service : un échantillon down à 10:00, au retour d'un trou de 18 h ; 43 envois manquants.
  • 21/08 au 12/10 : 46 jours UP, 6 MISSING, 1 DOWN.
    • MISSING : un envoi manquant entre 01:00 et 02:00 UTC les 29/08, 30/08, 01/09, 05/09 et 06/09 ; trois le 22/08 à 17:00 et 19:00, pendant des écritures sur /data.
    • DOWN le 03/09 : un seul échantillon down à 15:00, alors que les 96 envois sont arrivés. Avec la règle « un down suffit », un état fugitif du modem colore la journée.
  • 13/10 : UNKNOWN, coupé par l'export.
  • Contrôle du compte sur des copies modifiées en mémoire, fait sur l'export de 10 jours (rien d'écrit) : un message link ou last_sync retiré donne n_messages_lost = 1 ; les deux retirés, n_missing = 1 ; sans série last_sync, n_messages_lost = None.

NORDEND (109 jours, sans link, du 26/06 au 13/10) :

  • 76 jours UP, 29 MISSING, 5 UNKNOWN (26 au 29/06 : début d'historique, premier envoi le 29/06 à 07:00 ; 13/10 : coupé par l'export).
  • Les MISSING lourds sont les coupures de 1 à 23 h : 30/06 (95 envois manquants), 01/07 (55), 10 au 13/07 (8 à 62), 22-23/07 (43 et 33), 19 au 22/08 (12 à 23). La tension reste de 13,94 à 14,37 V au retour, sans redémarrage à 12,6 V : cohérent avec une station alimentée.
  • Les autres MISSING ont 1 à 5 envois manquants : fin août et début septembre surtout (26/08 au 06/09).
  • Aucun cas annoté par l'expert : aucun DOWN vu (impossible sans link) ; les MISSING ne sont pas encore confirmés.

Options écartées

Option Pourquoi écartée
Compter les heures où le RSRP est présent Une heure avec 1 instantané sur 4 paraît complète ; link donne le compte exact.
Comparer toutes les métriques texte registration, network_* et ip sont vides, donc pas envoyés, quand la lecture du modem échoue ou que le lien tombe : leur absence n'est pas une perte.
Compter les messages des métriques numériques Moyennes horaires : le nombre de messages n'est pas dans l'export.
Tolérer un envoi manquant par jour Aucune donnée pour le calibrer ; le compte reste dans facts pour en décider avec les cas de l'expert.
Déduire le lien des champs du modem sur NORDEND Sans link, un envoi sans network_technology peut être une lecture du modem qui échoue (26 % des heures depuis juillet) ; ce n'est pas un lien coupé.

Limites connues

  1. Aucun cas confirmé : DOWN n'a jamais été vu ; les MISSING de NORDEND attendent l'avis de l'expert.
  2. MISSING ne dit pas pourquoi : une coupure d'énergie fait aussi manquer les envois. Le croisement avec Energy reste à faire, au plus tard dans la couleur du jour.
  3. Remontée différée : sur NORDEND, rien n'arrive plus tard dans les heures des coupures (les envois y sont rangés à l'heure de la station) ; les envois perdus le restent. Une coupure du lien y apparaît donc comme MISSING.
  4. Un instantané toutes les 15 minutes : une coupure plus courte entre deux envois n'est pas vue.
  5. Le jour en cours est UNKNOWN jusqu'à sa dernière heure.
  6. Un message link absent n'est pas toujours perdu en route : si le collecteur s'arrête plus de 120 s pendant que sync tourne, la réponse du modem expire dans Redis et link n'est pas envoyé. Cela compte aussi dans n_messages_lost.
  7. Seuls deux messages par envoi sont comptés : la perte d'un autre message (une mesure radio, la tension) n'est pas vue.
  8. Sans link (NORDEND) : ni DOWN, ni up_percent, ni n_messages_lost ; seuls les envois entiers manquants se voient.
  9. Comptage par heure : un envoi décalé d'une seconde change d'heure, et un envoi en surnombre bouche un trou de sa propre heure (NORDEND en fait 5 à 7 par heure vers 06:00 et 09:00 UTC). Sur NORDEND, le 15/07 sort MISSING à tort (l'envoi de 09:00 est parti à 08:59, rangé dans l'heure de 08:00) et le 28/07 compte 1 envoi manquant au lieu de 2. Les 16 autres petits MISSING sont justes.
  10. Cadence supposée fixe : 4 envois par heure sur toutes les stations. Une station réglée autrement (30 min, 1 h) sortirait MISSING tous les jours.

Pistes

  • Deux corrections retenues sur le principe (2026-10-13), non codées : l'utilisateur veut d'abord voir avec le spécialiste comment articuler le code.
    1. Compter par quart d'heure (limite 9) : ramener chaque horodatage de last_sync au quart d'heure le plus proche (08:59 → 09:00, 06:19 → 06:15), puis compter les quarts d'heure distincts reçus dans la journée. Effet mesuré sur NORDEND : le 15/07 passe UP, le 28/07 reste MISSING avec 2 envois manquants, rien d'autre ne change.
    2. Mesurer la cadence de chaque station (limite 10) : l'intervalle le plus fréquent entre ses envois des jours précédents (calcul causal), à la place de SAMPLES_PER_HOUR. 15 min sur WEISSHORN et sur NORDEND.
    • Points d'articulation à trancher : link n'a pas d'horodatage propre (un compte par heure), alors que la correction 1 compte par quart d'heure sur last_sync : comment garder n_messages_lost cohérent ; cadence mesurée par l'analyse, ou lue dans la configuration de la station si elle y est.
  • Journal de la station : cmd_sync y écrit le nombre de messages de chaque envoi. S'il devient accessible, le comparer à ce qui arrive donnerait les pertes réelles, et séparerait « pas envoyé » de « perdu en route » (question 6 de docs/cellular/domaine/questions-pour-l-expert.md).
  • Avec les cas de l'expert : décider si un seul envoi manquant suffit à sortir de UP.
  • Renommer les états, proposé le 2026-10-13, non décidé : UP se lit « lien actif », alors que sans link (NORDEND) il veut seulement dire « tous les envois sont arrivés ». Proposition : COMPLETE, INCOMPLETE, LINK_DOWN.
  • registration (searching, denied) pourrait expliquer un DOWN.

Historique

  • 2026-10-13 : création, avec le chargement des métriques texte par common.stations (D-031).
  • 2026-10-13 : ajout de n_messages_lost (messages perdus dans un envoi arrivé, link comparé à last_sync), qui mène aussi à MISSING ; n_missing compte désormais un envoi comme arrivé si l'un de ses deux messages est arrivé.
  • 2026-10-13 : link facultatif (exports sans link, NORDEND) ; value devient received_percent ; ajout de n_sends ; début d'historique en UNKNOWN ; pourcentages None sur un jour coupé (D-032).
  • 2026-10-13 : limites 9 (comptage par heure) et 10 (cadence supposée) ; deux corrections retenues sur le principe, non codées, en attente du spécialiste (« Pistes »).
  • 2026-10-13 : résultats sur l'export de 65 jours de WEISSHORN (09/08-13/10), qui remplace celui de 10 jours.
  • 2026-10-13 : panneau en anglais, partagé avec la figure du site src/cellular/final.py ; livraison du domaine (vue client, notifications, guide docs/cellular/guide/, D-039).