Files
builazoo/docs/specs/personnel_accueil.md
2026-03-05 04:01:29 +01:00

69 lines
3.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Personnel daccueil (nouveaux animaux)
## 1. Définition
Personnel de service associé à lAccueil 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 daccueil.
## 2. Fonctions
* **Check-in** : Associe lanimal livré/acheté à un slot daccueil (contrôle capacité, timers).
* **Traçabilité** : Rend visibles des informations (traits révélés, historique) selon le score “Traçabilité” de laccueil.
* **Quarantaine** : Surveille et signale les incidents `QUARANTINE_ALERT` avec action de consultation.
* **Assistance UI** : Personnage contextuel de lAccueil et des livraisons camion.
## 3. Icone
* **Représentation :** Tampon “OK” + caisse (logistique).
* **Couleur dominante :** Ambre + bleu (service).
## 4. Interactions
* **Consultation :** Clic sur lAccueil → 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 daccueil est **lié** au bâtiment `accueil_animaux.md` (pas un employé libre).
* En cas daccueil saturé, lerreur 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.