builazoo/docs/specs/laboratoire.md

# Spécifications : Laboratoire (Site)

## Définition
Un laboratoire est un point d'intérêt spécial sur la Carte du Monde (POI) dédié à la recherche avancée et à l'obtention de spécimens rares. Il permet au joueur d'accéder à des animaux génétiquement modifiés ou disparus, ainsi qu'à des technologies de pointe pour son zoo.

## Fonctions
| Fonction | Description | Entrées | Sorties |
|---|---|---|---|
| Offres Spéciales | Propose périodiquement des œufs ou bébés animaux rares, souvent introuvables ailleurs. | Argent, Réputation | Animal Rare (Œuf/Bébé) |
| Analyse Génétique | Permet d'analyser l'ADN d'un animal pour découvrir ses traits cachés ou potentiels de mutation. | Échantillon (Animal), Argent | Rapport Génétique complet |
| Synthèse | Création d'animaux à partir de fragments d'ADN collectés (feature avancée). | Fragments ADN, Argent, Temps | Nouvel Animal (Clone) |

## Icone de base
Microscope stylisé bleu néon sur fond sombre, évoquant la haute technologie.

## Interactions
| Acteur A | Action | Acteur B | Résultat |
|---|---|---|---|
| Joueur | Cliquer | Laboratoire | Ouvre l'interface des offres et services du labo. |
| Joueur | Glisser-Déposer | Offre (Animal) vers Camion | Achète l'animal et lance le transport vers le zoo. |
| Joueur | Sélectionner | Animal du Zoo | Lance une analyse génétique (si le labo est débloqué). |

## Annexes Techniques

### 1. Données et États

#### Caractéristiques Initiales
| Caractéristique | Valeur Initiale | Type | Description |
|---|---|---|---|
| Niveau Tech | 1 | Entier | Niveau technologique du labo, débloquant des offres plus rares. |
| Slots Offres | 3 | Entier | Nombre d'animaux proposés simultanément. |
| Réputation Requise | 500 | Entier | Score de réputation minimum pour accéder au labo. |

#### Scores Initiaux
| Score | Valeur Initiale | Plage (Min-Max) | Impact |
|---|---|---|---|
| Fiabilité | 90% | 0-100% | Probabilité de succès des synthèses ou analyses sans erreur. |
| Prestige | 10 | 0-100 | Influence la rareté des animaux proposés (plus haut = plus rare). |

### 2. Cycles de Vie et Apparition

#### Conditions d'Apparition
| Condition | Seuil | Opérateur | Résultat |
|---|---|---|---|
| Exploration Carte | Zone "Ville" ou "Industrie" | Est | Le laboratoire est découvert sur la carte du monde. |
| Niveau Joueur | 5 | >= | Le laboratoire devient interactif. |

#### Conditions de Disparition
| Condition | Seuil | Opérateur | Résultat |
|---|---|---|---|
| Événement "Faillite Labo" | Aléatoire | Est | Le laboratoire ferme temporairement (24h). |
| Offre Expirée | 24h | > | L'offre d'animal est remplacée par une nouvelle. |

#### Hérédité
| Parent | Trait Transmis | Probabilité | Mutation Possible |
|---|---|---|---|
| Animal Cloné | Traits Génétiques | 99% | Oui (1% instabilité génétique) |
| Animal Analysé | Aucun | 0% | Non (Analyse non invasive) |

### 3. Impacts Environnementaux

#### Impact Température
| Plage Température | Effet sur l'entité | Bonus/Malus |
|---|---|---|
| < 0°C | Ralentissement des machines (synthèse) | Durée +20% |
| > 35°C | Surchauffe des serveurs (analyse) | Coût Énergie +15% |
| 20°C (Optimal) | Fonctionnement optimal | Vitesse +5% |

#### Impact Milieu (Biome)
| Biome | Compatibilité | Bonus/Malus |
|---|---|---|
| Urbain | 100% | Aucun (Emplacement standard) |
| Toundra | 80% | Coût maintenance +10% (Chauffage) |
| Désert | 70% | Coût maintenance +20% (Climatisation) |

