Guide utilisateur

Ce guide explique comment utiliser l'application selon le profil connecte :

• Administrateur
• Maitre du Donjon
• Joueur

Il est pense comme une base d'aide integrable plus tard dans une section Aide du site.

1. Introduction

RPGCombatBoard V2 est une application de conduite de campagne et de seance.

Son usage s'organise autour de trois grands besoins :

• administrer les comptes et les droits ;
• preparer, jouer et cloturer des seances ;
• permettre aux joueurs de suivre leurs personnages, leurs seances et les informations partagees.

L'application distingue clairement les roles. Un compte peut cumuler plusieurs roles, mais chaque espace garde son propre perimetre.

2. Comprendre les roles

Administrateur

L'administrateur gere surtout les comptes et les droits applicatifs.

Il peut :

• consulter le dashboard d'administration ;
• creer, modifier, activer ou desactiver des comptes ;
• attribuer ou retirer les roles applicatifs ;
• consulter certains reperes de pilotage globaux.

Il ne devient pas MJ automatiquement.

Maitre du Donjon

Le MJ pilote les campagnes et les seances.

Il peut :

• gerer ses campagnes ;
• rattacher joueurs et personnages ;
• gerer les maps, la carte courante et les projections ;
• preparer et mener une seance ;
• utiliser le board tactique ;
• gerer les combats, les logs et la cloture.

Joueur

Le joueur utilise l'espace joueur.

Il peut :

• consulter ses seances ;
• repondre a sa presence ;
• consulter ses personnages ;
• consulter son journal ;
• ouvrir certaines vues partagees comme player_info si son personnage est bien rattache au contexte.

Le joueur n'a pas acces au board tactique MJ ni aux outils d'administration.

Comptes multi-roles

Un meme compte peut cumuler plusieurs roles.

En pratique :

• un compte MJ + Joueur conserve l'acces a l'espace MJ et a l'espace joueur ;
• un compte Administrateur + MJ conserve les deux espaces ;
• un compte Administrateur + Joueur conserve les deux espaces.

Mon compte

Tout compte authentifie dispose aussi d'un espace Mon compte.

Cet ecran permet aujourd'hui de :

• verifier le compte connecte ;
• changer son mot de passe ;
• respecter la politique de securite imposee par l'application.

Le changement de mot de passe demande :

• le mot de passe actuel ;
• un nouveau mot de passe conforme ;
• une confirmation identique.

3. Guide Administrateur

3.1 Acceder a l'espace administrateur

Apres connexion, un compte disposant d'au moins un role applicatif arrive sur admin_pilotage.

Depuis cet espace, l'administrateur peut rejoindre :

• le dashboard administrateur ;
• la gestion des utilisateurs ;
• les reperes de pilotage.

3.2 Gerer les comptes utilisateurs

La gestion des utilisateurs permet de :

• creer un compte ;
• modifier son identite ;
• activer ou desactiver le compte ;
• attribuer les roles Administrateur, MJ et Joueur.

Points d'attention :

• un compte inactive ne peut plus se connecter ;
• un role donne acces a un espace precis, mais pas aux autres par inheritance implicite ;
• les changements sensibles de roles et d'authentification sont audites.

3.3 Comprendre les roles

Le bon reflexe est de raisonner en perimetre :

• Administrateur : comptes et supervision ;
• MJ : campagnes, seances, combat, ressources ;
• Joueur : personnages, seances, journal, vues partagees.

3.4 Utiliser les reperes de pilotage

La page Repères de pilotage donne une lecture transversale de l'instance.

On y retrouve notamment :

• des chiffres sur les comptes et les roles ;
• un premier suivi des comptes en ligne / vus recemment ;
• des reperes sur les espaces admin, MJ et joueur.

Cette page sert a controler rapidement l'etat general de l'application.

3.5 Consulter l'audit et les ecrans transverses

Selon les droits accordes, l'administrateur peut aussi acceder a des ecrans de controle plus transverses :

