VaultViz

Outil de data-visualization desktop local-first, fichier-comme-source-de-vérité, pour la CPAM 92.

Obsidian pour la dataviz : un exécutable local qui interprète des fichiers .vviz (JSON, spec Mosaic/vgplot) référençant des données Parquet. Pas de serveur, pas de cloud, pas de licence par utilisateur.

Objectifs

• Interpréteur de tableaux de bord BI générique : un .vviz décrit des vues (KPI, barres, courbes, camemberts, tables, carte choroplèthe), VaultViz les rend et les rend interactives (cross-filter, slicers, onglets, drill-down).
• Fichier autoporteur : le .vviz embarque ses données Parquet (base64 inline) → un seul fichier, double-clic, aucune dépendance externe. C'est le seul modèle officiel (cf. invariant I-6 / ADR-003).
• Local-first strict : tout le calcul est poussé dans DuckDB (push-down SQL), aucune donnée ne quitte le poste, aucune connexion sortante.
• Cible : parc Windows 11 de la CPAM 92, déploiement MECM/Intune, MSI signable par la DSI.

Statut

Développement du cœur applicatif V1 : terminé (45/45 stories — voir BACKLOG.md §0.3). Restent les jalons externes (signature DSI, déploiement MECM, pilote terrain, Go/No-Go V1) suivis dans BACKLOG-HORS-CORE.md.

Builds : releases MSI/EXE publiées via CI sur tag v*. Build de référence : v0.0.1-rc10 (corrige le chargement hors-ligne — voir Points d'attention).

Fonctionnalités V1

Domaine	Détail
Types de vues	KPI · barres (bar/barX/barY, classées, groupées) · line/area/dot · pie · table · map_choropleth
Interactivité	Selections cross-filter · slicers multi-valeurs (scope onglet/global) · onglets · drill-down · drill carto au clic
Cartographie	MapLibre GL JS + PMTiles (fond offline) + TopoJSON IGN ADMIN EXPRESS (départements)
Exports	PDF A4 paysage · PNG (fichier + presse-papiers) · CSV (UTF-8 BOM, données filtrées)
Données externes	Watcher FS + bannière de rechargement non intrusive
Format	.vviz autoporteur (Parquet base64 inline) — seul modèle officiel · schéma schema/vviz-v1.json

Points d'attention

• 100 % hors-ligne. VaultViz n'ouvre aucun port et n'émet aucun appel sortant (invariant I-2, ADR-008). Les extensions DuckDB nécessaires (parquet) sont liées statiquement dans le binaire — aucun téléchargement au runtime. Fonctionne sur poste verrouillé / coupé d'Internet.
• Build minimum : rc10. Les pré-releases rc8/rc9 contiennent un bug : sans parquet lié statiquement, DuckDB tentait un auto-install réseau au premier chargement → blocage ~30 s (« indexation de la source… ») sur poste sans réseau. Corrigé en rc10 ; ne pas déployer rc8/rc9.
• Lecture seule sur le share : VaultViz n'écrit jamais sur le partage réseau (invariant I-3).

Documentation

Document	Rôle	Quand le lire
PRD.md	Product Requirements Document — source de vérité	Avant toute décision produit
BACKLOG.md	Backlog cœur V1 (terminé) + suivi d'avancement	Pour suivre l'état du cœur applicatif
BACKLOG-HORS-CORE.md	Jalons externes (DSI/terrain) + contenu DLI	Pour suivre signature/déploiement/pilote
CLAUDE.md	Contrat de collaboration Claude Code	Au démarrage de chaque session IA
docs/user/user.md	Guide utilisateur (cadres non-techniciens)	Pour utiliser l'application
docs/author.md	Guide auteur de spec .vviz (data analysts)	Pour créer un tableau de bord
docs/deploy.md	Jonction CI → signature DSI → MECM	Pour le déploiement parc
docs/adr/	Architecture Decision Records détaillés	Pour comprendre une décision technique
VaultViz.md	Note d'opportunité originale (historique)	Pour comprendre la genèse

Stack

Tauri 2 (Rust + WebView2) · DuckDB natif (bundled + parquet) · Mosaic + vgplot · Apache Arrow IPC · MapLibre GL JS · PMTiles · TopoJSON IGN ADMIN EXPRESS · pdf-lib · Windows 11.

Plateforme cible

Windows 11 exclusivement — parc CPAM 92, déploiement MECM/Intune.

Contact

Auteur : A. Bergé (CPAM 92) — ab@alexandre-berge.fr