SPB Git

Repository Public

EXPORTS.md 3.8 KB

# 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).

Files main
Menu

Theme