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 201d196

9 changed files +1,960 −389

modified foodka/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 or self.page_no() == 1: # la couverture est la p. 1
	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 or self.page_no() == 1: # jamais de pied sur la couverture
	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"

modified foodka/statsdash.py +383 −61

		`@@ -2,10 +2,11 @@`
2	2	# Food-Ka — Agrégateur de produits d'épicerie (province de Québec)
3	3	# Auteur : Simon-Pierre Boucher — contact@spboucher.ai
4	4	# statsdash.py : tableau de bord analytique — source unique de
5		−# GET /api/stats/dashboard (contrat commun ka-ui/stats/SPEC.md) et du
6		−# rapport PDF Groupe-KA (GET /api/stats/report, moteur foodka/kapdf.py).
	5	+# GET /api/stats/dashboard (contrat commun ka-ui/stats/SPEC.md v2) et des
	6	+# 5 rapports PDF Groupe-KA (GET /api/stats/report, moteur foodka/kapdf.py).
7	7	# Tout est calculé sur les données réelles : products (catalogue vivant),
8	8	# price_log (historique des relevés de prix), sync_log (journal des syncs).
	9	+# Rien d'inventé : une mesure indisponible = champ omis (section masquée).
9	10	# Cache serveur : 5 minutes par période demandée.
10	11	# -----------------------------------------------------------------------------
11	12	from __future__ import annotations
		`@@ -42,12 +43,11 @@ _PRICE_SANE = "price IS NOT NULL AND price > 0 AND price <= 2000"`
42	43	_SOURCES_PATH = Path(__file__).resolve().parent.parent / "data" / "sources.json"
43	44
44	45
45		−def _source_names() -> dict[str, str]:
	46	+def _source_registry() -> list[dict]:
46	47	try:
47		− reg = json.loads(_SOURCES_PATH.read_text(encoding="utf-8"))["sources"]
48		− return {s["id"]: s.get("name") or s["id"] for s in reg}
	48	+ return json.loads(_SOURCES_PATH.read_text(encoding="utf-8"))["sources"]
49	49	except Exception:
50		− return {}
	50	+ return []
51	51
52	52
53	53	def _fmt_money(v: float \| None) -> str:
		`@@ -56,6 +56,10 @@ def _fmt_money(v: float \| None) -> str:`
56	56	return f"{v:,.2f}".replace(",", " ").replace(".", ",") + " $"
57	57
58	58
	59	+def _fmt_int(n: int) -> str:
	60	+ return f"{n:,}".replace(",", " ")
	61	+
	62	+
59	63	def _parse_date(s: str \| None) -> date \| None:
60	64	if not s:
61	65	return None
		`@@ -105,6 +109,16 @@ def _days_range(f: date, t: date) -> list[date]:`
105	109	return days
106	110
107	111
	112	+def _spark(points: list[dict], n: int = 30) -> list[dict]:
	113	+ """Sous-échantillonne une série pour la sparkline d'un KPI (≤ n points)."""
	114	+ if len(points) <= n:
	115	+ return points
	116	+ step = len(points) / (n - 1)
	117	+ out = [points[int(i * step)] for i in range(n - 1)]
	118	+ out.append(points[-1])
	119	+ return out
	120	+
	121	+
108	122	# ---------------------------------------------------------------------------
109	123	# Calcul principal
110	124	# ---------------------------------------------------------------------------
		`@@ -117,9 +131,24 @@ def _tracked_at(con, ts: float) -> int:`
117	131	" AND (active = 1 OR last_seen >= ?)", (ts, ts)).fetchone()["c"]
118	132
119	133
	134	+# variations de prix (LAG par produit sur price_log), bornées par ts — colonnes :
	135	+# uid, ts, price, prev, name, source, category
	136	+_MOVES_SQL = """WITH x AS (
	137	+ SELECT uid, ts, price,
	138	+ LAG(price) OVER (PARTITION BY uid ORDER BY ts) prev
	139	+ FROM price_log)
	140	+ SELECT x.uid, x.ts, x.price, x.prev, p.name, p.source, p.category
	141	+ FROM x JOIN products p ON p.uid = x.uid
	142	+ WHERE x.ts >= ? AND x.ts < ?
	143	+ AND x.price IS NOT NULL AND x.prev IS NOT NULL
	144	+ AND x.prev > 0 AND x.price > 0 AND x.price <> x.prev
	145	+ AND x.price <= 2000 AND x.prev <= 2000"""
	146	+
	147	+
120	148	def _compute(period: str, from_s: str \| None, to_s: str \| None) -> dict:
121	149	con = db.connect()
122		− names = _source_names()
	150	+ registry = _source_registry()
	151	+ names = {s["id"]: s.get("name") or s["id"] for s in registry}
123	152	label_of = lambda src: names.get(src, src) # noqa: E731
124	153
125	154	f_date, t_date, label, period_id = _resolve_period(con, period, from_s, to_s)
		`@@ -133,6 +162,7 @@ def _compute(period: str, from_s: str \| None, to_s: str \| None) -> dict:`
133	162	# ---- historique des relevés de prix (price_log) --------------------------
134	163	first_log = con.execute("SELECT MIN(ts) m FROM price_log").fetchone()["m"]
135	164	has_history = first_log is not None
	165	+ has_prev_history = bool(has_history and first_log < prev_end)
136	166
137	167	releves_cur = con.execute(
138	168	"SELECT COUNT(*) c FROM price_log WHERE ts >= ? AND ts < ?",
		`@@ -141,34 +171,40 @@ def _compute(period: str, from_s: str \| None, to_s: str \| None) -> dict:`
141	171	"SELECT COUNT(*) c FROM price_log WHERE ts >= ? AND ts < ?",
142	172	(prev_start, prev_end)).fetchone()["c"]
143	173
144		− # variations de prix détectées dans la période (LAG sur price_log)
145		− moves = con.execute(
146		− """WITH x AS (
147		− SELECT uid, ts, price,
148		− LAG(price) OVER (PARTITION BY uid ORDER BY ts) prev
149		− FROM price_log)
150		− SELECT x.uid, x.ts, x.price, x.prev, p.name, p.source
151		− FROM x JOIN products p ON p.uid = x.uid
152		− WHERE x.ts >= ? AND x.ts < ?
153		− AND x.price IS NOT NULL AND x.prev IS NOT NULL
154		− AND x.prev > 0 AND x.price > 0 AND x.price <> x.prev
155		− AND x.price <= 2000 AND x.prev <= 2000""",
156		− (start, end)).fetchall()
	174	+ # variations de prix détectées dans la période
	175	+ moves = con.execute(_MOVES_SQL, (start, end)).fetchall()
157	176	drops = [m for m in moves if m["price"] < m["prev"]]
158	177	hikes = [m for m in moves if m["price"] > m["prev"]]
159		− amp = ([abs(m["price"] - m["prev"]) / m["prev"] for m in moves])
	178	+ amp = [abs(m["price"] - m["prev"]) / m["prev"] for m in moves]
