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/pont.md

@@ -21,15 +21,26 @@ Structure permettant aux visiteurs (et au personnel) de traverser les étendues
 ### Données (JSON)
 ```json
 {
-  "bridge_id": "bridge_segment_15_15",
-  "type": "wooden_bridge",
+  "bridge_id": "uuid",
+  "owner_zoo_id": "uuid",
+  "type": "enum('wood_planks','stone_bridge','rope_bridge')",
+  "created_at": "timestamp",
+  "updated_at": "timestamp",
   "coordinates": {"x": 15, "y": 15},
   "water_underneath": true,
+  "connected_neighbors": ["enum('N','S','E','W')"],
+  "durability": "integer (0-100)",
   "stats": {
     "speed_modifier": 1.0,
     "attractiveness_bonus": 5
   },
   "cost_per_tile": 50,
+  "repair_cost": 20,
+  "render": {
+    "auto_tile_key": "string",
+    "height_offset_px": "integer (>= 0)",
+    "occluder": "boolean"
+  },
   "iso_x": "integer",
   "iso_y": "integer",
   "z_index": "integer"
@@ -39,6 +50,9 @@ Structure permettant aux visiteurs (et au personnel) de traverser les étendues
 ### Règles Métier
 *   **Support :** Doit commencer et finir sur la terre ferme (ou se connecter à un autre pont).
 *   **Hauteur :** En vue isométrique, le pont peut être légèrement surélevé par rapport à l'eau.
+*   **Auto-tiling** : se connecte aux ponts adjacents et (optionnellement) aux chemins si le bord touche la terre.
+*   **Usure** : `durability` baisse de 1/jour + 1 par X passages (ex. 50 passages). En dessous de 20, bruit de craquement + risque incident (arrêt temporaire) si non réparé.
+*   **Erreur construction** : interdite si la tuile d’eau est “profonde” et non pontable (flag terrain), ou si collision avec un bâtiment.
 
 ## 6. Annexes UX/UI
 *   **Visuel :** Planches de bois avec rambardes, piliers plongeant dans l'eau.
@@ -55,3 +69,10 @@ Structure permettant aux visiteurs (et au personnel) de traverser les étendues
 *   **Interactions** :
     *   **Sélection** : Cliquer sur la base de l'élément (ou son sprite principal) pour le sélectionner.
     *   **Feedback** : Surbrillance (outline blanc/jaune) au survol de la souris.
+
+## 1. Interactions UI (construction / réparation)
+*   **Construction** : mode “peinture” possible (drag) pour poser plusieurs tuiles de pont d’affilée, avec preview auto-tiling.
+*   **Réparation** : clic sur pont (durabilité < 100) → bouton “Réparer” (coût affiché) → animation marteau + retour à 100.
+*   **Messages** :
+    *   `BRIDGE_BUILD_BLOCKED` : "Impossible de construire un pont ici."
+    *   `BRIDGE_NEEDS_REPAIR` : "Pont endommagé : réparation recommandée."