Téléchargements universels — UQO Éval
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.
Mention
- 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). - XLSX : première feuille « UQO Éval » (titre, sous-titre, date, source, mention, liste des feuilles), puis une feuille par tableau, en-tête figé.
- 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.
- JSON : enveloppe
_uqo_eval { title, subtitle, generated, source, mention }+ le résultat.
Textes : UQO_MENTION_FR / UQO_MENTION_EN dans src/lib/export-generic.ts (fr/en selon la langue de l'interface).
API /api/export
| Méthode | Paramètres | Élément |
|---|---|---|
| GET | kind=estimate&id=<id_provinc> |
estimation « le prix d'un… » : unité, résultat, comparables ajustés, historique du rôle, contexte de marché |
| GET | kind=portfolio&ids=a,b,c |
parc : agrégats, une ligne par propriété, tous les comparables |
| 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) |
| GET | kind=stats |
tableau de bord des statistiques (KPI, séries, répartitions, palmarès) |
| GET | kind=prov |
« la valeur de l'immobilier québécois » (src/data/stats.json) |
| GET | kind=marche |
« la mesure à l'épreuve du marché » (src/data/marche-stats.json) |
| GET | kind=municipalite&slug=<slug> |
statistiques d'une municipalité (médianes par type, croissance) |
| 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)… |
Commun : 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>".
Sérialisation (toSheets)
Scalaires 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.
Interface
Composant 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).
Piège connu — ligatures JetBrains Mono
Avec 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 ».
Tests
src/lib/export-generic.test.ts (6) · e2e/exports.spec.ts (2, Playwright contre la production locale).