160	179	amp_avg_pct = round(100 * statistics.mean(amp), 1) if amp else None
	180	+
	181	+ drops_prev = hikes_prev = None
	182	+ if has_prev_history:
	183	+ mv_prev = con.execute(
	184	+ f"SELECT SUM(price < prev) d, SUM(price > prev) h FROM ({_MOVES_SQL})",
	185	+ (prev_start, prev_end)).fetchone()
	186	+ drops_prev, hikes_prev = mv_prev["d"] or 0, mv_prev["h"] or 0
	187	+
161	188	drops_by_day: dict[str, int] = {}
	189	+ hikes_by_day: dict[str, int] = {}
162	190	for m in drops:
163	191	d = datetime.fromtimestamp(m["ts"], TZ).date().isoformat()
164	192	drops_by_day[d] = drops_by_day.get(d, 0) + 1
	193	+ for m in hikes:
	194	+ d = datetime.fromtimestamp(m["ts"], TZ).date().isoformat()
	195	+ hikes_by_day[d] = hikes_by_day.get(d, 0) + 1
165	196	top_drops = sorted(
166	197	({"name": m["name"] or "", "source": m["source"],
167	198	"old": m["prev"], "new": m["price"], "ts": m["ts"],
168	199	"pct": round(100 * (m["prev"] - m["price"]) / m["prev"], 1)}
169	200	for m in drops), key=lambda d: -d["pct"])
	201	+ top_hikes = sorted(
	202	+ ({"name": m["name"] or "", "source": m["source"],
	203	+ "old": m["prev"], "new": m["price"], "ts": m["ts"],
	204	+ "pct": round(100 * (m["price"] - m["prev"]) / m["prev"], 1)}
	205	+ for m in hikes), key=lambda d: -d["pct"])
170	206
171		− # ---- KPI ------------------------------------------------------------------
	207	+ # ---- agrégats du catalogue --------------------------------------------------
