ok

docs/specs/personnage_generique.md

@@ -8,6 +8,52 @@ Entité active dans le jeu, qu'elle soit contrôlée par un humain, une IA ou un
 - **Bot** : IA gérant un zoo concurrent.
 - **Visiteur** : PNJ se promenant dans le zoo.
 - **Animal** : Entité biologique gérée par le joueur.
+- **Staff (Employé / PNJ de service)** : Personnage de service (accueil, guichet, boutique, recherche, soin, sécurité, nurserie, laboratoire).
+
+## Skins, thèmes et personnalisation
+Les personnages (joueur, visiteurs, bots, staff) sont rendus avec une combinaison :
+- **Thème global** : voir `theme.md` (palette, ambiance UI, décor, uniformes).
+- **Skins** : voir `skin.md` et l’équipement/possession via `inventaire_skins.md`.
+
+### Règles de rendu (contrat)
+- Un personnage peut avoir des **variantes visuelles** (uniforme, accessoires, palette) déterminées par le thème et les skins équipés.
+- Les personnages affichés dans une UI (portrait, badge, “paper doll”, bulle) doivent rester **cohérents** avec l’avatar/skin courant.
+- Un même rôle (ex. “vendeur”) peut avoir plusieurs skins, mais **un skin actif** doit être explicite (pas d’auto-déduction silencieuse).
+
+## Personnage contextuel de module (UI)
+Certains modules affichent un **personnage contextuel** quand le module est actionné ou lorsqu’un événement lié au module survient.
+
+### Objectifs
+- **Ancrage** : associer un module à un rôle (ex. Nurserie → Nurse).
+- **Interaction** : proposer des actions directes (1 clic) et des explications factuelles (état, cause, prochaine action).
+- **Cohérence cosmétique** : appliquer thème + skins sur le personnage.
+
+### Déclencheurs (génériques)
+- **Ouverture / activation** : ouverture d’un panneau, sélection d’un bâtiment, entrée dans un mode (build, gestion).
+- **Événement module** : arrivée, incident, succès d’une action, blocage explicite (fonds insuffisants, capacité pleine, gating réputation).
+- **État critique** : un statut “critique” du module est actif (ex. nurserie pleine, alerte quarantaine, alerte sécurité).
+
+### Interactions (génériques)
+- **Clic** : ouvre l’écran/action la plus pertinente du module (deep-link).
+- **Survol / tap** : affiche une fiche courte (rôle + état + action possible).
+- **Dialogue/bulle** : messages informatifs liés à un événement (sans “best effort”, sans masquage d’erreur).
+
+### Index des rôles (spécifications associées)
+- **Visiteurs homme/femme** : `visiteur.md`
+- **Joueur actif (avatar + pseudo + skins + profil)** : `joueur.md`, `avatar_joueur.md`, `inventaire_skins.md`
+- **Autres joueurs** : `joueur.md` (représentation externe) + `avatar_joueur.md` (portrait partagé)
+- **Bots** : `bot.md`
+- **Chercheur** : `chercheur.md`
+- **Nourisseur** : `nourisseur.md`
+- **Soigneur** : `soigneur.md`
+- **Agent de sécurité** : `agent_securite.md`
+- **Nurse (nurserie)** : `nurse.md`
+- **Personnel d’accueil (nouveaux animaux)** : `personnel_accueil.md`
+- **Guichetière (billetterie)** : `guichetiere.md`
+- **Vendeur (boutique)** : `vendeur.md`
+- **Vendeur “achat en pièces” (menu achats / conversion monnaies)** : `vendeur_pieces.md`
+- **Laborantin (site laboratoire carte monde)** : `laborantin.md`
+- **Maire (ville / carte monde)** : `maire.md`
 
 # Annexes Techniques