# Ka·Stats — l'explorateur de statistiques du Québec

**www.ka-stats.com** · Un service **Groupe KA**

Observatoire de données de l'écosystème : agrège en direct les dashboards
`GET /api/stats/dashboard` (contrat **ka-stats v2**) des 13 plateformes
publiques (Lou·Ka, Immo·Ka, Vrai-Prix, Auto·Ka, Job·Ka, Food·Ka, Resto·Ka,
Fabri·Ka, Sorti·Ka, Créa·Ka, Trouve·Ka, API·Ka) et les rend explorables :

- **Vue d'ensemble** — pouls de l'écosystème, grille des plateformes, prix du
  Québec en direct, records.
- **/site/:id** — rendu générique et complet du contrat v2 : KPI + sparklines,
  jauges, séries (crosshair + infobulles), multi-courbes (motifs de trait),
  empilées, anneaux, histogrammes, géo, heatmaps calendrier & horaire,
  tableaux triables/filtrables/paginés, records + liens vers les 5 rapports
  PDF de la plateforme.
- **/indicateurs** — les chiffres du Québec par thème (habitation, mobilité,
  emploi, consommation, culture, infrastructure).
- **/comparer** — jusqu'à 4 plateformes sur un seul axe, indice base 100.
- **/palmares** — records agrégés + classement de croissance.

## Aperçu

*Captures du 2026-08-25 (mobile 390×844 · desktop 1440×900).*

### Mobile

<table>
  <tr>
    <td align="center"><img src="docs/screenshots/mobile/home.webp" width="240" alt="Vue d'ensemble mobile"><br><sub><b>Vue d'ensemble — l'observatoire de données</b></sub></td>
    <td align="center"><img src="docs/screenshots/mobile/indicateurs.webp" width="240" alt="Indicateurs mobile"><br><sub><b>Indicateurs — les chiffres du Québec par thème</b></sub></td>
    <td align="center"><img src="docs/screenshots/mobile/menu-mobile.webp" width="240" alt="Menu mobile"><br><sub><b>Nav v2 — panneau plein écran</b></sub></td>
  </tr>
</table>

### Desktop

<table>
  <tr>
    <td align="center"><img src="docs/screenshots/desktop/home.webp" width="420" alt="Vue d'ensemble"><br><sub><b>Vue d'ensemble — période ajustable (jour → tout)</b></sub></td>
    <td align="center"><img src="docs/screenshots/desktop/indicateurs.webp" width="420" alt="Indicateurs"><br><sub><b>Indicateurs — prix, salaires, loyers, volumes des plateformes KA</b></sub></td>
  </tr>
  <tr>
    <td align="center"><img src="docs/screenshots/desktop/comparer.webp" width="420" alt="Comparer"><br><sub><b>Comparer — métriques croisées entre plateformes</b></sub></td>
    <td align="center"><img src="docs/screenshots/desktop/palmares.webp" width="420" alt="Palmarès"><br><sub><b>Palmarès — records et faits marquants détectés</b></sub></td>
  </tr>
  <tr>
    <td align="center" colspan="2"><img src="docs/screenshots/desktop/studio.webp" width="640" alt="Studio"><br><sub><b>Studio — construisez votre indicateur : 227 métriques, 13 plateformes, transformations (indice 100, variation, moyenne mobile, cumul), partage par lien</b></sub></td>
  </tr>
</table>

## Architecture

- `server.mjs` — Node **zéro dépendance** : statique + `/api/sites`,
  `/api/overview`, `/api/dashboard/:id` (proxy agrégateur, cache mémoire +
  disque 10 min, *stale-while-error* : satellite down ⇒ dernière bonne copie).
  Enveloppe `{success,data}` d'API·Ka dépliée automatiquement.
- `public/charts.js` — **QCharts**, graphiques SVG vanilla conformes au
  design system ka-ui + règles dataviz (marques fines, gaps de surface,
  grilles hairline, légende dès 2 séries, vue tableau jumelle sur chaque
  graphique, palette catégorielle validée en ordre fixe, rampes mono-teinte).
- `public/app.js` — SPA vanilla, routeur History API, sélecteur de période
  global (auj/7j/30j/3m/6m/12m/année/tout + plage libre) relayé aux
  satellites.
- Design system : `tokens.css` de ka-ui vendorisé + accent Ka·Stats
  **#095797** (bleu Québec).

## Exploitation

```bash
node server.mjs 8140          # healthcheck : /healthz
```

Déployé sur **M1M32** (`~/apps/ka-stats`) sous PM2 (`ka-stats` +
`ka-stats-ngrok` → https://www.ka-stats.com). Registre :
`~/Desktop/cluster-skill/cluster-deployments.json`.