#### Impact Saisons
| Saison | Effet | Modificateur |
|---|---|---|
| Hiver | Recherche sur animaux polaires favorisée | Rareté Animaux Froids +10% |
| Été | Recherche sur animaux tropicaux favorisée | Rareté Animaux Chauds +10% |
| Printemps | Pic de naissances (offres bébés) | Nombre Offres +1 |
| Automne | Analyse de maladies (prévention) | Coût Analyse -10% |

#### Impact Heure / Jour-Nuit
| Période | Activité | Visibilité |
|---|---|---|
| Jour (08h-20h) | Ouvert au public (visites scolaires) | Haute (Enseignes allumées) |
| Nuit (20h-08h) | Recherche intensive (offres "sombres") | Basse (Lumières tamisées) |

### 4. Impacts Biologiques et Sociaux

#### Impact Reproduction
| Facteur | Effet sur Taux | Condition |
|---|---|---|
| Fertilité Assistée | +20% | Si recherche "Fécondation In Vitro" débloquée |
| Clonage | Reproduction Naturelle = 0%, Production par Synthèse = 100% | Si l'espèce est éteinte ou si l’option \"Synthèse\" est utilisée au lieu d’un cycle de reproduction |

#### Impact Mort
| Cause | Conséquence | Durée |
|---|---|---|
| Échec Synthèse | Perte des fragments ADN | Instantané |
| Accident Labo | Fermeture temporaire pour décontamination | 48h |

#### Impact Nourriture
| Type Nourriture | Gain Santé | Coût | Préférence |
|---|---|---|---|
| Nutriments Synthétiques | +50 (pour clones) | 200$ / dose | 5 (Indispensable pour clones) |
| Nourriture Standard | +10 (pour clones) | 50$ / kg | 1 (Mal digéré par clones) |

#### Impact Attractivité Visiteurs
| Action/État | Gain Attractivité | Rayon d'action |
|---|---|---|
| Découverte Espèce Éteinte | +500 (Global Zoo) | Monde entier (Buzz médiatique) |
| Visite du Labo (si module) | +20 | 10m autour du bâtiment |

#### Impact Attractivité Animaux
| Espèce | Interaction | Effet Stress |
|---|---|---|
| Toutes | Prélèvement ADN | +10 (Stress léger) |
| Clones | Retour à la vie sauvage | +50 (Stress fort, inadapté) |

#### Impact Valeur
| Facteur | Variation Prix | Condition |
|---|---|---|
| Rareté Génétique | +200% | Si l'animal a des traits "Légendaires" |
| Défaut de Clonage | -50% | Si l'animal a le trait "Instable" |

### 5. Impacts Logistiques et Économiques

#### Vitesse (Camion)
| Type Route | Vitesse Max | Consommation |
|---|---|---|
| Autoroute (vers Labo) | 110 km/h | 10 L/100 |
| Piste (accès difficile) | 30 km/h | 20 L/100 |

#### Vitesse (Nurserie)
| Action | Durée de base | Réduction par Upgrade |
|---|---|---|
| Incubation Œuf Rare | 72h | -10% par niveau d'incubateur |
| Soin Post-Clonage | 24h | -5% par niveau de vétérinaire |

#### Vitesse (Accueil)
| Flux | Visiteurs/Minute | Capacité Max |
|---|---|---|
| Entrée Labo (Visite) | 5 | 50 (Groupe restreint) |

#### Vitesse (Recherche)
| Projet | Durée (Jours) | Coût Accélération |
|---|---|---|
| Séquençage ADN | 2 jours | 1000$ |
| Résurrection Mammouth | 30 jours | 50,000$ |

#### Vitesse (Labo)
| Analyse | Durée | Fiabilité |
|---|---|---|
| Test Paternité | 1h | 99.9% |
| Dépistage Maladies | 4h | 95% |

#### Vitesse (Visite)
| Zone | Temps Moyen | Facteur Ralentissement |
|---|---|---|
| Hall d'exposition | 15 min | Si guide présent (+10 min) |

#### Dépenses (Billeterie)
| Poste | Coût Hebdo | Maintenance |
|---|---|---|
| Guichet Spécial Labo | 500$ | 50$ |

