Le "VTT Data-Manager-Visuel" (VTT-DMV) est une application de bureau (Windows/Mac) distribuée via Steam, destinée aux Maîtres du Jeu (MJ) de
README.md

🎲 VTT Data-Manager-Visuel #

Local-First · Desktop · Steam P2P · Souveraineté numérique

Rust Tauri Svelte SurrealDB Licence: GPL v3

VTT-DMV est une application desktop tout-en-un pour les Maîtres de Jeu de jeux de rôle sur table.
Elle fusionne trois familles d'outils dans une seule app :

Création de monde Table virtuelle spatiale Outils de table
Wiki structuré (lieux, persos, orgas…) Rendu 2D canvas/WebGL Jet de dés
Relations typées et valuées Tokens draggable, brouillard de guerre Traqueur d'initiative
Templates de propriétés par genre Import de maps, calques Marqueurs d'état, compteurs

🔑 Philosophie #

100% local. Toutes les données et images vivent sur le disque dur du MJ. Pas de cloud, pas de compte, pas de serveur.

Le soir de la partie, les joueurs rejoignent instantanément via le réseau P2P de Steam — sans config IP, sans port forwarding. Le MJ garde la souveraineté totale sur son univers.

    ┌──────────────┐
    │   Disque MJ  │  ← Toutes les données, zéro cloud
    └──────┬───────┘
           │
    ┌──────┴───────┐
    │  Steam P2P   │  ← Les joueurs se connectent en un clic
    └──────────────┘

🧱 Stack technique #

Couche Technologie Rôle
Shell desktop Tauri v2 Fenêtre native, accès système, signatures
Frontend Svelte 5 + SvelteKit 3 + Vite 8 UI réactive, rendu 2D
Backend Rust Tokio Tâches async, réseau, fichiers
Base de données SurrealDB 3.2.5 (SurrealKV) Graphe embarqué, multi-modèle
Réseau P2P Steamworks SDK NAT traversal, lobby, invitations

📁 Structure #

├── src-tauri/              # Backend Rust (binaire Tauri)
│   ├── src/
│   │   ├── main.rs         # Point d'entrée
│   │   ├── lib.rs          # Point de composition Tauri
│   │   ├── domain/         # Entités et règles métier
│   │   ├── application/    # Cas d'usage et ports
│   │   ├── infrastructure/ # SurrealDB, fichiers et réseau
│   │   └── interfaces/     # Commandes Tauri
│   ├── Cargo.toml
│   └── tauri.conf.json
├── frontend/               # Frontend SvelteKit (UnoCSS + Bits UI + Lucide)
│   ├── src/
│   │   ├── routes/         # Pages SvelteKit
│   │   └── lib/
│   │       ├── components/ # Composants par domaine (ADR-0009)
│   │       │   ├── ui/     # Boutons, inputs, dialogues…
│   │       │   ├── workspace/ # Grille, panneaux, brouillard…
│   │       │   ├── entities/  # Fiches, relations, tags…
│   │       │   ├── table/     # Dés, initiative, tokens…
│   │       │   ├── campaign/  # Export, import, paramètres…
│   │       │   └── layout/    # AppShell, Sidebar, Toolbar…
│   │       ├── assets/    # Ressources frontend locales
│   │       ├── contracts/ # Validateurs runtime Valibot
│   │       ├── data/      # Données statiques typées
│   │       ├── state/     # État partagé Svelte 5
│   │       └── types/     # Types TypeScript
│   └── package.json
├── DOCUMENTATION/
│   ├── 10 - Produit /
│   │   ├── 11-cadrage/         # Discovery Brief, contexte produit
│   │   ├── 12-prd/             # PRD et synthèse produit
│   │   │   ├── architecture-produit-vtt-ameliorate.md
│   │   │   ├── 01-monde-du-jeu.md
│   │   │   ├── 02-workspace-visuel.md
│   │   │   ├── 03-session-de-table.md
│   │   │   ├── 04-assets-et-medias.md
│   │   │   ├── 05-permissions-et-securite.md
│   │   │   ├── 06-reseau-et-session.md
│   │   │   └── 07-schema-architecture-produit.md
│   │   └── 13-roadmap/         # Roadmap et jalons de produit
│   ├── 20-technique/
│   │   ├── 21-spec/            # SPECs techniques
│   │   ├── 22-exploitation/    # Runbooks (export, CI, property kits)
│   │   ├── 25-politique-test/  # Stratégie de test, conventions
│   │   ├── 27-veille/          # Rapports PoC, benchmarks
│   │   └── 28-frontend/        # Design system, pages, surfaces et composants
│   └── 30-decisions/           # ADRs architecturaux
├── backlog/                    # Tâches, milestones
├── Makefile                    # Commandes de build
└── CHANGELOG.md

