Repository Public
1# Téléchargements universels — UQO Éval23> Depuis le 2026-10-28, **tout élément généré par la plateforme se télécharge** (PDF, XLSX, CSV, JSON) et **porte toujours la mention UQO Éval**.45## Mention67- CSV : trois lignes d'en-tête `# UQO Éval — laboratoire pédagogique…`, `# <titre>`, `# généré le <date> · <URL source>` puis une section `# <feuille>` par tableau ; BOM UTF-8 (Excel).8- XLSX : première feuille **« UQO Éval »** (titre, sous-titre, date, source, mention, liste des feuilles), puis une feuille par tableau, en-tête figé.9- PDF : couverture noire au logo UQO + « Éval », titre, sous-titre, date et source ; tableaux (≤ 80 lignes et 8 colonnes par feuille, renvoi à XLSX/CSV au-delà) ; pied de page « UQO-EVAL.APP · PLATEFORME PÉDAGOGIQUE — … · COURS IMM1003 · IMM1033 » et pagination.10- JSON : enveloppe `_uqo_eval { title, subtitle, generated, source, mention }` + le résultat.1112Textes : `UQO_MENTION_FR` / `UQO_MENTION_EN` dans `src/lib/export-generic.ts` (fr/en selon la langue de l'interface).1314## API `/api/export`1516| Méthode | Paramètres | Élément |17|---|---|---|18| GET | `kind=estimate&id=<id_provinc>` | estimation « le prix d'un… » : unité, résultat, comparables ajustés, historique du rôle, contexte de marché |19| GET | `kind=portfolio&ids=a,b,c` | parc : agrégats, une ligne par propriété, tous les comparables |20| GET | `kind=cost&id=<uuid>` | estimation enregistrée de la méthode du coût (quantités, lignes, catégories, indirects, dépréciation, repères) |21| GET | `kind=stats` | tableau de bord des statistiques (KPI, séries, répartitions, palmarès) |22| GET | `kind=prov` | « la valeur de l'immobilier québécois » (`src/data/stats.json`) |23| GET | `kind=marche` | « la mesure à l'épreuve du marché » (`src/data/marche-stats.json`) |24| GET | `kind=municipalite&slug=<slug>` | statistiques d'une municipalité (médianes par type, croissance) |25| POST | corps `{ kind, title, subtitle?, lang?, result }` (≤ 12 Mo) | tout résultat déjà calculé côté client : laboratoire hédonique (`kind=hedonique` : nuages de points et code exclus des feuilles), atelier des comparables (`avendre`), estimation du coût non enregistrée (`cost`)… |2627Commun : `format=pdf|xlsx|csv|json` (défaut xlsx), `lang=fr|en`, limite 120 requêtes/min/IP, `Content-Disposition: attachment; filename="uqo-eval_<titre>_<date>.<ext>"`.2829## Sérialisation (`toSheets`)3031Scalaires de premier niveau et objets imbriqués (profondeur ≤ 3, clés `a.b.c`) → feuille **Résumé** ; tableaux d'objets → une feuille par clé (colonnes = union des clés, sous-objets aplatis) ; tableaux imbriqués dans une ligne (ex. série → points) → feuilles `série.étiquette` ; libellés bilingues `{fr, en}` → langue demandée ; booléens → 0/1.3233## Interface3435Composant `src/components/DownloadMenu.tsx` (`kind`, `title`, `result` pour POST ou `query` pour GET, `formats`, `variant` btn/link). Présent dans : `hedonique/Report.tsx`, `ResultView.tsx`, `parc/ParcClient.tsx`, `cout/ResultPanels.tsx`, `StatsView.tsx`, `StatsDashboard.tsx`, `MarcheView.tsx`, `municipalite/[slug]/page.tsx`, `avendre/EvalWorkbench.tsx`. Le Métré garde ses exports par révision (`/api/metre/versions/[id]?format=`) et de plans (`/api/metre/pages/[id]/export`).3637## Piège connu — ligatures JetBrains Mono3839Avec le build CommonJS de `fontkit` chargé par Next.js, les ligatures de JetBrains Mono (« // », « .. », « -- », « -> ») plantent (`Offset is outside the bounds of the DataView`). `disableLigatures(doc)` (export-generic) neutralise `liga/calt/dlig` sur `text`, `widthOfString`, `heightOfString` ; appliqué aux exports universels et au rapport PDF du Métré. Test : `export-generic.test.ts` « ligatures ».4041## Tests4243`src/lib/export-generic.test.ts` (6) · `e2e/exports.spec.ts` (2, Playwright contre la production locale).44