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:
@@ -17,10 +17,17 @@ Identique à la vente de bébés, mais avec des tolérances plus grandes sur les
|
||||
Identique à `vente_enchere_bebe.md`.
|
||||
|
||||
### Caractéristiques Initiales
|
||||
N/A
|
||||
| Caractéristique | Valeur | Notes |
|
||||
|---|---|---|
|
||||
| Durée Enchère | 4h - 24h | Les adultes tolèrent des durées plus longues que les bébés. |
|
||||
| Délai Validation | 10 min | Identique au générique enchères (sablier). |
|
||||
| Dégradation âge | Oui | Prix perçu diminue avec l’âge (cf. `animal_generique.md`). |
|
||||
|
||||
### Scores Initiaux
|
||||
N/A
|
||||
| Score | Valeur Initiale | Plage (Min-Max) | Impact |
|
||||
|---|---:|---|---|
|
||||
| Valeur perçue (âge) | 100 | 0-150 | Modifie la propension des bots à enchérir. |
|
||||
| Résistance transport | 80 | 0-100 | Réduit les risques d’incident pendant vente/transport. |
|
||||
|
||||
## 2. Cycles de Vie et Apparition
|
||||
### Conditions d'Apparition
|
||||
@@ -30,61 +37,114 @@ Action joueur.
|
||||
Vente ou Expiration.
|
||||
|
||||
### Hérédité
|
||||
N/A
|
||||
| Parent | Trait Transmis | Probabilité | Mutation Possible |
|
||||
|---|---|---:|---|
|
||||
| Parents (si connus) | Arbre généalogique | 100% | Non |
|
||||
| Vendeur | “Certificat d’entretien” | 100% | Non |
|
||||
|
||||
## 3. Impacts Environnementaux
|
||||
### Impact Température
|
||||
N/A
|
||||
| Plage Température | Effet sur l'entité | Bonus/Malus |
|
||||
|---|---|---|
|
||||
| < 0°C | Fatigue + | Risque incident +5% si pas de camion climatisé |
|
||||
| 15–25°C | Stable | 0 |
|
||||
| > 35°C | Fatigue + | Risque incident +5% si pas de camion climatisé |
|
||||
|
||||
### Impact Milieu (Biome)
|
||||
N/A
|
||||
| Biome | Compatibilité | Bonus/Malus |
|
||||
|---|---:|---|
|
||||
| Marché (UI) | 100% | Aucun |
|
||||
| Transport long | 90% | Légère fatigue (adultes résistent) |
|
||||
|
||||
### Impact Saisons
|
||||
N/A
|
||||
| Saison | Effet | Modificateur |
|
||||
|---|---|---|
|
||||
| Hiver | Demande espèces froides + | Bids +10% (espèces adaptées) |
|
||||
| Été | Demande espèces chaudes + | Bids +10% (espèces adaptées) |
|
||||
|
||||
### Impact Heure / Jour-Nuit
|
||||
N/A
|
||||
| Période | Activité marché | Impact |
|
||||
|---|---|---|
|
||||
| 18h–22h | Prime time | +10% bids |
|
||||
| Nuit | Faible | -15% bids |
|
||||
|
||||
## 4. Impacts Biologiques et Sociaux
|
||||
### Impact Reproduction
|
||||
N/A
|
||||
| Facteur | Effet sur Taux | Condition |
|
||||
|---|---|---|
|
||||
| Adulte fertile vendu | Prix x2 | Si fertilité > seuil et pas en cooldown |
|
||||
|
||||
### Impact Mort
|
||||
**Risque** : Si `status == expired` et non récupéré sous 24h -> Mort.
|
||||
|
||||
### Impact Nourriture
|
||||
N/A
|
||||
| Type Nourriture | Gain Santé | Coût | Préférence |
|
||||
|---|---:|---:|---:|
|
||||
| Rations transport | stable | inclus | 3 |
|
||||
|
||||
### Impact Attractivité (Visiteurs/Animaux)
|
||||
N/A
|
||||
| Action/État | Gain Attractivité | Rayon d'action |
|
||||
|---|---:|---:|
|
||||
| Vente star (rare) | -10% attractivité zoo | Global (zoo vendeur) |
|
||||
|
||||
### Impact Valeur
|
||||
N/A
|
||||
| Facteur | Variation Prix | Condition |
|
||||
|---|---:|---|
|
||||
| Âge élevé | -20% | au-delà du seuil “senior” |
|
||||
| Santé parfaite | +10% | survival élevé |
|
||||
|
||||
## 5. Impacts Logistiques et Économiques
|
||||
### Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)
|
||||
N/A
|
||||
| Paramètre | Valeur | Unité | Règle |
|
||||
|---|---:|---|---|
|
||||
| Fenêtre récupération invendu | 24 | h | sinon risque mort adulte (cf. spec) |
|
||||
| Délai validation | 10 | min | après acceptation |
|
||||
|
||||
### Dépenses (Boutiques/Visiteurs)
|
||||
N/A
|
||||
| Poste | Coût | Unité | Condition |
|
||||
|---|---:|---|---|
|
||||
| Taxe marché | 10% | du prix final | prélevée à finalisation |
|
||||
| Assurance transport | 3% | du prix final | optionnel |
|
||||
|
||||
### Trajet Visiteurs
|
||||
N/A
|
||||
| Trajet | Condition | Effet | Notes |
|
||||
|---|---|---|---|
|
||||
| Consultation marché | ouverture UI | tri | pas de visiteurs physiques |
|
||||
|
||||
## 6. Événements
|
||||
### Événements du Jeu / Carte / Zoo / Ville / Visiteur
|
||||
N/A
|
||||
| Event | Déclencheur | Effet | Durée |
|
||||
|---|---|---|---|
|
||||
| `AUCTION_CREATED_ADULT` | création enchère | listing visible | jusqu’à fin |
|
||||
| `AUCTION_EXPIRED_ADULT` | end_time atteint | statut expired | jusqu’à récupération |
|
||||
| `AUCTION_FINALIZED_ADULT` | validation finie | transfert | instant |
|
||||
|
||||
## 7. Progression
|
||||
### Tableau des Upgrades
|
||||
N/A
|
||||
| Niveau | Coût | Prérequis | Bonus Débloqué |
|
||||
|---|---:|---|---|
|
||||
| 1 | 0 | - | Accès enchères adultes |
|
||||
| 2 | 2000 | Réputation 300 | Taxe -1% |
|
||||
|
||||
## 8. Logique et Interfaces
|
||||
### Pseudo-code Impacts
|
||||
N/A
|
||||
```text
|
||||
createAuctionAdult(animal, startPrice, duration):
|
||||
assert animal.isAdult && animal.health > 50
|
||||
moveToTransit(animal)
|
||||
publishListing()
|
||||
|
||||
onExpire():
|
||||
markExpired()
|
||||
startReclaimTimer(24h)
|
||||
```
|
||||
|
||||
### Messages d'Infos / Alerte
|
||||
N/A
|
||||
| Type | Message | Condition | Priorité |
|
||||
|---|---|---|---:|
|
||||
| Info | "Enchère créée." | listing publié | 2 |
|
||||
| Warn | "Enchère expirée : récupérez l’animal." | status expired | 4 |
|
||||
| Error | "Impossible de vendre : animal indisponible." | malade/mort proche | 5 |
|
||||
|
||||
# Annexes UX/UI
|
||||
|
||||
@@ -107,15 +167,15 @@ N/A
|
||||
**Événements** : `CREATE_AUCTION_ADULT`.
|
||||
|
||||
#### Assets
|
||||
- **Musiques** : N/A
|
||||
- **Musiques** : `ui_market_open.mp3` (jingle court).
|
||||
- **Sons** : `cash_register_open.mp3`.
|
||||
- **Graphiques** : N/A
|
||||
- **Graphiques** : Icône bourse + badge “adulte”.
|
||||
- **Images** : Portrait Animal.
|
||||
- **Vidéos** : N/A
|
||||
- **Vidéos** : `auction_sheet_intro.webm` (0.8s non loop, optionnel).
|
||||
- **Animations** : Animal disparaît de la grille (part en zone de vente).
|
||||
- **Couleurs** : N/A
|
||||
- **Couleurs** : Or/Gris (adulte), Ambre (pending validation).
|
||||
- **Textes** : "Mise à prix".
|
||||
- **Formes** : N/A
|
||||
- **Formes** : Bottom sheet + cartes.
|
||||
|
||||
### Retour Invendu (Action)
|
||||
**Description UX** : L'enchère est finie sans acheteur. Le joueur doit récupérer l'animal.
|
||||
@@ -126,12 +186,12 @@ N/A
|
||||
**Événements** : `RECLAIM_ANIMAL`.
|
||||
|
||||
#### Assets
|
||||
- **Musiques** : N/A
|
||||
- **Musiques** : `ui_fail_soft.mp3` (jingle court).
|
||||
- **Sons** : `sad_trombone.mp3` (échec).
|
||||
- **Graphiques** : N/A
|
||||
- **Images** : N/A
|
||||
- **Vidéos** : N/A
|
||||
- **Graphiques** : Icône retour (flèche).
|
||||
- **Images** : `icon_reclaim.png`.
|
||||
- **Vidéos** : `reclaim_return.webm` (1.2s non loop, optionnel).
|
||||
- **Animations** : Retour visuel de l'animal.
|
||||
- **Couleurs** : Gris (Désactivé).
|
||||
- **Textes** : "Invendu".
|
||||
- **Formes** : N/A
|
||||
- **Formes** : Bouton primary “Récupérer”.
|
||||
|
||||
Reference in New Issue
Block a user