ok

docs/specs/personnel_accueil.md

@@ -0,0 +1,68 @@
+# Personnel d’accueil (nouveaux animaux)
+
+## 1. Définition
+Personnel de service associé à l’Accueil des animaux. Il gère le check-in (quarantaine/acclimatation), la traçabilité (documents, historique) et sert de personnage contextuel lors des arrivées et incidents d’accueil.
+
+## 2. Fonctions
+*   **Check-in** : Associe l’animal livré/acheté à un slot d’accueil (contrôle capacité, timers).
+*   **Traçabilité** : Rend visibles des informations (traits révélés, historique) selon le score “Traçabilité” de l’accueil.
+*   **Quarantaine** : Surveille et signale les incidents `QUARANTINE_ALERT` avec action de consultation.
+*   **Assistance UI** : Personnage contextuel de l’Accueil et des livraisons camion.
+
+## 3. Icone
+*   **Représentation :** Tampon “OK” + caisse (logistique).
+*   **Couleur dominante :** Ambre + bleu (service).
+
+## 4. Interactions
+*   **Consultation :** Clic sur l’Accueil → bottom sheet slots (personnel visible dans le panneau).
+*   **Incident :** Clic sur badge quarantaine → panneau cause/coût/durée.
+*   **Placement :** CTA “Placer” (deep-link) vers le mode placement.
+
+## 5. Annexes Techniques
+
+### Données (JSON)
+```json
+{
+  "employee_id": "reception_staff_01",
+  "type": "personnel_accueil_animaux",
+  "name": "Sam",
+  "salary": 35,
+  "hire_cost": 0,
+  "assigned_building": "reception_uuid",
+  "state": "enum (IDLE, CHECKIN, PAPERWORK, QUARANTINE, BREAK)",
+  "iso_x": "integer",
+  "iso_y": "integer",
+  "z_index": "integer"
+}
+```
+
+### Règles Métier
+*   Par défaut, le personnel d’accueil est **lié** au bâtiment `accueil_animaux.md` (pas un employé libre).
+*   En cas d’accueil saturé, l’erreur est explicite (`RECEPTION_FULL`) et le personnage affiche l’état (pas de dégradation silencieuse).
+
+# Annexes UX/UI
+
+## 0. Direction Artistique & Vue
+*   **Vue** : Isométrique (2.5D).
+*   **Style** : Coloré, vivant, détails foisonnants (Réf: IMG_20260303_170253.jpg).
+*   **Sprites** : 4 directions.
+*   **Interactions** :
+    *   **Sélection** : Cliquer sur la base de l'élément (ou son sprite principal) pour le sélectionner.
+    *   **Feedback** : Surbrillance (outline blanc/jaune) au survol de la souris.
+
+## Affichage contextuel (modules)
+- **Accueil des animaux** (`accueil_animaux.md`) : arrivée, prêt, saturation, incident quarantaine.
+- **Camion** (`camion.md`) : arrivée au zoo, déchargement vers accueil (adulte).
+
+### Déclencheurs (exemples)
+| Module | Event / Action | Effet UI |
+|---|---|---|
+| Accueil | `OPEN_RECEPTION` | Portrait + état “slots” (libres/occupés/prêts). |
+| Accueil | `ANIMAL_ARRIVAL` | Bulle “Arrivée enregistrée” + CTA inspecter. |
+| Accueil | `ANIMAL_READY` | Bulle “Prêt à placer” + CTA “Placer”. |
+| Accueil | `RECEPTION_FULL` | Bulle “Accueil saturé” + CTA “Voir slots”. |
+| Accueil | `QUARANTINE_ALERT` | Bulle “Alerte quarantaine” + CTA “Voir détails”. |
+
+## Skins & thèmes
+*   Uniforme dépend du thème (`theme.md`) : veste, badge, clipboard.
+*   Variantes cosmétiques via `inventaire_skins.md` si le thème autorise des uniformes alternatifs.