172	208	g = con.execute(
173	209	f"""SELECT COUNT(*) total, SUM(on_sale) on_sale,
174	210	COUNT(DISTINCT source) sources,
		`@@ -193,28 +229,18 @@ def _compute(period: str, from_s: str \| None, to_s: str \| None) -> dict:`
193	229	"SELECT AVG(price) a FROM price_log WHERE ts >= ? AND ts < ?"
194	230	" AND price > 0 AND price <= 2000", (prev_start, prev_end)).fetchone()["a"]
195	231
196		− def _kpi(id_, lbl, value, unit="", delta=None):
197		− d = {"id": id_, "label": lbl, "value": value, "unit": unit}
198		− if delta is not None:
199		− d["delta_pct"] = delta
200		− d["direction"] = "up" if delta >= 0 else "down"
201		− else:
202		− d["delta_pct"] = None
203		− return d
	232	+ new_cur = con.execute(
	233	+ "SELECT COUNT(*) c FROM products WHERE first_seen >= ? AND first_seen < ?",
	234	+ (start, end)).fetchone()["c"]
	235	+ new_prev = con.execute(
	236	+ "SELECT COUNT(*) c FROM products WHERE first_seen >= ? AND first_seen < ?",
	237	+ (prev_start, prev_end)).fetchone()["c"]
204	238
205		− kpis = [
206		− _kpi("suivis", "Produits suivis (actifs)", g["total"], "",
207		− _delta_pct(tracked_now, tracked_prev)),
208		− _kpi("releves", "Relevés de prix (période)", releves_cur, "",
209		− _delta_pct(releves_cur, releves_prev)),
210		− _kpi("bannieres", "Bannières connectées", g["sources"], "",
211		− _delta_pct(src_cur, src_prev)),
212		− _kpi("soldes", "Soldes actifs", g["on_sale"] or 0, ""),
213		− _kpi("prix_moyen", "Prix moyen (produits actifs)",
214		− round(g["avg_price"], 2) if g["avg_price"] else 0, "$",
215		− _delta_pct(avg_obs_cur, avg_obs_prev)),
216		− _kpi("categories", "Catégories", g["categories"], ""),
217		− ]
	239	+ # rabais moyen affiché (soldes actifs avec prix régulier connu)
	240	+ rabais_avg = con.execute(
	241	+ f"""SELECT AVG(100.0 * (regular_price - price) / regular_price) a
	242	+ FROM products WHERE active=1 AND on_sale=1 AND {_PRICE_SANE}
	243	+ AND regular_price IS NOT NULL AND regular_price > price""").fetchone()["a"]
218	244
219	245	# ---- séries par jour --------------------------------------------------------
220	246	data_start = (datetime.fromtimestamp(first_log, TZ).date()
		`@@ -238,6 +264,14 @@ def _compute(period: str, from_s: str \| None, to_s: str \| None) -> dict:`
238	264	" GROUP BY d", (start, end)) if r["a"] is not None}
239	265	pts_avg = [{"t": d, "v": avg_day[d]} for d in iso if d in avg_day]
240	266
	267	+ # comparaison N-1 de l'indice de prix moyen (si historique antérieur)
	268	+ cmp_avg: list[dict] = []
	269	+ if has_prev_history:
	270	+ cmp_avg = [{"t": r["d"], "v": round(r["a"], 2)} for r in con.execute(
	271	+ "SELECT date(ts,'unixepoch','localtime') d, AVG(price) a FROM price_log"
	272	+ " WHERE ts >= ? AND ts < ? AND price > 0 AND price <= 2000"
	273	+ " GROUP BY d ORDER BY d", (prev_start, prev_end)) if r["a"] is not None]
	274	+
241	275	new_day = {r["d"]: r["c"] for r in con.execute(
242	276	"SELECT date(first_seen,'unixepoch','localtime') d, COUNT(*) c FROM products"
243	277	" WHERE first_seen >= ? AND first_seen < ? GROUP BY d", (start, end))}
		`@@ -245,26 +279,156 @@ def _compute(period: str, from_s: str \| None, to_s: str \| None) -> dict:`
245	279
246	280	pts_drops = [{"t": d, "v": drops_by_day.get(d, 0)} for d in iso]
247	281
	282	+ # ---- KPI (≥ 8, deltas honnêtes, sparklines quand une série existe) ----------
	283	+ def _kpi(id_, lbl, value, unit="", delta=None, spark=None):
	284	+ d = {"id": id_, "label": lbl, "value": value, "unit": unit}
	285	+ if delta is not None:
	286	+ d["delta_pct"] = delta
	287	+ d["direction"] = "up" if delta >= 0 else "down"
	288	+ else:
	289	+ d["delta_pct"] = None
	290	+ if spark and len(spark) >= 2:
	291	+ d["spark"] = _spark(spark)
	292	+ return d
	293	+
	294	+ kpis = [
	295	+ _kpi("suivis", "Produits suivis (actifs)", g["total"], "",
	296	+ _delta_pct(tracked_now, tracked_prev), spark=pts_tracked),
	297	+ _kpi("releves", "Relevés de prix (période)", releves_cur, "",
	298	+ _delta_pct(releves_cur, releves_prev), spark=pts_releves),
	299	+ _kpi("baisses", "Baisses de prix détectées", len(drops), "",
	300	+ _delta_pct(len(drops), drops_prev), spark=pts_drops),
	301	+ _kpi("hausses", "Hausses de prix détectées", len(hikes), "",
	302	+ _delta_pct(len(hikes), hikes_prev)),
	303	+ _kpi("soldes", "Soldes actifs", g["on_sale"] or 0, ""),
	304	+ *([_kpi("rabais_moyen", "Rabais moyen affiché",
	305	+ round(rabais_avg, 1), "%")] if rabais_avg else []),
	306	+ _kpi("prix_moyen", "Prix moyen (produits actifs)",
	307	+ round(g["avg_price"], 2) if g["avg_price"] else 0, "$",
	308	+ _delta_pct(avg_obs_cur, avg_obs_prev), spark=pts_avg),
	309	+ _kpi("bannieres", "Bannières connectées", g["sources"], "",
	310	+ _delta_pct(src_cur, src_prev)),
	311	+ _kpi("nouveaux", "Nouveaux produits (période)", new_cur, "",
	312	+ _delta_pct(new_cur, new_prev) if new_prev else None, spark=pts_new),
	313	+ _kpi("categories", "Catégories", g["categories"], ""),
	314	+ ]
	315	+
	316	+ # ---- jauges (taux & couvertures mesurés sur le catalogue réel) ---------------
	317	+ active_total = g["total"] or 0
	318	+ gauges = []
	319	+ if active_total:
	320	+ fresh7 = con.execute(
	321	+ "SELECT COUNT(*) c FROM products WHERE active=1 AND last_seen >= ?",
	322	+ (now_ts - 7 * 86400,)).fetchone()["c"]
	323	+ with_img = con.execute(
	324	+ "SELECT COUNT(*) c FROM products WHERE active=1"
	325	+ " AND images IS NOT NULL AND images <> '' AND images <> '[]'").fetchone()["c"]
	326	+ with_up = con.execute(
	327	+ "SELECT COUNT(*) c FROM products WHERE active=1"
	328	+ " AND unit_price IS NOT NULL").fetchone()["c"]
	329	+ gauges = [
	330	+ {"id": "fraicheur", "label": "Produits vus il y a moins de 7 jours",
	331	+ "value": round(100 * fresh7 / active_total, 1), "max": 100, "unit": "%"},
	332	+ {"id": "images", "label": "Produits avec image",
	333	+ "value": round(100 * with_img / active_total, 1), "max": 100, "unit": "%"},
	334	+ {"id": "prix_unitaire", "label": "Produits avec prix unitaire comparable",
	335	+ "value": round(100 * with_up / active_total, 1), "max": 100, "unit": "%"},
	336	+ ]
	337	+ if registry:
	338	+ gauges.append({"id": "couverture",
	339	+ "label": "Bannières du registre avec produits actifs",
	340	+ "value": g["sources"], "max": len(registry), "unit": ""})
	341	+
	342	+ # ---- séries -------------------------------------------------------------------
248	343	series = []
	344	+ if has_history and len(pts_releves) >= 2:
	345	+ series.append({"id": "releves", "title": "Relevés de prix par jour",
	346	+ "unit": "relevés", "kind": "bar", "points": pts_releves})
249	347	if len(pts_tracked) >= 2:
250	348	series.append({"id": "suivis", "title": "Produits suivis par jour",
251	349	"unit": "produits", "kind": "line", "points": pts_tracked})
252		− if has_history and len(pts_releves) >= 2:
253		− series.append({"id": "releves", "title": "Relevés de prix par jour",
254		− "unit": "relevés", "kind": "line", "points": pts_releves})
255	350	if has_history and len(pts_avg) >= 2:
256		− series.append({"id": "prix_moyen", "title": "Prix moyen relevé par jour",
257		− "unit": "$", "kind": "line", "points": pts_avg})
	351	+ s_avg = {"id": "prix_moyen", "title": "Indice de prix moyen relevé par jour",
	352	+ "unit": "$", "kind": "area", "points": pts_avg}
	353	+ if len(cmp_avg) >= 2:
	354	+ s_avg["compare"] = cmp_avg
	355	+ series.append(s_avg)
258	356	if has_history and len(pts_drops) >= 2 and drops:
259	357	series.append({"id": "baisses", "title": "Baisses de prix détectées par jour",
260	358	"unit": "baisses", "kind": "line", "points": pts_drops})
261	359	if len(pts_new) >= 2 and any(p["v"] for p in pts_new):
262	360	series.append({"id": "nouveautes", "title": "Nouveaux produits par jour",
263		− "unit": "produits", "kind": "line", "points": pts_new})
	361	+ "unit": "produits", "kind": "bar", "points": pts_new})
264	362
265		− # ---- répartitions -------------------------------------------------------------
	363	+ # ---- multi-courbes : prix moyen relevé par jour, top bannières (≤ 4) ----------
	364	+ multiseries = []
	365	+ if has_history:
	366	+ rows = con.execute(
	367	+ """SELECT p.source s, date(l.ts,'unixepoch','localtime') d,
	368	+ AVG(l.price) a, COUNT(*) c
	369	+ FROM price_log l JOIN products p ON p.uid = l.uid
	370	+ WHERE l.ts >= ? AND l.ts < ? AND l.price > 0 AND l.price <= 2000
	371	+ GROUP BY s, d""", (start, end)).fetchall()
	372	+ by_src_day: dict[str, dict[str, float]] = {}
	373	+ src_obs: dict[str, int] = {}
	374	+ for r in rows:
	375	+ by_src_day.setdefault(r["s"], {})[r["d"]] = round(r["a"], 2)
	376	+ src_obs[r["s"]] = src_obs.get(r["s"], 0) + r["c"]
	377	+ # jusqu'à 4 bannières très actives partageant assez de jours communs
	378	+ chosen: list[str] = []
	379	+ common: set[str] = set()
	380	+ for s in sorted(src_obs, key=lambda s: -src_obs[s]):
	381	+ days_s = set(by_src_day[s])
	382	+ cand = (common & days_s) if chosen else days_s
	383	+ if len(cand) >= 3 and len(chosen) < 4:
	384	+ chosen.append(s)
	385	+ common = cand
	386	+ if len(chosen) >= 2 and len(common) >= 3:
	387	+ axis = sorted(common)
	388	+ multiseries.append({
	389	+ "id": "prix_bannieres",
	390	+ "title": "Prix moyen relevé par jour — bannières les plus actives",
	391	+ "unit": "$",
	392	+ "series": [{"label": label_of(s),
	393	+ "points": [{"t": d, "v": by_src_day[s][d]} for d in axis]}
	394	+ for s in chosen]})
	395	+
	396	+ # ---- barres empilées ------------------------------------------------------------
	397	+ stacked = []
	398	+ if moves and len(iso) >= 2:
	399	+ stacked.append({
	400	+ "id": "variations",
	401	+ "title": "Variations de prix par jour — baisses vs hausses",
	402	+ "unit": "variations", "keys": ["Baisses", "Hausses"],
	403	+ "points": [{"t": d, "values": [drops_by_day.get(d, 0),
	404	+ hikes_by_day.get(d, 0)]} for d in iso]})
	405	+ adds = con.execute(
	406	+ """SELECT source s, date(first_seen,'unixepoch','localtime') d, COUNT(*) c
	407	+ FROM products WHERE first_seen >= ? AND first_seen < ?
	408	+ GROUP BY s, d""", (start, end)).fetchall()
	409	+ if adds and len(iso) >= 2:
	410	+ add_tot: dict[str, int] = {}
	411	+ add_day: dict[tuple[str, str], int] = {}
	412	+ for r in adds:
	413	+ add_tot[r["s"]] = add_tot.get(r["s"], 0) + r["c"]
	414	+ add_day[(r["s"], r["d"])] = r["c"]
	415	+ top_src = sorted(add_tot, key=lambda s: -add_tot[s])[:5]
	416	+ others = [s for s in add_tot if s not in top_src]
	417	+ keys = [label_of(s) for s in top_src] + (["Autres"] if others else [])
	418	+ pts_st = []
	419	+ for d in iso:
	420	+ vals = [add_day.get((s, d), 0) for s in top_src]
	421	+ if others:
	422	+ vals.append(sum(add_day.get((s, d), 0) for s in others))
	423	+ pts_st.append({"t": d, "values": vals})
	424	+ if any(sum(p["values"]) for p in pts_st):
	425	+ stacked.append({"id": "ajouts",
	426	+ "title": "Nouveaux produits par jour et par bannière",
	427	+ "unit": "produits", "keys": keys, "points": pts_st})
	428	+
	429	+ # ---- répartitions ----------------------------------------------------------------
266	430	by_src = con.execute(
267		− "SELECT source, COUNT(*) n FROM products WHERE active=1"
	431	+ "SELECT source, COUNT(*) n, SUM(on_sale) sales FROM products WHERE active=1"
268	432	" GROUP BY source ORDER BY n DESC").fetchall()
269	433	donut_items = [{"label": label_of(r["source"]), "value": r["n"]}
270	434	for r in by_src[:8]] # top 8 (limite du donut ka-ui/kapdf)
		`@@ -277,8 +441,57 @@ def _compute(period: str, from_s: str \| None, to_s: str \| None) -> dict:`
277	441	{"id": "categories", "title": "Top catégories (produits actifs)", "kind": "bars",
278	442	"items": [{"label": r["category"], "value": r["n"]} for r in by_cat[:14]]},
279	443	]
280		−
281		− # ---- heatmap : relevés de prix par jour ---------------------------------------
	444	+ sale_src = [{"label": label_of(r["source"]), "value": r["sales"] or 0}
	445	+ for r in sorted(by_src, key=lambda r: -(r["sales"] or 0))
	446	+ if (r["sales"] or 0) > 0][:14]
	447	+ if sale_src:
	448	+ breakdowns.append({"id": "soldes_bannieres",
	449	+ "title": "Soldes actifs par bannière", "kind": "bars",
	450	+ "items": sale_src})
	451	+ if drops:
	452	+ d_src_cur: dict[str, int] = {}
	453	+ for m in drops:
	454	+ d_src_cur[m["source"]] = d_src_cur.get(m["source"], 0) + 1
	455	+ d_src_prev: dict[str, int] = {}
	456	+ if has_prev_history:
	457	+ d_src_prev = {r["source"]: r["c"] for r in con.execute(
	458	+ f"""SELECT source, COUNT(*) c FROM ({_MOVES_SQL})
	459	+ WHERE price < prev GROUP BY source""", (prev_start, prev_end))}
	460	+ breakdowns.append({
	461	+ "id": "baisses_bannieres",
	462	+ "title": "Baisses de prix détectées par bannière (période)", "kind": "bars",
	463	+ "items": [{"label": label_of(s), "value": n,
	464	+ "delta_pct": _delta_pct(n, d_src_prev.get(s))}
	465	+ for s, n in sorted(d_src_cur.items(), key=lambda kv: -kv[1])[:12]]})
	466	+
	467	+ # ---- distributions (histogrammes) --------------------------------------------------
	468	+ distributions = []
	469	+ rabais_rows = con.execute(
	470	+ f"""SELECT 100.0 * (regular_price - price) / regular_price pct
	471	+ FROM products WHERE active=1 AND on_sale=1 AND {_PRICE_SANE}
	472	+ AND regular_price IS NOT NULL AND regular_price > price""").fetchall()
	473	+ if rabais_rows:
	474	+ edges = [(0, 10), (10, 20), (20, 30), (30, 40), (40, 50), (50, 101)]
	475	+ bins = [{"label": ("50 % +" if lo == 50 else f"{lo}-{hi} %"),
	476	+ "value": sum(1 for r in rabais_rows if lo <= r["pct"] < hi)}
	477	+ for lo, hi in edges]
	478	+ distributions.append({"id": "rabais",
	479	+ "title": "Distribution des rabais affichés (soldes actifs)",
	480	+ "unit": "produits", "bins": bins})
	481	+ price_rows = con.execute(
	482	+ f"SELECT price FROM products WHERE active=1 AND {_PRICE_SANE}").fetchall()
	483	+ if price_rows:
	484	+ edges_p = [(0, 2, "0-2 $"), (2, 5, "2-5 $"), (5, 10, "5-10 $"),
	485	+ (10, 20, "10-20 $"), (20, 50, "20-50 $"),
	486	+ (50, 100, "50-100 $"), (100, 2001, "100 $ +")]
	487	+ bins_p = [{"label": lb,
	488	+ "value": sum(1 for r in price_rows if lo <= r["price"] < hi)}
	489	+ for lo, hi, lb in edges_p]
	490	+ distributions.append({"id": "prix",
	491	+ "title": "Distribution des prix (produits actifs)",
	492	+ "unit": "produits", "bins": bins_p})
	493	+
	494	+ # ---- heatmap calendrier : relevés de prix par jour ---------------------------------
282	495	heatmap = None
283	496	if has_history:
284	497	hm_start = max(start, now_ts - 183 * 86400)
		`@@ -288,7 +501,21 @@ def _compute(period: str, from_s: str \| None, to_s: str \| None) -> dict:`
288	501	if cells:
289	502	heatmap = {"title": "Relevés de prix par jour", "cells": cells}
290	503
291		− # ---- tableaux -------------------------------------------------------------------
	504	+ # ---- heatmap horaire 7×24 : relevés par jour de semaine × heure --------------------
	505	+ hourly = None
	506	+ if has_history:
	507	+ hcells = [{"dow": (r["w"] + 6) % 7, "hour": r["h"], "value": r["c"]}
	508	+ for r in con.execute(
	509	+ """SELECT CAST(strftime('%w', ts,'unixepoch','localtime') AS INT) w,
	510	+ CAST(strftime('%H', ts,'unixepoch','localtime') AS INT) h,
	511	+ COUNT(*) c
	512	+ FROM price_log WHERE ts >= ? AND ts < ?
	513	+ GROUP BY w, h""", (start, end))]
	514	+ if hcells:
	515	+ hourly = {"title": "Relevés de prix par jour de semaine et heure",
	516	+ "cells": hcells}
	517	+
	518	+ # ---- tableaux -----------------------------------------------------------------------
292	519	def _cut(s: str, n: int = 26) -> str:
293	520	s = (s or "").strip()
294	521	return s if len(s) <= n else s[: n - 1] + "…"
		`@@ -303,6 +530,7 @@ def _compute(period: str, from_s: str \| None, to_s: str \| None) -> dict:`
303	530	AND {_PRICE_SANE} AND regular_price > price
304	531	ORDER BY (regular_price - price) / regular_price DESC LIMIT 100""")]
305	532
	533	+ # prix moyens par catégorie + delta des prix relevés (période vs précédente)
