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:
@@ -41,10 +41,18 @@ Sélection hiérarchique : **Famille** > **Spécialisation**.
|
||||
```
|
||||
|
||||
### Caractéristiques Initiales
|
||||
N/A
|
||||
| Caractéristique | Valeur Initiale | Type | Description |
|
||||
|---|---:|---|---|
|
||||
| Fréquence min | 5 | minutes | Intervalle minimal entre actions. |
|
||||
| Fréquence max | 60 | minutes | Intervalle maximal (profil lent). |
|
||||
| Budget action | 10% | % coins | Part des coins max utilisable par action (plafond anti-ruine). |
|
||||
|
||||
### Scores Initiaux
|
||||
N/A
|
||||
| Score | Valeur Initiale | Plage (Min-Max) | Impact |
|
||||
|---|---:|---|---|
|
||||
| Agressivité marché | 50 | 0-100 | Propension à acheter/vendre. |
|
||||
| Prudence survie | 50 | 0-100 | Propension à acheter nourriture/soins. |
|
||||
| Priorité expansion | 20 | 0-100 | Propension à agrandir carte/améliorer bâtiments. |
|
||||
|
||||
## 2. Cycles de Vie et Apparition
|
||||
### Conditions d'Apparition
|
||||
@@ -54,46 +62,72 @@ Activation par joueur (déconnexion) ou Spawn serveur (Bot permanent).
|
||||
Connexion joueur.
|
||||
|
||||
### Hérédité
|
||||
N/A
|
||||
| Parent | Trait Transmis | Probabilité | Mutation Possible |
|
||||
|---|---|---:|---|
|
||||
| Profil choisi | Paramètres logique | 100% | Non |
|
||||
|
||||
## 3. Impacts Environnementaux
|
||||
### Impact Température
|
||||
N/A
|
||||
| Condition | Effet |
|
||||
|---|---|
|
||||
| Froid/Chaud extrême | Augmente achats régulation/biome | priorité survie + |
|
||||
|
||||
### Impact Milieu (Biome)
|
||||
N/A
|
||||
| Biome | Effet |
|
||||
|---|---|
|
||||
| Biome défavorable à la majorité | Achats “changement milieu” | priorité survie + |
|
||||
|
||||
### Impact Saisons
|
||||
N/A
|
||||
| Saison | Effet | Modificateur |
|
||||
|---|---|---|
|
||||
| Printemps | Focus reproduction | priorité éleveur + |
|
||||
| Hiver | Focus survie | priorité conservateur + |
|
||||
|
||||
### Impact Heure / Jour-Nuit
|
||||
N/A
|
||||
| Période | Effet |
|
||||
|---|---|
|
||||
| Nuit | Actions limitées | fréquence + lente |
|
||||
|
||||
## 4. Impacts Biologiques et Sociaux
|
||||
### Impact Reproduction
|
||||
N/A
|
||||
| Facteur | Effet sur Taux | Condition |
|
||||
|---|---|---|
|
||||
| Score survie élevé | Bot tente reproduction | profil éleveur |
|
||||
|
||||
### Impact Mort
|
||||
N/A
|
||||
| Cause | Conséquence | Durée |
|
||||
|---|---|---|
|
||||
| Série de morts | Bot achète nourriture/soins | 24h |
|
||||
|
||||
### Impact Nourriture
|
||||
N/A
|
||||
| Facteur | Variation | Condition |
|
||||
|---|---|---|
|
||||
| Stock bas | Achat immédiat | seuil profil |
|
||||
|
||||
### Impact Attractivité (Visiteurs/Animaux)
|
||||
N/A
|
||||
| Action/État | Gain Attractivité | Rayon d'action |
|
||||
|---|---:|---:|
|
||||
| Placements optimisés | + | zoo du bot |
|
||||
|
||||
### Impact Valeur
|
||||
N/A
|
||||
| Facteur | Variation | Condition |
|
||||
|---|---|---|
|
||||
| Profil commerçant | Valeur cash + | ventes fréquentes |
|
||||
|
||||
## 5. Impacts Logistiques et Économiques
|
||||
### Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)
|
||||
**Fréquence Action** : 1 action toutes les 5 à 60 minutes (selon profil).
|
||||
|
||||
### Dépenses (Boutiques/Visiteurs)
|
||||
N/A
|
||||
| Poste | Coût | Unité | Condition |
|
||||
|---|---:|---|---|
|
||||
| Achats auto nourriture | variable | coins | selon seuil |
|
||||
| Achat upgrades | variable | coins | selon priorité |
|
||||
|
||||
### Trajet Visiteurs
|
||||
N/A
|
||||
| Trajet | Règle | Notes |
|
||||
|---|---|---|
|
||||
| Rapport d’absence → décisions | Script profilé | Le bot ne “se déplace” pas : il calcule des actions sur l’état du zoo et sur le marché. |
|
||||
|
||||
## 6. Événements
|
||||
### Événements du Jeu / Carte / Zoo / Ville / Visiteur
|
||||
@@ -101,7 +135,10 @@ N/A
|
||||
|
||||
## 7. Progression
|
||||
### Tableau des Upgrades
|
||||
N/A
|
||||
| Niveau | Coût | Prérequis | Bonus Débloqué |
|
||||
|---|---:|---|---|
|
||||
| 1 | 0 | - | Profil basique |
|
||||
| 2 | 5000 | Réputation 300 | Stratégies avancées (arbitrage) |
|
||||
|
||||
## 8. Logique et Interfaces
|
||||
### Pseudo-code Impacts
|
||||
@@ -144,11 +181,11 @@ function runBotLogic(bot, zoo):
|
||||
**Événements** : `SELECT_BOT_PROFILE`.
|
||||
|
||||
#### Assets
|
||||
- **Musiques** : N/A
|
||||
- **Musiques** : `ui_bot_family_pick.mp3` (jingle court).
|
||||
- **Sons** : `card_flip.mp3`.
|
||||
- **Graphiques** : Illustrations des familles (ex: Conservateur avec bouclier, Commerçant avec bourse).
|
||||
- **Images** : Portraits Bots.
|
||||
- **Vidéos** : N/A
|
||||
- **Vidéos** : `bot_family_cards.webm` (1s loop, optionnel).
|
||||
- **Animations** : Flip de carte au choix.
|
||||
- **Couleurs** : Code couleur par famille (Vert=Conservateur, Jaune=Commerçant, etc.).
|
||||
- **Textes** : Titres et Descriptions courtes.
|
||||
@@ -162,12 +199,12 @@ function runBotLogic(bot, zoo):
|
||||
**Navigation** : Lire -> Fermer.
|
||||
**Événements** : `SHOW_REPORT`.
|
||||
#### Assets
|
||||
- **Musiques** : N/A
|
||||
- **Musiques** : `ui_report_open.mp3` (jingle court).
|
||||
- **Sons** : `notification.mp3`.
|
||||
- **Graphiques** : Icône Robot.
|
||||
- **Images** : N/A
|
||||
- **Vidéos** : N/A
|
||||
- **Animations** : N/A
|
||||
- **Images** : `icon_robot.png`, `report_bg.png`.
|
||||
- **Vidéos** : `report_scroll.webm` (0.8s loop, optionnel).
|
||||
- **Animations** : Apparition slide-in + highlight des lignes importantes.
|
||||
- **Couleurs** : Gris/Métal.
|
||||
- **Textes** : Liste des actions.
|
||||
- **Formes** : Liste à puces.
|
||||
|
||||
Reference in New Issue
Block a user