Files
builazoo/docs/specs/bebe_animal.md
Nicolas Cantu f0219559c5 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/*
2026-03-04 18:07:31 +01:00

203 lines
6.3 KiB
Markdown

# Spécifications : Bébé Animal
## Définition
Stade de développement entre l'éclosion de l'œuf et l'âge adulte.
## Spécificités
- **Lieu** : Doit grandir en Nurserie (recommandé) ou sur une case adaptée.
- **Fragilité** : Plus sensible aux écarts de température/faim que les adultes.
- **Vente** : Peut être vendu comme "Bébé" (souvent plus cher car potentiel reproducteur intact).
- **Évolution** : Devient "Bébé mature" en fin de nurserie, prêt à être placé sur la grille comme adulte.
# Annexes Techniques
## 1. Données et États
### Modèle de Données (JSON)
Structure identique à `Animal` (voir `animal_generique.md`), avec un flag ou état spécifique :
```json
{
"is_baby": true,
"growth_progress": "float (0-100)",
"nurserie_id": "uuid_v4 | null"
}
```
### Caractéristiques Initiales
| Caractéristique | Valeur Initiale |
| :--- | :--- |
| Santé | 100.0 |
| Faim | 0.0 |
| Croissance | 0.0 |
### Scores Initiaux
| Score | Valeur |
| :--- | :--- |
| Valeur Vente | 1.5 * Valeur Adulte (Potentiel) |
| Attractivité | 2 * Attractivité Adulte (Effet "Mignon") |
## 2. Cycles de Vie et Apparition
### Conditions d'Apparition
| Type | Condition |
| :--- | :--- |
| Naissance | Reproduction réussie |
| Éclosion | Fin timer œuf en Nurserie |
### Conditions de Disparition
| Cause | Seuil |
| :--- | :--- |
| Croissance terminée | Croissance >= 100 (Devient Adulte) |
| Mort | Santé <= 0 (Plus fragile) |
### Hérédité
Voir `animal_generique.md`.
## 3. Impacts Environnementaux
### Impact Température
**Facteur de fragilité : x2** par rapport à l'adulte.
| Delta T° | Effet sur Santé / Heure |
| :--- | :--- |
| +/- 1 | -2 |
| +/- 2 | -10 |
| > +/- 2 | -40 (Mort rapide) |
### Impact Milieu (Biome)
| Compatibilité | Effet |
| :--- | :--- |
| Mauvais Biome | Stress x2 par rapport à l'adulte |
### Impact Saisons
Voir `animal_generique.md`.
### Impact Heure / Jour-Nuit
Voir `animal_generique.md`.
## 4. Impacts Biologiques et Sociaux
### Impact Reproduction
**Stérilité temporaire** : Un bébé ne peut pas se reproduire (Logique biologique).
### Impact Mort
| Événement | Effet Satisfaction |
| :--- | :--- |
| Mort d'un bébé | Malus Réputation x2 (Tristesse visiteurs) |
### Impact Nourriture
**Métabolisme rapide :** Faim augmente 1.5x plus vite que l'adulte.
### Impact Attractivité (Visiteurs/Animaux)
| Rareté | Attractivité |
| :--- | :--- |
| Toutes | Bonus "Cuteness" (+50% rayon attraction) |
### Impact Valeur
| Facteur | Effet |
| :--- | :--- |
| Croissance 0-50% | Valeur max (Potentiel) |
| Croissance 50-99% | Valeur décroissante vers prix adulte |
## 5. Impacts Logistiques et Économiques
### Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)
**Vitesse Croissance** : 1% toutes les 30 secondes (rapide) à 1h (lent) selon Rareté.
### Dépenses (Boutiques/Visiteurs)
**Soins Vétérinaires** : Coût x2 si malade (Fragilité pédiatrique).
### Trajet Visiteurs
**Aimant** : Priorité absolue pour les visiteurs si le bébé est visible (hors nurserie).
## 6. Événements
### Événements du Jeu / Carte / Zoo / Ville / Visiteur
* **Croissance** : Passage à l'âge adulte (Notification).
* **Besoin Soin** : Alerte plus fréquente.
* **Premiers Pas** : Petit event mignon (+Satisfaction).
## 7. Progression
### Tableau des Upgrades
*Note : Stades biologiques naturels.*
| Stade | Nom | Effet |
| :--- | :--- | :--- |
| 0-30% | Nouveau-né | Fragilité Max, Dort beaucoup. |
| 30-70% | Jeune | Commence à marcher, Joue. |
| 70-100% | Adolescent | Mange comme un adulte, Moins fragile. |
## 8. Logique et Interfaces
### Pseudo-code Impacts
```javascript
function updateBaby(baby, context):
# Fragilité accrue
damageMultiplier = 2.0
growthRate = baseGrowthRate * nurserieLevelBonus
baby.growth_progress += growthRate
if baby.growth_progress >= 100:
transformToAdult(baby)
# Reste de la logique héritée de Animal avec damageMultiplier
```
### Messages d'Infos / Alerte
| ID | Niveau | Message |
| :--- | :--- | :--- |
| `BABY_GROWN` | Info | "Un bébé est devenu adulte !" |
| `BABY_CRITICAL` | Critique | "Un bébé est en danger critique !" |
# Annexes UX/UI
## 1. Expérience Utilisateur (UX)
### Croissance en Nurserie (Passif)
**Description UX** : Le bébé est visible dans son slot de nurserie. Il grandit visuellement (petite jauge).
**Description UI** : Sprite "Bébé" (tête disproportionnée, grands yeux). Jauge de croissance.
**Emplacement** : Modal Nurserie.
**Intégration** : Slot.
**Navigation** : Clic Slot Nurserie (Zoom).
**Événements** : `BABY_GROWING`.
#### Assets
- **Musiques** : Berceuse (Boîte à musique, boucle 30s).
- **Sons** : Petits bruits aigus.
- **Graphiques** : Sprite Bébé.
- **Images** : Photo "Échographie" (si œuf).
- **Vidéos** : Cinématique éclosion (optionnel).
- **Animations** : Respiration (Scale up/down léger).
- **Couleurs** : Tons pastels.
- **Textes** : "Bébé [Espèce]".
- **Formes** : Bulle de protection autour du bébé.
### Sortie Prématurée (Action)
**Description UX** : Le joueur décide de placer le bébé dans le zoo avant l'âge adulte (risqué).
**Description UI** : Warning "Attention, ce bébé est fragile !".
**Emplacement** : Nurserie -> Zoo.
**Intégration** : Confirmation modale.
**Navigation** : Drag -> Confirm -> Drop.
**Événements** : `PLACE_BABY`.
#### Assets
- **Musiques** : Alerte "Danger" (rythme rapide).
- **Sons** : `warning_beep.mp3`.
- **Graphiques** : Icône Danger.
- **Images** : Fond d'écran rouge clignotant (léger).
- **Vidéos** : Effet de tremblement rouge sur le sprite.
- **Animations** : Tremblement de l'interface.
- **Couleurs** : Rouge.
- **Textes** : "Risque de mort élevé !".
- **Formes** : Triangle d'avertissement.
### Passage Adulte (Événement)
**Description UX** : Le bébé atteint 100% de croissance. Il se transforme en adulte.
**Description UI** : Flash lumineux. Le sprite change. Notification "Adulte !".
**Emplacement** : Nurserie ou Zoo.
**Intégration** : Immédiat.
**Navigation** : Auto (Cutscene).
**Événements** : `BECOME_ADULT`.
#### Assets
- **Musiques** : Jingle évolution.
- **Sons** : `level_up.mp3`.
- **Graphiques** : Particules brillantes.
- **Images** : Sprite Adulte.
- **Vidéos** : Effet de morphing (shader).
- **Animations** : Morphing ou Fade cross.
- **Couleurs** : Blanc/Or.
- **Textes** : "Adulte".
- **Formes** : Rayons de lumière.