306	534	cat_prices: dict[str, list[float]] = {}
307	535	cat_sales: dict[str, int] = {}
308	536	for r in con.execute(
		`@@ -310,18 +538,62 @@ def _compute(period: str, from_s: str \| None, to_s: str \| None) -> dict:`
310	538	WHERE active=1 AND category<>'' AND {_PRICE_SANE}"""):
311	539	cat_prices.setdefault(r["category"], []).append(r["price"])
312	540	cat_sales[r["category"]] = cat_sales.get(r["category"], 0) + (r["on_sale"] or 0)
	541	+ cat_obs_cur = {r["cat"]: r["a"] for r in con.execute(
	542	+ """SELECT p.category cat, AVG(l.price) a
	543	+ FROM price_log l JOIN products p ON p.uid = l.uid
	544	+ WHERE l.ts >= ? AND l.ts < ? AND l.price > 0 AND l.price <= 2000
	545	+ AND p.category <> '' GROUP BY cat""", (start, end))}
	546	+ cat_obs_prev: dict[str, float] = {}
	547	+ if has_prev_history:
	548	+ cat_obs_prev = {r["cat"]: r["a"] for r in con.execute(
	549	+ """SELECT p.category cat, AVG(l.price) a
	550	+ FROM price_log l JOIN products p ON p.uid = l.uid
	551	+ WHERE l.ts >= ? AND l.ts < ? AND l.price > 0 AND l.price <= 2000
	552	+ AND p.category <> '' GROUP BY cat""", (prev_start, prev_end))}
	553	+
	554	+ def _fmt_delta(cat: str) -> str:
	555	+ dp = _delta_pct(cat_obs_cur.get(cat), cat_obs_prev.get(cat))
	556	+ if dp is None:
	557	+ return "—"
	558	+ return f"{'+' if dp >= 0 else '−'}{str(abs(dp)).replace('.', ',')} %"
	559	+
313	560	cat_rows = sorted(
314	561	([cat, len(v), _fmt_money(round(statistics.mean(v), 2)),
315		− _fmt_money(round(statistics.median(v), 2)), cat_sales.get(cat, 0)]
	562	+ _fmt_money(round(statistics.median(v), 2)), cat_sales.get(cat, 0),
	563	+ _fmt_delta(cat)]
316	564	for cat, v in cat_prices.items()), key=lambda r: -r[1])
317	565
	566	+ # bannières : produits, soldes, relevés (période), fraîcheur de synchro
	567	+ rel_src = {r["s"]: r["c"] for r in con.execute(
	568	+ """SELECT p.source s, COUNT(*) c FROM price_log l
	569	+ JOIN products p ON p.uid = l.uid
	570	+ WHERE l.ts >= ? AND l.ts < ? GROUP BY s""", (start, end))}
	571	+ last_sync = {r["source"]: r["ts"] for r in con.execute(
	572	+ "SELECT source, MAX(ts) ts FROM sync_log WHERE ok=1 GROUP BY source")}
	573	+ src_price = {r["source"]: r["a"] for r in con.execute(
	574	+ f"""SELECT source, AVG(price) a FROM products
	575	+ WHERE active=1 AND {_PRICE_SANE} GROUP BY source""")}
	576	+ src_rows = [
	577	+ [label_of(r["source"]), r["n"], r["sales"] or 0,
	578	+ _fmt_money(round(src_price[r["source"]], 2))
	579	+ if src_price.get(r["source"]) else "—",
	580	+ _fmt_int(rel_src.get(r["source"], 0)),
	581	+ (datetime.fromtimestamp(last_sync[r["source"]], TZ).strftime("%Y-%m-%d %H:%M")
	582	+ if last_sync.get(r["source"]) else "—")]
	583	+ for r in by_src]
	584	+
318	585	tables = [
319	586	{"id": "top_soldes", "title": "Top produits en solde (rabais les plus forts)",
320	587	"columns": ["Produit", "Bannière", "Prix", "Prix rég.", "Rabais"],
321	588	"rows": sale_rows},
322	589	{"id": "prix_categories", "title": "Prix moyens par catégorie",
323		− "columns": ["Catégorie", "Produits", "Prix moyen", "Prix médian", "En solde"],
	590	+ "columns": ["Catégorie", "Produits", "Prix moyen", "Prix médian",
	591	+ "En solde", "Δ prix relevés"],
324	592	"rows": cat_rows},
	593	+ {"id": "bannieres", "title": "Bannières — produits, soldes & fraîcheur",
	594	+ "columns": ["Bannière", "Produits actifs", "En solde", "Prix moyen",
	595	+ "Relevés (période)", "Dernière synchro"],
	596	+ "rows": src_rows},
325	597	]
326	598	if top_drops:
327	599	tables.insert(1, {
		`@@ -330,8 +602,15 @@ def _compute(period: str, from_s: str \| None, to_s: str \| None) -> dict:`
330	602	"rows": [[_cut(d["name"]), label_of(d["source"]), _fmt_money(d["old"]),
331	603	_fmt_money(d["new"]), f"−{d['pct']} %".replace(".", ",")]
332	604	for d in top_drops[:100]]})
	605	+ if top_hikes:
	606	+ tables.insert(2 if top_drops else 1, {
	607	+ "id": "hausses", "title": "Top hausses de prix détectées (période)",
	608	+ "columns": ["Produit", "Bannière", "Avant", "Après", "Hausse"],
	609	+ "rows": [[_cut(d["name"]), label_of(d["source"]), _fmt_money(d["old"]),
	610	+ _fmt_money(d["new"]), f"+{d['pct']} %".replace(".", ",")]
	611	+ for d in top_hikes[:100]]})
333	612
334		− # ---- records & faits marquants -----------------------------------------------
	613	+ # ---- records & faits marquants ------------------------------------------------------
335	614	records = []
336	615	best_sale = con.execute(
337	616	f"""SELECT name, source, price, regular_price,
		`@@ -351,23 +630,61 @@ def _compute(period: str, from_s: str \| None, to_s: str \| None) -> dict:`
351	630	"value": f"−{str(d0['pct']).replace('.', ',')} % · {_cut(d0['name'], 34)} "
352	631	f"({_fmt_money(d0['old'])} → {_fmt_money(d0['new'])})",
353	632	"date": datetime.fromtimestamp(d0["ts"], TZ).date().isoformat()})
	633	+ if top_hikes:
	634	+ h0 = top_hikes[0]
	635	+ records.append({
	636	+ "label": "Plus forte hausse détectée (période)",
	637	+ "value": f"+{str(h0['pct']).replace('.', ',')} % · {_cut(h0['name'], 34)} "
	638	+ f"({_fmt_money(h0['old'])} → {_fmt_money(h0['new'])})",
	639	+ "date": datetime.fromtimestamp(h0["ts"], TZ).date().isoformat()})
