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)
```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