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>
7.3 KiB
Guide : lire le diagnostic 4G d'une station AIMsight
- Statut : brouillon, 2026-10-13. La couleur du jour est calculée par
src/cellular/day_color.py, selon la matrice dedocs/cellular/matrice-lien-signal.drawio(D-037). Prototype : aucun cas de l'expert, deux corrections deDAILY_LINK_STATEen attente du spécialiste. - Lecteurs : la partie 1 s'adresse au client final (elle est affichée dans le bloc Cellular de la page System Summary) ; la partie 2 à l'ingénieur support AIMsight.
Partie 1 : lecture rapide
1. Ce que surveille le diagnostic
La station envoie ses mesures par la 4G, toutes les 15 minutes, soit 96 envois par jour. Chaque jour, le diagnostic répond à une question : tous les envois de la station sont-ils arrivés ?
La réponse est une couleur par jour. Le bloc montre aussi la qualité du signal 4G reçu par la station.
2. Les couleurs, et ce qu'il faut faire
| Couleur | Ce que ça veut dire | Que faire |
|---|---|---|
| 🟢 Vert | Tous les envois sont arrivés. | Rien. |
| 🟠 Orange | Quelques envois manquent, ou la 4G a été signalée coupée, mais la station a continué à mesurer. | Rien si l'orange est isolé : un envoi perdu suffit à le produire. Prévenir le support si les oranges se suivent plusieurs jours. |
| 🔴 Rouge | La station s'est tue une grande partie de la journée (5 heures ou plus). | Contacter le support. Regarder aussi le bloc Energy : une station sans énergie se tait aussi. |
| ⚪ Gris | Inconnu : journée incomplète (premier jour suivi, jour en cours), ou envois arrivés mais signal mesuré trop peu de temps. | Regarder les jours voisins. |
- La couleur du jour peut encore changer tant que la journée n'est pas terminée (minuit UTC).
3. Ce qu'affiche le bloc
- Data sent : « All data received », le nombre d'envois manquants sur 96, ou « 4G link reported down ».
- Signal : la qualité du signal sur la journée, sur une échelle à quatre classes : Cell edge (limite de la zone couverte), Mid cell, Good, Excellent. Le signal ne change pas la couleur : une station en limite de zone peut tout transmettre. C'est un repère, pas une alerte.
4. Deux exemples réels (2026)
WEISSHORN : une station bien couverte
| Jour | Couleur | Ce qui se passe |
|---|---|---|
| 20/08 | 🔴 | Fin de la mise en service : 18 heures de silence, 43 envois manquants. |
| 22/08, 29/08, 30/08, 01/09, 05/09, 06/09 | 🟠 | Oranges isolés : un à trois envois perdus, la station revient au vert le lendemain. Rien à faire. |
| 03/09 | 🟠 | La 4G est signalée coupée une fois, mais les 96 envois sont arrivés. |
| 07/09 – 12/10 | 🟢 | Tous les envois arrivent. Signal « Good » tous les jours. |
NORDEND : une station en limite de zone
| Période | Couleur | Ce qui se passe |
|---|---|---|
| 30/06 – 01/07, 11 – 13/07, 22 – 23/07, 19/08, 22/08 | 🔴 | Coupures de la liaison, de 1 à 23 heures sans envoi. |
| 26/08 – 06/09 | 🟠 presque tous les jours | 1 à 5 envois perdus par jour : une série d'oranges, la situation où il faut prévenir le support (cas pas encore confirmé par l'expert). |
| le reste | surtout 🟢 | Signal « Cell edge » presque tous les jours, et pourtant 76 jours sur 109 tous les envois arrivent. |
Partie 2 : annexe technique (support)
La couleur du jour combine deux analyses des messages du modem : link et last_sync (deux messages par envoi), et les mesures radio rsrp_dBm et rsrq_dB (moyennes horaires). Le détail (calcul exact, sources, résultats, options écartées) est dans leurs fiches : docs/cellular/analyses/daily_link_state.md et docs/cellular/analyses/daily_signal_state.md. Une couleur conclut au plus consistent with : elle signale une journée à regarder.
5. Les deux analyses
DAILY_LINK_STATE: envois attendus = 4 par heure × 24 (cadence observée, non documentée). Par heure, un envoi est arrivé si l'un de ses deux messages est arrivé. L'état se lit dans cet ordre :- jour incomplet dans l'export, ou début d'historique : inconnu ;
- au moins un échantillon
link = down:DOWN; - un envoi entier ou un message manquant :
MISSING(la cause n'est pas établie : lien, énergie, serveur) ; - sinon :
UP.
DAILY_SIGNAL_STATE: médianes du jour du RSRP et du RSRQ, classées sur une grille publiée (attribuée au modem Quectel BG96 par KORE Wireless, identique au wiki Teltonika) :EXCELLENT≥ −80 dBm / −10 dB,GOOD≥ −90 / −15,MID_CELL≥ −100 / −20, sinonCELL_EDGE. Le jour prend la pire des deux classes. Moins de 20 heures mesurées sur 24 : inconnu.
6. La matrice : du lien et du signal à la couleur
| Lien \ Signal | mesuré (toute classe) | inconnu (< 20 h) |
|---|---|---|
UP |
🟢 | ⚪ |
MISSING |
🟠 | 🔴 |
DOWN |
🟠 | 🔴 |
| inconnu | ⚪ | ⚪ |
- Rouge : des envois manquent et le signal n'est pas mesuré 20 heures sur 24, donc la station s'est tue 5 heures ou plus. Ce critère reprend
MIN_COVERAGE, sans nouveau seuil : sur NORDEND, il retient 9 des 11 coupures lourdes, et aucun des petits manques (D-037). - Pourquoi le signal ne change pas la couleur : avec
UP×CELL_EDGEen orange, NORDEND serait notifiée 76 jours sur 109 alors que tous ses envois sont arrivés. - Totaux : WEISSHORN (09/08 au 13/10/2026), 46 jours 🟢, 7 🟠, 1 🔴, 12 ⚪ ; NORDEND (26/06 au 13/10/2026), 76 🟢, 20 🟠, 9 🔴, 5 ⚪.
7. Lire la figure
python3 src/cellular/final.py écrit out/<STATION>_cellular_daily.html et sa figure en JSON (.json, pour Plotly.newPlot). C'est l'historique complet du bloc Cellular. La page de comparaison (python3 src/cellular/all_analyses.py, out/<STATION>_cellular.html) reprend les mêmes panneaux, avec les séries du modem et les envois reçus par heure dessous.
- Panneau
DAILY_LINK_STATE:sends receiveden % des envois attendus, l'état en marqueurs (● vertUP, ◆ jauneMISSING, ✕ violetDOWN). - Panneaux
DAILY_SIGNAL_STATE(RSRP en dBm, puis RSRQ en dB) : ladaily median, les planchers de la grille en tirets, la classe en marqueurs. - Survol : tous les faits calculés du jour (envois reçus et manquants, échantillons
upetdown, médianes, couverture). - Attention aux couleurs : celles des panneaux distinguent les états et les classes, ce ne sont pas celles de la matrice.
8. Limites à connaître
- Aucun cas de l'expert : les questions sont dans
docs/cellular/domaine/questions-pour-l-expert.md. - Cadence supposée de 15 minutes sur toutes les stations : une station réglée autrement serait orange tous les jours.
- Pas de croisement avec Energy : une coupure d'énergie fait aussi manquer les envois, et donne un rouge Cellular.
- Comptage par heure : un envoi décalé d'une seconde change d'heure (NORDEND, 15/07 : orange à tort). Deux corrections sont retenues sur le principe mais non codées, en attente du spécialiste.
- Un seul
downsuffit : un état fugitif du modem colore la journée en orange (WEISSHORN, 03/09). - Grille du signal d'un autre modem, présentée comme indicative : NORDEND est
CELL_EDGEpresque tous les jours et transmet presque tout. - Versions plus anciennes du collecteur (NORDEND) : sans
link, niDOWNni messages perdus ; seuls les envois entiers manquants se voient.