🚀 Quick start #

Prérequis #

  • Rust 1.85+
  • Node.js 22+
  • npm 10+
  • cargo-tauri 2.x (cargo install tauri-cli --version '^2' --locked)
  • cargo-nextest (cargo install cargo-nextest --locked) — requis pour make quality / make test
  • Steamworks SDK (optionnel — pour la feature réseau P2P)
# Installer les dépendances frontend depuis le lockfile
cd frontend && npm ci && cd ..

# Lancer en mode développement
make dev

# Builder le binaire standalone
make build

Débogage avec VS Code #

Le workspace recommande les extensions CodeLLDB et Tauri. Après leur installation :

  1. Ouvrir la vue Exécuter et déboguer de VS Code.
  2. Sélectionner Tauri : débogage développement.
  3. Appuyer sur F5.

La tâche préalable démarre Vite sur le port 5173, puis CodeLLDB compile et lance explicitement le binaire vtt-dmv. Les points d’arrêt Rust peuvent alors être posés dans src-tauri/.

WebKitGTK 2.52 — UnoCSS est configuré avec hmrTopLevelAwait: false pour éviter une course du chargeur de modules qui interrompait l’hydratation SvelteKit dans la WebView Tauri. Ce contournement suit UnoCSS #5257 et reste nécessaire jusqu’à la distribution du correctif WebKit #57827 par les distributions Linux.

Avec Steamworks (nécessite le SDK) #

# Activer la feature steamworks
cargo build --release -p vtt-dmv --features steamworks

📋 MVP — 13 fonctionnalités #

