builazoo/docs/specs/billeterie.md

# Spécifications : Billeterie

## Définition
Bâtiment d'entrée du zoo. Point d'apparition et de départ des visiteurs.

## Fonctionnalités
- **Entrée/Sortie** : Génère le flux de visiteurs.
- **Vente de tickets** : Génère des revenus par visiteur entrant.
- **Capacité** : Limite le nombre de visiteurs simultanés dans le zoo.

## Niveaux d'Amélioration (7 niveaux)
- **Coût** : Progressif par palier.
- **Effet** : Augmente le prix du ticket et la capacité maximale de visiteurs simultanés.
- **Ratio** : 1 unité couvre 20 visiteurs simultanés max.

# Annexes Techniques

## 1. Données et États
### Modèle de Données (JSON)
```json
{
  "id": "uuid",
  "type": "ticket_booth",
  "level": "integer (1-7)",
  "position": { "x": "int", "y": "int" },
  "stats": {
    "total_entries": "integer",
    "daily_revenue": "integer"
  }
}
```

### Caractéristiques Initiales
| Caractéristique | Valeur Initiale (Niv 1) |
| :--- | :--- |
| Prix Ticket | 10 pièces |
| Capacité Max | 20 visiteurs |

### Scores Initiaux
N/A

## 2. Cycles de Vie et Apparition
### Conditions d'Apparition
Présent au démarrage (Unique).

### Conditions de Disparition
Indestructible.

### Hérédité
N/A

## 3. Impacts Environnementaux
### Impact Température
N/A

### Impact Milieu (Biome)
N/A

### Impact Saisons
| Saison | Modificateur Prix Ticket |
| :--- | :--- |
| Été | +20% (Haute saison) |
| Hiver | -10% (Basse saison) |

### Impact Heure / Jour-Nuit
**Ouverture** : 08h00 - 20h00. Fermé la nuit (sauf événements).

## 4. Impacts Biologiques et Sociaux
### Impact Reproduction
N/A

### Impact Mort
N/A

### Impact Nourriture
N/A

### Impact Attractivité (Visiteurs/Animaux)
Point d'entrée unique. L'attractivité globale du zoo détermine le flux qui se présente à la billeterie.

### Impact Valeur
N/A

## 5. Impacts Logistiques et Économiques
### Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)
**Flux Entrée** : 1 visiteur / seconde max.

### Dépenses (Boutiques/Visiteurs)
Revenu principal (Ticket).

### Trajet Visiteurs
Point de départ (Spawn) et d'arrivée (Despawn).

## 6. Événements
### Événements du Jeu / Carte / Zoo / Ville / Visiteur
*   **Entrée** : Gain pièces.
*   **Refoulement** : Si Capacité Max atteinte.

## 7. Progression
### Tableau des Upgrades
| Niveau | Coût (Pièces) | Prix Ticket | Capacité Max | Temps Construction |
| :--- | :--- | :--- | :--- | :--- |
| 1 | 0 (Base) | 10 | 20 | 0s |
| 2 | 200 | 12 | 40 | 0s |
| 3 | 400 | 15 | 70 | 0s |
| 4 | 800 | 18 | 110 | 0s |
| 5 | 1600 | 22 | 160 | 0s |
| 6 | 3200 | 28 | 220 | 0s |
| 7 | 6400 | 35 | 300 | 0s |

## 8. Logique et Interfaces
### Pseudo-code Impacts
```
function processEntry(zoo):
  potentialVisitors = calculateAttractionFlow(zoo)
  
  if zoo.currentVisitors >= zoo.billeterie.capacity:
    emitEvent("ZOO_FULL")
    return
    
  actualVisitors = min(potentialVisitors, zoo.billeterie.capacity - zoo.currentVisitors)
  
  for i in 0..actualVisitors:
    spawnVisitor()
    player.addCoins(zoo.billeterie.ticketPrice)
```

### Messages d'Infos / Alerte
| ID | Niveau | Message |
| :--- | :--- | :--- |
| `ZOO_FULL` | Alerte | "Le zoo est complet ! Agrandissez la billeterie." |

# Annexes UX/UI

## 1. Expérience Utilisateur (UX)
### Consultation
**Description UX** : Le joueur clique sur la billeterie pour voir ses statistiques et son niveau.
**Description UI** : **Bottom Sheet** ou Panneau Latéral affichant le niveau actuel, la capacité, le prix du ticket et les revenus du jour.
**Emplacement** : Case Billeterie sur la grille du zoo.
**Intégration** : Bâtiment fixe (ne peut pas être déplacé ou supprimé).
**Navigation** : Clic -> Ouverture Panneau -> Fermeture (Croix ou clic extérieur).
**Événements** : `CLICK_BILLETERIE`.

#### Assets
- **Musiques** : N/A
- **Sons** : `ui_open.mp3`
- **Graphiques** : Pixel Art, style guichet.
- **Images** : `billeterie_lvl[1-7].png`
- **Vidéos** : N/A
- **Animations** : Légère surbrillance au survol.
- **Couleurs** : Palette UI standard.
- **Textes** : "Billeterie", "Niveau X", "Revenus : Y".
- **Formes** : Carré (case).

### Amélioration (Upgrade)
**Description UX** : Le joueur décide d'améliorer la billeterie pour augmenter la capacité et le prix du ticket.
**Description UI** : Bouton "Améliorer" dans le panneau de consultation, avec coût et prévisualisation des gains.
**Emplacement** : Panneau de consultation.
**Intégration** : Action immédiate si fonds suffisants.
**Navigation** : Clic "Améliorer" -> Confirmation (optionnelle) -> Mise à jour UI.
**Événements** : `UPGRADE_BILLETERIE`.

#### Assets
- **Musiques** : N/A
- **Sons** : `upgrade_success.mp3` (caisse enregistreuse).
- **Graphiques** : Icône flèche vers le haut.
- **Images** : N/A
- **Vidéos** : N/A
- **Animations** : Particules de succès (confettis/étoiles) autour du bâtiment.
- **Couleurs** : Bouton Vert (si achetable), Gris (si fonds insuffisants).
- **Textes** : "Améliorer (X pièces)".
- **Formes** : Bouton rectangulaire arrondi.

### Flux Visiteurs (Passif)
**Description UX** : Le joueur observe les visiteurs entrer dans le zoo.
**Description UI** : Petits sprites de visiteurs apparaissant à la porte et se dispersant.
**Emplacement** : Devant la billeterie.
**Intégration** : Animation continue pendant les heures d'ouverture.
**Navigation** : N/A
**Événements** : `VISITOR_SPAWN`.

#### Assets
- **Musiques** : N/A
- **Sons** : `visitor_entry.mp3` (bruit de foule léger, pas à chaque spawn).
- **Graphiques** : Sprites visiteurs variés.
- **Images** : N/A
- **Vidéos** : N/A
- **Animations** : Marche (4 directions).
- **Couleurs** : Variées (vêtements).
- **Textes** : N/A
- **Formes** : N/A