- Rust 55%
- TypeScript 30%
- Svelte 12%
- Shell 2%
- JavaScript <1%
- 4 more languages <1%
🎲 VTT Data-Manager-Visuel #
Local-First · Desktop · Steam P2P · Souveraineté numérique
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 pourmake 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 :
- Ouvrir la vue Exécuter et déboguer de VS Code.
- Sélectionner
Tauri : débogage développement. - 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: falsepour é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 |
|---|---|
| Monde structuré | Préparation de partie |
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.