• les logs d'audit ;
• la gestion des transformations globales entre formes et bestiaire ;
• certains ecrans de supervision accessibles depuis les stats, les seances ou les logs.

Ces pages servent surtout a verifier, corriger ou auditer des actions sensibles deja effectuees ailleurs dans l'application.

4. Guide Maitre du Donjon

4.1 Vue d'ensemble de l'espace MJ

L'espace MJ est le coeur metier de l'application.

Il couvre :

• les campagnes ;
• les seances ;
• les maps ;
• le board tactique ;
• les bibliotheques MJ ;
• les logs de combat ;
• les projections joueur.

4.2 Gerer les campagnes

Une campagne sert de conteneur principal.

Depuis la gestion de campagne, le MJ peut :

• creer ou modifier une campagne ;
• definir ses informations generales ;
• rattacher des joueurs ;
• affecter des personnages ;
• ajuster leur statut et leur visibilite ;
• gerer les maps de campagne ;
• consulter la timeline de campagne ;
• utiliser les liens utiles vers le board et les vues partagees.

Bonnes pratiques :

• verifier le slug de campagne ;
• garder un roster propre ;
• distinguer les personnages actifs, inactifs ou non rattaches.

4.3 Gerer les maps

Le point d'entree principal est maintenant :

• Bibliothèque des maps

La gestion des maps se complete ensuite avec :

• Board > Maps
• Maps de seance

Bibliotheque des maps

Cette page permet de :

• retrouver ses maps et celles publiques d'autres MJ ;
• filtrer les maps rattachees, les maps non rattachees et les maps publiques d'autres MJ ;
• renommer une map ;
• modifier leur portee ;
• rattacher une map a une campagne ou la retirer d'une campagne ;
• supprimer physiquement une map orpheline quand c'est autorise.
• ouvrir l'image en grand dans une modale d'aperçu.

Retirer une map d'une campagne :

• ne supprime pas forcement le fichier ;
• rend la map orpheline ;
• la laisse visible ensuite dans la bibliotheque du MJ.

Board > Maps

Depuis le board tactique, le MJ peut :

• choisir la map affichee ;
• gerer la visibilite cote joueurs ;
• ouvrir rapidement la vue joueur ;
• ouvrir la bibliotheque pour revenir a la gestion complete si besoin.

Maps de seance

Depuis la fiche d'une seance, le MJ peut aussi :

• rattacher des maps de campagne a la seance ;
• changer leur ordre ;
• detacher une map de la seance sans la supprimer de la campagne.

Ce niveau sert a preparer les cartes utiles pour une seance precise sans melanger toute la bibliotheque de campagne.

Visibilites a connaitre

• Privee MJ : reservee au MJ
• Visible par les joueurs : visible cote joueur si la map est diffusee dans le bon contexte
• Reutilisable par les autres MJ : visible dans les bibliotheques des autres MJ en lecture seule

4.4 Creer et preparer une seance

La seance est le pivot du produit.

Une seance permet de centraliser :

• date et horaire ;
• presences ;
• briefing ;
• journal ;
• temps en jeu ;
• cartes rattachees ;
• suivi narratif ;
• combats et statistiques ;
• cloture et resume.

Le cycle principal est :

1. Préparer
2. Jouer
3. Clôturer

4.5 Utiliser l'onglet Preparer

L'onglet Preparer sert a poser le contexte avant la partie.

On y retrouve selon les besoins :

• une checklist avant seance ;
• les informations de presence ;
• le resume de la seance precedente ;
• le roster ;
• les reperes lies a la campagne ou a la seance ;
• les elements de briefing a preparer ;
• les cartes rattachees ;
• les informations a transmettre aux joueurs.

Objectif :

• arriver en seance avec un contexte clair ;
• verifier ce qui manque ;
• eviter les oublis de dernier moment.

4.6 Utiliser l'onglet Jouer

L'onglet Jouer sert pendant la partie.

Il a ete pense comme un espace de pilotage direct.

On y retrouve :

