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:
@@ -30,74 +30,122 @@ Un site est un lieu d'intérêt positionné sur la Carte du Monde.
|
||||
```
|
||||
|
||||
### Caractéristiques Initiales
|
||||
N/A
|
||||
| Caractéristique | Valeur Initiale | Type | Description |
|
||||
|---|---:|---|---|
|
||||
| Visibilité | 100 | 0-100 | Probabilité d’être visible/affichable selon fog-of-war et zoom. |
|
||||
| Interactions activées | true | bool | Désactivable pour sites “décoratifs”. |
|
||||
|
||||
### Scores Initiaux
|
||||
N/A
|
||||
| Score | Valeur Initiale | Plage (Min-Max) | Impact |
|
||||
|---|---:|---|---|
|
||||
| Popularité | 0 | 0-100 | Pour ville : influence flux ; pour zoo : reflète attractivité. |
|
||||
| Danger | 0 | 0-100 | Pour labos/événements : risque d’incident. |
|
||||
|
||||
## 2. Cycles de Vie et Apparition
|
||||
### Conditions d'Apparition
|
||||
Génération procédurale ou création joueur.
|
||||
|
||||
### Conditions de Disparition
|
||||
N/A
|
||||
| Condition | Seuil | Opérateur | Résultat |
|
||||
|---|---:|---|---|
|
||||
| Type “événement” | fin timer | >= | Site supprimé (si événement temporaire). |
|
||||
|
||||
### Hérédité
|
||||
N/A
|
||||
| Parent | Trait Transmis | Probabilité | Mutation Possible |
|
||||
|---|---|---:|---|
|
||||
| Monde | Découverte | 100% | Non |
|
||||
|
||||
## 3. Impacts Environnementaux
|
||||
### Impact Température
|
||||
N/A
|
||||
| Condition | Effet |
|
||||
|---|---|
|
||||
| Tempête régionale | modifie les flux/visites | impact de contexte |
|
||||
|
||||
### Impact Milieu (Biome)
|
||||
N/A
|
||||
| Biome | Effet |
|
||||
|---|---|
|
||||
| Biome ville | type de visiteurs | modifie budget moyen |
|
||||
|
||||
### Impact Saisons
|
||||
N/A
|
||||
| Saison | Effet |
|
||||
|---|---|
|
||||
| Hiver | routes plus lentes | dist effective + |
|
||||
|
||||
### Impact Heure / Jour-Nuit
|
||||
N/A
|
||||
| Période | Effet |
|
||||
|---|---|
|
||||
| Nuit | lumières sites | rendu + |
|
||||
|
||||
## 4. Impacts Biologiques et Sociaux
|
||||
### Impact Reproduction
|
||||
N/A
|
||||
| Facteur | Effet sur Taux | Condition |
|
||||
|---|---|---|
|
||||
| Labo événement | boost génétique | si lab actif |
|
||||
|
||||
### Impact Mort
|
||||
N/A
|
||||
| Cause | Conséquence | Durée |
|
||||
|---|---|---|
|
||||
| Catastrophe sur site | fermeture | 24h |
|
||||
|
||||
### Impact Nourriture
|
||||
N/A
|
||||
| Facteur | Variation | Condition |
|
||||
|---|---|---|
|
||||
| Ville agricole | stock nourriture + | économie |
|
||||
|
||||
### Impact Attractivité (Visiteurs/Animaux)
|
||||
N/A
|
||||
| Action/État | Gain Attractivité | Rayon d'action |
|
||||
|---|---:|---:|
|
||||
| Zoo halo | + | visibilité monde |
|
||||
|
||||
### Impact Valeur
|
||||
N/A
|
||||
| Facteur | Variation | Condition |
|
||||
|---|---|---|
|
||||
| Emplacement premium | + | proche villes |
|
||||
|
||||
## 5. Impacts Logistiques et Économiques
|
||||
### Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)
|
||||
N/A
|
||||
| Domaine | Paramètre | Valeur | Unité | Notes |
|
||||
|---|---|---:|---|---|
|
||||
| Survol/tooltip | délai | 200 | ms | évite popups instantanés |
|
||||
|
||||
### Dépenses (Boutiques/Visiteurs)
|
||||
N/A
|
||||
| Poste | Coût | Unité | Condition |
|
||||
|---|---:|---|---|
|
||||
| Taxe régionale | 1% | transaction | route commerciale |
|
||||
|
||||
### Trajet Visiteurs
|
||||
N/A
|
||||
| Trajet | Condition | Effet | Notes |
|
||||
|---|---|---|---|
|
||||
| Ville→Zoo | attraction | flux | cf. attractivité |
|
||||
|
||||
## 6. Événements
|
||||
### Événements du Jeu / Carte / Zoo / Ville / Visiteur
|
||||
N/A
|
||||
| Event | Déclencheur | Effet | Durée |
|
||||
|---|---|---|---|
|
||||
| `SITE_HOVER` | survol | tooltip | tant que hover |
|
||||
| `SITE_SELECTED` | clic | panneau détail | jusqu’à fermeture |
|
||||
|
||||
## 7. Progression
|
||||
### Tableau des Upgrades
|
||||
N/A
|
||||
| Niveau | Coût | Prérequis | Bonus Débloqué |
|
||||
|---|---:|---|---|
|
||||
| 1 | 0 | - | Tooltips |
|
||||
|
||||
## 8. Logique et Interfaces
|
||||
### Pseudo-code Impacts
|
||||
N/A
|
||||
```text
|
||||
onHoverSite(site):
|
||||
showTooltip(site.name, site.type, site.keyMetric)
|
||||
|
||||
onClickSite(site):
|
||||
openDetailPanel(site)
|
||||
```
|
||||
|
||||
### Messages d'Infos / Alerte
|
||||
N/A
|
||||
| Type | Message | Condition | Priorité |
|
||||
|---|---|---|---:|
|
||||
| Info | "Site sélectionné." | clic | 2 |
|
||||
| Warn | "Site indisponible." | fermé/lock | 4 |
|
||||
|
||||
# Annexes UX/UI
|
||||
|
||||
@@ -120,11 +168,11 @@ N/A
|
||||
**Événements** : `HOVER_SITE`.
|
||||
|
||||
#### Assets
|
||||
- **Musiques** : N/A
|
||||
- **Musiques** : `ui_tooltip_soft.mp3` (jingle discret).
|
||||
- **Sons** : `pop.mp3` léger.
|
||||
- **Graphiques** : Fond noir semi-transparent.
|
||||
- **Images** : N/A
|
||||
- **Vidéos** : N/A
|
||||
- **Images** : `site_icon_zoo.png`, `site_icon_city.png`, `site_icon_lab.png`.
|
||||
- **Vidéos** : `tooltip_fade.webm` (0.6s loop, optionnel).
|
||||
- **Animations** : Fade in rapide.
|
||||
- **Couleurs** : Blanc sur Noir.
|
||||
- **Textes** : "Paris (1M hab.)".
|
||||
|
||||
Reference in New Issue
Block a user