Vue d'ensemble — période ajustable (jour → tout) |
Indicateurs — prix, salaires, loyers, volumes des plateformes KA |
Comparer — métriques croisées entre plateformes |
Palmarès — records et faits marquants détectés |
Studio — construisez votre indicateur : 248 métriques, 14 plateformes, transformations (indice 100, variation, moyenne mobile, cumul), partage par lien |
---
## Les 14 plateformes agrégées
Chaque plateforme expose `GET /api/stats/dashboard` (contrat ka-stats v2) ;
Ka·Stats les interroge en parallèle avec la période demandée. Les accents
proviennent de l'`ecosystem.json` de ka-ui.
| Plateforme | Domaine | Thème | Mission |
|---|---|---|---|
| Lou·Ka | www.lou-ka.com | habitation | Tous les logements à louer |
| Immo·Ka | www.immo-ka.com | habitation | Toutes les propriétés à vendre |
| House·Ka | www.house-ka.com | habitation | Maisons à vendre — Canada hors Québec (EN) |
| Vrai-Prix | www.vrai-prix.com | habitation | La valeur réelle de chaque propriété |
| Rent·Ka | www.rent-ka.com | habitation | Locations résidentielles — Canada hors Québec |
| Auto·Ka | www.auto-ka.com | mobilité | Les voitures usagées du Québec |
| Job·Ka | www.job-ka.com | emploi | Tous les emplois des employeurs québécois |
| Food·Ka | www.food-ka.com | consommation | Les prix d'épicerie, suivis à la source |
| Resto·Ka | www.resto-ka.com | consommation | Chaque resto, chaque plat, chaque prix |
| Fabri·Ka | www.fabri-ka.com | consommation | Les produits fabriqués au Québec |
| Sorti·Ka | www.sorti-ka.com | culture | Toutes les sorties, dans les 17 régions |
| Créa·Ka | www.crea-ka.com | culture | Les créateurs d'ici, tous leurs liens |
| Trouve·Ka | www.trouve-ka.com | culture | Le moteur de recherche du web québécois |
| API·Ka | www.api-ka.com | infrastructure | La donnée de l'écosystème, par API |
---
## Pages & fonctionnalités
| Route | Page | Contenu |
|---|---|---|
| `/` | Vue d'ensemble | Pouls de l'écosystème (somme quotidienne des indicateurs principaux), grille des 14 plateformes (accents officiels, KPI, sparklines), prix du Québec en direct, records, CTA vers le Studio |
| `/site/:id` | Fiche plateforme | Rendu générique complet du dashboard v2 de la plateforme + liens vers ses 5 rapports PDF (`/api/stats/report?mode=…` sur le domaine satellite) |
| `/indicateurs` | Indicateurs | Les chiffres du Québec par thème (habitation, mobilité, emploi, consommation, culture, infrastructure) avec deltas ▲/▼ % |
| `/comparer` | Comparateur | Jusqu'à 4 plateformes sur un seul axe, indice base 100 (mode brut disponible mais déconseillé — avertissement affiché) |
| `/studio` | Studio | Constructeur d'indicateurs : 248 métriques, transformations, combinaisons, types de graphique, sauvegarde locale, liens partageables |
| `/palmares` | Palmarès | Jours records, classement de croissance, grille des faits marquants |
Fonctions transversales :
- **Sélecteur de période global** — `auj / 7j / 30j / 3m / 6m / 12m / annee /
tout` + plage libre `from/to` (AAAA-MM-JJ), relayé tel quel aux satellites,
persistant à travers les pages.
- **Routeur History API** — SPA vanilla sans framework ; navigation interne
interceptée (`a[data-link]`), scroll remis à zéro à chaque page.
- **Exports** — chaque graphique offre **CSV** (données exactes) et **PNG**
(rendu du SVG), plus « Ouvrir dans le Studio » pour les séries temporelles.
- **Footer d'écosystème** — avis d'agrégateur (« nous ne vendons rien, ne
louons rien »), liens vers toutes les plateformes et Groupe-KA.com.
- **Analytics maison** — beacon `ka-a.js` d'administration-ka.com
(`__kaSite = "ka-stats"`), trafic humain seulement.
---
## Le contrat ka-stats v2 et son rendu générique
La fiche `/site/:id` ne connaît **aucune plateforme en particulier** : elle
rend ce que le dashboard v2 déclare, bloc par bloc. Types de blocs pris en
charge :
| Bloc v2 | Rendu Ka·Stats |
|---|---|
| `kpis[]` | Cartes KPI (valeur, unité, delta %) + **sparkline** si fournie |
| `gauges[]` | **Jauges** (arc SVG) |
| `series[]` | Séries temporelles — ligne/aire/barres commutables, courbe fantôme « période précédente » en tireté si `compare` est fourni |
| `multiseries[]` | **Multi-courbes** (≤ 4 sous-séries, motifs de trait distincts pour l'accessibilité) |
| `stacked[]` | Aires/barres **empilées** |
| `breakdowns[]` | Répartitions — **barres horizontales ↔ anneau** commutables |
| `histograms[]` | **Histogrammes** de distribution |
| `geo[]` | Répartitions **géographiques** (barres par région) |
| `heatmap_calendar` / `heatmap_hours` | **Heatmaps** calendrier (jour × semaine) et horaire (heure × jour) |
| `tables[]` | Tableaux **triables, filtrables, paginés** |
| `records[]` | Cartes de records / faits marquants |
L'enveloppe `{success, data}` propre à API·Ka est **dépliée automatiquement**
côté serveur — le front ne voit qu'un seul format.
---
## QCharts — graphiques SVG maison
`public/charts.js` (~1 000 lignes) : bibliothèque de graphiques **SVG
vanilla**, zéro dépendance, conforme au design system ka-ui et aux règles
dataviz du groupe :
- marques fines (traits 2 px), grilles *hairline*, texte toujours en encre,
palette catégorielle validée en ordre fixe (`Q.CAT`), rampes mono-teinte,
motifs de trait (`Q.DASHES`) pour distinguer les séries sans dépendre de la
couleur seule ;
- **crosshair + infobulle toutes-séries** sur les lignes, infobulle par-marque
sur barres et cellules ;
- **zoom par sélection horizontale** (glisser sur le graphique), bandeau de
zoom avec bouton « Réinitialiser », **double-clic = réinitialiser** ;
- **légende cliquable** dès 2 séries pour masquer/afficher chaque série ;
- **vue tableau jumelle sur chaque graphique** (l'infobulle ne « garde »
jamais une valeur : les données exactes sont toujours à un clic) ;
- exports **CSV** et **PNG** intégrés à la coquille de carte (`switchableChart`),
types commutables (ligne ↔ aire ↔ barres, barres ↔ anneau) ;
- primitives : `sparkline`, `lineChart`, `vBarChart`, `hBarChart`, `donut`,
`stackedBar`, `gauge`, `calendarHeatmap`, `hourHeatmap`.
---
## API
Toutes les routes acceptent `?period=` (`auj|7j|30j|3m|6m|12m|annee|tout`,
défaut `30j`) et, pour une plage libre, `?from=AAAA-MM-JJ&to=AAAA-MM-JJ`.
| Route | Rôle |
|---|---|
| `GET /healthz` (alias `/api/health`) | Healthcheck : `{ok, app, sites, uptime}` |
| `GET /api/sites` | Les 14 plateformes (id, wordmark, domaine, accents, tagline, thème) |
| `GET /api/overview` | Agrégat global : totaux (éléments, plateformes en vie, graphiques), pouls quotidien, KPI et records par plateforme |
| `GET /api/dashboard/:id` | Dashboard v2 complet d'une plateforme (proxy avec cache ; `stale: true` si copie de secours) |
| `GET /api/catalog` | Catalogue des métriques combinables du Studio (248 refs : `site\|kpi\|id`, `site\|series\|id`, `site\|multi\|id\|i`, `site\|stacked\|id\|i`) |
| `GET /api/metric?refs=a,b,…` | Points normalisés de 1 à 4 métriques (label, unité, série `{t,v}`) — le moteur du Studio |
Exemple :
```bash
curl -s "https://www.ka-stats.com/api/overview?period=30j" | jq .totals
curl -s "https://www.ka-stats.com/api/metric?refs=lou-ka|kpi|active,food-ka|series|avg_price&period=12m"
```
---
## Architecture
```
navigateur ── SPA vanilla (app.js + charts.js + tokens.css)
│
server.mjs (Node ≥ 18, zéro dépendance, ~400 lignes)
│ statique + SSR des metas SEO + API agrégatrice
├── cache mémoire par (site, période) — TTL 10 min
├── cache disque data/cache.json (périodes standard seulement)
└── fan-out HTTPS parallèle vers les 14 satellites
https://
