README

## 1.8.9 — Fraîcheur Health des données — 2026-09-12

- Le pulse Stats distingue données fraîches, anciennes, inconnues ou partielles selon Screpy et la collecte locale.
- Le score ne pénalise pas un simple volume de trafic nul; il mesure d abord la disponibilité/fraîcheur des sources.

## 1.8.8 — Pulse opérationnel transversal — 2026-09-12

- Expose au Core un pulse 24 h basé sur les événements locaux et l état du connecteur Screpy.
- Prépare le futur Health AWM sans dupliquer le moteur de collecte Stats.

## Stats AWM 1.8.6 — source du cockpit global

Stats expose maintenant un contrat global temporel pour le Centre d'opérations Tech : instant, 1 minute, 1 heure, 1 journée, 1 mois, 3 mois et 1 an. Stats reste la seule source GeoIP et d'agrégation trafic; Tech enrichit seulement avec l'état opérationnel du site.

# Stats AWM 1.8.5 — localités GeoIP fiables sur la carte

Stats AWM passe d une page de statistiques à un véritable cockpit analytique Alliance. La vue d ensemble est maintenant conçue pour afficher les données utiles immédiatement, avec une navigation compacte et des blocs interactifs qui ouvrent un niveau de détail sans quitter le dashboard.

## Dashboard principal
- Navigation compacte dans le header Stats AWM.
- Période déplacée dans le header sur desktop.
- Client et site restent dans une barre de contexte courte sous le header.
- Le dashboard est visible dès l arrivée dans Stats, sans bloc client intermédiaire.
- Grand graphique **Visites Web** avec série courante et vraie série de la période précédente.
- Bloc **Performance** avec KPI Web + SERP.
- Blocs **Trafic par canal**, **Pages les plus consultées**, **Mots-clés suivis** et **Opportunités SERP**.
- Les métriques SERP ne sont jamais inventées : en absence de données Screpy locales, l interface affiche un état d attente.



## Carte des visites dans le dashboard
La vue d ensemble intègre maintenant une carte interactive directement dans le cockpit principal. Le graphique des visites est maintenant **fusionné directement à la carte, sans panneau de fond distinct** : la courbe, la grille et les libellés restent lisibles tout en laissant la cartographie visible derrière. Les points de visites utilisent un noyau lumineux et un halo discret afin de mieux matérialiser les zones actives.

Périodes disponibles :
- À l instant : présences actives + activité des 60 dernières minutes;
- Aujourd hui : depuis minuit America/Toronto;
- 30 derniers jours;
- 3 mois;
- Personnalisé : dates de début et de fin, maximum 365 jours.

La carte réutilise les profils **Clair / Doux / Nuit** et l ajustement de luminosité déjà validés. Les nouvelles mesures Connector peuvent conserver une position GeoIP approximative arrondie; le tracker historique autonome utilise seulement le fuseau navigateur comme repli. Aucune adresse IP ni position GPS n est exposée ou ajoutée pour cette fonction.

Les anciennes visites qui n ont jamais enregistré de contexte géographique restent comptées dans les KPI mais ne sont pas artificiellement placées sur la carte. La carte affiche donc un indicateur de couverture géographique pour éviter toute interprétation trompeuse. **Aucune position n est inventée** : les points apparaissent uniquement lorsqu un contexte géographique approximatif existe réellement.

## Interaction et drill-down
Les blocs du dashboard sont cliquables. Un popup détaillé peut présenter selon le bloc :
- évolution dans le temps;
- valeur courante et période précédente;
- métriques de soutien;
- explication de la métrique;
- liste complète des canaux;
- pages et variations;
- mots-clés SERP et positions;
- Quick Wins positions 4 à 20;
- santé/fraîcheur de la collecte.

Le popup se ferme par le bouton X, le fond ou Échap. Le rafraîchissement silencieux attend qu un popup soit fermé afin de ne pas interrompre l analyse en cours.



## Lisibilité du drill-down
Le popup de détail a été ajusté pour une lecture plus confortable :
- titre et sous-titre plus visibles;
- valeur principale plus grande;
- cartes de soutien plus lisibles;
- tableau détaillé plus gros pour les pages, mots-clés et opportunités;
- largeur du popup augmentée pour éviter un effet trop tassé.

## Données et comparaisons
- La série de comparaison quotidienne est calculée dans le même fuseau `America/Toronto` que la période courante.
- Les pages affichent maintenant leur variation de vues contre la période précédente.
- Les graphiques et popups utilisent seulement les données déjà stockées dans Stats/Screpy AWM.
- Aucun appel IA n est requis pour l affichage ou les comparaisons du dashboard.

## Responsive
- Desktop : dashboard en grille dense, proche d une application SaaS analytique.
- Tablette : réorganisation progressive des blocs.
- Mobile : blocs en une colonne, KPI 2 par ligne et popup plein écran compact.
- Le sélecteur de sections mobile 1.7.8 reste disponible.

## Screpy et historique
- Synchronisation quotidienne conservée.
- Backfill historique automatique par petits lots conservé.
- Historique SERP append-only conservé.
- Archivage non destructif des mots-clés retirés conservé.
- Carte Leaflet clair/doux/nuit et ajustement fin validé terrain conservés.

## Discipline de documentation
Toute évolution Stats AWM doit être documentée dans `CHANGELOG.md`. Toute idée future acceptée doit rester dans `ROADMAP.md` jusqu à son passage explicite à **Livré**, **Reporté** ou **Archivé**. Chaque Suite distribuée garde également ses notes de livraison et sa validation.


## Carte stable et collecte géographique 1.8.4
- Le rafraîchissement silencieux du dashboard conserve l instance Leaflet existante : les tuiles ne sont plus rechargées toutes les 30 secondes.
- Les marqueurs et la courbe ne sont redessinés que si leurs données changent réellement.
- Les événements Web peuvent maintenant recevoir le même contexte géographique approximatif que la présence live.
- Le heartbeat de présence peut compléter les événements récents de sa propre session quand ceux-ci étaient dépourvus de géographie.
- Aucun IP ni GPS n est stocké. Les anciennes visites sans information exploitable restent non localisées.


## Localité GeoIP 1.8.5
Les points de la carte exigent maintenant des coordonnées GeoIP approximatives réelles. Un simple fuseau horaire ne génère plus de point artificiel. Lorsqu Hub Client 1.11.40 fournit ville, région, pays et coordonnées, Stats les conserve dans l historique et affiche par exemple **Montréal, Québec, CA** au lieu de **America/Toronto**.

La base Stats passe à DB 1.6 avec les métadonnées `region_code`, `postal_code`, `geo_source` et `geo_precision`. La carte peut ainsi expliquer si la position provient de FreeIPAPI, des en-têtes de l hébergeur ou d un résolveur local. Les coordonnées restent arrondies et l IP brute n est jamais stockée dans Stats.