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:
@@ -43,7 +43,11 @@ Processus de vente spécifique pour les bébés animaux nés dans le zoo.
|
||||
| Délai Validation | 10 min (fixe) |
|
||||
|
||||
### Scores Initiaux
|
||||
N/A
|
||||
| Score | Valeur Initiale | Plage (Min-Max) | Impact |
|
||||
|---|---:|---|---|
|
||||
| Visibilité Listing | 50 | 0-100 | Poids de tri côté marché. |
|
||||
| Stress (vente) | 10 | 0-100 | Monte avec le temps ; au-delà de 70, accélère le risque de mort. |
|
||||
| Confiance vendeur | 0 | -100 à +100 | Influence la participation des bots (anti-spam). |
|
||||
|
||||
## 2. Cycles de Vie et Apparition
|
||||
### Conditions d'Apparition
|
||||
@@ -53,46 +57,79 @@ Action joueur.
|
||||
Vente ou Expiration.
|
||||
|
||||
### Hérédité
|
||||
N/A
|
||||
| Parent | Trait Transmis | Probabilité | Mutation Possible |
|
||||
|---|---|---:|---|
|
||||
| Parents (réels) | Rareté/Couleur | cf. `reproduction.md` | Oui |
|
||||
| Vendeur | “Certificat de soin” | 100% | Non |
|
||||
|
||||
## 3. Impacts Environnementaux
|
||||
### Impact Température
|
||||
N/A
|
||||
| Plage Température | Effet sur l'entité | Bonus/Malus |
|
||||
|---|---|---|
|
||||
| < 5°C | Stress +2/min | Risque mort + (si durée > 10 min) |
|
||||
| 20°C (Idéal) | Stress -1/min | Stabilise |
|
||||
| > 30°C | Stress +2/min | Risque mort + (si durée > 10 min) |
|
||||
|
||||
### Impact Milieu (Biome)
|
||||
N/A
|
||||
| Biome / Contexte | Compatibilité | Bonus/Malus |
|
||||
|---|---:|---|
|
||||
| Marché (UI) | 100% | Aucun |
|
||||
| Transport long | 80% | Fatigue + |
|
||||
|
||||
### Impact Saisons
|
||||
N/A
|
||||
| Saison | Effet | Modificateur |
|
||||
|---|---|---|
|
||||
| Printemps | Demande bébés + | Bids +10% |
|
||||
| Été | Chaleur | Stress +10% |
|
||||
| Automne | Neutre | 0% |
|
||||
| Hiver | Froid | Stress +10% |
|
||||
|
||||
### Impact Heure / Jour-Nuit
|
||||
N/A
|
||||
| Période | Activité marché | Impact |
|
||||
|---|---|---|
|
||||
| 18h–22h | Prime time | +15% bids |
|
||||
| Nuit | Faible | -20% bids |
|
||||
|
||||
## 4. Impacts Biologiques et Sociaux
|
||||
### Impact Reproduction
|
||||
N/A
|
||||
| Facteur | Effet sur Taux | Condition |
|
||||
|---|---|---|
|
||||
| Bébé rare vendu | +10 réputation | Si `status` devient `sold` puis finalisé |
|
||||
|
||||
### Impact Mort
|
||||
**Risque** : Si `status == expired` et non récupéré sous 1h -> Mort du bébé.
|
||||
|
||||
### Impact Nourriture
|
||||
N/A
|
||||
| Type Nourriture | Gain Santé | Coût | Préférence |
|
||||
|---|---:|---:|---:|
|
||||
| Lait / soin | Stabilise | inclus | 5 |
|
||||
|
||||
### Impact Attractivité (Visiteurs/Animaux)
|
||||
N/A
|
||||
| Action/État | Gain Attractivité | Rayon d'action |
|
||||
|---|---:|---:|
|
||||
| Vente bébé rare conclue | +25 | Global |
|
||||
| Bébé mort (invendu) | -50 | Global |
|
||||
|
||||
### Impact Valeur
|
||||
**Dépréciation** : Aucune (c'est une enchère).
|
||||
|
||||
## 5. Impacts Logistiques et Économiques
|
||||
### Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)
|
||||
N/A
|
||||
| Paramètre | Valeur | Unité | Règle |
|
||||
|---|---:|---|---|
|
||||
| Délai validation | 10 | min | après acceptation |
|
||||
| Fenêtre récupération invendu | 1 | h | sinon mort bébé |
|
||||
|
||||
### Dépenses (Boutiques/Visiteurs)
|
||||
N/A
|
||||
| Poste | Coût | Unité | Condition |
|
||||
|---|---:|---|---|
|
||||
| Taxe marché | 10% | du prix final | prélevée à finalisation |
|
||||
| Assurance transport | 5% | du prix final | optionnel |
|
||||
|
||||
### Trajet Visiteurs
|
||||
N/A
|
||||
| Trajet | Condition | Effet | Notes |
|
||||
|---|---|---|---|
|
||||
| Consultation acheteurs | ouverture marché | tri par visibilité | pas de visiteurs physiques |
|
||||
|
||||
## 6. Événements
|
||||
### Événements du Jeu / Carte / Zoo / Ville / Visiteur
|
||||
@@ -102,11 +139,28 @@ N/A
|
||||
|
||||
## 7. Progression
|
||||
### Tableau des Upgrades
|
||||
N/A
|
||||
| Niveau | Coût | Prérequis | Bonus Débloqué |
|
||||
|---|---:|---|---|
|
||||
| 1 | 0 | - | Accès enchères bébés |
|
||||
| 2 | 1000 | Réputation 200 | Taxe -1% |
|
||||
| 3 | 5000 | Réputation 1000 | Visibilité +10 |
|
||||
|
||||
## 8. Logique et Interfaces
|
||||
### Pseudo-code Impacts
|
||||
N/A
|
||||
```text
|
||||
onAcceptBid(auction, bid):
|
||||
auction.status = 'pending_validation'
|
||||
auction.pending_until = now + 10min
|
||||
|
||||
onTick():
|
||||
if auction.status == 'pending_validation' and now >= pending_until:
|
||||
finalize(auction)
|
||||
|
||||
finalize(auction):
|
||||
transferCoins(bidder, seller, amount - tax)
|
||||
scheduleDelivery(truck, bidderZoo)
|
||||
auction.status = 'sold'
|
||||
```
|
||||
|
||||
### Messages d'Infos / Alerte
|
||||
| ID | Niveau | Message |
|
||||
@@ -135,12 +189,12 @@ N/A
|
||||
**Événements** : `CREATE_AUCTION`.
|
||||
|
||||
#### Assets
|
||||
- **Musiques** : N/A
|
||||
- **Musiques** : `ui_market_open.mp3` (jingle court).
|
||||
- **Sons** : `cash_register_open.mp3`.
|
||||
- **Graphiques** : Icône Bourse/Pièce.
|
||||
- **Images** : Portrait Bébé.
|
||||
- **Vidéos** : N/A
|
||||
- **Animations** : N/A
|
||||
- **Vidéos** : `auction_sheet_intro.webm` (0.8s non loop, optionnel).
|
||||
- **Animations** : Compteur “mise à prix” qui s’incrémente, pulsation du bouton “Valider”.
|
||||
- **Couleurs** : Or.
|
||||
- **Textes** : "Prix de départ", "Durée".
|
||||
- **Formes** : Champs de saisie.
|
||||
@@ -154,12 +208,12 @@ N/A
|
||||
**Événements** : `OPEN_MY_SALES`.
|
||||
|
||||
#### Assets
|
||||
- **Musiques** : N/A
|
||||
- **Musiques** : `ui_market_list.mp3` (jingle discret optionnel).
|
||||
- **Sons** : `notification.mp3` (si offre reçue).
|
||||
- **Graphiques** : N/A
|
||||
- **Images** : N/A
|
||||
- **Vidéos** : N/A
|
||||
- **Animations** : N/A
|
||||
- **Couleurs** : N/A
|
||||
- **Graphiques** : Icône cloche + badge compteur.
|
||||
- **Images** : `icon_hourglass.png`, `icon_bid.png`.
|
||||
- **Vidéos** : `bid_badge_pulse.webm` (0.6s loop, optionnel).
|
||||
- **Animations** : Badge qui pulse sur nouvelle offre.
|
||||
- **Couleurs** : Ambre (#F39C12) en attente validation, Vert (#2ECC71) vendu.
|
||||
- **Textes** : "Meilleure offre : X".
|
||||
- **Formes** : N/A
|
||||
- **Formes** : Pills (badges), cartes liste.
|
||||
|
||||
Reference in New Issue
Block a user