• les actions rapides ;
• le Journal live ;
• le briefing de seance ;
• le temps en jeu ;
• la timeline utile ;
• le suivi narratif et les quetes ;
• les points a traiter pendant la partie.

Usage type :

1. utiliser une action rapide ;
2. noter ce qui se passe dans le Journal live ;
3. suivre les points importants sans quitter la seance ;
4. garder une trace exploitable pour la cloture.

Le MJ peut aussi :

• ajuster l'heure en jeu de la seance ;
• enregistrer des evenements de temps ;
• faire vivre des reperes narratifs avec statut, visibilite et echeance en jeu.

4.7 Utiliser le board tactique

Le board tactique sert au pilotage des cartes, des acteurs et des combats.

Le MJ peut notamment :

• afficher la carte courante ;
• gerer les PJ et les PNJ ;
• lancer et suivre un combat ;
• utiliser l'initiative ;
• modifier les PV et PV temporaires ;
• ouvrir les projections joueur ;
• utiliser le fog de guerre ;
• consulter les logs.

Le board permet aussi de regler plusieurs parametres des vues joueur, par exemple :

• afficher ou masquer certaines zones laterales ;
• afficher ou masquer PJ, PNJ et initiative ;
• afficher ou masquer la grille.

4.8 Utiliser le compte a rebours

Le bouton Compte à rebours du board tactique permet d'ajuster un chronometre exprime en tours de jeu, mais uniquement lorsqu'un combat est deja actif.

Une fois le combat demarre :

1. cliquer sur l'icone du compte a rebours ;
2. activer le compteur ;
3. indiquer le nombre de tours souhaites.

Important :

• le compteur ne baisse pas a chaque combattant ;
• il baisse a la fin d'un round complet ;
• quand la valeur atteint 0, l'alerte visuelle se declenche.

4.9 Projections joueur : player_map et player_info

Le MJ dispose de deux vues de projection principales.

player_map

Cette vue sert a projeter :

• la carte partagee ;
• les PJ et PNJ visibles ;
• les informations utiles de combat ;
• la lecture tactique cote joueurs.

player_info

Cette vue sert a projeter :

• les personnages joueurs ;
• certaines informations de combat partagees ;
• des etats visuels simples et lisibles.

Important :

• player_map reste un outil MJ malgre son nom ;
• player_info peut aussi etre accessible a un joueur dans certains cas, si le contexte lui appartient.

4.10 Gerer le combat et les logs

Le module combat permet au MJ de :

• demarrer et terminer un combat ;
• gerer l'ordre d'initiative ;
• corriger les PV ;
• transformer un acteur et revenir a sa forme precedente quand le contexte le permet ;
• poser des contextes d'attaque ou de reaction ;
• utiliser certaines confirmations de securite sur les actions sensibles ;
• consulter et corriger les logs de combat ;
• supprimer une entree ou une session de logs avec garde-fous.

L'application inclut deja plusieurs protections utiles :

• confirmations harmonisees sur les actions sensibles ;
• garde-fous serveur sur certaines operations critiques ;
• audit et historique des manipulations importantes.

4.11 Consulter les statistiques de seance

Une seance peut aussi ouvrir vers des pages de statistiques.

Selon le contenu de la seance, le MJ peut y retrouver :

• des chiffres de combat ;
• des syntheses par acteur ;
• des timelines de combat ;
• des details utiles pour relire ce qui s'est passe.

Ces ecrans sont utiles apres la partie, mais aussi pendant la preparation de la seance suivante.

4.12 Cloturer une seance

L'onglet Clôturer sert a terminer proprement la seance.

Le lot actuel permet de suivre un parcours lisible :

1. Récompenser
2. Résumer
3. Préparer la suite
4. Clôturer

On y retrouve :

• une checklist apres seance ;
• l'XP des personnages presents ;
• le resume MJ ;
• le partage joueur ;
• les notes de cloture ;
• le bouton final de cloture.

Le cockpit de clôture donne un recap rapide sur :

• l'XP ;
• le resume MJ ;
• le partage joueur ;
• les notes de cloture ;
• l'etat de cloture de la seance.