#### Dépenses (Boutiques)
| Article | Coût Achat | Marge |
|---|---|---|
| Kit Petit Chimiste | 20$ | 40% |
| Peluche Dinosaure | 15$ | 60% |

#### Dépenses (Visiteurs)
| Type Dépense | Montant Moyen | Fréquence |
|---|---|---|
| Don pour la Recherche | 10$ | 1 visiteur sur 20 |
| Ticket Visite Guidée | 25$ | 1 visiteur sur 10 |

#### Dépenses (Employés)
| Rôle | Salaire | Prime |
|---|---|---|
| Généticien | 3000$ / mois | +500$ par découverte majeure |
| Agent de Sécurité | 1800$ / mois | Aucune |

#### Dépenses (Nurseries)
| Soin | Coût Matériel | Coût Personnel |
|---|---|---|
| Suivi Clonage | 500$ / jour | 200$ / jour |

#### Dépenses (Nourriture)
| Type | Prix/Kg | Fournisseur |
|---|---|---|
| Gel Nutritif | 100$ | LaboCorp |

#### Dépenses (Acceuil des animaux)
| Installation | Coût Construction | Entretien |
|---|---|---|
| Enclos Stérile | 10,000$ | 500$ / semaine |

#### Dépenses (Camion)
| Trajet | Coût Essence | Usure |
|---|---|---|
| Zoo <-> Labo (50km) | 50$ | 2% |

#### Trajet Visiteurs

##### Trajet Visiteurs vers/depuis la ville
| Moyen Transport | Temps | Coût | Fréquence |
|---|---|---|---|
| Navette Scientifique | 30 min | 5$ | 1/h |

##### Trajet Visiteurs vers/depuis les animaux
| Chemin | Distance | Attrait |
|---|---|---|
| Tunnel Vitré | 50m | 8/10 (Vue sur labo) |

##### Trajet Visiteurs vers/depuis les boutiques
| Emplacement | Détour Moyen | Taux de Conversion |
|---|---|---|
| Sortie Labo | 0m (Passage obligé) | 30% |

##### Trajet Visiteurs vers/depuis la billeterie (entrées/sorties du zoo)
| Flux | Temps Attente | Saturation |
|---|---|---|
| Entrée VIP Labo | 0 min | 10% |

### 6. Événements

#### Événements du Jeu
| Event | Déclencheur | Effet Global | Durée |
|---|---|---|---|
| Découverte Majeure | Aléatoire (1/an) | Attractivité Science +20% | 1 mois |
| Fuite de Spécimen | Sécurité < 20% | Panique (Visiteurs partent) | Jusqu'à capture |

#### Événements du Carte
| Event | Lieu | Impact Zone |
|---|---|---|
| Conférence Science | Ville voisine | Hôtels complets, affluence +10% |

#### Événements du Zoo
| Event | Cible | Conséquence |
|---|---|---|
| Mutation Spontanée | Animal en gestation | Naissance d'un variant rare |

#### Événements du Ville / Visiteur
| Event | Impact Affluence | Impact Budget |
|---|---|---|
| Manifestation Anti-Clonage | -15% | Sécurité +10% (Coût) |

#### Événements du Visiteur
| Action | Satisfaction | Besoin |
|---|---|---|
| Voir un clone | +20 (Émerveillement) | Éducation |
| Voir une expérience ratée | -30 (Dégoût) | Sécurité |

#### Événements du Joueur
| Action | Coût Action | Gain XP |
|---|---|---|
| Financer Recherche | 10,000$ | +500 XP Science |

### 7. Progression

#### Tableau des Upgrades
| Niveau | Coût | Prérequis | Bonus Débloqué |
|---|---|---|---|
| Labo Niv 1 | 50,000$ | Zoo Niv 3 | Analyses simples, Offres standards |
| Labo Niv 2 | 150,000$ | Labo Niv 1 | Séquençage ADN, Offres Rares |
| Labo Niv 3 | 500,000$ | Labo Niv 2 | Clonage, Offres Légendaires |

### 8. Logique et Interfaces

