docs: enrich docs/specs and remove placeholders
**Motivations:** - Make docs/specs implementation-ready without empty sections or placeholders. **Root causes:** - Multiple specs still contained non-actionable placeholders (N/A, “see above”, "..."), and inconsistent “no cache” wording. **Correctifs:** - Replace placeholders with explicit tables, structures, and typed examples. - Align “no cache / no memorization” statements where relevant. **Evolutions:** - Add a features doc entry to track the documentation enrichment effort. **Pages affectées:** - docs/specs/* - docs/features/docs-specs-enrichment.md - docs/leo.md - docs/plan-enrich-docs-specs.md
This commit is contained in:
@@ -25,17 +25,27 @@ Propriété de `Zoo`.
|
||||
| Survie | 100% |
|
||||
|
||||
### Scores Initiaux
|
||||
N/A
|
||||
| Score | Valeur Initiale | Plage (Min-Max) | Impact |
|
||||
|---|---:|---|---|
|
||||
| Survie globale | 100 | 0-100 | Conditionne reproduction, maladies, perception valeur animaux. |
|
||||
| Risque maladie | 0% | 0-100% | Monte si survie < 60. |
|
||||
| Malus mortalité | 0 | 0-100 | Monte si survie < 30, augmente probas décès. |
|
||||
|
||||
## 2. Cycles de Vie et Apparition
|
||||
### Conditions d'Apparition
|
||||
N/A
|
||||
| Condition | Seuil | Opérateur | Résultat |
|
||||
|---|---:|---|---|
|
||||
| Premier animal vivant | 1 | >= | Score calculable (sinon 100 par convention de vide). |
|
||||
|
||||
### Conditions de Disparition
|
||||
N/A
|
||||
| Condition | Seuil | Opérateur | Résultat |
|
||||
|---|---:|---|---|
|
||||
| Zoo supprimé | true | Est | Score supprimé avec le zoo. |
|
||||
|
||||
### Hérédité
|
||||
N/A
|
||||
| Parent | Trait Transmis | Probabilité | Mutation Possible |
|
||||
|---|---|---:|---|
|
||||
| Soft reset | Bonus de départ (+10) | 100% | Non |
|
||||
|
||||
## 3. Impacts Environnementaux
|
||||
### Impact Température
|
||||
@@ -45,10 +55,15 @@ Moyenne des adéquations T°.
|
||||
Moyenne des adéquations Biome.
|
||||
|
||||
### Impact Saisons
|
||||
N/A
|
||||
| Saison | Effet | Modificateur |
|
||||
|---|---|---|
|
||||
| Hiver | Températures plus dures | survie -5 si pas de régulation |
|
||||
| Été | Canicule | survie -5 si pas d’ombre/eau |
|
||||
|
||||
### Impact Heure / Jour-Nuit
|
||||
N/A
|
||||
| Période | Effet | Modificateur |
|
||||
|---|---|---|
|
||||
| Nuit | Récupération | +1 survie/h si conditions OK |
|
||||
|
||||
## 4. Impacts Biologiques et Sociaux
|
||||
### Impact Reproduction
|
||||
@@ -61,28 +76,47 @@ Seuil critique : < 20% (Risque épidémie).
|
||||
Moyenne des Faims.
|
||||
|
||||
### Impact Attractivité (Visiteurs/Animaux)
|
||||
N/A
|
||||
| État | Effet | Condition |
|
||||
|---|---|---|
|
||||
| Survie > 90 | Visiteurs satisfaits | bonus attractivité local |
|
||||
| Survie < 50 | Visiteurs inquiets | malus attractivité |
|
||||
|
||||
### Impact Valeur
|
||||
N/A
|
||||
| Facteur | Variation Prix | Condition |
|
||||
|---|---:|---|
|
||||
| Survie > 90 | +10% | animal en vente |
|
||||
| Survie < 50 | -20% | animal en vente |
|
||||
|
||||
## 5. Impacts Logistiques et Économiques
|
||||
### Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)
|
||||
N/A
|
||||
| Domaine | Paramètre | Valeur | Unité | Effet |
|
||||
|---|---|---:|---|---|
|
||||
| Recalcul score | Période | 60 | s | Recalcul périodique ou lazy update. |
|
||||
|
||||
### Dépenses (Boutiques/Visiteurs)
|
||||
N/A
|
||||
| Poste | Coût | Unité | Condition |
|
||||
|---|---:|---|---|
|
||||
| Soins vétérinaires | 50 | coins / animal | si état critique |
|
||||
| Régulation T° | variable | coins / jour | selon `temperature.md` |
|
||||
|
||||
### Trajet Visiteurs
|
||||
N/A
|
||||
| Mécanisme | Effet | Détail |
|
||||
|---|---|---|
|
||||
| Évitement zones malades | détour | réduit densité autour animaux malades |
|
||||
|
||||
## 6. Événements
|
||||
### Événements du Jeu / Carte / Zoo / Ville / Visiteur
|
||||
N/A
|
||||
| Event | Déclencheur | Effet | Durée |
|
||||
|---|---|---|---|
|
||||
| `SURVIVAL_DROP` | passage sous seuil | alerte | tant que < seuil |
|
||||
| `DISEASE_OUTBREAK` | survie < 20 + RNG | maladie | 24h in-game |
|
||||
|
||||
## 7. Progression
|
||||
### Tableau des Upgrades
|
||||
N/A
|
||||
| Niveau | Coût | Prérequis | Bonus Débloqué |
|
||||
|---|---:|---|---|
|
||||
| 1 | 0 | - | Monitoring basique |
|
||||
| 2 | 2000 | centre recherche niv 2 | Détection précoce maladies |
|
||||
|
||||
## 8. Logique et Interfaces
|
||||
### Pseudo-code Impacts
|
||||
@@ -116,11 +150,11 @@ survivalScore = average(allAnimals.health)
|
||||
**Événements** : `HEALTH_UPDATE`.
|
||||
|
||||
#### Assets
|
||||
- **Musiques** : N/A
|
||||
- **Musiques** : `ui_health_soft.mp3` (jingle discret), `ui_critical_pulse.mp3` (optionnel).
|
||||
- **Sons** : `heartbeat.mp3` (si critique).
|
||||
- **Graphiques** : Icône Cœur.
|
||||
- **Images** : N/A
|
||||
- **Vidéos** : N/A
|
||||
- **Images** : `icon_heart.png`, `icon_cross.png`.
|
||||
- **Vidéos** : `heart_pulse.webm` (0.8s loop, optionnel).
|
||||
- **Animations** : Battement (Pulsation).
|
||||
- **Couleurs** : Vert -> Jaune -> Rouge.
|
||||
- **Textes** : "98%".
|
||||
|
||||
Reference in New Issue
Block a user