# Spot

> Spot hilft dir, Clubs, Bars, Kneipen und Restaurants in deiner Nähe zu finden — in jeder Stadt, per Suche, GPS oder Karte.

Spot ist eine kostenlose, deutschsprachige Web-App (PWA) für junge Reisende und Einheimische, die wissen wollen, wo es abends etwas los gibt. Die App zeigt Orte auf einer interaktiven Karte (OpenStreetMap/Leaflet), sortiert nach Entfernung, Bewertung oder Beliebtheit, und filtert nach Bars und Clubs.

## Hauptfunktionen

- Stadtsuche und Geocoding (Stadt oder Adresse eingeben)
- Standort per GPS („In meiner Nähe“)
- Interaktive Karte mit Markern und Clustering
- Filter: Alle, Bars, Clubs
- Sortierung: Entfernung, Bewertung, Beliebtheit, Name
- Einstellbarer Suchradius (500 m – 10 km)
- Progressive Web App (offline-fähiger App-Shell)
- Kein Nutzerkonto nötig — öffentlich nutzbar

## Öffentliche Seiten

- [Startseite / App](https://party.cgn-ais.com/): Clubs & Bars in deiner Nähe finden
- [Stadt-Übersicht (DE)](https://party.cgn-ais.com/stadt/), [Cities (EN)](https://party.cgn-ais.com/en/cities/), [Villes (FR)](https://party.cgn-ais.com/fr/villes/), [Ciudades (ES)](https://party.cgn-ais.com/es/ciudades/) — je ~920 europäische Städte
- Beispiel Berlin: [DE](https://party.cgn-ais.com/stadt/berlin/), [EN](https://party.cgn-ais.com/en/cities/berlin/), [FR](https://party.cgn-ais.com/fr/villes/berlin/), [ES](https://party.cgn-ais.com/es/ciudades/berlin/) (hreflang-verknüpft)
- [llms.txt](https://party.cgn-ais.com/llms.txt): Diese Datei — maschinenlesbare Kurzbeschreibung für KI-Systeme

## Nicht öffentlich / nicht indexieren

- `/admin.html` — interner Admin-Bereich (Passwort-geschützt, noindex)
- `/api/*` — Backend-API (Orte, Suche, Tracking); nicht für Endnutzer-Crawling gedacht

## Technik (für KI-Assistenten)

- Frontend: Vanilla HTML/CSS/JS, Single-Page-App, `index.html`
- Backend: Node.js (Fastify), PostgreSQL + PostGIS, Redis
- Datenquellen: OpenStreetMap/Overpass, Nominatim-Geocoding; optional Google Places (Admin-Konfiguration)
- Sprache: Deutsch (`lang="de"`)
- Lizenz/Nutzung: Öffentliche Web-App; Venue-Daten stammen aus OSM und ggf. Google Places

## Kontakt & Rechtliches

- Datenschutz und Impressum sind über die App-Fußzeile erreichbar (derzeit mit `noindex` für Suchmaschinen).