KA Agent v2 (widget) : plein écran à l'ouverture (desktop+mobile), fond gelé + calage visualViewport (clavier mobile stable), rendu Markdown complet en streaming (titres, listes, tableaux, code, liens nommés)

Simon-Pierre Boucher committed 1 mo ago (Aug 19, 2026) parent 52e6cbc

5 changed files +1,252 −215

modified public/ka-agent.js +177 −48

		`@@ -3,7 +3,11 @@`
3	3	* Groupe KA. Vanilla JS, zéro dépendance, injecté sur les 13 sites.
4	4	* <script>window.KA_AGENT={site:"lou-ka"}</script>
5	5	* <script src="/ka-agent.js" defer></script>
6		− * Bulle flottante en bas à droite → panneau de chat (bulle) → plein écran (⛶).
	6	+ * v2 (2026-08-19) : ouverture directement PLEIN ÉCRAN (desktop et mobile,
	7	+ * bouton ▭ pour réduire en fenêtre sur desktop) ; sur téléphone le panneau se
	8	+ * cale sur window.visualViewport (le clavier ne fait plus grossir/défiler la
	9	+ * page — fond verrouillé par body position:fixed) ; rendu MARKDOWN complet en
	10	+ * streaming (titres, listes, tableaux, code, liens nommés, citations).
