docs(runbook): skill tourisme-tunisie

common/tourisme-tunisie-skill.md

@@ -0,0 +1,43 @@
+# Runbook — Skill hermes `tourisme-tunisie`
+
+Date : 2026-07-16 | Instance : common (tap partage) | Statut : Deploye
+
+## Objet
+Skill donnant aux agents Hermes la capacite de proposer des lieux a visiter en
+Tunisie autour d'un point (sites historiques, musees, plages, parcs). Usage perso/famille.
+
+## Emplacement
+Tap Gitea `bolbol/hermes-skills`, dossier `skills/tourisme-tunisie/` :
+- `SKILL.md` : quand l'utiliser + methodologie de presentation (proximite d'abord,
+  melange des registres, time-sensitive musees ~16h, sites isoles = lampe/pas seul,
+  fusion doublons FR/AR, pas d'accents sur Gabes/Kebili/Medenine).
+- `find_places.py` : script autonome, Python stdlib seulement.
+
+## Chaine technique (0 cle API, 0 cout)
+- Geocodage : Nominatim (`countrycodes=tn`, 1 req/s).
+- POI : Overpass QL (`tourism|historic|natural=beach|leisure=park`, `around:rayon`).
+- PIEGE EGRESS NAS : depuis les conteneurs, les miroirs Overpass classiques
+  (overpass-api.de, kumi, private.coffee) timeout (>20-120 s). Seul
+  `https://maps.mail.ru/osm/tools/overpass/api/interpreter` repond vite (~5 s).
+  → il est mis EN TETE de la liste OVERPASS, ne pas retirer. Bascule auto ensuite.
+- Sortie : liste triee par distance, categorie, lien OSM, horaires si dispo. `--json` pour l'agent.
+
+## Usage
+    python3 find_places.py --near "Salakta, Mahdia" --radius 12 --limit 18
+    python3 find_places.py --lat 35.39 --lon 11.04 --radius 15
+    python3 find_places.py --near "Mahdia" --json
+
+## Rayons conseilles
+Littoral Sahel dense : 10-12 km. Zone rurale / gouvernorats sud : 25-40 km.
+
+## Deploiement (git absent du NAS → API Gitea)
+Push via `POST /api/v1/repos/bolbol/hermes-skills/contents/<path>` (token GITEA_DEPLOY_TOKEN,
+base64, branche main). Le tap est pull au demarrage de session : nouveau skill visible a la
+session suivante sans restart (si absent, recreer le conteneur force le re-pull).
+
+## Valide le 16/07/2026
+Tests reels OK sur Salakta (musee + necropole + thermes + plages) et Mahdia
+(Skifa El Kahla, musee regional avec horaires, forts, palais fatimide).
+
+## Limites
+Horaires OSM peu fiables → confirmer sur place. Villes industrielles (Ksar Hellal) = vide normal.