354	640	if has_history and per_day:
355	641	rec_day = max(per_day.items(), key=lambda kv: kv[1])
356	642	records.append({"label": "Jour record de relevés de prix",
357		− "value": f"{rec_day[1]:,}".replace(",", " ") + " relevés",
	643	+ "value": _fmt_int(rec_day[1]) + " relevés",
358	644	"date": rec_day[0]})
359	645	if new_day:
360	646	rec_new = max(new_day.items(), key=lambda kv: kv[1])
361	647	records.append({"label": "Jour record de nouveaux produits",
362		− "value": f"{rec_new[1]:,}".replace(",", " ") + " produits",
	648	+ "value": _fmt_int(rec_new[1]) + " produits",
363	649	"date": rec_new[0]})
364	650	if moves:
365	651	records.append({
366	652	"label": "Variations de prix détectées (période)",
367		− "value": f"{len(drops):,} baisses · {len(hikes):,} hausses".replace(",", " ")})
	653	+ "value": f"{_fmt_int(len(drops))} baisses · {_fmt_int(len(hikes))} hausses"})
368	654	if amp_avg_pct is not None:
369	655	records.append({"label": "Amplitude moyenne des variations de prix",
370	656	"value": f"±{amp_avg_pct} %".replace(".", ",")})
	657	+ if rel_src:
	658	+ top_rel = max(rel_src.items(), key=lambda kv: kv[1])
	659	+ records.append({"label": "Bannière la plus relevée (période)",
	660	+ "value": f"{label_of(top_rel[0])} · "
	661	+ f"{_fmt_int(top_rel[1])} relevés"})
	662	+ if hourly and hourly["cells"]:
	663	+ dows = ["lundi", "mardi", "mercredi", "jeudi", "vendredi", "samedi", "dimanche"]
	664	+ peak = max(hourly["cells"], key=lambda c: c["value"])
	665	+ records.append({"label": "Heure de pointe des relevés",
	666	+ "value": f"{dows[peak['dow']]} {peak['hour']} h · "
	667	+ f"{_fmt_int(peak['value'])} relevés"})
	668	+ cat_sale_share = [(cat, 100 * cat_sales.get(cat, 0) / len(v))
	669	+ for cat, v in cat_prices.items()
	670	+ if len(v) >= 50 and cat_sales.get(cat, 0) > 0]
	671	+ if cat_sale_share:
	672	+ top_cat = max(cat_sale_share, key=lambda kv: kv[1])
	673	+ records.append({"label": "Catégorie la plus en solde",
	674	+ "value": (f"{top_cat[0]} · {round(top_cat[1], 1)} % des produits"
	675	+ ).replace(".", ",")})
	676	+ cat_deltas = [(cat, _delta_pct(cat_obs_cur.get(cat), cat_obs_prev.get(cat)))
	677	+ for cat in cat_obs_cur if cat_obs_prev.get(cat)]
	678	+ cat_deltas = [(c, d) for c, d in cat_deltas if d is not None]
	679	+ if cat_deltas:
	680	+ up_cat = max(cat_deltas, key=lambda kv: kv[1])
	681	+ dn_cat = min(cat_deltas, key=lambda kv: kv[1])
	682	+ if up_cat[1] > 0:
	683	+ records.append({"label": "Catégorie en plus forte hausse (prix relevés)",
	684	+ "value": f"{up_cat[0]} · +{str(up_cat[1]).replace('.', ',')} %"})
	685	+ if dn_cat[1] < 0:
	686	+ records.append({"label": "Catégorie en plus forte baisse (prix relevés)",
	687	+ "value": f"{dn_cat[0]} · −{str(abs(dn_cat[1])).replace('.', ',')} %"})