# Feature Statut
F01 Base de données de monde souveraine (19 types d'entités) ✅ M4 — CRUD monde (SPEC-014)
F02 Workspace spatial 2D avec tokens draggable ✅ M4/M5 — rendu Canvas/WebGL (SPEC-002)
F03 Réseau P2P Steamworks zéro-config ✅ Implémenté (TASK-151) — recette 2 clients Steam à valider (SPEC-003)
F04 Sécurité Payload Router (permissions champ) 🟡 Moteur livré ; UI permissions → TASK-178 (SPEC-004)
F05 Gestion des médias (images, cartes) ✅ M4/M5 — import, classification et streaming (SPEC-005)
F06 Éditeur de token ✅ M5 (SPEC-006)
F07 Recherche full-text et filtres 🔲 M6 — TASK-161 (SPEC-007)
F08 Export/Import (JSON, worldbuilding produit) 🔲 M6 — TASK-162 (SPEC-008)
F09 Accessibilité, thème sombre, navigation clavier ✅ M3/M4 (SPEC-009)
F10 Jets de dés, marqueurs d'état, compteurs ✅ M5 (SPEC-010)
F11 Interactions MJ↔Joueurs (chat, épinglage, loot) ✅ M5 (SPEC-011) — recette P2P à faire
F12 Gestion personnages joueurs (fiche, inventaire) ✅ M5 (SPEC-012)
F13 Outils tactiques (grille, brouillard, mesure) 🔲 Non démarré — SPEC-F13 à rédiger (grille/placement couverts par F02)

🗺️ Roadmap #

Milestone Objectif Statut
M0 Socle documentaire & décisions ✅ Terminé (13/07/2026)
M1 Infrastructure cœur (stack, DB, 3 PoC, 4 SPECs, 8 ADRs) ✅ Terminé (16/07/2026)
M2 Complétion documentaire (38 ADRs, 9 SPECs) ✅ Terminé (27/07/2026, archivé)
M3 Design System & Fondations (composition par domaine) ✅ Terminé (02/09/2026)
M4 Features cœur & Wireframes ✅ Terminé (112/112)
M5 Outils de table ✅ Terminé (121/121)
M6 Fonctions transverses 🔄 En cours (57/79)
M7 Polish & distribution Steam 🔄 Démarré (8/15)

Phase active : M6 (Fonctions transverses) à 57/79 et M7 (Polish & distribution) à 8/15.

  • Plan actif : DOCUMENTATION/10 - Produit /13-roadmap/roadmap-mvp.md (v6.0)
  • Historique des versions de la roadmap : DOCUMENTATION/10 - Produit /13-roadmap/roadmap-changelog.md
  • Archive des milestones soldés (M0 → M5) : DOCUMENTATION/10 - Produit /13-roadmap/roadmap-historique-m0-m5.md
  • Livraisons produit : CHANGELOG.md

📚 Documentation #

Toute la doc est dans /DOCUMENTATION :

  • 10 - Produit → PRD, roadmap, guide utilisateur
  • 20 - Technique → SPECs, glossaire, sécurité, veille
  • 30 - Décisions → ADRs (Architecture Decision Records)
  • 40 - Exploitation → Runbooks, audits

Pour toute évolution d'interface, consulter la convention de construction des pages, le registre des surfaces UI, le guide des pages et le catalogue des composants.

Le modèle de données est visualisé dans un ERD D2 : vue graphique du schéma réel.

Aperçus design #

Le catalogue des wireframes SVG regroupe les fondations visuelles et les variantes d’interface consultables directement dans Tangled. Ces maquettes illustrent les quatre usages centraux : organiser le workspace, gérer les médias locaux, structurer le monde et préparer les personnages ou scénarios.

Workspace spatial Assets locaux
Workspace spatial avec sidebars et panneaux Explorateur d’assets avec collections et tags
Monde structuré Préparation de partie
Gestionnaire des fiches et relations Fiche personnage avec statistiques et progression

Chaque aperçu ouvre le SVG original, lisible et versionnable. La fiche scénario, les fondations Dark/Light et les états détaillés du workspace restent accessibles dans l’index complet ci-dessous.

Fondations et thèmes Layout Workspace Assets et fiches
Fondations App shell Canvas par défaut Explorateur d’assets
Dark/Light Sidebar déployée Panneaux flottants Gestionnaire des fiches
Sidebar repliée Toolbar contextuelle Fiche personnage
Sidebar à droite Fiche scénario
Double sidebar

🛠️ Commandes Makefile #

Commande Description
make dev-setup Installe les outils requis (cargo-nextest, cargo-dupes) + les hooks git (pre-commit/pre-push)
make quality-staged Gate de commit (pre-commit) : fmt + lint des fichiers indexés + gates statiques
make quality Gate complète (fin de tâche / pre-push) : clippy, tests, tests navigateur, audits — rejouée seulement si l'arbre a changé (ADR-0058)
make quality-force Gate complète en ignorant l'empreinte d'arbre
make quality-online Gate complète + npm audit et base d'avis cargo fraîche (CI, réseau ouvert)
make doc Génère la documentation Rust (hors gate, avant release)
make dev Lancer Tauri + SvelteKit en mode dev
make build Builder le binaire release
make fmt Formater Rust + JS
make lint Linter Rust + JS
make test Tests Rust (nextest) + frontend (vitest)
make clean Nettoyer les artifacts de build
make prune Purger les résidus régénérables (cache incrémental, doc générée) sans perdre les dépendances compilées

📝 Licence #

GNU General Public License v3.0 © 2026 — Logiciel libre (copyleft).

Le code source est utilisable, modifiable et redistribuable librement. Toute version dérivée distribuée doit publier son code source sous la même licence (GPL v3). La vente est autorisée.