Files
Support-Agent/docs/cellular/guide/diagnostic-cellulaire.md
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

97 lines
7.3 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.
# 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 de `docs/cellular/matrice-lien-signal.drawio` (D-037). Prototype : aucun cas de l'expert, deux corrections de `DAILY_LINK_STATE` en 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 :
1. jour incomplet dans l'export, ou début d'historique : inconnu ;
2. au moins un échantillon `link = down` : `DOWN` ;
3. un envoi entier ou un message manquant : `MISSING` (la cause n'est pas établie : lien, énergie, serveur) ;
4. 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, sinon `CELL_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_EDGE` en 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 received` en % des envois attendus, l'état en marqueurs (● vert `UP`, ◆ jaune `MISSING`, ✕ violet `DOWN`).
- **Panneaux `DAILY_SIGNAL_STATE`** (RSRP en dBm, puis RSRQ en dB) : la `daily 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 `up` et `down`, 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
1. **Aucun cas de l'expert** : les questions sont dans `docs/cellular/domaine/questions-pour-l-expert.md`.
2. **Cadence supposée de 15 minutes** sur toutes les stations : une station réglée autrement serait orange tous les jours.
3. **Pas de croisement avec Energy** : une coupure d'énergie fait aussi manquer les envois, et donne un rouge Cellular.
4. **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.
5. **Un seul `down` suffit** : un état fugitif du modem colore la journée en orange (WEISSHORN, 03/09).
6. **Grille du signal d'un autre modem**, présentée comme indicative : NORDEND est `CELL_EDGE` presque tous les jours et transmet presque tout.
7. **Versions plus anciennes du collecteur** (NORDEND) : sans `link`, ni `DOWN` ni messages perdus ; seuls les envois entiers manquants se voient.