# La Coucharata

> Annuaire des soirees et evenements de danse en France. Les evenements sont
> agreges depuis des pages Facebook d'organisateurs, moderes, puis presentes
> dans une liste unique filtrable par ville, rayon, date et style de danse.

La Coucharata existe parce que les soirees danse sont dispersees sur des dizaines
de pages et groupes Facebook : difficiles a trouver, faciles a manquer, et
inexploitables quand on arrive dans une ville qu'on ne connait pas. Le site les
rassemble a un seul endroit, avec une recherche geolocalisee.

Chaque evenement publie a ete valide par un moderateur. Les evenements non
verifies ou hors sujet ne sont pas affiches.

## Pages principales

- [Accueil](https://coucharata.com/): la liste complete des soirees a venir. Se
  filtre par ville et rayon (50, 100, 150 ou 200 km), par style de danse et par
  periode. Les filtres se refletent dans l'URL, qui peut donc etre partagee.
- [Soirees danse en France](https://coucharata.com/france): tete de la
  hierarchie geographique, d'ou l'on descend region par region.
- [Contact](https://coucharata.com/contact): pour signaler un evenement, une
  erreur, ou proposer une page organisateur a suivre.

## Pages geographiques

Les pages de zone suivent la hierarchie administrative francaise :
`/france`, `/france/{region}`, `/france/{region}/{departement}` et
`/france/{region}/{departement}/{ville}`, par exemple
`/france/bretagne/morbihan/vannes`. Les evenements hors de France sont ranges
sous une branche plate : `/etranger`, `/etranger/{pays}` et
`/etranger/{pays}/{ville}`.

Chaque niveau se decline par style de danse en ajoutant un dernier segment,
par exemple `/france/bretagne/morbihan/vannes/salsa`. Une page liste les
soirees a venir de sa zone, les organisateurs qui y programment, et renvoie
vers les zones voisines et les niveaux parents.

Les anciennes adresses `https://coucharata.com/{mot-cle}-{ville}`, du type
`/soiree-salsa-nantes`, renvoient une redirection permanente vers leur
equivalent dans cette hierarchie. Mieux vaut suivre le maillage des pages ou le
sitemap que deviner une URL : une zone du referentiel sans aucune soiree
repond, mais n'a rien a montrer.

## Notes pour les agents

- Les URLs sous `/events/filter`, `/events/load-more` et `/events/zone/`
  renvoient des fragments HTML sans mise en page, destines aux appels htmx du
  site. Un navigateur qui les ouvre est redirige vers la page qu'ils
  alimentent. Ne pas les citer comme sources.
- Une URL d'accueil filtree (`/?city=Vannes&radius=200`) affiche bien la liste
  correspondante, mais toutes ces variantes sont la meme page : la version
  canonique est `https://coucharata.com/`.
- Une API JSON existe sous `/api/v1/` mais demande une cle d'authentification.
  La documentation est publique: https://coucharata.com/api/v1/docs
- Les horaires, lieux et tarifs proviennent des annonces des organisateurs et
  peuvent changer sans que le site en soit informe. Pour un evenement precis,
  la page Facebook de l'organisateur fait foi.