371	688
372	689	con.close()
373	690	return {
		`@@ -375,9 +692,14 @@ def _compute(period: str, from_s: str \| None, to_s: str \| None) -> dict:`
375	692	"period": {"from": f_date.isoformat(), "to": t_date.isoformat(),
376	693	"label": label, "id": period_id},
377	694	"kpis": kpis,
	695	+ **({"gauges": gauges} if gauges else {}),
378	696	"series": series,
	697	+ **({"multiseries": multiseries} if multiseries else {}),
	698	+ **({"stacked": stacked} if stacked else {}),
379	699	"breakdowns": breakdowns,
	700	+ **({"distributions": distributions} if distributions else {}),
380	701	**({"heatmap": heatmap} if heatmap else {}),
	702	+ **({"hourly": hourly} if hourly else {}),
381	703	"tables": tables,
382	704	"records": records,
383	705	}
		`@@ -385,7 +707,7 @@ def _compute(period: str, from_s: str \| None, to_s: str \| None) -> dict:`
385	707
386	708	def dashboard(period: str = "30j", from_s: str \| None = None,
387	709	to_s: str \| None = None) -> dict:
388		− """Tableau de bord (contrat SPEC.md) — mis en cache 5 minutes par période."""
	710	+ """Tableau de bord (contrat SPEC.md v2) — mis en cache 5 minutes par période."""
389	711	key = (period, from_s or "", to_s or "")
390	712	now = time.time()
391	713	with _cache_lock:

modified foodka/web.py +8 −6

		`@@ -268,7 +268,10 @@ def stats_report(`
268	268	to_date: str \| None = Query(None, alias="to"),
269	269	mode: str = "complet",
270	270	):
271		− """Rapport PDF estampillé Groupe-KA — mêmes chiffres que /api/stats/dashboard."""
	271	+ """Rapport PDF estampillé Groupe-KA — mêmes chiffres que /api/stats/dashboard.
	272	+
	273	+ 5 modes : complet \| synthese \| tendances \| repartitions \| donnees
	274	+ (mode inconnu → complet, voir kapdf.REPORT_MODES)."""
272	275	from . import kapdf, statsdash
273	276	dash = statsdash.dashboard(period, from_date, to_date)
274	277	site = {
		`@@ -277,14 +280,13 @@ def stats_report(`
277	280	"domain": "www.food-ka.com",
278	281	"tagline": "Épicerie — tout le Québec, toujours à jour",
279	282	}
280		− pdf = kapdf.GroupeKAReport(
281		− site=site, dashboard=dash,
282		− mode="synthese" if mode == "synthese" else "complet").build()
	283	+ report = kapdf.GroupeKAReport(site=site, dashboard=dash, mode=mode)
	284	+ pdf = report.build()
	285	+ fname = kapdf.filename("food-ka", period, report.mode)
283	286	return Response(
284	287	content=pdf,
285	288	media_type="application/pdf",
286		− headers={"Content-Disposition":
287		− f'attachment; filename="{kapdf.filename("food-ka", period)}"'})
	289	+ headers={"Content-Disposition": f'attachment; filename="{fname}"'})
288	290
289	291
290	292	@app.get("/api/stats/rapport.pdf")

modified frontend/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"));

modified frontend/src/api.ts +10 −2

		`@@ -135,22 +135,30 @@ export interface DetailedStats {`