4.13 Bibliotheques MJ

Le MJ dispose de plusieurs bibliotheques.

Bibliotheque des monstres

Elle sert a :

• consulter le bestiaire ;
• ouvrir une fiche de monstre ;
• deployer rapidement un monstre vers le board ;
• relier certaines formes d'acteur a des references de bestiaire.

Bibliotheque PNJ

Elle sert a :

• creer et modifier des modeles PNJ ;
• les supprimer si besoin ;
• les deployer rapidement pendant la preparation ou en jeu.

Bibliotheque de rencontres

Elle sert a :

• creer une rencontre preparee ;
• la completer ligne par ligne ;
• l'ouvrir dans une fiche dediee ;
• la dupliquer ou l'archiver ;
• la deployer plus vite en jeu.

5. Guide Joueur

5.1 Acceder a l'espace joueur

Le joueur utilise principalement player_dashboard.

Cet espace permet de consulter :

• ses seances ;
• ses personnages ;
• son journal ;
• son historique d'XP ;
• certaines vues partagees.

5.2 Consulter ses seances

L'onglet Séances permet de lire les seances sous deux formes :

• Liste
• Calendrier

Vue liste

La vue liste est utile pour :

• comparer rapidement plusieurs seances ;
• verifier leur statut ;
• retrouver facilement l'action de presence ;
• voir les autres personnages deja inscrits et l'etat visible de leur reponse ;
• ouvrir les statistiques de combat d'une seance quand elles existent.

Vue calendrier

La vue calendrier est utile pour :

• visualiser les seances mois par mois ;
• naviguer entre les mois ;
• repérer plus vite les campagnes planifiees ;
• distinguer les seances PJ et MJ si le compte cumule plusieurs roles.

La legende sous le calendrier permet de comprendre :

• le statut de la seance par la couleur de fond ;
• le role PJ ou MJ par un badge.

5.3 Repondre a sa presence

Le joueur peut repondre a la presence de ses personnages quand la seance l'autorise.

Bon a savoir :

• la reponse concerne uniquement ses propres personnages ;
• les reponses des autres inscrits peuvent etre visibles a titre informatif dans le tableau des seances ;
• elle se fait personnage par personnage ;
• une seance terminee ou annulee ne se modifie plus librement cote joueur ;
• le MJ garde un droit de correction cote administration.

5.4 Consulter ses personnages

Le joueur peut consulter les personnages rattaches a son compte.

Selon les droits et les formulaires exposes, il peut aussi modifier les champs autorises de sa fiche, sans acceder aux outils tactiques reserves au MJ.

5.5 Consulter son journal

Le joueur peut retrouver son journal et certaines informations historiques reliees a ses personnages et a ses seances.

Cet espace sert notamment a :

• relire les entrees visibles ;
• suivre les seances deja jouees ;
• consulter un historique d'XP ;
• retrouver certains chiffres de combat ou moments marquants selon les donnees disponibles.

Cet espace sert a garder un suivi personnel de la campagne sans passer par le board MJ.

5.6 Consulter player_info

Un joueur peut ouvrir player_info uniquement si au moins un de ses personnages est rattache a la campagne cible.

Cette vue permet de consulter les informations partagees par le MJ, dans un format plus lisible pour les joueurs que le board tactique.

5.7 Ce qu'un joueur ne peut pas faire

Un joueur pur ne peut pas :

• ouvrir le board tactique MJ ;
• ouvrir player_map ;
• gerer les campagnes ;
• acceder aux bibliotheques MJ ;
• gerer les comptes utilisateurs ;
• corriger les logs de combat.

6. Parcours typiques

6.1 Administrateur : creer un compte et lui donner un role

1. ouvrir la gestion des utilisateurs ;
2. creer ou modifier le compte ;
3. activer le compte ;
4. attribuer le bon role ;
5. verifier que le perimetre attendu est bien accessible.

6.2 MJ : creer une campagne et lancer une premiere seance

