builazoo/docs/specs/accueil_animaux.md

Spécifications : Accueil des Animaux

Définition

Zone tampon pour les nouveaux animaux arrivant dans le zoo (achats adultes ou transferts).

Fonctionnalités

• Acclimatation : Période obligatoire avant de pouvoir placer l'animal sur la grille active.
• Stockage temporaire : Évite de devoir placer immédiatement un animal acheté si le terrain n'est pas prêt.

Niveaux d'Amélioration (7 niveaux)

• Coût : Progressif par palier.
• Effet : Réduit le temps d'acclimatation. Améliore le potentiel reproducteur de l'animal entrant.
• Ratio : 1 unité couvre 1 animal en cours d'accueil.

Annexes Techniques

1. Données et États

Modèle de Données (JSON)

{
  "id": "uuid",
  "type": "animal_reception",
  "level": "integer (1-7)",
  "slots": [
    { "animal_id": "uuid", "arrival_time": "timestamp", "ready_time": "timestamp" }
  ]
}

Caractéristiques Initiales

Caractéristique	Valeur Initiale (Niv 1)
Temps Acclimatation	10 minutes
Capacité	1 animal

Scores Initiaux

N/A

2. Cycles de Vie et Apparition

Conditions d'Apparition

Présent au démarrage.

Conditions de Disparition

Indestructible.

Hérédité

N/A

3. Impacts Environnementaux

Impact Température

Zone neutre (T° idéale simulée).

Impact Milieu (Biome)

Zone neutre.

Impact Saisons

Protégé.

Impact Heure / Jour-Nuit

N/A

4. Impacts Biologiques et Sociaux

Impact Reproduction

Bonus Repro : Un animal passant par un accueil de haut niveau gagne un bonus temporaire de fertilité (+10% à +50%).

Impact Mort

Pas de mort possible en zone d'accueil (Stase).

Impact Nourriture

Nourri automatiquement.

Impact Attractivité (Visiteurs/Animaux)

N/A

Impact Valeur

N/A

5. Impacts Logistiques et Économiques

Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)

Réduction Temps Acclimatation :

Niveau	Temps Base
1	10 min
2	8 min
3	6 min
4	4 min
5	2 min
6	1 min
7	Instantané

Dépenses (Boutiques/Visiteurs)

N/A

Trajet Visiteurs

N/A

6. Événements

Événements du Jeu / Carte / Zoo / Ville / Visiteur

• Arrivée : Animal livré par camion.
• Prêt : Animal prêt à être placé.

7. Progression

Tableau des Upgrades

Niveau	Coût (Pièces)	Capacité	Temps Acclimatation	Temps Construction
1	100	1	10 min	0s
2	200	2	8 min	0s
3	400	3	6 min	0s
4	800	4	4 min	0s
5	1600	5	2 min	0s
6	3200	6	1 min	0s
7	6400	7	0 min	0s

8. Logique et Interfaces

Pseudo-code Impacts

function updateReception(center):
  for slot in center.slots:
    if currentTime >= slot.ready_time:
      notifyPlayer("ANIMAL_READY", slot.animal_id)

Messages d'Infos / Alerte

ID	Niveau	Message
ANIMAL_READY	Info	"Un nouvel animal est prêt à rejoindre le zoo !"
RECEPTION_FULL	Warning	"Accueil saturé, impossible d'acheter."

Annexes UX/UI

1. Expérience Utilisateur (UX)

Arrivée Animal (Passif)

Description UX : Le camion décharge un animal. Il apparaît dans l'Accueil en mode "Attente". Description UI : Notification "Livraison effectuée". L'icône de l'Accueil change (ex: porte fermée -> porte avec caisse devant). Notification Push : "Votre [Animal] est arrivé à l'accueil !" envoyée si le joueur est hors ligne. Emplacement : Case Accueil. Intégration : Suite de l'action Camion. Navigation : N/A Événements : DELIVERY_COMPLETE.

Assets

• Musiques : N/A
• Sons : truck_door.mp3, crate_drop.mp3.
• Graphiques : Sprite Caisse en bois.
• Images : N/A
• Vidéos : N/A
• Animations : Camion qui repart.
• Couleurs : Marron (Caisse).
• Textes : N/A
• Formes : N/A

Consultation & Acclimatation (Consultation)

Description UX : Le joueur vérifie le temps restant avant de pouvoir placer l'animal. Description UI : Bottom Sheet listant les animaux en transit. Barre de progression "Acclimatation" pour chacun. Emplacement : Modal Accueil. Intégration : Liste verticale. Navigation : Clic Accueil -> Modal. Événements : OPEN_RECEPTION.

Assets

• Musiques : N/A
• Sons : ui_open.mp3
• Graphiques : Style "Quarantaine" ou "Étable propre".
• Images : Portrait animal.
• Vidéos : N/A
• Animations : Barre de progression qui avance.
• Couleurs : Orange (En cours), Vert (Prêt).
• Textes : "Prêt dans X min".
• Formes : Barres arrondies.

Transfert vers Zoo (Action)

Description UX : L'animal est prêt. Le joueur le glisse vers le zoo. Description UI : Bouton "Placer" ou Drag & Drop depuis la liste. Alternative : Tap to Select -> Tap to Place. Emplacement : Modal Accueil -> Carte Zoo. Intégration : Mode placement (comme Nurserie). Navigation : Drag -> Drop. Événements : PLACE_ANIMAL.

Assets

• Musiques : N/A
• Sons : animal_happy.mp3 (cri de l'animal).
• Graphiques : Sprite Animal.
• Images : N/A
• Vidéos : N/A
• Animations : Animal qui saute de joie au placement.
• Couleurs : N/A
• Textes : N/A
• Formes : N/A