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

docs/specs/attractivite_zoo_sur_ville.md

@@ -20,7 +20,7 @@ L'attraction est calculée pour chaque couple (Ville, Zoo).
 
 ## 1. Données et États
 ### Modèle de Données (JSON)
-Calculé à la volée ou mis en cache.
+Calculé à la volée, sans cache (cf. règle “pas de mémorisation”).
 ```json
 {
   "zoo_id": "uuid",
@@ -30,67 +30,105 @@ Calculé à la volée ou mis en cache.
 ```
 
 ### Caractéristiques Initiales
-N/A
+| Caractéristique | Valeur Initiale | Type | Description |
+|---|---|---|---|
+| Rayon attraction max | 30 | cases monde | Au-delà, attraction = 0 (plafond). |
+| Facteur ville | 1.0 | float | Multiplie le flux (population/aisance). |
 
 ### Scores Initiaux
-N/A
+| Score | Valeur Initiale | Plage (Min-Max) | Impact |
+|---|---:|---|---|
+| Attraction brute | 0 | 0-∞ | Avant concurrence/plafonds. |
+| Flux visiteurs/jour | 0 | 0-∞ | Résultat final injecté à la billeterie. |
 
 ## 2. Cycles de Vie et Apparition
 ### Conditions d'Apparition
-N/A
+| Condition | Seuil | Opérateur | Résultat |
+|---|---:|---|---|
+| Zoo et ville existent | true | Est | Calcul possible. |
 
 ### Conditions de Disparition
-N/A
+| Condition | Seuil | Opérateur | Résultat |
+|---|---:|---|---|
+| Zoo supprimé | true | Est | Flux devient 0. |
 
 ### Hérédité
-N/A
+| Parent | Trait Transmis | Probabilité | Mutation Possible |
+|---|---|---:|---|
+| Soft reset | Cartographie connue | 100% | Non |
 
 ## 3. Impacts Environnementaux
 ### Impact Température
-N/A
+| Condition | Effet |
+|---|---|
+| Températures extrêmes régionales | réduit la volonté de voyager | flux -10% à -30% |
 
 ### Impact Milieu (Biome)
-N/A
+| Biome / route | Effet |
+|---|---|
+| Montagne (routes lentes) | distance effective + | flux - |
 
 ### Impact Saisons
 **Hiver** : Réduit la volonté de voyager (-20% rayon d'attraction).
 
 ### Impact Heure / Jour-Nuit
-N/A
+| Période | Effet |
+|---|---|
+| Nuit | pas de départs | flux 0 vers billeterie |
 
 ## 4. Impacts Biologiques et Sociaux
 ### Impact Reproduction
-N/A
+| Facteur | Effet sur Taux | Condition |
+|---|---|---|
+| Naissances médiatisées | flux + | événement “baby boom” |
 
 ### Impact Mort
-N/A
+| Cause | Conséquence | Durée |
+|---|---|---|
+| Série de morts | flux - | 24h (décroissance) |
 
 ### Impact Nourriture
-N/A
+| Facteur | Variation | Condition |
+|---|---|---|
+| Prix nourriture élevé | visiteurs budget - | dépense moyenne - |
 
 ### Impact Attractivité (Visiteurs/Animaux)
 Voir formule.
 
 ### Impact Valeur
-N/A
+| Facteur | Variation | Condition |
+|---|---|---|
+| Ville riche | dépense moyenne + | facteur ville > 1 |
 
 ## 5. Impacts Logistiques et Économiques
 ### Vitesse (Camion/Nurserie/Accueil/Recherche/Labo/Visite)
-N/A
+| Paramètre | Valeur | Unité | Effet |
+|---|---:|---|---|
+| Recalcul flux | 1 | jour in-game | Recalcul quotidien (ou lazy). |
 
 ### Dépenses (Boutiques/Visiteurs)
-N/A
+| Poste | Coût | Unité | Condition |
+|---|---:|---|---|
+| Marketing ville ciblée | 500–5000 | coins | augmente facteur ville temporaire |
 
 ### Trajet Visiteurs
-N/A
+| Trajet | Condition | Effet | Notes |
+|---|---|---|---|
+| Ville→Zoo | calcul distance | flux | distance^2 + plafond rayon |
 
 ## 6. Événements
 ### Événements du Jeu / Carte / Zoo / Ville / Visiteur
-N/A
+| Event | Déclencheur | Effet | Durée |
+|---|---|---|---|
+| `FLOW_UPDATED` | recalcul quotidien | met à jour overlay | instant |
+| `CITY_FESTIVAL` | événement ville | flux - | 1 jour |
 
 ## 7. Progression
 ### Tableau des Upgrades
-N/A
+| Niveau | Coût | Prérequis | Bonus Débloqué |
+|---|---:|---|---|
+| 1 | 0 | - | Flux visible sur carte monde |
+| 2 | 2000 | réputation 300 | Rayon attraction +10% |
 
 ## 8. Logique et Interfaces
 ### Pseudo-code Impacts
@@ -104,7 +142,10 @@ function calculateDailyVisitors(zoo, city):
 ```
 
 ### Messages d'Infos / Alerte
-N/A
+| Type | Message | Condition | Priorité |
+|---|---|---|---:|
+| Info | "Nouvelle estimation visiteurs/jour : {n}" | recalcul | 2 |
+| Warn | "La distance réduit fortement vos visiteurs." | dist proche plafond | 3 |
 
 # Annexes UX/UI
 
@@ -123,15 +164,15 @@ N/A
 **Description UI** : Lignes pointillées mouvantes reliant les villes au zoo. Épaisseur = Volume flux. **Particules** : Petits points ou voitures circulant sur les lignes pour donner une sensation de vie.
 **Emplacement** : Carte Monde.
 **Intégration** : Overlay.
-**Navigation** : N/A
+**Navigation** : Toggle “Flux visiteurs” dans le HUD carte monde → survol d’une ligne → affiche détail (ville, visiteurs/jour, facteur saison, distance).
 **Événements** : `VIEW_FLOW`.
 
 #### Assets
-- **Musiques** : N/A
-- **Sons** : N/A
+- **Musiques** : `ambience_world_flow.mp3` (léger, optionnel).
+- **Sons** : `ui_flow_toggle.mp3` (toggle overlay).
 - **Graphiques** : Lignes de flux.
-- **Images** : N/A
-- **Vidéos** : N/A
+- **Images** : `flow_dotted_line.png`, `car_particle.png`.
+- **Vidéos** : `flow_ants.webm` (1s loop, optionnel).
 - **Animations** : Pointillés qui avancent (effet fourmis).
 - **Couleurs** : Blanc ou Vert fluo.
 - **Textes** : "150 visiteurs/jour".