1. creer la campagne ;
2. rattacher les joueurs ;
3. affecter les personnages ;
4. ajouter les premieres maps ;
5. creer la seance ;
6. preparer le briefing, les cartes et les repères utiles ;
7. passer dans Jouer pendant la partie ;
8. terminer dans Clôturer.

6.3 MJ : preparer un combat et projeter les infos joueurs

1. ouvrir le board tactique ;
2. verifier la carte courante ;
3. placer les acteurs utiles ;
4. demarrer le combat ;
5. ouvrir player_map ou player_info selon le besoin ;
6. utiliser le compte a rebours si la scene l'exige.

6.4 Joueur : repondre a une seance

1. ouvrir player_dashboard ;
2. aller dans Séances ;
3. retrouver la seance en Liste ou en Calendrier ;
4. ouvrir l'entree concernee ;
5. enregistrer sa reponse de presence pour le bon personnage.

6.5 MJ : preparer la suite d'une seance

1. ouvrir la fiche de seance ;
2. verifier le cockpit de clôture ;
3. completer l'XP, le resume MJ et le partage joueur ;
4. consigner les notes de cloture ;
5. cloturer la seance ;
6. revenir ensuite a la timeline de campagne ou aux stats si besoin.

7. Questions frequentes

Quelle difference entre player_map et player_info ?

• player_map est une projection carte reservee au MJ ;
• player_info est une vue partagee plus orientee informations joueur.

Pourquoi une action est-elle refusee ?

Les refus viennent en general de l'un des cas suivants :

• mauvais role ;
• campagne ou personnage hors perimetre ;
• seance deja terminee ou annulee ;
• ressource appartenant a un autre MJ ;
• garde-fou metier sur une action sensible.

A quoi sert la timeline de campagne ?

La Timeline campagne sert a relire une campagne dans la duree.

Elle croise notamment :

• les seances ;
• le temps en jeu ;
• le journal ;
• les combats ;
• les reperes narratifs.

Elle est utile pour reprendre le contexte, retrouver un evenement ou preparer la suite.

Que trouve-t-on dans les statistiques de seance ?

Les statistiques de seance rassemblent surtout les informations de combat deja journalisees :

• chiffres globaux ;
• details par acteur ;
• timeline de combat.

Si aucune donnee exploitable n'existe encore, certains blocs peuvent naturellement rester vides.

Que signifie une map privee, partagee ou publique ?

• Privée : reservee au MJ
• Partagée : visible cote joueur dans le bon contexte
• Publique : reutilisable selon les regles inter-MJ du module

Comment savoir si une seance est prete a etre cloturee ?

L'onglet Clôturer affiche deja les principaux reperes :

• XP renseignee ou non ;
• resume MJ pret ou non ;
• partage joueur active ou non ;
• notes de cloture presentes ou non ;
• etat global de cloture.

8. Glossaire

Campagne

Conteneur principal de jeu. Elle regroupe joueurs, personnages, maps et seances.

Seance

Unite de jeu preparee, jouee puis cloturee dans l'application.

Board

Interface tactique MJ pour la carte, les acteurs, le combat et les projections.

Map courante

Carte active utilisee comme reference principale dans le board ou les projections.

Map orpheline

Map non rattachee a une campagne, conservee dans la bibliotheque pour etre reaffectee plus tard.

Resume MJ

Resume de reference saisi par le MJ apres la seance.

Partage joueur

Option qui rend certaines informations visibles cote joueur.

Compte a rebours

Chronometre exprime en tours de jeu, utilisable pendant un combat actif.

Timeline de campagne

Vue transversale qui regroupe les reperes d'une campagne dans le temps : seances, journal, combats, temps en jeu et elements narratifs.

9. Limites et remarques

• certaines vues restent conditionnelles selon le role et le rattachement du compte ;
• player_map reste reserve au MJ malgre son nom ;
• certains automatismes de cloture de seance restent encore partiels ;
• la documentation d'aide pourra encore etre enrichie avec des captures et des parcours plus détaillés au moment de son integration dans le site.