Aller au contenu

📡 Helia NC — Qualité du réseau mobile

Commande Claude Code

Commande : /helia-reseau
Tags : helia réseau latence maintenance opt-nc
Source : Voir le code source

Latence API, disponibilité, profil horaire, maintenances programmées et incidents réseau Helia NC.

📡 Contexte

Ce skill se concentre sur la qualité du réseau mobile Helia NC : est-ce que l'API répond vite ? Y a-t-il une maintenance en cours ? Quelles sont les meilleures heures pour une connexion rapide ?

Il s'appuie sur : - La table api_ping — mesure de latence toutes les 5 min, stockée dans DuckDB - Le CLI helia maintenance — état des services en temps réel - Les vues SQL v_api_health, v_hourly_latency, v_latency_heatmap

Pour la consommation data/voix, les forfaits et les recharges → voir /helia-conso

📥 Installation

Prérequis

# DuckDB CLI (pour les requêtes historiques) — Linux & macOS
brew install duckdb

Le CLI helia et la base ~/.config/helia/data/helia.db doivent être configurés au préalable.

Skill (Slash Command)

mkdir -p ~/.claude/commands && \
curl -o ~/.claude/commands/helia-reseau.md \
  https://raw.githubusercontent.com/adriens/claude-commands/main/docs/skills/helia-reseau/src/helia-reseau.md

📝 Utilisation

/helia-reseau

Sans argument → tableau de bord réseau complet (latence, dispo, meilleures/pires heures).

Sous-commandes disponibles

Commande Description
/helia-reseau Tableau de bord réseau complet
/helia-reseau latence Latence actuelle, P95, profil horaire
/helia-reseau maintenance Maintenances en cours, incidents, état du réseau
/helia-reseau dispo Taux de disponibilité global et par jour
/helia-reseau heatmap Latence par heure × jour de semaine
/helia-reseau report 📄 Rapport Markdown complet avec charts
/helia-reseau expert 🔬 Rapport expert SLA — CIO, DT, OPS, support OPT-NC

Générer un rapport réseau

/helia-reseau report

Produit un fichier Markdown avec note d'analyse, tableau de synthèse et 4 charts Mermaid (latence horaire, dispo par jour, timeouts, pie OK/timeout).

Le rapport est écrit automatiquement dans :

~/Documents/helia/reseau/YYYY-MM-DD_rapport_reseau.md

Rapport expert pour professionnels

/helia-reseau expert

Rapport PDF professionnel (Quarto + R + XeLaTeX + FontAwesome5) — 3 pages max :

Profil Ce qu'il y trouve
CIO / CEO Synthèse exécutive, niveau SLA (two/three/four nines), indisponibilité cumulée
Directeur Télécom Conformité SLA, MTBF, P95/P99, tendance par jour
OPS / SysAdmin Distribution des temps de réponse, top 10 incidents horodatés, profil horaire
Support OPT-NC Données précises exportables pour ticket d'incident

Prérequis : R, Quarto CLI, packages duckdb ggplot2 kableExtra dplyr scales gridExtra, TinyTeX + fontawesome5

Rapport écrit dans : 

~/Documents/helia/reseau/YYYY-MM-DD_rapport_expert_reseau.pdf

✨ Fonctionnalités

  • 🟢/🟡/🔴 Latence API : moyenne, P95, max (dernière heure)
  • ⛔ Timeouts : nombre et taux sur la période
  • 📶 Disponibilité : % global et par jour
  • ⏰ Profil horaire : meilleures et pires heures de la journée
  • 🗓 Heatmap : latence par heure × jour de semaine
  • 🔧 Maintenances : services en cours de maintenance via helia maintenance --json
  • 🗺 Incidents : redirection vers helia.nc/etat-du-reseau

🔀 Flow de travail

flowchart TD
    classDef input fill:#2980b9,stroke:#1a5276,color:#fff,rx:8
    classDef process fill:#e67e22,stroke:#a04000,color:#fff
    classDef result fill:#27ae60,stroke:#1a7a42,color:#fff
    classDef alert fill:#c0392b,stroke:#7b241c,color:#fff
    classDef decision fill:#7f8c8d,stroke:#2c3e50,color:#fff,shape:diamond

    A(["📡 /helia-reseau"]):::input --> B{"❓ Question ?"}:::decision
    B -->|"Tableau de bord"| C["🗄️ DuckDB\nv_api_health + v_hourly_latency"]:::process
    B -->|"Maintenance / incident"| D["⚡ helia maintenance --json"]:::process
    B -->|"Heatmap / profil"| E["🗄️ DuckDB\nv_latency_heatmap"]:::process
    B -->|"Panne / zone"| F["🌐 helia.nc/etat-du-reseau"]:::alert
    C --> G["📊 Tableau réseau\n🟢🟡🔴 Latence · Dispo · Timeouts"]:::result
    D --> H{"🔴 Maintenance ?"}:::decision
    H -->|"Oui"| F
    H -->|"Non"| G
    E --> I["🗓 Heatmap\nheure × jour de semaine"]:::result
    G --> J{"🔴 Dégradé ?"}:::decision
    J -->|"Oui"| K["📞 1013 · reclamation@helia.nc"]:::alert
    J -->|"Non"| L["✅ Réseau nominal"]:::result