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

115 lines
12 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# `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).