Standardisation exhaustive des spécifications techniques

**Motivations:**
- Harmoniser la documentation technique pour faciliter le développement.
- Garantir l'exhaustivité des données de Game Design pour chaque entité.

**Root causes:**
- Documentation hétérogène et incomplète.

**Correctifs:**
- N/A

**Evolutions:**
- Réécriture complète de 53 fichiers de spécifications selon un modèle strict.
- Ajout de données de Game Design (prix, durées, impacts) pour combler les manques.
- Ajout systématique des annexes UX/UI.

**Pages affectées:**
- docs/specs/*
This commit is contained in:
2026-03-04 18:07:31 +01:00
parent c7d389ecbb
commit f0219559c5
43 changed files with 1832 additions and 1071 deletions

View File

@@ -1,118 +1,376 @@
# Spécifications : Laboratoire (Site)
## Définition
Un laboratoire est un point d'intérêt spécial sur la Carte du Monde (POI).
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.
## Fonction
- **Offres Spéciales** : Propose périodiquement des œufs ou bébés animaux rares.
- **Prix Fixe** : Contrairement aux zoos, les ventes du laboratoire sont souvent à prix fixe, sans enchères (ou règles spécifiques).
- **Icône** : 🔬
## 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) |
## Interaction
- **Achat** : Glisser l'offre du laboratoire vers le camion du joueur.
## Icone de base
Microscope stylisé bleu néon sur fond sombre, évoquant la haute technologie.
# Annexes Techniques
## 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é). |
## 1. Données et États
### Modèle de Données (JSON)
```json
{
"id": "uuid",
"type": "lab",
"current_offer": { "animal_type": "string", "rarity": "int", "price": "int", "expires_at": "timestamp" }
}
```
## Annexes Techniques
### Caractéristiques Initiales
N/A
### 1. Données et États
### Scores Initiaux
N/A
#### 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. |
## 2. Cycles de Vie et Apparition
### Conditions d'Apparition
Génération carte.
#### 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). |
### Conditions de Disparition
N/A
### 2. Cycles de Vie et Apparition
### Hérédité
N/A
#### 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. |
## 3. Impacts Environnementaux
### Impact Température
N/A
#### 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. |
### Impact Milieu (Biome)
N/A
#### 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) |
### Impact Saisons
N/A
### 3. Impacts Environnementaux
### Impact Heure / Jour-Nuit
N/A
#### 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% |
## 4. Impacts Biologiques et Sociaux
### Impact Reproduction
N/A
#### 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 Mort
N/A
#### 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 Nourriture
N/A
#### 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) |
### Impact Attractivité (Visiteurs/Animaux)
N/A
### 4. Impacts Biologiques et Sociaux
### Impact Valeur
N/A
#### Impact Reproduction
| Facteur | Effet sur Taux | Condition |
|---|---|---|
| Fertilité Assistée | +20% | Si recherche "Fécondation In Vitro" débloquée |
| Clonage | N/A (Création artificielle) | Remplace la reproduction naturelle pour les espèces éteintes |
## 5. Impacts Logistiques et Économiques
### Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)
**Rotation Offres** : 1 offre toutes les 4h à 24h.
#### Impact Mort
| Cause | Conséquence | Durée |
|---|---|---|
| Échec Synthèse | Perte des fragments ADN | Instantané |
| Accident Labo | Fermeture temporaire pour décontamination | 48h |
### Dépenses (Boutiques/Visiteurs)
N/A
#### 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) |
### Trajet Visiteurs
N/A
#### 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 |
## 6. Événements
### Événements du Jeu / Carte / Zoo / Ville / Visiteur
* **Nouvelle Offre Rare** : Notification globale ou locale.
#### 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é) |
## 7. Progression
### Tableau des Upgrades
N/A
#### 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" |
## 8. Logique et Interfaces
### Pseudo-code Impacts
N/A
### 5. Impacts Logistiques et Économiques
### Messages d'Infos / Alerte
| ID | Niveau | Message |
| :--- | :--- | :--- |
| `LAB_OFFER` | Info | "Le laboratoire propose un spécimen rare !" |
#### 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 |
# Annexes UX/UI
#### 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 |
## 1. Expérience Utilisateur (UX)
### Offre Rare (Passif)
**Description UX** : Le laboratoire a un stock spécial.
**Description UI** : Halo brillant autour du labo. Icône "!" ou "ADN".
**Emplacement** : Carte Monde.
**Intégration** : Effet visuel.
**Navigation** : N/A
**Événements** : `LAB_GLOW`.
#### Vitesse (Accueil)
| Flux | Visiteurs/Minute | Capacité Max |
|---|---|---|
| Entrée Labo (Visite) | 5 | 50 (Groupe restreint) |
#### Assets
- **Musiques** : N/A
- **Sons** : `sci_fi_hum.mp3`.
- **Graphiques** : Halo bleu néon.
- **Images** : N/A
- **Vidéos** : N/A
- **Animations** : Pulsation.
- **Couleurs** : Bleu électrique / Violet.
- **Textes** : N/A
- **Formes** : N/A
#### 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
### 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 |