#### Pseudo-code Impacts
| Algorithme | Entrées | Logique Simplifiée | Sortie |
|---|---|---|---|
| Calcul Succès Clonage | Fiabilité Labo, Rareté Animal | `Succès = Fiabilité - (Rareté * 5)` | Booléen (Réussite/Échec) |
| Génération Offre | Niveau Labo, Seed Aléatoire | `Rareté = Rand(1, Niveau * 2)` | Animal proposé |

#### Messages d'Infos / Alerte
| Type | Message | Condition | Priorité |
|---|---|---|---|
| Info | "Le laboratoire propose un spécimen rare !" | Nouvelle offre générée | 3 |
| Warn | "Échec de la synthèse génétique." | Synthèse ratée | 4 |
| Error | "Alerte de sécurité au laboratoire !" | Fuite ou Intrusion | 5 (Max) |

## 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.


### 1. Expérience Utilisateur (UX)

#### Description UX
| Étape Utilisateur | Action Attendue | Feedback Système |
|---|---|---|
| Notification Offre | Clic sur notif | Caméra centre sur Labo + Halo |
| Consultation Offres | Clic sur Labo | Ouverture Modal "Offres du Labo" |
| Achat Animal | Drag & Drop vers Camion | Son "Validation", Animation particule ADN |

#### Description UI
| Élément | Type (Bouton/Panel) | Contenu | État par défaut |
|---|---|---|---|
| Panel Labo | Fenêtre Modale | Liste animaux, Stats Labo | Caché |
| Bouton Synthèse | Bouton Action | Icône éprouvette | Grisé (si pas de fragments) |

#### Emplacement
| Élément | Position | Ancrage | Z-Index |
|---|---|---|---|
| Notif Labo | Haut Droite | Top-Right | 100 |
| Modal Labo | Centre Écran | Center | 200 |

#### Intégration
| Composant Parent | Contraintes | Responsive |
|---|---|---|
| HUD Principal | Max 80% largeur écran | Oui |

#### Navigation
| De l'écran | Vers l'écran | Transition | Trigger |
|---|---|---|---|
| Carte Monde | Vue Labo | Zoom fluide | Clic Batiment |
| Vue Labo | Carte Monde | Dezoom | Bouton Fermer |

#### Événements
| Input Utilisateur | Action Système | Son | Animation |
|---|---|---|---|
| Hover Offre | Affiche Tooltip Détails | `hover_tech.mp3` | Scale 1.05 |
| Clic Achat | Débite argent, ajoute animal | `buy_success.mp3` | Flash vert |

#### Assets Skinables

##### Musiques
| Piste | Contexte | Loop | Volume |
|---|---|---|---|
| `lab_ambient.mp3` | Vue intérieure Labo | Oui | 40% |

##### Sons
| SFX | Trigger | Priorité |
|---|---|---|
| `sci_fi_hum.mp3` | Ambiance fond | Basse |
| `dna_scan.mp3` | Analyse terminée | Haute |

##### Graphiques
| Asset | Format | Résolution |
|---|---|---|
| `icon_lab.png` | PNG | 128x128 |
| `bg_lab_interior.jpg` | JPG | 1920x1080 |

##### Images
| Image | Usage | Alt Text |
|---|---|---|
| `dna_strand.png` | Décoration UI | "Brin d'ADN stylisé" |

##### Vidéos
| Clip | Usage | Durée |
|---|---|---|
| `cloning_process.mp4` | Cinématique succès | 5s |

##### Animations
| Nom | Cible | Durée | Type (CSS/JS) |
|---|---|---|---|
| `pulse_neon` | Bordures UI | 2000ms | CSS Keyframes |

##### Couleurs
| Code Hex | Usage | Sémantique |
|---|---|---|
| #00FFFF | Texte, Bordures | Technologie, Futur |
| #202040 | Fond Panel | Mystère, Science |

##### Textes
| Clé i18n | Valeur FR | Valeur EN |
|---|---|---|
| `LAB_TITLE` | Laboratoire de Génétique | Genetics Lab |
| `BTN_SYNTHESIZE` | Synthétiser | Synthesize |

##### Formes
| Forme | Usage | Style Bordure |
|---|---|---|
| Hexagone | Icônes, Boutons | Solid 2px |