7	11	* Flux SSE en direct depuis le backend central (texte token par token +
8	12	* indicateur d'outil). Historique conservé en localStorage (par site).
9	13	*/
		`@@ -21,60 +25,147 @@`
21	25	border-radius:50%;border:2px solid var(--ink,#141814);background:var(--accent,#d9f26b);
22	26	color:var(--on-accent,#141814);font:700 17px/1 "Space Grotesk",system-ui,sans-serif;
23	27	cursor:pointer;box-shadow:4px 4px 0 rgba(20,24,20,.85);display:flex;align-items:center;
24		− justify-content:center;transition:transform .15s}
	28	+ justify-content:center;transition:transform .15s;touch-action:manipulation}
25	29	.kaa-btn:hover{transform:translate(-2px,-2px)}
26		− .kaa-panel{position:fixed;right:16px;bottom:calc(86px + env(safe-area-inset-bottom,0px));z-index:2147483001;width:min(392px,calc(100vw - 24px));
27		− height:min(580px,calc(100vh - 110px));height:min(580px,calc(100dvh - 110px));display:none;flex-direction:column;background:var(--paper,#f5f3ee);
28		− border:2px solid var(--ink,#141814);border-radius:14px;box-shadow:8px 8px 0 rgba(20,24,20,.85);
29		− overflow:hidden;font-family:Inter,system-ui,sans-serif}
	30	+ .kaa-panel{position:fixed;z-index:2147483001;display:none;flex-direction:column;background:var(--paper,#f5f3ee);
	31	+ overflow:hidden;font-family:Inter,system-ui,sans-serif;touch-action:manipulation}
30	32	.kaa-panel.kaa-open{display:flex}
31		− .kaa-panel.kaa-full{right:0;bottom:0;width:100vw;height:100vh;height:100dvh;border-radius:0;border:0;box-shadow:none}
32		− html.kaa-lock,html.kaa-lock body{overflow:hidden!important;overscroll-behavior:none}
	33	+ .kaa-panel.kaa-full{left:0;top:0;right:0;bottom:0;width:100vw;height:100vh;height:100dvh;border:0;border-radius:0;box-shadow:none}
	34	+ .kaa-panel:not(.kaa-full){right:16px;bottom:calc(86px + env(safe-area-inset-bottom,0px));width:min(392px,calc(100vw - 24px));
	35	+ height:min(580px,calc(100vh - 110px));height:min(580px,calc(100dvh - 110px));
	36	+ border:2px solid var(--ink,#141814);border-radius:14px;box-shadow:8px 8px 0 rgba(20,24,20,.85)}
	37	+ html.kaa-lock,html.kaa-lock body{overflow:hidden!important;overscroll-behavior:none;touch-action:none}
33	38	.kaa-head{display:flex;align-items:center;gap:9px;padding:11px 14px;background:var(--ink,#141814);
34		− color:var(--paper,#f5f3ee);flex:none}
	39	+ color:var(--paper,#f5f3ee);flex:none;padding-top:max(11px,env(safe-area-inset-top,0px))}
35	40	.kaa-head b{font:700 15px "Space Grotesk",system-ui,sans-serif;letter-spacing:-.02em}
36	41	.kaa-head .kaa-ka{display:inline-block;background:var(--accent,#d9f26b);color:var(--on-accent,#141814);
37	42	border-radius:6px;padding:1px 7px 2px;transform:rotate(-2deg);font-weight:700}
38	43	.kaa-head small{font:700 9.5px "JetBrains Mono",monospace;letter-spacing:.09em;text-transform:uppercase;opacity:.65}
39	44	.kaa-head .kaa-sp{flex:1}
40	45	.kaa-hbtn{width:34px;height:34px;border:1.5px solid rgba(245,243,238,.4);border-radius:8px;background:none;
41		− color:var(--paper,#f5f3ee);font-size:15px;cursor:pointer;line-height:1}
	46	+ color:var(--paper,#f5f3ee);font-size:15px;cursor:pointer;line-height:1;flex:none}
42	47	.kaa-hbtn:hover{border-color:var(--accent,#d9f26b);color:var(--accent,#d9f26b)}
43	48	.kaa-log{flex:1;overflow-y:auto;padding:14px;display:flex;flex-direction:column;gap:10px;
44	49	overscroll-behavior:contain;-webkit-overflow-scrolling:touch}
45	50	.kaa-msg{max-width:86%;padding:9px 13px;border:1.5px solid var(--ink,#141814);border-radius:12px;
46		− font-size:13.5px;line-height:1.5;white-space:pre-wrap;word-break:break-word}
	51	+ font-size:13.5px;line-height:1.55;word-break:break-word}
	52	+ .kaa-full .kaa-msg{max-width:min(86%,760px)}
	53	+ .kaa-full .kaa-log{align-items:stretch}
47	54	.kaa-msg.kaa-u{align-self:flex-end;background:var(--accent,#d9f26b);color:var(--on-accent,#141814);
48		− border-bottom-right-radius:4px}
	55	+ border-bottom-right-radius:4px;white-space:pre-wrap}
49	56	.kaa-msg.kaa-a{align-self:flex-start;background:#fff;border-bottom-left-radius:4px;box-shadow:3px 3px 0 rgba(20,24,20,.12)}
50		− .kaa-msg.kaa-a a{color:inherit;text-decoration:underline;text-underline-offset:3px}
51		− .kaa-msg.kaa-a b{font-weight:700}
	57	+ .kaa-msg.kaa-a a{color:inherit;text-decoration:underline;text-underline-offset:3px;font-weight:600}
	58	+ .kaa-msg.kaa-a p{margin:.35em 0}
	59	+ .kaa-msg.kaa-a p:first-child{margin-top:0}
	60	+ .kaa-msg.kaa-a p:last-child{margin-bottom:0}
	61	+ .kaa-msg.kaa-a h1,.kaa-msg.kaa-a h2,.kaa-msg.kaa-a h3,.kaa-msg.kaa-a h4{
	62	+ font:700 14px "Space Grotesk",system-ui,sans-serif;letter-spacing:-.01em;margin:.7em 0 .3em}
	63	+ .kaa-msg.kaa-a h1:first-child,.kaa-msg.kaa-a h2:first-child,.kaa-msg.kaa-a h3:first-child,.kaa-msg.kaa-a h4:first-child{margin-top:.1em}
	64	+ .kaa-msg.kaa-a h1{font-size:15.5px}.kaa-msg.kaa-a h2{font-size:14.5px}
	65	+ .kaa-msg.kaa-a ul,.kaa-msg.kaa-a ol{margin:.35em 0;padding-left:1.35em}
	66	+ .kaa-msg.kaa-a li{margin:.18em 0}
	67	+ .kaa-msg.kaa-a code{font:600 12px "JetBrains Mono",monospace;background:var(--surface-2,#f0eee7);
	68	+ border:1px solid rgba(20,24,20,.15);border-radius:5px;padding:.5px 4px}
	69	+ .kaa-msg.kaa-a pre{margin:.45em 0;padding:9px 11px;background:var(--ink,#141814);color:var(--paper,#f5f3ee);
	70	+ border-radius:9px;overflow-x:auto}
	71	+ .kaa-msg.kaa-a pre code{background:none;border:0;color:inherit;padding:0;font-weight:400;font-size:11.5px;line-height:1.5}
	72	+ .kaa-msg.kaa-a blockquote{margin:.45em 0;padding:.15em .8em;border-left:3px solid var(--accent,#d9f26b);
	73	+ background:var(--surface-2,#faf9f5);color:var(--ink-2,#4d5551)}
	74	+ .kaa-msg.kaa-a hr{border:0;border-top:1.5px dashed rgba(20,24,20,.3);margin:.6em 0}
	75	+ .kaa-msg.kaa-a table{border-collapse:collapse;margin:.45em 0;font-size:12.5px;display:block;overflow-x:auto;max-width:100%}
	76	+ .kaa-msg.kaa-a th,.kaa-msg.kaa-a td{border:1.5px solid var(--ink,#141814);padding:4px 9px;text-align:left;white-space:nowrap}
	77	+ .kaa-msg.kaa-a th{background:var(--accent,#d9f26b);color:var(--on-accent,#141814);
	78	+ font:700 11px "Space Grotesk",system-ui,sans-serif;letter-spacing:.02em}
	79	+ .kaa-msg.kaa-a td{background:#fff}
52	80	.kaa-tool{align-self:flex-start;font:700 10px "JetBrains Mono",monospace;letter-spacing:.07em;
53	81	text-transform:uppercase;color:var(--ink-2,#4d5551);padding:3px 10px;border:1.5px dashed var(--ink-2,#4d5551);
54	82	border-radius:999px;background:var(--surface-2,#faf9f5)}
55	83	.kaa-in{display:flex;gap:8px;padding:11px;border-top:2px solid var(--ink,#141814);background:#fff;flex:none;
56	84	padding-bottom:calc(11px + env(safe-area-inset-bottom,0))}
	85	+ .kaa-full .kaa-in{justify-content:center}
	86	+ .kaa-full .kaa-in textarea{max-width:700px}
57	87	.kaa-in textarea{flex:1;resize:none;min-height:44px;max-height:110px;padding:10px 12px;font:16px/1.4 Inter,system-ui,sans-serif;
58	88	border:1.5px solid var(--ink,#141814);border-radius:9px;background:var(--paper,#f5f3ee);outline:none}
59	89	.kaa-in button{min-width:52px;min-height:44px;border:1.5px solid var(--ink,#141814);border-radius:9px;
60		− background:var(--ink,#141814);color:var(--accent,#d9f26b);font:700 16px "Space Grotesk",system-ui;cursor:pointer}
	90	+ background:var(--ink,#141814);color:var(--accent,#d9f26b);font:700 16px "Space Grotesk",system-ui;cursor:pointer;touch-action:manipulation}
61	91	.kaa-in button:disabled{opacity:.45}
62		− .kaa-hello{font-size:12.5px;color:var(--ink-2,#4d5551);padding:4px 2px}
	92	+ .kaa-hello{font-size:12.5px;color:var(--ink-2,#4d5551);padding:4px 2px;max-width:760px}
63	93	.kaa-dots::after{content:"…";animation:kaa-b 1.2s infinite}
64	94	@keyframes kaa-b{0%{opacity:.2}50%{opacity:1}100%{opacity:.2}}
65		− @media (max-width:560px){.kaa-panel{right:8px;left:8px;width:auto}}
	95	+ @media (max-width:640px){.kaa-x1{display:none}}
66	96	`;
67	97
68		− /* ---------- markdown minimal (gras, liens, puces) — texte échappé d'abord ---------- */
	98	+ /* ---------- markdown complet (rendu en streaming, texte échappé d'abord) ---------- */
69	99	function esc(s) {
70	100	return s.replace(/&/g, "&").replace(/</g, "<").replace(/>/g, ">");
71	101	}
72		− function md(s) {
73		− return esc(s)
74		− .replace(/\\([^]+)\\*/g, "<b>$1</b>")
75		− .replace(/(https?:\/\/[^\s<)"']+)/g, function (u) {
76		− return '<a href="' + u + '" target="_blank" rel="noopener noreferrer">' + u.replace(/^https?:\/\/(www\.)?/, "").slice(0, 40) + "</a>";
77		− });
	102	+ function inline(s) {
	103	+ s = esc(s);
	104	+ s = s.replace(/`([^`\n]+)`/g, "<code>$1</code>");
	105	+ s = s.replace(/\[([^\]\n]+)\]$(https?:\/\/[^\s)]+)$/g,
	106	+ '<a href="$2" target="_blank" rel="noopener noreferrer">$1</a>');
	107	+ s = s.replace(/\\([^\n]+)\\*/g, "<b>$1</b>");
	108	+ s = s.replace(/(^\|[^\w])\([^\n]+)\(?!\*)/g, "$1<i>$2</i>");
	109	+ s = s.replace(/(^\|[^"'>=\w])(https?:\/\/[^\s<)"']+)/g, function (m, pre, u) {
	110	+ return pre + '<a href="' + u + '" target="_blank" rel="noopener noreferrer">' +
	111	+ u.replace(/^https?:\/\/(www\.)?/, "").slice(0, 42) + "</a>";
	112	+ });
	113	+ return s;
	114	+ }
	115	+ function md(src) {
	116	+ var lines = String(src).split("\n"), out = [], i = 0, m;
	117	+ function para(buf) { if (buf.length) out.push("<p>" + buf.map(inline).join("<br>") + "</p>"); }
	118	+ while (i < lines.length) {
	119	+ var l = lines[i];
	120	+ if (/^\s```/.test(l)) { / bloc de code */
	121	+ var code = []; i++;
	122	+ while (i < lines.length && !/^\s*```/.test(lines[i])) code.push(lines[i++]);
	123	+ i++;
	124	+ out.push("<pre><code>" + esc(code.join("\n")) + "</code></pre>");
	125	+ } else if ((m = l.match(/^\s(#{1,4})\s+(.)$/))) { /* titres */
	126	+ out.push("<h" + m[1].length + ">" + inline(m[2]) + "</h" + m[1].length + ">"); i++;
	127	+ } else if (/^\s(---+\|\\\+)\s$/.test(l)) { / filet */
	128	+ out.push("<hr>"); i++;
	129	+ } else if (/^\s>\|^\s>/.test(l)) { /* citation */
	130	+ var q = [];
	131	+ while (i < lines.length && /^\s>/.test(lines[i])) q.push(lines[i++].replace(/^\s>\s?/, ""));
	132	+ out.push("<blockquote>" + q.map(inline).join("<br>") + "</blockquote>");
	133	+ } else if (/^\s\\|.\\|\s$/.test(l)) { / tableau */
	134	+ var rows = [];
	135	+ while (i < lines.length && /^\s\\|.\\|\s*$/.test(lines[i])) {
	136	+ var cells = lines[i].trim().replace(/^\\|\|\\|$/g, "").split("\|").map(function (c) { return c.trim(); });
	137	+ if (!/^[:\-\s\|]+$/.test(lines[i].replace(/\\|/g, ""))) rows.push(cells);
	138	+ i++;
	139	+ }
	140	+ if (rows.length) {
	141	+ var t = "<table>";
	142	+ rows.forEach(function (r, ri) {
	143	+ var tag = ri === 0 ? "th" : "td";
	144	+ t += "<tr>" + r.map(function (c) { return "<" + tag + ">" + inline(c) + "</" + tag + ">"; }).join("") + "</tr>";
	145	+ });
	146	+ out.push(t + "</table>");
	147	+ }
	148	+ } else if (/^\s[-+]\s+/.test(l)) { /* liste à puces */
	149	+ var ul = [];
	150	+ while (i < lines.length && /^\s[-+]\s+/.test(lines[i]))
	151	+ ul.push("<li>" + inline(lines[i++].replace(/^\s[-+]\s+/, "")) + "</li>");
	152	+ out.push("<ul>" + ul.join("") + "</ul>");
	153	+ } else if (/^\s\d+[.)]\s+/.test(l)) { / liste numérotée */
	154	+ var ol = [];
	155	+ while (i < lines.length && /^\s*\d+[.)]\s+/.test(lines[i]))
	156	+ ol.push("<li>" + inline(lines[i++].replace(/^\s*\d+[.)]\s+/, "")) + "</li>");
	157	+ out.push("<ol>" + ol.join("") + "</ol>");
	158	+ } else if (!l.trim()) { i++; } /* ligne vide */
	159	+ else { /* paragraphe */
	160	+ var buf = [];
	161	+ while (i < lines.length && lines[i].trim() &&
	162	+ !/^\s(```\|#{1,4}\s\|[-+]\s\|\d+[.)]\s\|>\|\\|\|---+\s*$)/.test(lines[i]))
	163	+ buf.push(lines[i++]);
	164	+ if (!buf.length) buf.push(lines[i++] \|\| "");
	165	+ para(buf);
	166	+ }
	167	+ }
	168	+ return out.join("");
78	169	}
79	170
80	171	/* ---------- état ---------- */
		`@@ -98,10 +189,10 @@`
98	189	panel.setAttribute("aria-label", "KA Agent");
99	190	panel.innerHTML =
100	191	'<div class="kaa-head"><b>KA<span class="kaa-ka">Agent</span></b><small>Groupe KA · IA</small><span class="kaa-sp"></span>' +
101		− '<button class="kaa-hbtn kaa-x1" title="Plein écran" aria-label="Plein écran">⛶</button>' +
	192	+ '<button class="kaa-hbtn kaa-x1" title="Réduire / agrandir" aria-label="Réduire ou agrandir">▭</button>' +
102	193	'<button class="kaa-hbtn kaa-x2" title="Fermer" aria-label="Fermer">✕</button></div>' +
103	194	'<div class="kaa-log"></div>' +
104		− '<div class="kaa-in"><textarea rows="1" placeholder="Posez votre question…" aria-label="Votre question"></textarea>' +
	195	+ '<div class="kaa-in"><textarea rows="1" enterkeyhint="send" autocapitalize="sentences" autocomplete="off" placeholder="Posez votre question…" aria-label="Votre question"></textarea>' +
105	196	"<button aria-label=\"Envoyer\">➤</button></div>";
106	197	document.body.appendChild(btn);
107	198	document.body.appendChild(panel);
		`@@ -132,45 +223,83 @@`
132	223	if (log.length) return;
133	224	var d = document.createElement("div");
134	225	d.className = "kaa-hello";
135		− d.textContent = "👋 Je suis KA Agent, l'assistant de l'écosystème Groupe KA. Posez-moi une question sur ce site, ses données (prix, annonces, stats…) ou sur le groupe.";
	226	+ d.textContent = "👋 Je suis KA Agent, l'assistant de l'écosystème Groupe KA. Posez-moi une question sur ce site, ses données (prix, annonces, fiches, stats…) ou sur le groupe.";
136	227	logEl.appendChild(d);
137	228	}
138	229	function render() {
139	230	logEl.innerHTML = "";
140	231	hello();
141		− log.forEach(function (m) { bubble(m.role === "user" ? "kaa-u" : "kaa-a", md(m.content)); });
	232	+ log.forEach(function (m) {
	233	+ m.role === "user" ? bubble("kaa-u", esc(m.content)) : bubble("kaa-a", md(m.content));
	234	+ });
142	235	scroll();
143	236	}
144	237
145		− /* ---------- ouverture / plein écran ---------- */
146		− /* Sur téléphone : panneau plein écran d'office + scroll d'arrière-plan
147		− verrouillé tant qu'il est ouvert (html.kaa-lock). Pas de focus clavier
148		− forcé au tap (le clavier ne s'ouvre que si l'utilisateur touche le champ). */
149		− var mobileMq = window.matchMedia("(max-width: 640px)");
	238	+ /* ---------- plein écran + clavier mobile ----------
	239	+ Ouverture = PLEIN ÉCRAN direct (desktop et mobile). ▭ réduit en fenêtre
	240	+ (desktop seulement — caché sur mobile). Tant que le plein écran est ouvert,
	241	+ l'arrière-plan est GELÉ (body position:fixed, scroll restauré à la
	242	+ fermeture) et le panneau se cale sur window.visualViewport : quand le
	243	+ clavier s'ouvre, le panneau rétrécit à la place de laisser iOS
	244	+ zoomer/pousser la page. Pas de focus clavier forcé au tap sur mobile. */
150	245	var fineInput = window.matchMedia("(hover: hover) and (pointer: fine)");
151		− function syncLock() {
152		− var open = panel.classList.contains("kaa-open");
153		− if (open && mobileMq.matches) panel.classList.add("kaa-full");
154		− document.documentElement.classList.toggle(
155		− "kaa-lock", open && panel.classList.contains("kaa-full"));
	246	+ var vv = window.visualViewport;
	247	+ var savedY = 0;
	248	+
	249	+ function isOpen() { return panel.classList.contains("kaa-open"); }
	250	+ function isFull() { return panel.classList.contains("kaa-full"); }
	251	+
	252	+ function fitVV() {
	253	+ if (!vv \|\| !isOpen() \|\| !isFull()) { panel.style.height = ""; panel.style.top = ""; return; }
	254	+ panel.style.top = Math.round(vv.offsetTop) + "px";
	255	+ panel.style.height = Math.round(vv.height) + "px";
	256	+ scroll();
156	257	}
157		− btn.addEventListener("click", function () {
158		− panel.classList.toggle("kaa-open");
159		− if (panel.classList.contains("kaa-open")) {
160		− render();
161		− if (fineInput.matches) ta.focus();
	258	+ if (vv) {
	259	+ vv.addEventListener("resize", fitVV);
	260	+ vv.addEventListener("scroll", fitVV);
	261	+ }
	262	+
	263	+ function lockBg(on) {
	264	+ var b = document.body, h = document.documentElement;
	265	+ if (on && !h.classList.contains("kaa-lock")) {
	266	+ savedY = window.scrollY \|\| 0;
	267	+ h.classList.add("kaa-lock");
	268	+ b.style.position = "fixed";
	269	+ b.style.top = -savedY + "px";
	270	+ b.style.left = "0"; b.style.right = "0"; b.style.width = "100%";
	271	+ } else if (!on && h.classList.contains("kaa-lock")) {
	272	+ h.classList.remove("kaa-lock");
	273	+ b.style.position = ""; b.style.top = ""; b.style.left = ""; b.style.right = ""; b.style.width = "";
	274	+ window.scrollTo(0, savedY);
162	275	}
163		− syncLock();
	276	+ }
	277	+ function sync() {
	278	+ lockBg(isOpen() && isFull());
	279	+ fitVV();
	280	+ }
	281	+
	282	+ btn.addEventListener("click", function () {
	283	+ panel.classList.add("kaa-open", "kaa-full"); // plein écran d'office
	284	+ render();
	285	+ if (fineInput.matches) ta.focus();
	286	+ sync();
164	287	});
165	288	panel.querySelector(".kaa-x2").addEventListener("click", function () {
166	289	panel.classList.remove("kaa-open", "kaa-full");
167		− syncLock();
	290	+ sync();
168	291	});
169	292	panel.querySelector(".kaa-x1").addEventListener("click", function () {
170	293	panel.classList.toggle("kaa-full");
171		− syncLock();
	294	+ sync();
172	295	scroll();
173	296	});
	297	+ document.addEventListener("keydown", function (e) {
	298	+ if (e.key === "Escape" && isOpen()) {
	299	+ panel.classList.remove("kaa-open", "kaa-full");
	300	+ sync();
	301	+ }
	302	+ });
174	303
175	304	/* ---------- envoi + flux SSE ---------- */
176	305	var busy = false;
		`@@ -182,7 +311,7 @@`
182	311	ta.value = "";
183	312	log.push({ role: "user", content: q });
184	313	save();
185		− bubble("kaa-u", md(q));
	314	+ bubble("kaa-u", esc(q));
186	315	var out = bubble("kaa-a", '<span class="kaa-dots"></span>');
187	316	var acc = "";
188	317	var chips = [];
		`@@ -211,7 +340,7 @@`
211	340	try { data = JSON.parse(dm); } catch (e) {}
212	341	if (ev === "delta" && data.text) {
213	342	acc += data.text;
214		− out.innerHTML = md(acc);
	343	+ out.innerHTML = md(acc); // markdown re-rendu à chaque delta
215	344	scroll();
216	345	} else if (ev === "tool") {
217	346	chips.push(toolChip(data.name \|\| "recherche"));

added scripts/build-stats-v2.mjs +164 −0

		`@@ -0,0 +1,164 @@`
	1	+// Auteur : Simon-Pierre Boucher — contact@spboucher.ai
	2	+/**
	3	+ * scripts/build-stats-v2.mjs — agrégats v2 du module Stats commun Groupe KA.
	4	+ * Lit data/vraiprix.db (rôle d'évaluation + corpus de ventes + indice marché)
	5	+ * et écrit src/data/stats-v2.json : tout ce que /api/stats/dashboard v2 sert
	6	+ * en plus des agrégats historiques de src/data/stats.json.
	7	+ * Données 100 % réelles — aucune valeur inventée. À relancer quand la DB change :
	8	+ * node scripts/build-stats-v2.mjs
	9	+ */
	10	+import Database from "better-sqlite3";
	11	+import { writeFileSync } from "fs";
	12	+import path from "path";
	13	+
	14	+const db = new Database(path.join(process.cwd(), "data", "vraiprix.db"), { readonly: true });
	15	+const out = {};
	16	+out.generated = new Date().toISOString();
	17	+
	18	+/* ---------------- unités (rôle d'évaluation, millésime 2026) ---------------- */
	19	+console.time("units");
	20	+out.units = db.prepare(`
	21	+ SELECT COUNT(*) AS total,
	22	+ SUM(lat IS NOT NULL AND lng IS NOT NULL AND lat != 0) AS geoloc,
	23	+ SUM(valeur_role IS NOT NULL AND valeur_role > 0) AS with_role,
	24	+ SUM(est_2026 IS NOT NULL AND est_2026 > 0) AS with_est2026,
	25	+ SUM(annee_construction IS NOT NULL AND annee_construction > 1500) AS with_year,
	26	+ SUM(aire_etages_m2 IS NOT NULL AND aire_etages_m2 > 0) AS with_area,
	27	+ CAST(AVG(CASE WHEN est_2026 > 0 THEN est_2026 END) AS INTEGER) AS avg_est2026,
	28	+ CAST(AVG(CASE WHEN valeur_role > 0 THEN valeur_role END) AS INTEGER) AS avg_role,
	29	+ CAST(SUM(CASE WHEN valeur_role > 0 THEN valeur_role ELSE 0 END) AS INTEGER) AS sum_role,
	30	+ SUM(COALESCE(nb_logements, 0)) AS logements
	31	+ FROM units`).get();
	32	+console.timeEnd("units");
	33	+
	34	+/* ------------- distribution des valeurs estimées 2026 (histogramme) ------------- */
	35	+console.time("bins");
	36	+const BINS = [
	37	+ [0, 100e3, "< 100 k$"], [100e3, 200e3, "100-200 k$"], [200e3, 300e3, "200-300 k$"],
	38	+ [300e3, 400e3, "300-400 k$"], [400e3, 500e3, "400-500 k$"], [500e3, 750e3, "500-750 k$"],
	39	+ [750e3, 1e6, "750 k-1 M$"], [1e6, 2e6, "1-2 M$"], [2e6, 5e6, "2-5 M$"], [5e6, Infinity, "5 M$ +"],
	40	+];
	41	+const caseExpr = BINS.map(([lo, hi], i) =>
	42	+ hi === Infinity ? `WHEN est_2026 >= ${lo} THEN ${i}` : `WHEN est_2026 >= ${lo} AND est_2026 < ${hi} THEN ${i}`
	43	+).join(" ");
	44	+const binRows = db.prepare(`
	45	+ SELECT CASE ${caseExpr} END AS b, COUNT(*) AS n
	46	+ FROM units WHERE est_2026 > 0 GROUP BY b ORDER BY b`).all();
	47	+out.valeur_bins = BINS.map(([, , label], i) => ({
	48	+ label, value: binRows.find((r) => r.b === i)?.n ?? 0,
	49	+}));
	50	+console.timeEnd("bins");
	51	+
	52	+/* ------------- parc par tranche d'année de construction ------------- */
	53	+console.time("construction");
	54	+const ERAS = [
	55	+ [0, 1900, "Avant 1900"], [1900, 1946, "1900-1945"], [1946, 1961, "1946-1960"],
	56	+ [1961, 1976, "1961-1975"], [1976, 1991, "1976-1990"], [1991, 2006, "1991-2005"],
	57	+ [2006, 2016, "2006-2015"], [2016, 3000, "2016 +"],
	58	+];
	59	+const eraExpr = ERAS.map(([lo, hi], i) => `WHEN annee_construction >= ${lo} AND annee_construction < ${hi} THEN ${i}`).join(" ");
	60	+const eraRows = db.prepare(`
	61	+ SELECT CASE ${eraExpr} END AS b, COUNT(*) AS n,
	62	+ CAST(SUM(CASE WHEN est_2026 > 0 THEN est_2026 ELSE 0 END) AS INTEGER) AS total,
	63	+ CAST(AVG(CASE WHEN est_2026 > 0 THEN est_2026 END) AS INTEGER) AS moyenne
	64	+ FROM units WHERE annee_construction > 1500 GROUP BY b ORDER BY b`).all();
	65	+out.construction = ERAS.map(([, , label], i) => {
	66	+ const r = eraRows.find((x) => x.b === i);
	67	+ return { label, n: r?.n ?? 0, total: r?.total ?? 0, moyenne: r?.moyenne ?? null };
	68	+});
	69	+console.timeEnd("construction");
	70	+
	71	+/* ---------------- records réels du rôle ---------------- */
	72	+console.time("records");
	73	+out.rec = {};
	74	+out.rec.max_role = db.prepare(`
	75	+ SELECT municipalite, valeur_role AS v, cubf_libelle FROM units
	76	+ WHERE valeur_role IS NOT NULL ORDER BY valeur_role DESC LIMIT 1`).get();
	77	+out.rec.max_est = db.prepare(`
	78	+ SELECT municipalite, est_2026 AS v FROM units
	79	+ WHERE est_2026 IS NOT NULL ORDER BY est_2026 DESC LIMIT 1`).get();
	80	+out.rec.max_terrain = db.prepare(`
	81	+ SELECT municipalite, superficie_terrain_m2 AS m2 FROM units
	82	+ WHERE superficie_terrain_m2 IS NOT NULL ORDER BY superficie_terrain_m2 DESC LIMIT 1`).get();
	83	+out.rec.max_logements = db.prepare(`
	84	+ SELECT municipalite, nb_logements AS n FROM units
	85	+ WHERE nb_logements IS NOT NULL ORDER BY nb_logements DESC LIMIT 1`).get();
	86	+const oldest = db.prepare(`
	87	+ SELECT MIN(annee_construction) AS y FROM units WHERE annee_construction > 1600`).get();
	88	+out.rec.oldest = {
	89	+ y: oldest.y,
	90	+ n: db.prepare("SELECT COUNT(*) AS n FROM units WHERE annee_construction = ?").get(oldest.y).n,
	91	+};
	92	+console.timeEnd("records");
	93	+
	94	+/* ---------------- transactions (corpus de ventes réelles 2021-2026) ---------------- */
	95	+console.time("tx");
	96	+const TX_TYPE_FR = { unifamilial: "Unifamiliale", condo: "Condo", plex: "Plex", "indéterminé": "Indéterminé" };
	97	+const txTypeKeys = ["unifamilial", "condo", "plex", "indéterminé"];
	98	+const monthly = new Map(); // m -> { n, total, amounts[], byType: [4] }
	99	+for (const r of db.prepare("SELECT substr(date,1,7) AS m, amount, property_type FROM transactions").iterate()) {
	100	+ let e = monthly.get(r.m);
	101	+ if (!e) { e = { n: 0, total: 0, amounts: [], byType: [0, 0, 0, 0] }; monthly.set(r.m, e); }
	102	+ e.n++; e.total += r.amount; e.amounts.push(r.amount);
	103	+ const ti = txTypeKeys.indexOf(r.property_type ?? "indéterminé");
	104	+ e.byType[ti === -1 ? 3 : ti]++;
	105	+}
	106	+const months = [...monthly.keys()].sort();
	107	+const median = (a) => { const s = [...a].sort((x, y) => x - y); return s[Math.floor(s.length / 2)]; };
	108	+out.tx = {
	109	+ monthly: months.map((m) => {
	110	+ const e = monthly.get(m);
	111	+ return { m, n: e.n, total: Math.round(e.total), median: Math.round(median(e.amounts)) };
	112	+ }),
	113	+ monthly_by_type: {
	114	+ keys: txTypeKeys.map((k) => TX_TYPE_FR[k]),
	115	+ points: months.map((m) => ({ t: m, values: monthly.get(m).byType })),
	116	+ },
	117	+};
	118	+// bins des montants de vente
	119	+const TXB = [
	120	+ [0, 200e3, "< 200 k$"], [200e3, 300e3, "200-300 k$"], [300e3, 400e3, "300-400 k$"],
	121	+ [400e3, 500e3, "400-500 k$"], [500e3, 700e3, "500-700 k$"], [700e3, 1e6, "700 k-1 M$"],
	122	+ [1e6, 2e6, "1-2 M$"], [2e6, Infinity, "2 M$ +"],
	123	+];
	124	+const txCase = TXB.map(([lo, hi], i) =>
	125	+ hi === Infinity ? `WHEN amount >= ${lo} THEN ${i}` : `WHEN amount >= ${lo} AND amount < ${hi} THEN ${i}`).join(" ");
	126	+const txBinRows = db.prepare(`SELECT CASE ${txCase} END AS b, COUNT(*) AS n FROM transactions GROUP BY b`).all();
	127	+out.tx.amount_bins = TXB.map(([, , label], i) => ({ label, value: txBinRows.find((r) => r.b === i)?.n ?? 0 }));
	128	+// activité quotidienne (26 dernières semaines du corpus) pour le calendrier
	129	+const maxDate = db.prepare("SELECT MAX(date) AS d FROM transactions").get().d;
	130	+const since = new Date(maxDate + "T12:00:00");
	131	+since.setDate(since.getDate() - 26 * 7);
	132	+out.tx.daily = db.prepare(`
	133	+ SELECT date, COUNT(*) AS n FROM transactions WHERE date >= ? GROUP BY date ORDER BY date`)
	134	+ .all(since.toISOString().slice(0, 10)).map((r) => ({ date: r.date, n: r.n }));
	135	+out.tx.max_date = maxDate;
	136	+out.tx.max = db.prepare("SELECT amount, city, date FROM transactions ORDER BY amount DESC LIMIT 1").get();
	137	+const best = out.tx.monthly.reduce((a, b) => (b.n > a.n ? b : a));
	138	+out.tx.best_month = { m: best.m, n: best.n };
	139	+// top villes par nombre de ventes
	140	+out.tx.top_villes = db.prepare(`
	141	+ SELECT city, COUNT(*) AS n, CAST(AVG(amount) AS INTEGER) AS moyenne
	142	+ FROM transactions WHERE city IS NOT NULL GROUP BY city ORDER BY n DESC LIMIT 20`).all();
	143	+console.timeEnd("tx");
	144	+
	145	+/* ---------------- indice de marché mensuel par type ---------------- */
	146	+console.time("market");
	147	+const MI_TYPE_FR = { unifamilial: "Unifamiliale", condo: "Condo", plex: "Plex", "indéterminé": "Ensemble" };
	148	+const miTypes = db.prepare("SELECT DISTINCT type_prop FROM market_index ORDER BY type_prop").all().map((r) => r.type_prop);
	149	+out.market = {
	150	+ idx_by_type: miTypes.map((t) => ({
	151	+ label: MI_TYPE_FR[t] ?? t,
	152	+ points: db.prepare("SELECT month, idx FROM market_index WHERE type_prop = ? ORDER BY month").all(t)
	153	+ .map((r) => ({ t: r.month, v: Math.round(r.idx * 1000) / 1000 })),
	154	+ })),
	155	+ ppm2_by_type: miTypes.filter((t) => t !== "indéterminé").map((t) => ({
	156	+ label: MI_TYPE_FR[t] ?? t,
	157	+ points: db.prepare("SELECT month, ppm2 FROM market_index WHERE type_prop = ? AND ppm2 IS NOT NULL ORDER BY month").all(t)
	158	+ .map((r) => ({ t: r.month, v: Math.round(r.ppm2) })),
	159	+ })),
	160	+};
	161	+console.timeEnd("market");
	162	+
	163	+writeFileSync(path.join(process.cwd(), "src", "data", "stats-v2.json"), JSON.stringify(out));
	164	+console.log("→ src/data/stats-v2.json écrit,", JSON.stringify(out).length, "octets");

modified src/ka/stats/SPEC.md +128 −66

		`@@ -1,53 +1,88 @@`
1		−# ka-stats — module Stats commun Groupe KA (spec v1)
	1	+# ka-stats — module Stats commun Groupe KA (spec v2)
2	2
3		−Contrat partagé par les 12 plateformes pour leurs pages /stats (tableau de
4		−bord analytique) et l'export PDF estampillé Groupe-KA. Le visuel suit le
5		−design system ka-ui (tokens.css) avec l'accent de la marque.
	3	+Contrat partagé par les plateformes pour leurs pages /stats (tableau de
	4	+bord analytique) et les exports PDF estampillés Groupe-KA. Le visuel suit
	5	+le design system ka-ui (tokens.css) avec l'accent de la marque.
	6	+
	7	+v2 (2026-08-19) : sparklines dans les KPI, jauges, multi-courbes,
	8	+barres empilées, distributions (histogrammes), heatmap horaire 7×24, deltas
	9	+sur les répartitions, statistiques de séries (min/max/moy/méd/σ), et **5
	10	+rapports PDF au lieu de 2. Tous les nouveaux champs sont optionnels** :
	11	+un dashboard v1 reste valide et se rend tel quel.
6	12
7	13	## 1. Page /stats — structure obligatoire (dans cet ordre)
8	14
9		−1. Bandeau KPI : 4–6 grandes cartes (`KpiCard`) — valeur, libellé,
10		− variation vs période précédente (▲/▼ + %, vert `--green` / rouge `--danger`).
	15	+1. Bandeau KPI : 6–10 grandes cartes (`KpiCard`) — valeur, libellé,
	16	+ variation vs période précédente (▲/▼ + %, vert `--green` / rouge
	17	+ `--danger`), sparkline de tendance quand une série existe.
11	18	2. Sélecteur de période global (`PeriodSelector`) : `aujourd'hui · 7 j ·
12	19	30 j · 3 m · 6 m · 12 m · année en cours · tout` + plage personnalisée
13	20	(2 champs date). Toute la page se recalcule (state → refetch dashboard).
14		−3. Graphiques : courbes d'évolution (`LineChart`, survol = infobulle,
15		− légende cliquable pour masquer une série, comparaison N vs N-1 en
16		− pointillé), barres (`BarChart`), anneaux (`Donut`), calendrier de chaleur
17		− (`CalendarHeatmap`) quand pertinent.
18		−4. Répartition géographique (par ville/région) quand pertinent — barres
19		− horizontales triées (pas besoin de vraie carte).
20		−5. Tableaux détaillés (`DataTable`) : tri par colonne, recherche interne,
	21	+3. Jauges (`GaugeCard`) quand pertinent : taux, couvertures, complétude.
	22	+4. Graphiques d'évolution : courbes/aires (`LineChart`, survol =
	23	+ infobulle, légende cliquable, comparaison N vs N-1 en pointillé), barres
	24	+ verticales (`VBarChart` — volumes quotidiens), multi-courbes ≤ 4 séries
	25	+ (`MultiLineChart` — motifs de trait distincts, jamais la couleur seule),
	26	+ barres empilées (`StackedBarChart` — composition dans le temps).
	27	+ Sous les courbes clés : `StatSummary` (min/max/moyenne/médiane/écart-type).
	28	+5. Répartitions : barres horizontales (`BarChart`, deltas optionnels),
	29	+ anneaux (`Donut`), distributions/histogrammes (`Histogram`).
	30	+6. Répartition géographique (par ville/région) — barres horizontales
	31	+ triées (pas besoin de vraie carte).
	32	+7. Calendriers : `CalendarHeatmap` (26 semaines) et, quand l'activité
	33	+ horaire est journalisée, `HourHeatmap` (7 jours × 24 h).
	34	+8. Tableaux détaillés (`DataTable`) : tri par colonne, recherche interne,
21	35	pagination (25/pg), débordement horizontal propre sur mobile (.tbl-wrap).
22		−6. Records & faits marquants : générés depuis les données (jour record,
23		− plus forte croissance, meilleure entrée…) — cartes compactes.
24		−7. Fraîcheur : « Mis à jour le {date heure} » + bouton Rafraîchir.
25		−8. Bouton PDF bien visible en haut : « Télécharger le rapport PDF » avec
26		− deux choix (Rapport complet / Synthèse 2 pages). Indicateur de progression
27		− si > 2 s.
	36	+ Viser 3 à 5 tableaux par plateforme.
	37	+9. Records & faits marquants : générés depuis les données (jour record,
	38	+ plus forte croissance, meilleure entrée…) — cartes compactes, 6–12.
	39	+10. Fraîcheur : « Mis à jour le {date heure} » + bouton Rafraîchir.
	40	+11. Bouton PDF bien visible en haut (`PdfButton`) : bouton principal
	41	+ « Rapport PDF complet » + menu « Autres rapports ▾ » listant les
	42	+ 5 rapports (voir §3). Indicateur de progression si > 2 s.
28	43
29	44	Responsive : KPI empilés < 768 px, graphiques pleine largeur redimensionnés
30	45	(SVG viewBox), tableaux en défilement horizontal contenu, tactile ≥ 44 px.
31	46	AUCUNE donnée inventée : une stat indisponible = bloc « Pas encore mesuré »
32	47	(carte grise propre), jamais un faux chiffre.
33	48
	49	+Accessibilité (règles fermes) : un seul axe Y par graphique (jamais de
	50	+double échelle) ; ≥ 2 séries ⇒ légende obligatoire ; l'identité d'une série
	51	+multi-courbes passe par le motif de trait en plus de la couleur ; le
	52	+texte reste en encre (jamais coloré à la couleur de série) ; chaque
	53	+graphique a son infobulle de survol et un équivalent tableau existe.
	54	+
34	55	## 2. API — contrat commun
35	56
36	57	`GET /api/stats/dashboard?period=7j\|30j\|3m\|6m\|12m\|annee\|tout\|auj&from=YYYY-MM-DD&to=YYYY-MM-DD`
37	58
38	59	```jsonc
39	60	{
40		− "updated": "2026-08-17T21:04:00-04:00",
41		− "period": { "from": "2026-07-18", "to": "2026-08-17", "label": "30 jours" },
	61	+ "updated": "2026-08-19T01:00:00-04:00",
	62	+ "period": { "from": "2026-07-20", "to": "2026-08-19", "label": "30 jours" },
42	63	"kpis": [ { "id": "total", "label": "Annonces actives", "value": 33744,
43		− "unit": "", "delta_pct": 4.2, "direction": "up" } ],
	64	+ "unit": "", "delta_pct": 4.2, "direction": "up",
	65	+ "spark": [{ "t": "2026-08-01", "v": 31200 }] } ], // spark optionnel
	66	+ "gauges": [ { "id": "geo", "label": "Fiches géolocalisées", "value": 92,
	67	+ "max": 100, "unit": "%" } ], // optionnel
44	68	"series": [ { "id": "vol", "title": "Annonces actives par jour", "unit": "annonces",
45		− "kind": "line", "points": [{ "t": "2026-07-18", "v": 31200 }],
46		− "compare": [{ "t": "2025-07-18", "v": 24100 }] } ],
47		− "breakdowns": [ { "id": "types", "title": "Par type", "kind": "donut",
48		− "items": [{ "label": "4½", "value": 9120 }] } ],
	69	+ "kind": "line", // line \| bar \| area
	70	+ "points": [{ "t": "2026-07-20", "v": 31200 }],
	71	+ "compare": [{ "t": "2025-07-20", "v": 24100 }] } ],
	72	+ "multiseries": [ { "id": "seg", "title": "Prix médian par taille", "unit": "$",
	73	+ "series": [ { "label": "3½", "points": [/* … */] },
	74	+ { "label": "4½", "points": [/* … */] } ] } ], // ≤ 4
	75	+ "stacked": [ { "id": "src", "title": "Ajouts par source", "unit": "ajouts",
	76	+ "keys": ["Kijiji", "Centris", "Autres"],
	77	+ "points": [{ "t": "2026-08-01", "values": [120, 80, 30] }] } ],
	78	+ "breakdowns": [ { "id": "types", "title": "Par type", "kind": "donut", // donut \| bars
	79	+ "items": [{ "label": "4½", "value": 9120, "delta_pct": 2.1 }] } ],
	80	+ "distributions": [ { "id": "prix", "title": "Distribution des loyers", "unit": "annonces",
	81	+ "bins": [{ "label": "800-1000$", "value": 3120 }] } ],
49	82	"geo": { "title": "Par région", "items": [{ "label": "Montréal", "value": 15680 }] },
50	83	"heatmap": { "title": "Activité", "cells": [{ "date": "2026-08-01", "value": 210 }] },
	84	+ "hourly": { "title": "Activité par heure",
	85	+ "cells": [{ "dow": 0, "hour": 9, "value": 40 }] }, // dow 0=lun … 6=dim
51	86	"tables": [ { "id": "top", "title": "Top villes", "columns": ["Ville", "Annonces", "Δ 30 j"],
52	87	"rows": [["Montréal", 15680, "+3,1 %"]] } ],
53	88	"records": [ { "label": "Jour record d'ajouts", "value": "412 annonces", "date": "2026-08-09" } ]
		`@@ -56,23 +91,40 @@ AUCUNE donnée inventée : une stat indisponible = bloc « Pas encore mesuré »`
56	91
57	92	Champs absents = section masquée. Cache serveur recommandé (≥ 5 min par
58	93	période). Les valeurs proviennent des données réelles (DB de la plateforme,
59		−journaux de sync des connecteurs, /api/v1/runs d'API-KA…).
	94	+journaux de sync des connecteurs, /api/v1/runs d'API-KA…). Arrondir les
	95	+`delta_pct` à 1 décimale côté serveur.
60	96
61		−`GET /api/stats/report?period=…&from=&to=&mode=complet\|synthese`
	97	+## 3. Rapports PDF — 5 modes
	98	+
	99	+`GET /api/stats/report?period=…&from=&to=&mode=complet\|synthese\|tendances\|repartitions\|donnees`
62	100	→ `application/pdf`, en-tête `Content-Disposition: attachment; filename=
63		−groupe-ka_<plateforme>_stats_<periode>_<YYYY-MM-DD>.pdf`.
	101	+groupe-ka_<plateforme>_stats_<periode>[_<mode>]_<YYYY-MM-DD>.pdf`
	102	+(pas de suffixe pour `complet` — rétrocompatible v1 ; `kapdf.filename()`
	103	+accepte maintenant `mode` en 3e argument).
	104	+
	105	+\| Mode \| Contenu \|
	106	+\|---\|---\|
	107	+\| `complet` \| tout : sommaire, KPI, jauges, séries + stats de séries, multi-séries, empilées, répartitions, distributions, géo, heatmap horaire, tableaux (200 lignes), records \|
	108	+\| `synthese` \| couverture + KPI + jauges + records (2–3 pages) \|
	109	+\| `tendances` \| KPI + toutes les séries temporelles + min/max/moy/méd/σ + records \|
	110	+\| `repartitions` \| breakdowns, distributions, géo, activité horaire \|
	111	+\| `donnees` \| tous les tableaux en version longue (400 lignes) \|
64	112
65		−## 3. PDF — gabarit Groupe-KA (implémentations : `kapdf.py` fpdf2 pour les
66		−apps Python ; les apps Next portent le même gabarit en pdfkit)
	113	+Un `mode` inconnu retombe sur `complet`. Le gabarit (implémentations :
	114	+`kapdf.py` fpdf2 pour les apps Python ; les apps Next portent le même
	115	+gabarit en pdfkit) :
67	116
68	117	- Couverture : cadre encre, kicker « GROUPE KA · RAPPORT STATISTIQUE »,
69		− wordmark de la plateforme (boîte encre + accent), sous-titre, période
70		− couverte, date/heure de génération, bande encre au pied avec
	118	+ wordmark de la plateforme (boîte encre + accent), type de rapport,
	119	+ période couverte, date/heure de génération, bande encre au pied avec
71	120	« par Groupe KA — groupe-ka.com ».
72		−- Sommaire avec numéros de pages (mode complet).
73		−- KPI : grille de cartes (bordure encre, valeur en gros, delta coloré).
	121	+- Sommaire avec numéros de pages (modes complet et donnees).
	122	+- KPI : grille de cartes (bordure encre, valeur en gros, delta coloré
	123	+ arrondi à 1 décimale). Jauges : demi-arcs accent.
74	124	- Graphiques VECTORIELS (dessinés en primitives, jamais de capture) :
75		− courbes, barres, anneaux — accent de la plateforme, axes/graduations encre.
	125	+ courbes/aires, barres verticales, multi-courbes (motifs distincts),
	126	+ empilées (nuances d'accent), anneaux, heatmap horaire — accent de la
	127	+ plateforme, axes/graduations encre.
76	128	- Tableaux paginés proprement (lignes zébrées `--surface-2`, jamais
77	129	coupés en deux à cheval sur une ligne).
78	130	- Records puis page de fin : coordonnées Groupe KA (3 courriels +
		`@@ -81,43 +133,53 @@ apps Python ; les apps Next portent le même gabarit en pdfkit)`
81	133	- Chaque page : en-tête discret (« Groupe KA · {Plateforme} », filet
82	134	encre) + pied (« © Groupe-KA — {année} — groupe-ka.com · {période} · p. X/Y »).
83	135	- A4 portrait, marges 18 mm, typo : Helvetica (fallback sûr) ou fonts TTF du
84		− DS si présentes. Mode « synthese » = couverture + 1 page KPI/records.
	136	+ DS si présentes.
85	137
86	138	## 4. Spécifique par plateforme (sections métier attendues)
87	139
88		−- groupe-ka : tableau de bord maître — consolidation des 12 (volume total,
89		− croissance), classement des plateformes, bloc résumé par plateforme + lien
	140	+- groupe-ka : tableau de bord maître — consolidation des plateformes
	141	+ (volume total, croissance), classement, bloc résumé par plateforme + lien
90	142	vers sa page /stats ; « Rapport écosystème complet » = PDF consolidé.
91	143	- lou-ka : annonces actives/nouvelles/retirées, loyers moyens/médians par
92		− ville & taille, évolution, répartition par type, top villes.
93		−- immo-ka : annonces actives/nouvelles/vendues-retirées, prix moyen/médian
94		− par ville/région/type, délai de présence, top villes, tension du marché.
	144	+ ville & taille (multiseries), distribution des loyers, évolution,
	145	+ répartition par type, top villes, sources (stacked).
	146	+- immo-ka : annonces actives/nouvelles/vendues-retirées, prix
	147	+ moyen/médian par ville/région/type (multiseries), distribution des prix,
	148	+ délai de présence, top villes, tension du marché.
95	149	- vrai-prix : couverture du rôle (unités, valeur totale), estimations
96		− servies si journalisées, répartitions par municipalité/type, indices marché.
97		−- auto-ka : volume par marque/modèle/année/carburant/boîte, prix moyens et
98		− km moyens par segment, top marques/modèles.
99		−- fabri-ka : produits par catégorie/région/boutique, fourchettes de prix,
100		− nouveautés par période, top catégories.
101		−- food-ka : produits suivis, relevés de prix, soldes détectés (baisses/
102		− hausses, amplitude), top produits en solde, prix moyens par catégorie.
103		−- resto-ka : restos par cuisine/ville/gamme, menus & plats, nouveautés/
104		− fermetures détectées, top établissements.
	150	+ servies si journalisées, répartitions par municipalité/type, distribution
	151	+ des valeurs, indices marché.
	152	+- auto-ka : volume par marque/modèle/année/carburant/boîte, prix moyens
	153	+ et km moyens par segment (multiseries), distributions prix/km/année,
	154	+ top marques/modèles.
	155	+- fabri-ka : produits par catégorie/région/boutique, fourchettes de prix
	156	+ (distribution), nouveautés par période, top catégories.
	157	+- food-ka : produits suivis, relevés de prix, soldes détectés
	158	+ (baisses/hausses, amplitude — stacked), top produits en solde, prix moyens
	159	+ par catégorie, distribution des rabais.
	160	+- resto-ka : restos par cuisine/ville/gamme, menus & plats, distribution
	161	+ des prix de plats, nouveautés/fermetures détectées, top établissements.
105	162	- sorti-ka : événements à venir/passés par catégorie/ville, gratuits vs
106		− payants, heatmap calendrier, top lieux.
107		−- crea-ka : créateurs par plateforme/niche/tier, comptes reliés, top
108		− créateurs, croissance du répertoire.
109		−- trouve-ka : pages indexées, domaines, rythme de crawl (indexées/h),
110		− erreurs, file frontier, tendances si les requêtes sont journalisées.
111		−- api-ka : appels par endpoint/jour/heure, latences moyennes + p95, taux
112		− d'erreur, top endpoints, uptime (données des middlewares de logging + runs).
113		−- Transverse (tous) : volume total agrégé + croissance, connecteurs actifs
114		− et éléments ajoutés/mis à jour par période (journaux de sync), complétude/
115		− fraîcheur moyenne des fiches quand mesurable. Trafic web : seulement si des
116		− journaux d'accès existent — sinon état vide propre.
	163	+ payants (stacked), heatmap calendrier + horaire, top lieux.
	164	+- crea-ka : créateurs par plateforme/niche/tier, comptes reliés
	165	+ (stacked par plateforme), distribution des audiences, top créateurs,
	166	+ croissance du répertoire.
	167	+- trouve-ka : pages indexées, domaines, rythme de crawl (indexées/h —
	168	+ hourly), erreurs, file frontier, tendances des requêtes journalisées.
	169	+- api-ka : appels par endpoint/jour/heure (hourly), latences moyennes +
	170	+ p95 (multiseries), taux d'erreur, top endpoints/clés, uptime.
	171	+- job-ka : offres actives/nouvelles/expirées par catégorie/ville/
	172	+ entreprise, distribution des salaires affichés, top employeurs.
	173	+- Transverse (tous) : volume total agrégé + croissance, connecteurs
	174	+ actifs et éléments ajoutés/mis à jour par période (journaux de sync —
	175	+ stacked par source quand possible), complétude/fraîcheur moyenne des
	176	+ fiches quand mesurable (jauges). Trafic web : seulement si des journaux
	177	+ d'accès existent — sinon état vide propre.
117	178
118	179	## 5. Ajouter une métrique / un graphique / une plateforme
119	180
120		−1 métrique = 1 entrée `kpis[]` ou `series[]` côté API (requête SQL agrégée +
121		−cache) — le front la rend automatiquement. 1 plateforme = implémenter les 2
122		−endpoints du contrat + une page /stats montée sur les composants du kit +
123		−`kapdf.py` (ou gabarit pdfkit) branché sur le même JSON de dashboard.
	181	+1 métrique = 1 entrée `kpis[]`, `series[]`, `multiseries[]`, `stacked[]`,
	182	+`distributions[]` ou `gauges[]` côté API (requête SQL agrégée + cache) — le
	183	+front la rend automatiquement. 1 plateforme = implémenter les 2 endpoints du
	184	+contrat + une page /stats montée sur les composants du kit + `kapdf.py` (ou
	185	+gabarit pdfkit) branché sur le même JSON de dashboard.

modified src/ka/stats/kacharts.tsx +393 −30

		`@@ -2,22 +2,39 @@`
2	2	// ka-ui/stats/kacharts.tsx — kit de graphiques SVG du module Stats commun
3	3	// Groupe KA (zéro dépendance, React 18+). Style : design system ka-ui
4	4	// (bordures encre, accent de la plateforme via var(--accent)).
5		−// Composants : KpiCard, PeriodSelector, LineChart (infobulle + légende
6		−// cliquable + comparaison N-1), BarChart, Donut, CalendarHeatmap, DataTable
7		−// (tri/recherche/pagination), RecordCard, PdfButton, EmptyBlock, Fraicheur.
8		−import { useMemo, useState } from "react";
	5	+// v2 — composants : KpiCard (+sparkline), PeriodSelector, LineChart (ligne/
	6	+// aire, infobulle + légende cliquable + comparaison N-1), MultiLineChart
	7	+// (≤4 séries, pointillés distincts = jamais la couleur seule), VBarChart
	8	+// (barres verticales / histogrammes), StackedBarChart, BarChart (horizontal,
	9	+// deltas), Donut, GaugeCard, CalendarHeatmap, HourHeatmap (7×24),
	10	+// StatSummary (min/max/moy/méd/σ), DataTable (tri/recherche/pagination),
	11	+// RecordCard, PdfButton (menu de rapports), EmptyBlock, Fraicheur.
	12	+import { useEffect, useMemo, useRef, useState } from "react";
9	13
10		−/* ---------- types (contrat SPEC.md) ---------- */
	14	+/* ---------- types (contrat SPEC.md v2) ---------- */
11	15	export type Kpi = {
12	16	id: string; label: string; value: number \| string; unit?: string;
13	17	delta_pct?: number \| null; direction?: "up" \| "down";
	18	+ spark?: Point[]; help?: string;
14	19	};
15	20	export type Point = { t: string; v: number };
16	21	export type Serie = {
17		− id: string; title: string; unit?: string; kind?: "line" \| "bar";
	22	+ id: string; title: string; unit?: string;
	23	+ kind?: "line" \| "bar" \| "area";
18	24	points: Point[]; compare?: Point[];
19	25	};
20		−export type BreakItem = { label: string; value: number };
	26	+export type MultiSerie = {
	27	+ id: string; title: string; unit?: string;
	28	+ series: { label: string; points: Point[] }[]; // ≤ 4 séries
	29	+};
	30	+export type StackedSerie = {
	31	+ id: string; title: string; unit?: string;
	32	+ keys: string[]; points: { t: string; values: number[] }[];
	33	+};
	34	+export type BreakItem = { label: string; value: number; delta_pct?: number \| null };
	35	+export type Distribution = { id: string; title: string; unit?: string; bins: { label: string; value: number }[] };
	36	+export type Gauge = { id: string; label: string; value: number; max: number; unit?: string; help?: string };
	37	+export type HourCell = { dow: number; hour: number; value: number }; // dow 0=lun … 6=dim
21	38	export type TableSpec = { id: string; title: string; columns: string[]; rows: (string \| number)[][] };
22	39	export type RecordFact = { label: string; value: string; date?: string };
23	40
		`@@ -32,25 +49,63 @@ export const PERIODS: { id: string; label: string }[] = [`
32	49	{ id: "tout", label: "Tout" },
33	50	];
34	51
	52	+export const REPORT_MODES: { id: string; label: string; desc: string }[] = [
	53	+ { id: "complet", label: "Rapport complet", desc: "Toutes les sections — KPI, tendances, répartitions, tableaux, records" },
	54	+ { id: "synthese", label: "Synthèse exécutive", desc: "2 pages — indicateurs clés et faits marquants" },
	55	+ { id: "tendances", label: "Tendances & évolution", desc: "Courbes, comparaisons N-1 et statistiques de séries" },
	56	+ { id: "repartitions", label: "Répartitions & géographie", desc: "Catégories, distributions, régions et activité" },
	57	+ { id: "donnees", label: "Données détaillées", desc: "Tous les tableaux, en version longue" },
	58	+];
	59	+
35	60	export const fmtInt = (n: number) => n.toLocaleString("fr-CA");
36	61	export const fmtNum = (n: number) =>
37	62	Number.isInteger(n) ? fmtInt(n) : n.toLocaleString("fr-CA", { maximumFractionDigits: 2 });
	63	+const fmtPct = (n: number) => `${n >= 0 ? "+" : ""}${fmtNum(n)} %`;
38	64
39		−/* ---------- KPI ---------- */
	65	+/* Styles des séries multiples : couleur + motif de trait (l'identité n'est
	66	+ jamais portée par la couleur seule — règle d'accessibilité). */
	67	+const MULTI_STYLES = [
	68	+ { stroke: "var(--accent)", dash: undefined, width: 2.4 },
	69	+ { stroke: "var(--ink)", dash: undefined, width: 1.6 },
	70	+ { stroke: "var(--accent-deep, var(--accent))", dash: "6 3", width: 2 },
	71	+ { stroke: "var(--ink-3)", dash: "2 3", width: 2 },
	72	+];
	73	+
	74	+/* ---------- KPI (+ sparkline) ---------- */
40	75	export function KpiCard({ k }: { k: Kpi }) {
41	76	const up = (k.direction ?? ((k.delta_pct ?? 0) >= 0 ? "up" : "down")) === "up";
	77	+ const sp = (k.spark ?? []).filter((p) => typeof p.v === "number");
	78	+ const spark = useMemo(() => {
	79	+ if (sp.length < 2) return null;
	80	+ const w = 120, h = 30;
	81	+ const vmax = Math.max(...sp.map((p) => p.v));
	82	+ const vmin = Math.min(...sp.map((p) => p.v));
	83	+ const rng = vmax - vmin \|\| 1;
	84	+ const X = (i: number) => (w * i) / (sp.length - 1);
	85	+ const Y = (v: number) => 2 + (h - 4) * (1 - (v - vmin) / rng);
	86	+ const d = sp.map((p, i) => `${i ? "L" : "M"}${X(i).toFixed(1)},${Y(p.v).toFixed(1)}`).join("");
	87	+ return { w, h, d, area: `${d}L${w},${h}L0,${h}Z` };
	88	+ }, [k.spark]);
42	89	return (
43		− <article className="card" style={{ padding: "14px 16px", minWidth: 0 }}>
	90	+ <article className="card" style={{ padding: "14px 16px", minWidth: 0 }} title={k.help}>
44	91	<p style={{ margin: 0, fontFamily: "var(--font-display)", fontWeight: 700, fontSize: "clamp(22px,2.4vw,30px)", letterSpacing: "-0.02em" }}>
45	92	{typeof k.value === "number" ? fmtNum(k.value) : k.value}
46	93	{k.unit ? <span style={{ fontSize: "0.6em", color: "var(--ink-2)" }}> {k.unit}</span> : null}
47	94	</p>
48	95	<p className="klabel" style={{ margin: "6px 0 0" }}>{k.label}</p>
49		− {k.delta_pct !== undefined && k.delta_pct !== null && (
50		− <p style={{ margin: "8px 0 0", fontFamily: "var(--font-mono)", fontSize: 11, fontWeight: 700, color: up ? "var(--green)" : "var(--danger)" }}>
51		− {up ? "▲" : "▼"} {k.delta_pct >= 0 ? "+" : ""}{fmtNum(k.delta_pct)} % <span style={{ color: "var(--ink-3)", fontWeight: 500 }}>vs période préc.</span>
52		− </p>
53		− )}
	96	+ <div style={{ display: "flex", justifyContent: "space-between", alignItems: "flex-end", gap: 8 }}>
	97	+ {k.delta_pct !== undefined && k.delta_pct !== null ? (
	98	+ <p style={{ margin: "8px 0 0", fontFamily: "var(--font-mono)", fontSize: 11, fontWeight: 700, color: up ? "var(--green)" : "var(--danger)" }}>
	99	+ {up ? "▲" : "▼"} {fmtPct(k.delta_pct)} <span style={{ color: "var(--ink-3)", fontWeight: 500 }}>vs période préc.</span>
	100	+ </p>
	101	+ ) : <span />}
	102	+ {spark && (
	103	+ <svg viewBox={`0 0 ${spark.w} ${spark.h}`} style={{ width: 96, height: 24, flex: "none" }} aria-hidden="true">
	104	+ <path d={spark.area} fill="var(--accent)" opacity={0.14} />
	105	+ <path d={spark.d} fill="none" stroke="var(--accent)" strokeWidth={1.8} />
	106	+ </svg>
	107	+ )}
	108	+ </div>
54	109	</article>
55	110	);
56	111	}
		`@@ -84,12 +139,13 @@ export function PeriodSelector({`
84	139	);
85	140	}
86	141
87		−/* ---------- Courbe ---------- */
	142	+/* ---------- Courbe / aire ---------- */
88	143	export function LineChart({ serie, height = 240 }: { serie: Serie; height?: number }) {
89	144	const [hide, setHide] = useState<{ cur: boolean; cmp: boolean }>({ cur: false, cmp: false });
90	145	const [hover, setHover] = useState<number \| null>(null);
91	146	const W = 720, H = height, PL = 54, PR = 10, PT = 14, PB = 26;
92	147	const pts = serie.points ?? [];
	148	+ if (serie.kind === "bar") return <VBarChart serie={serie} height={height} />;
93	149	if (pts.length < 2) return <EmptyBlock title={serie.title} />;
94	150	const all = [...(hide.cur ? [] : pts), ...(!hide.cmp && serie.compare ? serie.compare : [])];
95	151	const vmax = Math.max(...all.map((p) => p.v), 1);
		`@@ -127,6 +183,9 @@ export function LineChart({ serie, height = 240 }: { serie: Serie; height?: numb`
127	183	{[0, Math.floor(pts.length / 2), pts.length - 1].map((i) => (
128	184	<text key={i} x={X(i, pts.length)} y={H - 8} textAnchor="middle" fontSize={10} fill="var(--ink-3)" fontFamily="var(--font-mono)">{pts[i].t}</text>
129	185	))}
	186	+ {serie.kind === "area" && !hide.cur && (
	187	+ <path d={`${path(pts)}L${X(pts.length - 1, pts.length)},${Y(0)}L${X(0, pts.length)},${Y(0)}Z`} fill="var(--accent)" opacity={0.13} />
	188	+ )}
130	189	{!hide.cmp && serie.compare && serie.compare.length > 1 && (
131	190	<path d={path(serie.compare)} fill="none" stroke="var(--ink-3)" strokeWidth={1.4} strokeDasharray="4 4" />
132	191	)}
		`@@ -148,17 +207,211 @@ export function LineChart({ serie, height = 240 }: { serie: Serie; height?: numb`
148	207	);
149	208	}
150	209
151		−function LegendChip({ label, color, off, dashed, onClick }: { label: string; color: string; off: boolean; dashed?: boolean; onClick: () => void }) {
	210	+function LegendChip({ label, color, off, dashed, onClick }: { label: string; color: string; off?: boolean; dashed?: boolean; onClick?: () => void }) {
152	211	return (
153		− <button type="button" onClick={onClick} aria-pressed={!off}
154		− style={{ display: "inline-flex", alignItems: "center", gap: 6, border: 0, background: "none", cursor: "pointer", opacity: off ? 0.4 : 1, fontFamily: "var(--font-mono)", fontSize: 10.5, fontWeight: 700, textTransform: "uppercase", letterSpacing: "0.06em", minHeight: 44 }}>
	212	+ <button type="button" onClick={onClick} aria-pressed={!off} disabled={!onClick}
	213	+ style={{ display: "inline-flex", alignItems: "center", gap: 6, border: 0, background: "none", cursor: onClick ? "pointer" : "default", opacity: off ? 0.4 : 1, fontFamily: "var(--font-mono)", fontSize: 10.5, fontWeight: 700, textTransform: "uppercase", letterSpacing: "0.06em", minHeight: 44 }}>
155	214	<span style={{ width: 18, height: 0, borderTop: `3px ${dashed ? "dashed" : "solid"} ${color}` }} />
156	215	{label}
157	216	</button>
158	217	);
159	218	}
160	219
161		−/* ---------- Barres horizontales (répartitions, géo) ---------- */
	220	+/* ---------- Multi-courbes (≤ 4 séries, motifs distincts) ---------- */
	221	+export function MultiLineChart({ ms, height = 260 }: { ms: MultiSerie; height?: number }) {
	222	+ const series = (ms.series ?? []).filter((s) => (s.points ?? []).length > 1).slice(0, 4);
	223	+ const [off, setOff] = useState<Record<string, boolean>>({});
	224	+ const [hover, setHover] = useState<number \| null>(null);
	225	+ if (!series.length) return <EmptyBlock title={ms.title} />;
	226	+ const W = 720, H = height, PL = 54, PR = 10, PT = 14, PB = 26;
	227	+ const n = Math.max(...series.map((s) => s.points.length));
	228	+ const shown = series.filter((s) => !off[s.label]);
	229	+ const all = shown.flatMap((s) => s.points.map((p) => p.v));
	230	+ const vmax = Math.max(...(all.length ? all : [1]), 1);
	231	+ const vmin = Math.min(0, ...(all.length ? all : [0]));
	232	+ const X = (i: number, len: number) => PL + ((W - PL - PR) * i) / (len - 1);
	233	+ const Y = (v: number) => PT + (H - PT - PB) * (1 - (v - vmin) / (vmax - vmin \|\| 1));
	234	+ const ref = series[0].points;
	235	+ const hi = hover !== null ? Math.min(n - 1, Math.max(0, hover)) : null;
	236	+ return (
	237	+ <figure className="card" style={{ margin: 0, padding: 16 }}>
	238	+ <figcaption style={{ display: "flex", justifyContent: "space-between", flexWrap: "wrap", gap: 8 }}>
	239	+ <b style={{ fontFamily: "var(--font-display)", fontSize: 15 }}>{ms.title}</b>
	240	+ <span style={{ display: "flex", gap: 10, flexWrap: "wrap" }}>
	241	+ {series.map((s, i) => (
	242	+ <LegendChip key={s.label} label={s.label} color={MULTI_STYLES[i].stroke}
	243	+ dashed={!!MULTI_STYLES[i].dash} off={!!off[s.label]}
	244	+ onClick={() => setOff((o) => ({ ...o, [s.label]: !o[s.label] }))} />
	245	+ ))}
	246	+ </span>
	247	+ </figcaption>
	248	+ <svg viewBox={`0 0 ${W} ${H}`} style={{ width: "100%", height: "auto", marginTop: 10, touchAction: "pan-y" }} role="img" aria-label={ms.title}
	249	+ onMouseMove={(e) => {
	250	+ const r = (e.currentTarget as SVGSVGElement).getBoundingClientRect();
	251	+ const fx = ((e.clientX - r.left) / r.width) * W;
	252	+ setHover(Math.round(((fx - PL) / (W - PL - PR)) * (n - 1)));
	253	+ }}
	254	+ onMouseLeave={() => setHover(null)}>
	255	+ {[0, 1, 2, 3, 4].map((g) => {
	256	+ const y = PT + ((H - PT - PB) * g) / 4;
	257	+ const v = vmax - ((vmax - vmin) * g) / 4;
	258	+ return (
	259	+ <g key={g}>
	260	+ <line x1={PL} x2={W - PR} y1={y} y2={y} stroke="var(--line)" strokeWidth={1} />
	261	+ <text x={PL - 6} y={y + 3} textAnchor="end" fontSize={10} fill="var(--ink-3)" fontFamily="var(--font-mono)">{fmtInt(Math.round(v))}</text>
	262	+ </g>
	263	+ );
	264	+ })}
	265	+ {[0, Math.floor(ref.length / 2), ref.length - 1].map((i) => (
	266	+ <text key={i} x={X(i, ref.length)} y={H - 8} textAnchor="middle" fontSize={10} fill="var(--ink-3)" fontFamily="var(--font-mono)">{ref[i]?.t}</text>
	267	+ ))}
	268	+ {series.map((s, i) => off[s.label] ? null : (
	269	+ <path key={s.label}
	270	+ d={s.points.map((p, j) => `${j ? "L" : "M"}${X(j, s.points.length)},${Y(p.v)}`).join("")}
	271	+ fill="none" stroke={MULTI_STYLES[i].stroke} strokeWidth={MULTI_STYLES[i].width}
	272	+ strokeDasharray={MULTI_STYLES[i].dash} />
	273	+ ))}
	274	+ {hi !== null && (
	275	+ <line x1={X(hi, n)} x2={X(hi, n)} y1={PT} y2={H - PB} stroke="var(--ink)" strokeWidth={1} strokeDasharray="2 3" />
	276	+ )}
	277	+ </svg>
	278	+ {hi !== null && (
	279	+ <p className="chip" style={{ marginTop: 8, display: "inline-flex", gap: 12, flexWrap: "wrap" }}>
	280	+ <b>{ref[hi]?.t}</b>
	281	+ {shown.map((s, i) => (
	282	+ <span key={s.label}>{s.label} : <b>{s.points[hi] ? fmtNum(s.points[hi].v) : "—"}{ms.unit ? ` ${ms.unit}` : ""}</b></span>
	283	+ ))}
	284	+ </p>
	285	+ )}
	286	+ </figure>
	287	+ );
	288	+}
	289	+
	290	+/* ---------- Barres verticales (volumes quotidiens, histogrammes) ---------- */
	291	+export function VBarChart({ serie, height = 240 }: { serie: Serie; height?: number }) {
	292	+ const [hover, setHover] = useState<number \| null>(null);
	293	+ const pts = serie.points ?? [];
	294	+ if (!pts.length) return <EmptyBlock title={serie.title} />;
	295	+ const W = 720, H = height, PL = 54, PR = 10, PT = 14, PB = 26;
	296	+ const vmax = Math.max(...pts.map((p) => p.v), 1);
	297	+ const bw = Math.max(2, (W - PL - PR) / pts.length - 2);
	298	+ return (
	299	+ <figure className="card" style={{ margin: 0, padding: 16 }}>
	300	+ <figcaption><b style={{ fontFamily: "var(--font-display)", fontSize: 15 }}>{serie.title}</b></figcaption>
	301	+ <svg viewBox={`0 0 ${W} ${H}`} style={{ width: "100%", height: "auto", marginTop: 10 }} role="img" aria-label={serie.title}
	302	+ onMouseLeave={() => setHover(null)}>
	303	+ {[0, 1, 2, 3, 4].map((g) => {
	304	+ const y = PT + ((H - PT - PB) * g) / 4;
	305	+ const v = vmax - (vmax * g) / 4;
	306	+ return (
	307	+ <g key={g}>
	308	+ <line x1={PL} x2={W - PR} y1={y} y2={y} stroke="var(--line)" strokeWidth={1} />
	309	+ <text x={PL - 6} y={y + 3} textAnchor="end" fontSize={10} fill="var(--ink-3)" fontFamily="var(--font-mono)">{fmtInt(Math.round(v))}</text>
	310	+ </g>
	311	+ );
	312	+ })}
	313	+ {pts.map((p, i) => {
	314	+ const x = PL + ((W - PL - PR) * i) / pts.length;
	315	+ const h = (H - PT - PB) * (p.v / vmax);
	316	+ return (
	317	+ <rect key={i} x={x + 1} y={H - PB - h} width={bw} height={Math.max(h, p.v > 0 ? 1.5 : 0)} rx={2}
	318	+ fill="var(--accent)" opacity={hover === null \|\| hover === i ? 1 : 0.45}
	319	+ stroke="var(--ink)" strokeWidth={0.5}
	320	+ onMouseEnter={() => setHover(i)}>
	321	+ <title>{`${p.t} — ${fmtNum(p.v)}${serie.unit ? ` ${serie.unit}` : ""}`}</title>
	322	+ </rect>
	323	+ );
	324	+ })}
	325	+ {[0, Math.floor(pts.length / 2), pts.length - 1].filter((v, i, a) => a.indexOf(v) === i).map((i) => (
	326	+ <text key={i} x={PL + ((W - PL - PR) * (i + 0.5)) / pts.length} y={H - 8} textAnchor="middle" fontSize={10} fill="var(--ink-3)" fontFamily="var(--font-mono)">{pts[i].t}</text>
	327	+ ))}
	328	+ </svg>
	329	+ {hover !== null && (
	330	+ <p className="chip" style={{ marginTop: 8 }}>{pts[hover].t} — <b>{fmtNum(pts[hover].v)}{serie.unit ? ` ${serie.unit}` : ""}</b></p>
	331	+ )}
	332	+ </figure>
	333	+ );
	334	+}
	335	+
	336	+/* ---------- Histogramme (distribution) ---------- */
	337	+export function Histogram({ dist }: { dist: Distribution }) {
	338	+ const serie: Serie = {
	339	+ id: dist.id, title: dist.title, unit: dist.unit, kind: "bar",
	340	+ points: (dist.bins ?? []).map((b) => ({ t: b.label, v: b.value })),
	341	+ };
	342	+ return <VBarChart serie={serie} height={220} />;
	343	+}
	344	+
	345	+/* ---------- Barres empilées (composition dans le temps) ---------- */
	346	+export function StackedBarChart({ st, height = 260 }: { st: StackedSerie; height?: number }) {
	347	+ const [hover, setHover] = useState<number \| null>(null);
	348	+ const keys = (st.keys ?? []).slice(0, 6);
	349	+ const pts = st.points ?? [];
	350	+ if (!keys.length \|\| !pts.length) return <EmptyBlock title={st.title} />;
	351	+ const W = 720, H = height, PL = 54, PR = 10, PT = 14, PB = 26;
	352	+ const totals = pts.map((p) => p.values.slice(0, keys.length).reduce((s, v) => s + (v \|\| 0), 0));
	353	+ const vmax = Math.max(...totals, 1);
	354	+ const bw = Math.max(2, (W - PL - PR) / pts.length - 2);
	355	+ const shades = [1, 0.72, 0.5, 0.34, 0.22, 0.13];
	356	+ return (
	357	+ <figure className="card" style={{ margin: 0, padding: 16 }}>
	358	+ <figcaption style={{ display: "flex", justifyContent: "space-between", flexWrap: "wrap", gap: 8 }}>
	359	+ <b style={{ fontFamily: "var(--font-display)", fontSize: 15 }}>{st.title}</b>
	360	+ <span style={{ display: "flex", gap: 10, flexWrap: "wrap" }}>
	361	+ {keys.map((k, i) => (
	362	+ <span key={k} style={{ display: "inline-flex", alignItems: "center", gap: 5, fontFamily: "var(--font-mono)", fontSize: 10.5, fontWeight: 700, textTransform: "uppercase", letterSpacing: "0.06em" }}>
	363	+ <span style={{ width: 11, height: 11, borderRadius: 3, border: "1px solid var(--ink)", background: "var(--accent)", opacity: shades[i] }} />
	364	+ {k}
	365	+ </span>
	366	+ ))}
	367	+ </span>
	368	+ </figcaption>
	369	+ <svg viewBox={`0 0 ${W} ${H}`} style={{ width: "100%", height: "auto", marginTop: 10 }} role="img" aria-label={st.title}
	370	+ onMouseLeave={() => setHover(null)}>
	371	+ {[0, 1, 2, 3, 4].map((g) => {
	372	+ const y = PT + ((H - PT - PB) * g) / 4;
	373	+ return (
	374	+ <g key={g}>
	375	+ <line x1={PL} x2={W - PR} y1={y} y2={y} stroke="var(--line)" strokeWidth={1} />
	376	+ <text x={PL - 6} y={y + 3} textAnchor="end" fontSize={10} fill="var(--ink-3)" fontFamily="var(--font-mono)">{fmtInt(Math.round(vmax - (vmax * g) / 4))}</text>
	377	+ </g>
	378	+ );
	379	+ })}
	380	+ {pts.map((p, i) => {
	381	+ const x = PL + ((W - PL - PR) * i) / pts.length;
	382	+ let yAcc = H - PB;
	383	+ return (
	384	+ <g key={i} onMouseEnter={() => setHover(i)} opacity={hover === null \|\| hover === i ? 1 : 0.5}>
	385	+ {keys.map((k, j) => {
	386	+ const v = p.values[j] \|\| 0;
	387	+ const h = (H - PT - PB) * (v / vmax);
	388	+ yAcc -= h;
	389	+ return v > 0 ? (
	390	+ <rect key={k} x={x + 1} y={yAcc} width={bw} height={Math.max(h - 1, 0.8)} rx={1.5}
	391	+ fill="var(--accent)" opacity={shades[j]} stroke="var(--ink)" strokeWidth={0.4}>
	392	+ <title>{`${p.t} · ${k} — ${fmtNum(v)}${st.unit ? ` ${st.unit}` : ""}`}</title>
	393	+ </rect>
	394	+ ) : null;
	395	+ })}
	396	+ </g>
	397	+ );
	398	+ })}
	399	+ {[0, Math.floor(pts.length / 2), pts.length - 1].filter((v, i, a) => a.indexOf(v) === i).map((i) => (
	400	+ <text key={i} x={PL + ((W - PL - PR) * (i + 0.5)) / pts.length} y={H - 8} textAnchor="middle" fontSize={10} fill="var(--ink-3)" fontFamily="var(--font-mono)">{pts[i].t}</text>
	401	+ ))}
	402	+ </svg>
	403	+ {hover !== null && (
	404	+ <p className="chip" style={{ marginTop: 8, display: "inline-flex", gap: 12, flexWrap: "wrap" }}>
	405	+ <b>{pts[hover].t}</b>
	406	+ {keys.map((k, j) => <span key={k}>{k} : <b>{fmtNum(pts[hover].values[j] \|\| 0)}</b></span>)}
	407	+ <span style={{ color: "var(--ink-3)" }}>total {fmtNum(totals[hover])}</span>
	408	+ </p>
	409	+ )}
	410	+ </figure>
	411	+ );
	412	+}
	413	+
	414	+/* ---------- Barres horizontales (répartitions, géo) — deltas optionnels ---------- */
162	415	export function BarChart({ title, items, unit }: { title: string; items: BreakItem[]; unit?: string }) {
163	416	const rows = (items ?? []).slice(0, 14);
164	417	if (!rows.length) return <EmptyBlock title={title} />;
		`@@ -169,9 +422,16 @@ export function BarChart({ title, items, unit }: { title: string; items: BreakIt`
169	422	<div style={{ marginTop: 12, display: "grid", gap: 9 }}>
170	423	{rows.map((r) => (
171	424	<div key={r.label} title={`${r.label} — ${fmtNum(r.value)}${unit ? ` ${unit}` : ""}`}>
172		− <div style={{ display: "flex", justifyContent: "space-between", fontSize: 12.5 }}>
	425	+ <div style={{ display: "flex", justifyContent: "space-between", gap: 8, fontSize: 12.5 }}>
173	426	<span style={{ overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" }}>{r.label}</span>
174		− <b style={{ fontFamily: "var(--font-mono)", fontSize: 11.5 }}>{fmtNum(r.value)}{unit ? ` ${unit}` : ""}</b>
	427	+ <span style={{ display: "inline-flex", gap: 8, alignItems: "baseline", flex: "none" }}>
	428	+ {r.delta_pct !== undefined && r.delta_pct !== null && (
	429	+ <span style={{ fontFamily: "var(--font-mono)", fontSize: 10, fontWeight: 700, color: r.delta_pct >= 0 ? "var(--green)" : "var(--danger)" }}>
	430	+ {r.delta_pct >= 0 ? "▲" : "▼"} {fmtPct(r.delta_pct)}
	431	+ </span>
	432	+ )}
	433	+ <b style={{ fontFamily: "var(--font-mono)", fontSize: 11.5 }}>{fmtNum(r.value)}{unit ? ` ${unit}` : ""}</b>
	434	+ </span>
175	435	</div>
176	436	<div style={{ marginTop: 3, height: 12, background: "rgba(20,24,20,0.06)", borderRadius: "0 3px 3px 0" }}>
177	437	<div style={{ height: "100%", width: `${Math.max((r.value / max) * 100, 1)}%`, background: "var(--accent)", border: "1px solid var(--ink)", borderRadius: "0 3px 3px 0", boxSizing: "border-box" }} />
		`@@ -224,6 +484,26 @@ export function Donut({ title, items }: { title: string; items: BreakItem[] }) {`
224	484	);
225	485	}
226	486
	487	+/* ---------- Jauge (taux, complétude, couverture) ---------- */
	488	+export function GaugeCard({ g }: { g: Gauge }) {
	489	+ const frac = Math.max(0, Math.min(1, g.max ? g.value / g.max : 0));
	490	+ const R = 60, C = Math.PI * R;
	491	+ return (
	492	+ <article className="card" style={{ padding: "14px 16px", minWidth: 0 }} title={g.help}>
	493	+ <svg viewBox="0 0 150 84" style={{ width: "100%", maxWidth: 190, display: "block", margin: "0 auto" }} role="img" aria-label={`${g.label} : ${fmtNum(g.value)}${g.unit ?? ""} sur ${fmtNum(g.max)}`}>
	494	+ <path d={`M15,75 A${R},${R} 0 0 1 135,75`} fill="none" stroke="rgba(20,24,20,0.08)" strokeWidth={13} strokeLinecap="round" />
	495	+ <path d={`M15,75 A${R},${R} 0 0 1 135,75`} fill="none" stroke="var(--accent)" strokeWidth={13} strokeLinecap="round"
	496	+ strokeDasharray={`${frac * C} ${C}`} />
	497	+ <text x={75} y={66} textAnchor="middle" fontFamily="var(--font-display)" fontWeight={700} fontSize={22} fill="var(--ink)">
	498	+ {fmtNum(g.value)}{g.unit ? <tspan fontSize={12} fill="var(--ink-2)"> {g.unit}</tspan> : null}
	499	+ </text>
	500	+ <text x={75} y={80} textAnchor="middle" fontSize={9} fill="var(--ink-3)" fontFamily="var(--font-mono)">{(frac * 100).toFixed(0)} % de {fmtNum(g.max)}{g.unit ? ` ${g.unit}` : ""}</text>
	501	+ </svg>
	502	+ <p className="klabel" style={{ margin: "8px 0 0", textAlign: "center" }}>{g.label}</p>
	503	+ </article>
	504	+ );
	505	+}
	506	+
227	507	/* ---------- Calendrier de chaleur ---------- */
228	508	export function CalendarHeatmap({ title, cells }: { title: string; cells: { date: string; value: number }[] }) {
229	509	if (!cells?.length) return <EmptyBlock title={title} />;
		`@@ -261,6 +541,64 @@ export function CalendarHeatmap({ title, cells }: { title: string; cells: { date`
261	541	);
262	542	}
263	543
	544	+/* ---------- Heatmap horaire 7 × 24 (activité par heure) ---------- */
	545	+const DOW = ["Lun", "Mar", "Mer", "Jeu", "Ven", "Sam", "Dim"];
	546	+export function HourHeatmap({ title, cells }: { title: string; cells: HourCell[] }) {
	547	+ if (!cells?.length) return <EmptyBlock title={title} />;
	548	+ const grid = new Map(cells.map((c) => [`${c.dow}-${c.hour}`, c.value]));
	549	+ const max = Math.max(...cells.map((c) => c.value), 1);
	550	+ const CW = 24, CH = 20, LX = 34, LY = 16;
	551	+ return (
	552	+ <figure className="card" style={{ margin: 0, padding: 16 }}>
	553	+ <figcaption><b style={{ fontFamily: "var(--font-display)", fontSize: 15 }}>{title}</b> <span className="klabel">jour × heure</span></figcaption>
	554	+ <div className="tbl-wrap" style={{ marginTop: 12 }}>
	555	+ <svg viewBox={`0 0 ${LX + 24 * CW} ${LY + 7 * CH}`} style={{ minWidth: 520, width: "100%", height: "auto" }} role="img" aria-label={title}>
	556	+ {[0, 6, 12, 18, 23].map((h) => (
	557	+ <text key={h} x={LX + h * CW + CW / 2} y={11} textAnchor="middle" fontSize={9} fill="var(--ink-3)" fontFamily="var(--font-mono)">{h} h</text>
	558	+ ))}
	559	+ {DOW.map((d, i) => (
	560	+ <text key={d} x={LX - 6} y={LY + i * CH + CH / 2 + 3} textAnchor="end" fontSize={9} fill="var(--ink-3)" fontFamily="var(--font-mono)">{d}</text>
	561	+ ))}
	562	+ {Array.from({ length: 7 }, (_, d) => Array.from({ length: 24 }, (_, h) => {
	563	+ const v = grid.get(`${d}-${h}`) ?? 0;
	564	+ return (
	565	+ <rect key={`${d}-${h}`} x={LX + h * CW} y={LY + d * CH} width={CW - 2} height={CH - 2} rx={2.5}
	566	+ fill={v ? "var(--accent)" : "rgba(20,24,20,0.07)"} fillOpacity={v ? 0.22 + 0.78 * (v / max) : 1}
	567	+ stroke="rgba(20,24,20,0.15)" strokeWidth={0.5}>
	568	+ <title>{`${DOW[d]} ${h} h — ${fmtNum(v)}`}</title>
	569	+ </rect>
	570	+ );
	571	+ }))}
	572	+ </svg>
	573	+ </div>
	574	+ </figure>
	575	+ );
	576	+}
	577	+
	578	+/* ---------- Statistiques de série (min/max/moy/méd/σ) ---------- */
	579	+export function StatSummary({ serie }: { serie: Serie }) {
	580	+ const vs = (serie.points ?? []).map((p) => p.v).filter((v) => typeof v === "number");
	581	+ if (vs.length < 2) return null;
	582	+ const sorted = [...vs].sort((a, b) => a - b);
	583	+ const mean = vs.reduce((s, v) => s + v, 0) / vs.length;
	584	+ const med = sorted[Math.floor(sorted.length / 2)];
	585	+ const sd = Math.sqrt(vs.reduce((s, v) => s + (v - mean) ** 2, 0) / vs.length);
	586	+ const items: [string, number][] = [
	587	+ ["Min", sorted[0]], ["Max", sorted[sorted.length - 1]],
	588	+ ["Moyenne", Math.round(mean * 100) / 100], ["Médiane", med],
	589	+ ["Écart-type", Math.round(sd * 100) / 100],
	590	+ ];
	591	+ return (
	592	+ <div style={{ display: "flex", flexWrap: "wrap", gap: 8, marginTop: 8 }}>
	593	+ {items.map(([l, v]) => (
	594	+ <span key={l} className="chip" style={{ fontSize: 11 }}>
	595	+ <span style={{ color: "var(--ink-3)" }}>{l}</span> <b style={{ fontFamily: "var(--font-mono)" }}>{fmtNum(v)}</b>
	596	+ </span>
	597	+ ))}
	598	+ </div>
	599	+ );
	600	+}
	601	+
264	602	/* ---------- Tableau : tri, recherche, pagination ---------- */
265	603	export function DataTable({ spec, pageSize = 25 }: { spec: TableSpec; pageSize?: number }) {
266	604	const [q, setQ] = useState("");
		`@@ -338,9 +676,19 @@ export function RecordCard({ r }: { r: RecordFact }) {`
338	676	);
339	677	}
340	678
341		−/* ---------- Bouton PDF ---------- */
	679	+/* ---------- Menu de rapports PDF (5 rapports) ---------- */
342	680	export function PdfButton({ period, from, to, endpoint = "/api/stats/report" }: { period: string; from?: string; to?: string; endpoint?: string }) {
343		− const [busy, setBusy] = useState(false);
	681	+ const [open, setOpen] = useState(false);
	682	+ const [busy, setBusy] = useState<string \| null>(null);
	683	+ const box = useRef<HTMLSpanElement>(null);
	684	+ useEffect(() => {
	685	+ if (!open) return;
	686	+ const close = (e: MouseEvent) => {
	687	+ if (box.current && !box.current.contains(e.target as Node)) setOpen(false);
	688	+ };
	689	+ document.addEventListener("mousedown", close);
	690	+ return () => document.removeEventListener("mousedown", close);
	691	+ }, [open]);
344	692	const url = (mode: string) => {
345	693	const p = new URLSearchParams({ period, mode });
346	694	if (from) p.set("from", from);
		`@@ -348,23 +696,38 @@ export function PdfButton({ period, from, to, endpoint = "/api/stats/report" }:`
348	696	return `${endpoint}?${p}`;
349	697	};
350	698	const dl = (mode: string) => {
351		− setBusy(true);
	699	+ setBusy(mode);
	700	+ setOpen(false);
352	701	const a = document.createElement("a");
353	702	a.href = url(mode);
354	703	a.download = "";
355	704	document.body.appendChild(a);
356	705	a.click();
357	706	a.remove();
358		− setTimeout(() => setBusy(false), 2500);
	707	+ setTimeout(() => setBusy(null), 3000);
359	708	};
360	709	return (
361		− <span style={{ display: "inline-flex", gap: 8, flexWrap: "wrap" }}>
362		− <button type="button" className="btn btn-primary" onClick={() => dl("complet")} disabled={busy}>
363		− {busy ? "Génération…" : "⬇ Télécharger le rapport PDF"}
	710	+ <span ref={box} style={{ position: "relative", display: "inline-flex", gap: 8, flexWrap: "wrap" }}>
	711	+ <button type="button" className="btn btn-primary" onClick={() => dl("complet")} disabled={!!busy}>
	712	+ {busy ? "Génération…" : "⬇ Rapport PDF complet"}
364	713	</button>
365		− <button type="button" className="btn btn-ghost" onClick={() => dl("synthese")} disabled={busy}>
366		− Synthèse (2 p.)
	714	+ <button type="button" className="btn btn-ghost" onClick={() => setOpen((o) => !o)} disabled={!!busy}
	715	+ aria-haspopup="menu" aria-expanded={open}>
	716	+ Autres rapports ▾
367	717	</button>
	718	+ {open && (
	719	+ <div role="menu" className="card" style={{ position: "absolute", top: "calc(100% + 6px)", right: 0, zIndex: 50, minWidth: 300, padding: 6, background: "var(--surface)", boxShadow: "0 10px 28px rgba(20,24,20,0.18)" }}>
	720	+ {REPORT_MODES.map((m) => (
	721	+ <button key={m.id} type="button" role="menuitem" onClick={() => dl(m.id)}
	722	+ style={{ display: "block", width: "100%", textAlign: "left", border: 0, background: "none", cursor: "pointer", padding: "9px 10px", borderRadius: 6 }}
	723	+ onMouseEnter={(e) => (e.currentTarget.style.background = "var(--surface-2)")}
	724	+ onMouseLeave={(e) => (e.currentTarget.style.background = "none")}>
	725	+ <b style={{ display: "block", fontSize: 13, fontFamily: "var(--font-display)" }}>{m.label}</b>
	726	+ <span className="klabel" style={{ fontSize: 11 }}>{m.desc}</span>
	727	+ </button>
	728	+ ))}
	729	+ </div>
	730	+ )}
368	731	</span>
369	732	);
370	733	}

modified src/ka/stats/kapdf.py +390 −71

		`@@ -1,10 +1,17 @@`
1	1	# Auteur : Simon-Pierre Boucher — contact@spboucher.ai
2		−# ka-ui/stats/kapdf.py — moteur PDF commun Groupe KA (fpdf2).
	2	+# ka-ui/stats/kapdf.py — moteur PDF commun Groupe KA (fpdf2). v2
3	3	# Consomme le JSON du contrat /api/stats/dashboard (voir SPEC.md) et produit
4		−# le rapport estampillé Groupe-KA : couverture, sommaire, KPI, graphiques
5		−# VECTORIELS (courbes/barres/anneaux), tableaux paginés, records, page de fin.
	4	+# les rapports estampillés Groupe-KA. 5 modes :
	5	+# complet — toutes les sections (KPI, jauges, séries + stats, multi-
	6	+# séries, empilées, distributions, répartitions, géo,
	7	+# heatmap horaire, tableaux, records)
	8	+# synthese — couverture + KPI + records (2-3 pages)
	9	+# tendances — KPI + toutes les séries temporelles + stats de séries
	10	+# repartitions — breakdowns, distributions, géo, activité horaire
	11	+# donnees — tous les tableaux en version longue (400 lignes max)
	12	+# Graphiques VECTORIELS uniquement (primitives fpdf), accent de la marque.
6	13	# Usage :
7		−# from kapdf import GroupeKAReport
	14	+# from kapdf import GroupeKAReport, REPORT_MODES, filename
8	15	# pdf_bytes = GroupeKAReport(site={"wordmark":"Lou·Ka","accent":"#ff6a00",
9	16	# "domain":"www.lou-ka.com","tagline":"…"}, dashboard=dash_json,
10	17	# mode="complet").build()
		`@@ -26,6 +33,14 @@ GREEN = (28, 92, 65)`
26	33	DANGER = (179, 66, 58)
27	34	WHITE = (255, 255, 255)
28	35
	36	+REPORT_MODES = {
	37	+ "complet": "Rapport complet",
	38	+ "synthese": "Synthèse exécutive",
	39	+ "tendances": "Tendances & évolution",
	40	+ "repartitions": "Répartitions & géographie",
	41	+ "donnees": "Données détaillées",
	42	+}
	43	+
29	44	EMAILS = [
30	45	("contact@groupe-ka.com", "Projets, partenariats & données"),
31	46	("info@groupe-ka.com", "Médias & questions générales"),
		`@@ -52,7 +67,8 @@ def _fr(n) -> str:`
52	67	_SUBST = {
53	68	"—": "-", "–": "-", "→": "->", "▲": "+", "▼": "-",
54	69	"…": "...", "’": "'", "‘": "'", "“": '"', "”": '"',
55		− "œ": "oe", "Œ": "OE", "−": "-", " ": " ", " ": " ",
	70	+ "œ": "oe", "Œ": "OE", "−": "-", " ": " ", " ": " ",
	71	+ "×": "x", "·": ".", "σ": "sigma", "Δ": "delta",
56	72	}
57	73
58	74
		`@@ -79,7 +95,7 @@ class _PDF(FPDF):`
79	95	self.set_auto_page_break(True, margin=22)
80	96
81	97	def header(self):
82		− if self.cover_mode:
	98	+ if self.cover_mode or self.page_no() == 1:
83	99	return
84	100	self.set_font("helvetica", "B", 8.5)
85	101	self.set_text_color(*INK)
		`@@ -95,7 +111,9 @@ class _PDF(FPDF):`
95	111	self.set_y(20)
96	112
97	113	def footer(self):
98		− if self.cover_mode:
	114	+ # page 1 = couverture (le flag cover_mode est déjà retombé quand
	115	+ # add_page() clôt la page 1 → tester aussi le numéro de page)
	116	+ if self.cover_mode or self.page_no() == 1:
99	117	return
100	118	self.set_y(-15)
101	119	self.set_draw_color(*INK3)
		`@@ -112,7 +130,7 @@ class GroupeKAReport:`
112	130	def __init__(self, site: dict, dashboard: dict, mode: str = "complet"):
113	131	self.site = site
114	132	self.d = dashboard
115		− self.mode = mode
	133	+ self.mode = mode if mode in REPORT_MODES else "complet"
116	134	self.accent = _hex(site.get("accent", "#d9f26b"))
117	135	period = dashboard.get("period", {}) or {}
118	136	self.period_label = period.get("label") or "toute la période"
		`@@ -127,6 +145,11 @@ class GroupeKAReport:`
127	145	p.set_fill_color(*fill)
128	146	p.rect(x, y, w, h, style="DF", round_corners=True, corner_radius=2.2)
129	147
	148	+ def _shade(self, i, n=8):
	149	+ shades = [1.0, 0.78, 0.58, 0.42, 0.30, 0.22, 0.15, 0.10]
	150	+ f = shades[i % len(shades)]
	151	+ return tuple(int(PAPER[j] + (self.accent[j] - PAPER[j]) * f) for j in range(3))
	152	+
130	153	def _kicker(self, text):
131	154	p = self.pdf
132	155	p.set_font("helvetica", "B", 8)
		`@@ -150,6 +173,14 @@ class GroupeKAReport:`
150	173	self.toc.append((title, self.pdf.page_no()))
151	174	self.pdf.ln(11)
152	175
	176	+ def _chart_title(self, title):
	177	+ p = self.pdf
	178	+ p.set_font("helvetica", "B", 10)
	179	+ p.set_text_color(*INK)
	180	+ p.set_x(p.l_margin)
	181	+ p.cell(0, 6, title)
	182	+ p.ln(7)
	183	+
153	184	# ---------- pages ----------
154	185	def _cover(self):
155	186	p = self.pdf
		`@@ -161,12 +192,10 @@ class GroupeKAReport:`
161	192	p.set_draw_color(*INK)
162	193	p.set_line_width(1.0)
163	194	p.rect(10, 10, 190, 277)
164		− # kicker
165	195	p.set_font("helvetica", "B", 10)
166	196	p.set_text_color(*GREEN)
167	197	p.set_xy(24, 34)
168	198	p.cell(0, 6, "GROUPE KA · RAPPORT STATISTIQUE")
169		− # wordmark : partie gauche + boîte encre/accent
170	199	wm = self.site.get("wordmark", "")
171	200	left, boxed = (wm.split("·") + [None])[:2] if "·" in wm else (wm, None)
172	201	p.set_xy(24, 70)
		`@@ -184,7 +213,7 @@ class GroupeKAReport:`
184	213	p.set_xy(24, 100)
185	214	p.set_font("helvetica", "", 13)
186	215	p.set_text_color(*INK2)
187		− p.multi_cell(150, 7, f"Rapport statistique — {wm}")
	216	+ p.multi_cell(150, 7, f"{REPORT_MODES[self.mode]} — {wm}")
188	217	now = datetime.now(ZoneInfo("America/Toronto"))
189	218	per = self.d.get("period", {}) or {}
190	219	p.set_xy(24, 125)
		`@@ -193,7 +222,7 @@ class GroupeKAReport:`
193	222	("Période couverte", self.period_label + (f" ({per.get('from')} → {per.get('to')})" if per.get("from") else "")),
194	223	("Généré le", now.strftime("%Y-%m-%d à %H:%M") + " (heure de l'Est)"),
195	224	("Plateforme", "https://" + self.site.get("domain", "")),
196		− ("Mode", "Rapport complet" if self.mode == "complet" else "Synthèse"),
	225	+ ("Type de rapport", REPORT_MODES[self.mode]),
197	226	]
198	227	y = 128
199	228	for k, v in rows:
		`@@ -205,7 +234,6 @@ class GroupeKAReport:`
205	234	p.cell(0, 6, str(v))
206	235	p.set_font("helvetica", "", 10.5)
207	236	y += 8
208		− # bande encre au pied
209	237	p.set_fill_color(*INK)
210	238	p.rect(10, 262, 190, 25, style="F")
211	239	p.set_xy(24, 270)
		`@@ -230,7 +258,7 @@ class GroupeKAReport:`
230	258	p = self.pdf
231	259	cols, gw, gh, gap = 3, 56, 26, 3
232	260	x0, y = p.l_margin, p.get_y()
233		− for i, k in enumerate(kpis[:9]):
	261	+ for i, k in enumerate(kpis[:12]):
234	262	x = x0 + (i % cols) * (gw + gap)
235	263	if i and i % cols == 0:
236	264	y += gh + gap
		`@@ -252,20 +280,81 @@ class GroupeKAReport:`
252	280	p.set_font("helvetica", "B", 8)
253	281	p.set_text_color(*(GREEN if up else DANGER))
254	282	arrow = "+" if k["delta_pct"] >= 0 else ""
255		− p.cell(gw - 8, 4, f"{'▲' if up else '▼'} {arrow}{str(k['delta_pct']).replace('.', ',')} % vs période préc.")
	283	+ dv = round(float(k["delta_pct"]), 1)
	284	+ dv = int(dv) if float(dv).is_integer() else dv
	285	+ p.cell(gw - 8, 4, f"{'▲' if up else '▼'} {arrow}{str(dv).replace('.', ',')} % vs période préc.")
256	286	p.set_y(y + gh + 8)
257	287
258		− def _line_chart(self, s):
	288	+ def _gauges(self):
	289	+ gs = self.d.get("gauges") or []
	290	+ gs = [g for g in gs if isinstance(g.get("value"), (int, float)) and g.get("max")]
	291	+ if not gs:
	292	+ return
	293	+ self._section_title("Taux & couvertures")
	294	+ p = self.pdf
	295	+ cols, gw, gh, gap = 3, 56, 34, 3
	296	+ x0, y = p.l_margin, p.get_y()
	297	+ for i, g in enumerate(gs[:9]):
	298	+ x = x0 + (i % cols) * (gw + gap)
	299	+ if i and i % cols == 0:
	300	+ y += gh + gap
	301	+ if y > 240:
	302	+ p.add_page(); y = p.get_y()
	303	+ self._card(x, y, gw, gh)
	304	+ frac = max(0.0, min(1.0, g["value"] / g["max"]))
	305	+ cx, cy, r = x + gw / 2, y + 20, 14
	306	+ # arc de fond + arc de valeur (demi-cercle en petits segments)
	307	+ for pass_col, pass_frac, lw in (((225, 223, 217), 1.0, 2.6), (self.accent, frac, 2.6)):
	308	+ p.set_draw_color(*pass_col)
	309	+ p.set_line_width(lw)
	310	+ steps = max(2, int(60 * pass_frac))
	311	+ last = None
	312	+ for st in range(steps + 1):
	313	+ a = math.pi + math.pi * pass_frac * st / steps
	314	+ pt = (cx + r * math.cos(a), cy + r * math.sin(a))
	315	+ if last:
	316	+ p.line(last[0], last[1], pt[0], pt[1])
	317	+ last = pt
	318	+ p.set_font("helvetica", "B", 11)
	319	+ p.set_text_color(*INK)
	320	+ p.set_xy(x + 4, cy - 5)
	321	+ p.cell(gw - 8, 6, f"{_fr(g['value'])}{' ' + g['unit'] if g.get('unit') else ''}", align="C")
	322	+ p.set_font("helvetica", "", 6.6)
	323	+ p.set_text_color(*INK3)
	324	+ p.set_xy(x + 4, cy + 1.5)
	325	+ p.cell(gw - 8, 4, f"{frac * 100:.0f} % de {_fr(g['max'])}", align="C")
	326	+ p.set_xy(x + 3, y + gh - 7)
	327	+ p.set_font("helvetica", "", 7)
	328	+ p.set_text_color(*INK2)
	329	+ p.multi_cell(gw - 6, 3.3, str(g.get("label", ""))[:60], align="C")
	330	+ p.set_y(y + gh + 8)
	331	+
	332	+ def _serie_stats_row(self, s):
	333	+ """Ligne min/max/moyenne/médiane sous un graphique de série."""
	334	+ p = self.pdf
	335	+ vs = [pt["v"] for pt in (s.get("points") or []) if isinstance(pt.get("v"), (int, float))]
	336	+ if len(vs) < 2:
	337	+ return
	338	+ sv = sorted(vs)
	339	+ mean = sum(vs) / len(vs)
	340	+ med = sv[len(sv) // 2]
	341	+ sd = math.sqrt(sum((v - mean) ** 2 for v in vs) / len(vs))
	342	+ p.set_font("helvetica", "", 6.8)
	343	+ p.set_text_color(*INK3)
	344	+ p.cell(0, 4, f"min {_fr(sv[0])} · max {_fr(sv[-1])} · moyenne {_fr(round(mean, 2))} · médiane {_fr(med)} · écart-type {_fr(round(sd, 2))}")
	345	+ p.ln(5.5)
	346	+
	347	+ def _line_chart(self, s, with_stats=False):
259	348	p = self.pdf
260	349	pts = s.get("points") or []
261	350	if len(pts) < 2:
262	351	return
	352	+ if s.get("kind") == "bar":
	353	+ self._vbars(s)
	354	+ return
263	355	if p.get_y() > 200:
264	356	p.add_page()
265		− p.set_font("helvetica", "B", 10)
266		− p.set_text_color(*INK)
267		− p.cell(0, 6, s.get("title", ""))
268		− p.ln(7)
	357	+ self._chart_title(s.get("title", ""))
269	358	x0, y0, w, h = p.l_margin, p.get_y(), 174, 52
270	359	self._card(x0, y0, w, h, fill=WHITE)
271	360	cx, cy, cw, ch = x0 + 12, y0 + 6, w - 20, h - 16
		`@@ -273,7 +362,6 @@ class GroupeKAReport:`
273	362	vmax = max(vals) or 1
274	363	vmin = min(0, min(vals))
275	364	rng = (vmax - vmin) or 1
276		− # grille + graduations
277	365	p.set_font("helvetica", "", 6.3)
278	366	p.set_text_color(*INK3)
279	367	p.set_draw_color(200, 200, 195)
		`@@ -284,6 +372,20 @@ class GroupeKAReport:`
284	372	p.set_xy(x0 + 1, gy - 1.6)
285	373	p.cell(10, 3, _fr(vmin + rng * g / 4), align="R")
286	374
	375	+ def xy(i, n, v):
	376	+ return (cx + cw * (i / (n - 1)), cy + ch - ch * ((v - vmin) / rng))
	377	+
	378	+ # aire sous la courbe (kind=area) : petits trapèzes accent pâle
	379	+ if s.get("kind") == "area":
	380	+ fill = tuple(int(PAPER[j] + (self.accent[j] - PAPER[j]) * 0.18) for j in range(3))
	381	+ p.set_fill_color(*fill)
	382	+ p.set_draw_color(*fill)
	383	+ n = len(pts)
	384	+ for i in range(n - 1):
	385	+ x1, y1 = xy(i, n, pts[i]["v"])
	386	+ x2, y2 = xy(i + 1, n, pts[i + 1]["v"])
	387	+ p.polygon([(x1, y1), (x2, y2), (x2, cy + ch), (x1, cy + ch)], style="DF")
	388	+
287	389	def draw(series, color, width, dash=None):
288	390	n = len(series)
289	391	p.set_draw_color(*color)
		`@@ -292,8 +394,7 @@ class GroupeKAReport:`
292	394	p.set_dash_pattern(dash=1.2, gap=1.2)
293	395	last = None
294	396	for i, pt in enumerate(series):
295		− px = cx + cw * (i / (n - 1))
296		− py = cy + ch - ch * ((pt["v"] - vmin) / rng)
	397	+ px, py = xy(i, n, pt["v"])
297	398	if last:
298	399	p.line(last[0], last[1], px, py)
299	400	last = (px, py)
		`@@ -302,7 +403,6 @@ class GroupeKAReport:`
302	403	if s.get("compare"):
303	404	draw(s["compare"], INK3, 0.35, dash=True)
304	405	draw(pts, self.accent, 0.7)
305		− # libellés d'axe X (premier / milieu / dernier)
306	406	p.set_text_color(*INK3)
307	407	for frac, idx in ((0, 0), (0.5, len(pts) // 2), (1, -1)):
308	408	p.set_xy(cx + cw * frac - 9, cy + ch + 1.5)
		`@@ -312,9 +412,166 @@ class GroupeKAReport:`
312	412	p.set_font("helvetica", "", 6.8)
313	413	p.set_text_color(*INK3)
314	414	p.cell(0, 4, "— période courante (accent) · ---- période comparée")
315		− p.ln(6)
316		− else:
317		− p.ln(2)
	415	+ p.ln(5.5)
	416	+ if with_stats:
	417	+ self._serie_stats_row(s)
	418	+ p.ln(1.5)
	419	+
	420	+ def _vbars(self, s):
	421	+ """Barres verticales : série kind=bar ou distribution (bins)."""
	422	+ p = self.pdf
	423	+ pts = s.get("points") or [{"t": b.get("label"), "v": b.get("value")} for b in (s.get("bins") or [])]
	424	+ pts = [pt for pt in pts if isinstance(pt.get("v"), (int, float))]
	425	+ if not pts:
	426	+ return
	427	+ if p.get_y() > 205:
	428	+ p.add_page()
	429	+ self._chart_title(s.get("title", ""))
	430	+ x0, y0, w, h = p.l_margin, p.get_y(), 174, 48
	431	+ self._card(x0, y0, w, h, fill=WHITE)
	432	+ cx, cy, cw, ch = x0 + 12, y0 + 5, w - 20, h - 14
	433	+ vmax = max(pt["v"] for pt in pts) or 1
	434	+ p.set_font("helvetica", "", 6.3)
	435	+ p.set_text_color(*INK3)
	436	+ p.set_draw_color(200, 200, 195)
	437	+ p.set_line_width(0.15)
	438	+ for g in range(5):
	439	+ gy = cy + ch - ch * g / 4
	440	+ p.line(cx, gy, cx + cw, gy)
	441	+ p.set_xy(x0 + 1, gy - 1.6)
	442	+ p.cell(10, 3, _fr(vmax * g / 4), align="R")
	443	+ n = len(pts)
	444	+ bw = max(0.8, cw / n - 0.6)
	445	+ p.set_fill_color(*self.accent)
	446	+ p.set_draw_color(*INK)
	447	+ p.set_line_width(0.15)
	448	+ for i, pt in enumerate(pts):
	449	+ bh = ch * (pt["v"] / vmax)
	450	+ p.rect(cx + cw * i / n + 0.3, cy + ch - bh, bw, max(bh, 0.4 if pt["v"] > 0 else 0), style="DF")
	451	+ p.set_text_color(*INK3)
	452	+ for frac, idx in ((0, 0), (0.5, n // 2), (1, -1)):
	453	+ p.set_xy(cx + cw * frac - 10, cy + ch + 1.5)
	454	+ p.cell(20, 3, str(pts[idx].get("t", ""))[:12], align="C")
	455	+ p.set_y(y0 + h + 5)
	456	+
	457	+ def _multiline(self, ms):
	458	+ """Multi-séries (≤4) : accent plein / encre fin / accent pointillé /
	459	+ gris pointillé — l'identité passe par le motif, pas la couleur seule."""
	460	+ p = self.pdf
	461	+ series = [s for s in (ms.get("series") or []) if len(s.get("points") or []) > 1][:4]
	462	+ if not series:
	463	+ return
	464	+ if p.get_y() > 195:
	465	+ p.add_page()
	466	+ self._chart_title(ms.get("title", ""))
	467	+ x0, y0, w, h = p.l_margin, p.get_y(), 174, 52
	468	+ self._card(x0, y0, w, h, fill=WHITE)
	469	+ cx, cy, cw, ch = x0 + 12, y0 + 6, w - 20, h - 16
	470	+ vals = [pt["v"] for s in series for pt in s["points"]]
	471	+ vmax = max(vals) or 1
	472	+ vmin = min(0, min(vals))
	473	+ rng = (vmax - vmin) or 1
	474	+ p.set_font("helvetica", "", 6.3)
	475	+ p.set_text_color(*INK3)
	476	+ p.set_draw_color(200, 200, 195)
	477	+ p.set_line_width(0.15)
	478	+ for g in range(5):
	479	+ gy = cy + ch - ch * g / 4
	480	+ p.line(cx, gy, cx + cw, gy)
	481	+ p.set_xy(x0 + 1, gy - 1.6)
	482	+ p.cell(10, 3, _fr(vmin + rng * g / 4), align="R")
	483	+ styles = [
	484	+ (self.accent, 0.7, None),
	485	+ (INK, 0.45, None),
	486	+ (self.accent, 0.55, True),
	487	+ (INK3, 0.5, True),
	488	+ ]
	489	+ for si, s in enumerate(series):
	490	+ col, lw, dash = styles[si]
	491	+ p.set_draw_color(*col)
	492	+ p.set_line_width(lw)
	493	+ if dash:
	494	+ p.set_dash_pattern(dash=1.4, gap=1.2)
	495	+ n = len(s["points"])
	496	+ last = None
	497	+ for i, pt in enumerate(s["points"]):
	498	+ px = cx + cw * (i / (n - 1))
	499	+ py = cy + ch - ch * ((pt["v"] - vmin) / rng)
	500	+ if last:
	501	+ p.line(last[0], last[1], px, py)
	502	+ last = (px, py)
	503	+ p.set_dash_pattern()
	504	+ ref = series[0]["points"]
	505	+ p.set_text_color(*INK3)
	506	+ for frac, idx in ((0, 0), (0.5, len(ref) // 2), (1, -1)):
	507	+ p.set_xy(cx + cw * frac - 9, cy + ch + 1.5)
	508	+ p.cell(18, 3, str(ref[idx].get("t", ""))[:10], align="C")
	509	+ p.set_y(y0 + h + 4)
	510	+ p.set_font("helvetica", "", 6.8)
	511	+ p.set_text_color(*INK3)
	512	+ marks = ["—", "—", "----", "----"]
	513	+ leg = " · ".join(f"{marks[i]} {s.get('label', '')}" for i, s in enumerate(series))
	514	+ p.cell(0, 4, leg[:120])
	515	+ p.ln(6)
	516	+
	517	+ def _stacked(self, st):
	518	+ p = self.pdf
	519	+ keys = (st.get("keys") or [])[:6]
	520	+ pts = st.get("points") or []
	521	+ if not keys or not pts:
	522	+ return
	523	+ if p.get_y() > 195:
	524	+ p.add_page()
	525	+ self._chart_title(st.get("title", ""))
	526	+ x0, y0, w, h = p.l_margin, p.get_y(), 174, 52
	527	+ self._card(x0, y0, w, h, fill=WHITE)
	528	+ cx, cy, cw, ch = x0 + 12, y0 + 6, w - 20, h - 16
	529	+ totals = [sum(v or 0 for v in pt.get("values", [])[: len(keys)]) for pt in pts]
	530	+ vmax = max(totals) or 1
	531	+ p.set_font("helvetica", "", 6.3)
	532	+ p.set_text_color(*INK3)
	533	+ p.set_draw_color(200, 200, 195)
	534	+ p.set_line_width(0.15)
	535	+ for g in range(5):
	536	+ gy = cy + ch - ch * g / 4
	537	+ p.line(cx, gy, cx + cw, gy)
	538	+ p.set_xy(x0 + 1, gy - 1.6)
	539	+ p.cell(10, 3, _fr(vmax * g / 4), align="R")
	540	+ n = len(pts)
	541	+ bw = max(0.8, cw / n - 0.6)
	542	+ p.set_draw_color(*WHITE)
	543	+ p.set_line_width(0.12)
	544	+ for i, pt in enumerate(pts):
	545	+ yacc = cy + ch
	546	+ for j, k in enumerate(keys):
	547	+ v = (pt.get("values") or [0] * len(keys))[j] if j < len(pt.get("values", [])) else 0
	548	+ if not v:
	549	+ continue
	550	+ bh = ch * (v / vmax)
	551	+ yacc -= bh
	552	+ p.set_fill_color(*self._shade(j))
	553	+ p.rect(cx + cw * i / n + 0.3, yacc, bw, max(bh - 0.15, 0.3), style="DF")
	554	+ p.set_text_color(*INK3)
	555	+ for frac, idx in ((0, 0), (0.5, n // 2), (1, -1)):
	556	+ p.set_xy(cx + cw * frac - 10, cy + ch + 1.5)
	557	+ p.cell(20, 3, str(pts[idx].get("t", ""))[:12], align="C")
	558	+ p.set_y(y0 + h + 4)
	559	+ # légende
	560	+ p.set_font("helvetica", "", 6.8)
	561	+ lx = p.l_margin
	562	+ for j, k in enumerate(keys):
	563	+ p.set_fill_color(*self._shade(j))
	564	+ p.set_draw_color(*INK)
	565	+ p.set_line_width(0.2)
	566	+ p.rect(lx, p.get_y() + 0.6, 3, 3, style="DF")
	567	+ p.set_xy(lx + 4, p.get_y())
	568	+ p.set_text_color(*INK2)
	569	+ txt = str(k)[:22]
	570	+ p.cell(p.get_string_width(txt) + 3, 4, txt)
	571	+ lx = p.get_x() + 3
	572	+ if lx > 165:
	573	+ break
	574	+ p.ln(7)
318	575
319	576	def _bars(self, title, items, unit=""):
320	577	p = self.pdf
		`@@ -324,10 +581,8 @@ class GroupeKAReport:`
324	581	need = 10 + len(items) * 7
325	582	if p.get_y() + need > 265:
326	583	p.add_page()
327		− p.set_font("helvetica", "B", 10)
328		− p.set_text_color(*INK)
329		− p.cell(0, 6, title)
330		− p.ln(8)
	584	+ self._chart_title(title)
	585	+ p.ln(1)
331	586	vmax = max(it["value"] for it in items) or 1
332	587	for it in items:
333	588	y = p.get_y()
		`@@ -335,19 +590,23 @@ class GroupeKAReport:`
335	590	p.set_text_color(*INK)
336	591	p.set_x(p.l_margin)
337	592	p.cell(46, 5, str(it["label"])[:34])
338		− bw = 96 * (it["value"] / vmax)
	593	+ bw = 86 * (it["value"] / vmax)
339	594	p.set_fill_color(*self.accent)
340	595	p.set_draw_color(*INK)
341	596	p.set_line_width(0.25)
342	597	p.rect(p.l_margin + 48, y + 0.7, max(bw, 0.8), 3.6, style="DF")
343		− p.set_xy(p.l_margin + 148, y)
	598	+ p.set_xy(p.l_margin + 136, y)
344	599	p.set_font("helvetica", "B", 7.6)
345		− p.cell(26, 5, _fr(it["value"]) + (" " + unit if unit else ""), align="R")
	600	+ p.cell(24, 5, _fr(it["value"]) + (" " + unit if unit else ""), align="R")
	601	+ if it.get("delta_pct") is not None:
	602	+ up = it["delta_pct"] >= 0
	603	+ p.set_font("helvetica", "B", 6.6)
	604	+ p.set_text_color(*(GREEN if up else DANGER))
	605	+ p.cell(14, 5, f"{'+' if up else ''}{str(round(it['delta_pct'], 1)).replace('.', ',')} %", align="R")
346	606	p.ln(6.4)
347	607	p.ln(3)
348	608
349	609	def _donut(self, b):
350		− # anneau vectoriel simple (arcs) + légende
351	610	p = self.pdf
352	611	items = [it for it in (b.get("items") or []) if it.get("value")][:8]
353	612	total = sum(it["value"] for it in items)
		`@@ -355,17 +614,13 @@ class GroupeKAReport:`
355	614	return
356	615	if p.get_y() > 210:
357	616	p.add_page()
358		− p.set_font("helvetica", "B", 10)
359		− p.set_text_color(*INK)
360		− p.cell(0, 6, b.get("title", ""))
361		− p.ln(8)
	617	+ self._chart_title(b.get("title", ""))
	618	+ p.ln(1)
362	619	cx, cy, r = p.l_margin + 26, p.get_y() + 24, 20
363		− shades = [1.0, 0.78, 0.58, 0.42, 0.30, 0.22, 0.15, 0.10]
364	620	start = -90.0
365	621	for i, it in enumerate(items):
366	622	frac = it["value"] / total
367		− f = shades[i % len(shades)]
368		− col = tuple(int(PAPER[j] + (self.accent[j] - PAPER[j]) * f) for j in range(3))
	623	+ col = self._shade(i)
369	624	steps = max(2, int(72 * frac))
370	625	p.set_fill_color(*col)
371	626	p.set_draw_color(*col)
		`@@ -384,11 +639,9 @@ class GroupeKAReport:`
384	639	p.set_line_width(0.4)
385	640	p.ellipse(cx - 11, cy - 11, 22, 22, style="DF")
386	641	p.ellipse(cx - r, cy - r, 2 * r, 2 * r, style="D")
387		− # légende
388	642	ly = cy - 22
389	643	for i, it in enumerate(items):
390		− f = shades[i % len(shades)]
391		− col = tuple(int(PAPER[j] + (self.accent[j] - PAPER[j]) * f) for j in range(3))
	644	+ col = self._shade(i)
392	645	p.set_fill_color(*col)
393	646	p.set_draw_color(*INK)
394	647	p.rect(p.l_margin + 60, ly + 0.8, 4, 4, style="DF")
		`@@ -400,7 +653,39 @@ class GroupeKAReport:`
400	653	ly += 5.6
401	654	p.set_y(max(cy + r, ly) + 6)
402	655
403		− def _table(self, t):
	656	+ def _hourly(self):
	657	+ hh = self.d.get("hourly") or {}
	658	+ cells = hh.get("cells") or []
	659	+ if not cells:
	660	+ return
	661	+ p = self.pdf
	662	+ if p.get_y() > 190:
	663	+ p.add_page()
	664	+ self._chart_title(hh.get("title", "Activité par jour et heure"))
	665	+ x0, y0 = p.l_margin, p.get_y()
	666	+ cw, chh, lx, ly = 6.4, 6.4, 12, 5
	667	+ vmax = max((c.get("value") or 0) for c in cells) or 1
	668	+ grid = {(c.get("dow"), c.get("hour")): c.get("value") or 0 for c in cells}
	669	+ dows = ["Lun", "Mar", "Mer", "Jeu", "Ven", "Sam", "Dim"]
	670	+ p.set_font("helvetica", "", 5.8)
	671	+ p.set_text_color(*INK3)
	672	+ for h in (0, 6, 12, 18, 23):
	673	+ p.set_xy(x0 + lx + h * cw, y0)
	674	+ p.cell(cw, 3, f"{h}h", align="C")
	675	+ for d in range(7):
	676	+ p.set_xy(x0, y0 + ly + d * chh + 1.5)
	677	+ p.cell(lx - 1, 3, dows[d], align="R")
	678	+ for h in range(24):
	679	+ v = grid.get((d, h), 0)
	680	+ f = 0.1 + 0.9 * (v / vmax) if v else 0.0
	681	+ col = tuple(int(PAPER[j] + (self.accent[j] - PAPER[j]) * f) for j in range(3)) if v else (235, 233, 228)
	682	+ p.set_fill_color(*col)
	683	+ p.set_draw_color(215, 213, 207)
	684	+ p.set_line_width(0.1)
	685	+ p.rect(x0 + lx + h * cw, y0 + ly + d * chh, cw - 0.5, chh - 0.5, style="DF")
	686	+ p.set_y(y0 + ly + 7 * chh + 5)
	687	+
	688	+ def _table(self, t, max_rows=200):
404	689	p = self.pdf
405	690	cols = t.get("columns") or []
406	691	rows = t.get("rows") or []
		`@@ -417,7 +702,7 @@ class GroupeKAReport:`
417	702	p.ln(6)
418	703	head()
419	704	p.set_text_color(*INK)
420		− for i, row in enumerate(rows[:200]):
	705	+ for i, row in enumerate(rows[:max_rows]):
421	706	if p.get_y() > 262:
422	707	p.add_page()
423	708	head()
		`@@ -428,10 +713,10 @@ class GroupeKAReport:`
428	713	txt = _fr(cell) if isinstance(cell, (int, float)) else str(cell)
429	714	p.cell(w, 5.4, " " + txt[:34], fill=True)
430	715	p.ln(5.4)
431		− if len(rows) > 200:
	716	+ if len(rows) > max_rows:
432	717	p.set_font("helvetica", "", 7)
433	718	p.set_text_color(*INK3)
434		− p.cell(0, 5, f"… {len(rows) - 200} lignes supplémentaires non imprimées")
	719	+ p.cell(0, 5, f"… {len(rows) - max_rows} lignes supplémentaires non imprimées")
435	720	p.ln(6)
436	721
437	722	def _records(self):
		`@@ -440,7 +725,7 @@ class GroupeKAReport:`
440	725	return
441	726	self._section_title("Records & faits marquants")
442	727	p = self.pdf
443		− for r in recs[:10]:
	728	+ for r in recs[:14]:
444	729	if p.get_y() > 258:
445	730	p.add_page()
446	731	y = p.get_y()
		`@@ -498,43 +783,76 @@ class GroupeKAReport:`
498	783	"groupe-ka.com/conditions · /confidentialite · /loi-25.",
499	784	)
500	785
501		− def _toc_page(self):
502		− # insérée après coup ? fpdf ne réordonne pas : on écrit le sommaire en
503		− # page 2 en réservant la page lors du build (voir build()).
504		− pass
	786	+ # ---------- groupes de sections ----------
	787	+ def _all_series(self, with_stats=True):
	788	+ for s in self.d.get("series") or []:
	789	+ self._line_chart(s, with_stats=with_stats)
	790	+ for ms in self.d.get("multiseries") or []:
	791	+ self._multiline(ms)
	792	+ for st in self.d.get("stacked") or []:
	793	+ self._stacked(st)
	794	+
	795	+ def _all_breakdowns(self):
	796	+ for b in self.d.get("breakdowns") or []:
	797	+ if b.get("kind") == "donut":
	798	+ self._donut(b)
	799	+ else:
	800	+ self._bars(b.get("title", ""), b.get("items"))
	801	+ for dist in self.d.get("distributions") or []:
	802	+ self._vbars(dist)
	803	+ geo = self.d.get("geo")
	804	+ if geo:
	805	+ self._bars(geo.get("title", "Répartition géographique"), geo.get("items"))
	806	+ self._hourly()
505	807
506	808	def build(self) -> bytes:
507	809	p = self.pdf
508	810	p.alias_nb_pages()
509	811	self._cover()
	812	+ with_toc = self.mode in ("complet", "donnees")
	813	+ toc_page_no = None
510	814	if self.mode == "synthese":
511	815	p.add_page()
512	816	self._kpis()
	817	+ self._gauges()
	818	+ self._records()
	819	+ self._final_page()
	820	+ elif self.mode == "tendances":
	821	+ p.add_page()
	822	+ self._kpis()
	823	+ self._section_title("Évolution & tendances")
	824	+ self._all_series(with_stats=True)
513	825	self._records()
514	826	self._final_page()
515		− else:
	827	+ elif self.mode == "repartitions":
	828	+ p.add_page()
	829	+ self._section_title("Répartitions, distributions & géographie")
	830	+ self._all_breakdowns()
	831	+ self._final_page()
	832	+ elif self.mode == "donnees":
	833	+ p.add_page()
	834	+ toc_page_no = p.page_no()
	835	+ for t in self.d.get("tables") or []:
	836	+ self._table(t, max_rows=400)
	837	+ self._final_page()
	838	+ else: # complet
516	839	p.add_page()
517	840	toc_page_no = p.page_no()
518	841	p.add_page()
519	842	self._kpis()
520		− for s in self.d.get("series") or []:
521		− if s.get("kind") == "bar":
522		− self._bars(s.get("title", ""), [{"label": pt.get("t"), "value": pt.get("v")} for pt in (s.get("points") or [])], s.get("unit", ""))
523		− else:
524		− self._line_chart(s)
525		− for b in self.d.get("breakdowns") or []:
526		− if b.get("kind") == "donut":
527		− self._donut(b)
528		− else:
529		− self._bars(b.get("title", ""), b.get("items"))
530		− geo = self.d.get("geo")
531		− if geo:
532		− self._bars(geo.get("title", "Répartition géographique"), geo.get("items"))
	843	+ self._gauges()
	844	+ if (self.d.get("series") or self.d.get("multiseries") or self.d.get("stacked")):
	845	+ self._section_title("Évolution & tendances")
	846	+ self._all_series(with_stats=True)
	847	+ if (self.d.get("breakdowns") or self.d.get("distributions") or self.d.get("geo") or self.d.get("hourly")):
	848	+ self._section_title("Répartitions, distributions & géographie")
	849	+ self._all_breakdowns()
533	850	for t in self.d.get("tables") or []:
534	851	self._table(t)
535	852	self._records()
536	853	self._final_page()
537		− # sommaire écrit sur la page réservée (page 2)
	854	+ # sommaire écrit sur la page réservée
	855	+ if toc_page_no is not None:
538	856	last_page = p.page
539	857	p.page = toc_page_no
540	858	p.set_y(22)
		`@@ -553,6 +871,7 @@ class GroupeKAReport:`
553	871	return bytes(p.output())
554	872
555	873
556		−def filename(platform_id: str, period: str) -> str:
	874	+def filename(platform_id: str, period: str, mode: str = "complet") -> str:
557	875	today = datetime.now(ZoneInfo("America/Toronto")).strftime("%Y-%m-%d")
558		− return f"groupe-ka_{platform_id}_stats_{period}_{today}.pdf"
	876	+ suffix = "" if mode in ("", "complet") else f"_{mode}"
	877	+ return f"groupe-ka_{platform_id}_stats_{period}{suffix}_{today}.pdf"
559	878