135	135	}
136	136
137	137	// --- Tableau de bord analytique (GET /api/stats/dashboard — contrat ka-ui) ----
138		−import type { Kpi, RecordFact, Serie, TableSpec } from "./ka/stats/kacharts";
	138	+import type {
	139	+ Distribution, Gauge, HourCell, Kpi, MultiSerie, RecordFact, Serie,
	140	+ StackedSerie, TableSpec,
	141	+} from "./ka/stats/kacharts";
139	142
140	143	export interface DashBreakdown {
141	144	id: string;
142	145	title: string;
143	146	kind: "donut" \| "bars";
144		− items: { label: string; value: number }[];
	147	+ items: { label: string; value: number; delta_pct?: number \| null }[];
145	148	}
146	149
147	150	export interface Dashboard {
148	151	updated: string; // ISO — moment du calcul
149	152	period: { from: string; to: string; label: string; id: string };
150	153	kpis: Kpi[];
	154	+ gauges?: Gauge[]; // v2 — taux & couvertures
151	155	series: Serie[];
	156	+ multiseries?: MultiSerie[]; // v2 — ≤ 4 courbes comparées
	157	+ stacked?: StackedSerie[]; // v2 — composition dans le temps
152	158	breakdowns: DashBreakdown[];
	159	+ distributions?: Distribution[]; // v2 — histogrammes
153	160	heatmap?: { title: string; cells: { date: string; value: number }[] };
	161	+ hourly?: { title: string; cells: HourCell[] }; // v2 — 7 × 24
154	162	tables: TableSpec[];
155	163	records: RecordFact[];
156	164	}

modified frontend/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 frontend/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 frontend/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 or self.page_no() == 1: # la couverture est la p. 1
	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 or self.page_no() == 1: # jamais de pied sur la couverture
	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"

modified frontend/src/pages/Stats.tsx +81 −34

		`@@ -1,10 +1,13 @@`
1	1	// -----------------------------------------------------------------------------
2	2	// Food-Ka — Agrégateur de produits d'épicerie (province de Québec)
3	3	// Auteur : Simon-Pierre Boucher — contact@spboucher.ai
4		−// pages/Stats.tsx : tableau de bord analytique (module Stats commun Groupe KA)
5		−// · Consomme /api/stats/dashboard (contrat ka-ui/stats/SPEC.md) — KPI avec
6		−// deltas, sélecteur de période, courbes/barres/anneau/heatmap, tableaux
7		−// triables, records & faits marquants, export PDF Groupe-KA.
	4	+// pages/Stats.tsx : tableau de bord analytique (module Stats commun Groupe KA v2)
	5	+// · Consomme /api/stats/dashboard (contrat ka-ui/stats/SPEC.md v2) — KPI avec
	6	+// sparklines, jauges, courbes/aires + comparaison N-1 + stats de séries,
	7	+// multi-courbes par bannière, barres empilées, répartitions avec deltas,
	8	+// histogrammes (rabais & prix), heatmaps calendrier + horaire 7×24,
	9	+// tableaux triables, records & faits marquants.
	10	+// · Export PDF Groupe-KA : 5 rapports (PdfButton v2).
8	11	// · Bonus plateforme : 🧺 panier comparatif (depuis /api/stats/detailed).
9	12	// -----------------------------------------------------------------------------
10	13	import { useCallback, useEffect, useState } from "react";
		`@@ -17,7 +20,8 @@ import {`
17	20	import SourceLogo from "../components/SourceLogo";
18	21	import {
19	22	BarChart, CalendarHeatmap, DataTable, Donut, EmptyBlock, Fraicheur,
20		− KpiCard, LineChart, PdfButton, PeriodSelector, RecordCard,
	23	+ GaugeCard, Histogram, HourHeatmap, KpiCard, LineChart, MultiLineChart,
	24	+ PdfButton, PeriodSelector, RecordCard, StackedBarChart, StatSummary,
21	25	} from "../ka/stats/kacharts";
22	26
23	27	const fmt = (n: number \| null \| undefined) =>
		`@@ -27,6 +31,9 @@ const fmt$ = (n: number \| null \| undefined) =>`
27	31	? "—"
28	32	: `${n.toLocaleString("fr-CA", { minimumFractionDigits: 2, maximumFractionDigits: 2 })} $`;
29	33
	34	+/* Séries dont on affiche les stats (min/max/moy/méd/σ) sous la courbe */
	35	+const STAT_SERIES = new Set(["releves", "prix_moyen", "suivis", "baisses"]);
	36	+
30	37	/* ---------- 🧺 Panier comparatif (section métier Food-Ka) ---------- */
31	38	function BasketSection({ m }: { m: DetailedStats }) {
32	39	const basketCols = m.basket_totals.map((t) => t.source);
		`@@ -113,6 +120,15 @@ function BasketSection({ m }: { m: DetailedStats }) {`
113	120	);
114	121	}
115	122
	123	+/* ---------- titre de sous-section ---------- */
	124	+function SectionTitle({ children }: { children: React.ReactNode }) {
	125	+ return (
	126	+ <h2 style={{ fontSize: 19, textTransform: "uppercase", margin: "26px 0 14px" }}>
	127	+ {children}
	128	+ </h2>
	129	+ );
	130	+}
	131	+
116	132	/* ---------- Page ---------- */
117	133	export default function StatsPage() {
118	134	const [period, setPeriod] = useState("30j");
		`@@ -154,7 +170,7 @@ export default function StatsPage() {`
154	170	<div className="container stats-page" aria-busy="true">
155	171	<div className="skel" style={{ height: 110, marginTop: 40 }} />
156	172	<div className="tiles" style={{ marginTop: 20 }}>
157		− {Array.from({ length: 6 }).map((_, i) => (
	173	+ {Array.from({ length: 8 }).map((_, i) => (
158	174	<div className="skel" key={i} style={{ height: 110 }} />
159	175	))}
160	176	</div>
		`@@ -163,20 +179,26 @@ export default function StatsPage() {`
163	179	</div>
164	180	);
165	181
166		− const lines = dash.series.filter((s) => (s.kind ?? "line") === "line");
167		− const barSeries = dash.series.filter((s) => s.kind === "bar");
168	182	const donuts = dash.breakdowns.filter((b) => b.kind === "donut");
169	183	const barBreaks = dash.breakdowns.filter((b) => b.kind !== "donut");
	184	+ const gauges = dash.gauges ?? [];
	185	+ const multi = dash.multiseries ?? [];
	186	+ const stacked = dash.stacked ?? [];
	187	+ const dists = dash.distributions ?? [];
	188	+ const pdfProps = {
	189	+ period: dash.period.id,
	190	+ from: useCustom ? custom.from : undefined,
	191	+ to: useCustom ? custom.to : undefined,
	192	+ };
170	193
171	194	return (
172	195	<div className="container stats-page" style={{ opacity: loading ? 0.6 : 1, transition: "opacity 0.2s" }}>
173	196	<span className="kicker">Observatoire — prix d'épicerie au Québec</span>
174	197
175		− {/* 1 · en-tête : titre + export PDF */}
	198	+ {/* en-tête : titre + export PDF (5 rapports) */}
176	199	<div className="stats-head">
177	200	<h1 className="stats-title">L'épicerie, en chiffres</h1>
178		− <PdfButton period={dash.period.id} from={useCustom ? custom.from : undefined}
179		− to={useCustom ? custom.to : undefined} />
	201	+ <PdfButton {...pdfProps} />
180	202	</div>
181	203	<p className="sub">
182	204	Tableau de bord calculé sur les données réelles de la plateforme —
		`@@ -184,7 +206,12 @@ export default function StatsPage() {`
184	206	synchronisations. Période : <b>{dash.period.label}</b> ({dash.period.from} → {dash.period.to}).
185	207	</p>
186	208
187		− {/* 2 · sélecteur de période */}
	209	+ {/* 1 · bandeau KPI (sparklines + deltas) */}
	210	+ <div style={{ display: "grid", gridTemplateColumns: "repeat(auto-fit, minmax(180px, 1fr))", gap: 14, marginBottom: 20 }}>
	211	+ {dash.kpis.map((k) => <KpiCard key={k.id} k={k} />)}
	212	+ </div>
	213	+
	214	+ {/* 2 · sélecteur de période global */}
188	215	<div style={{ margin: "0 0 22px" }}>
189	216	<PeriodSelector
190	217	value={useCustom ? "" : period}
		`@@ -194,35 +221,56 @@ export default function StatsPage() {`
194	221	/>
195	222	</div>
196	223
197		− {/* 3 · bandeau KPI */}
198		− <div style={{ display: "grid", gridTemplateColumns: "repeat(auto-fit, minmax(165px, 1fr))", gap: 14, marginBottom: 26 }}>
199		− {dash.kpis.map((k) => <KpiCard key={k.id} k={k} />)}
200		− </div>
	224	+ {/* 3 · jauges : taux & couvertures */}
	225	+ {gauges.length > 0 && (
	226	+ <>
	227	+ <SectionTitle>Qualité & couverture des données</SectionTitle>
	228	+ <div style={{ display: "grid", gridTemplateColumns: "repeat(auto-fit, minmax(min(100%, 200px), 1fr))", gap: 14, marginBottom: 22 }}>
	229	+ {gauges.map((g) => <GaugeCard key={g.id} g={g} />)}
	230	+ </div>
	231	+ </>
	232	+ )}
201	233
202		− {/* 4 · courbes d'évolution */}
	234	+ {/* 4 · graphiques d'évolution : courbes/aires/barres + stats de séries,
	235	+ multi-courbes ≤ 4, barres empilées */}
	236	+ <SectionTitle>Évolution & tendances</SectionTitle>
203	237	<div style={{ display: "grid", gap: 18, marginBottom: 18 }}>
204		− {lines.map((s) => <LineChart key={s.id} serie={s} />)}
205		− {lines.length === 0 && <EmptyBlock title="Évolution sur la période" />}
	238	+ {dash.series.map((s) => (
	239	+ <div key={s.id}>
	240	+ <LineChart serie={s} />
	241	+ {STAT_SERIES.has(s.id) && <StatSummary serie={s} />}
	242	+ </div>
	243	+ ))}
	244	+ {dash.series.length === 0 && <EmptyBlock title="Évolution sur la période" />}
	245	+ {multi.map((ms) => <MultiLineChart key={ms.id} ms={ms} />)}
	246	+ {stacked.map((st) => <StackedBarChart key={st.id} st={st} />)}
206	247	</div>
207	248
208		− {/* 5 · barres (séries) + répartitions */}
	249	+ {/* 5 · répartitions : anneaux, barres (deltas), distributions */}
	250	+ <SectionTitle>Répartitions & distributions</SectionTitle>
209	251	<div style={{ display: "grid", gridTemplateColumns: "repeat(auto-fit, minmax(min(100%, 320px), 1fr))", gap: 18, marginBottom: 18 }}>
210		− {barSeries.map((s) => (
211		− <BarChart key={s.id} title={s.title} unit={s.unit}
212		− items={s.points.slice(-14).map((p) => ({ label: p.t, value: p.v }))} />
213		− ))}
214	252	{donuts.map((b) => <Donut key={b.id} title={b.title} items={b.items} />)}
215	253	{barBreaks.map((b) => <BarChart key={b.id} title={b.title} items={b.items} />)}
	254	+ {dists.map((d) => <Histogram key={d.id} dist={d} />)}
216	255	</div>
217	256
218		− {/* 6 · calendrier de chaleur */}
219		− {dash.heatmap && (
220		− <div style={{ marginBottom: 18 }}>
221		− <CalendarHeatmap title={dash.heatmap.title} cells={dash.heatmap.cells} />
222		− </div>
	257	+ {/* 6 · calendriers : heatmap 26 semaines + heatmap horaire 7×24 */}
	258	+ {(dash.heatmap \|\| dash.hourly) && (
	259	+ <>
	260	+ <SectionTitle>Calendriers d'activité</SectionTitle>
	261	+ <div style={{ display: "grid", gap: 18, marginBottom: 18 }}>
	262	+ {dash.heatmap && (
	263	+ <CalendarHeatmap title={dash.heatmap.title} cells={dash.heatmap.cells} />
	264	+ )}
	265	+ {dash.hourly && (
	266	+ <HourHeatmap title={dash.hourly.title} cells={dash.hourly.cells} />
	267	+ )}
	268	+ </div>
	269	+ </>
223	270	)}
224	271
225		− {/* 7 · tableaux détaillés */}
	272	+ {/* 7 · tableaux détaillés (tri, recherche, pagination) */}
	273	+ <SectionTitle>Tableaux détaillés</SectionTitle>
226	274	<div style={{ display: "grid", gap: 18, marginBottom: 18 }}>
227	275	{dash.tables.map((t) => <DataTable key={t.id} spec={t} />)}
228	276	</div>
		`@@ -233,18 +281,17 @@ export default function StatsPage() {`
233	281	{/* 9 · records & faits marquants */}
234	282	{dash.records.length > 0 && (
235	283	<section style={{ margin: "18px 0" }}>
236		− <h2 style={{ fontSize: 19, textTransform: "uppercase" }}>Records & faits marquants</h2>
	284	+ <SectionTitle>Records & faits marquants</SectionTitle>
237	285	<div style={{ display: "grid", gridTemplateColumns: "repeat(auto-fit, minmax(min(100%, 300px), 1fr))", gap: 12 }}>
238	286	{dash.records.map((r) => <RecordCard key={r.label} r={r} />)}
239	287	</div>
240	288	</section>
241	289	)}
242	290
243		− {/* 10 · fraîcheur + pied */}
	291	+ {/* 10 · fraîcheur + export PDF */}
244	292	<div style={{ display: "flex", flexWrap: "wrap", gap: 12, alignItems: "center", justifyContent: "space-between", marginTop: 24 }}>
245	293	<Fraicheur updated={dash.updated} onRefresh={load} />
246		− <PdfButton period={dash.period.id} from={useCustom ? custom.from : undefined}
247		− to={useCustom ? custom.to : undefined} />
	294	+ <PdfButton {...pdfProps} />
248	295	</div>
249	296	<p className="stats-foot">
250	297	Données réelles recalculées à chaque synchronisation (cache 5 min) —
251	298