# Papa-Kind-Treff – Start-Doku

Stand: 2026-08-05

Diese Datei ist die zentrale Start-Doku für neue Chats und den schnellen Projekteinstieg.

## Für neue Chats
Bitte immer zuerst diese Datei lesen und danach die kanonische interne Dokumentation unter `Internal/` vollständig prüfen.

Verbindliche deutsche Referenz:
- `Internal/de/README.md`
- `Internal/de/PROJECT_CONTEXT.md`
- `Internal/de/PROJECT_STRUCTURE.md`

Parallele englische Referenz:
- `Internal/en/README.md`
- `Internal/en/PROJECT_CONTEXT.md`
- `Internal/en/PROJECT_STRUCTURE.md`

## Dokumentationsregel
- Die Dokumentation unter `Internal/de/` und `Internal/en/` ist vollständig parallel zu pflegen.
- Änderungen an Projektstand, Struktur, Wording, Datenschutz, Sicherheit oder Produktverhalten müssen immer in Deutsch und Englisch nachgezogen werden.
- Die Root-`README.md` bleibt bewusst im Hauptordner, damit sie in neuen Chats direkt als Einstieg genannt werden kann.

## Kurzüberblick Projekt
Papa-Kind-Treff ist eine PHP-basierte Plattform für Väter mit Fokus auf:
- lokale Events, Termine und Treffen
- Community-Austausch
- geschützten Mitgliederbereich mit Profil, Kinderinfos und eigenen Events
- neue Basis für ein übergreifendes Termin-, Ort- und Veranstaltungssystem

## Wichtige aktuelle Produktregeln
- Primärbegriff im Produkt: `Events`
- `Termine` und `Treffen` ergänzend in SEO- und Erklärungstexten
- Hauptnavigation aktuell: `Home`, `Event Suche`, `Community`
- Profil-Menü aktuell: `Profil`, `Kinder`, `Events`, `Ausflugsziele`, `Community`, `Einstellungen`, `Abmelden`
- neue interne Grundstruktur: `listing_places`, `listings`, `listing_occurrences`, `listing_prices`, `listing_benefits`
- Seiten-Admins haben zusätzlich eine System-Sektion für globale Wartungs- und Diensteschalter
- Im Mitgliederbereich ist `Events` jetzt wieder auf echte eigene Events und Event-Teilnahmen beschränkt
- Orte und sonstige Veranstaltungen laufen jetzt separat unter `Ausflugsziele`
- Eigene Events unterstützen aktuell Kategorie, Bild-Upload, klare Kinderangabe, optionale Platzzahl und direkte Karten-/Adress-Synchronisierung
- Die Eingabe im Mitgliederbereich ist jetzt bewusst vereinfacht: zuerst nur Pflichtangaben, optionale Angaben in einklappbaren Bereichen
- Kategorien werden jetzt über eine Sucheingabe mit bestehenden Vorschlägen gepflegt; neue Kategorien werden automatisch angelegt und sind für Seiten-Admins im Systembereich zusammenführbar

## Datenschutz und Sicherheit
- sensible Profilfelder werden app-seitig verschlüsselt gespeichert
- Konto-E-Mails werden verschlüsselt gespeichert und zusätzlich über einen separaten HMAC-Lookup-Hash adressiert
- Standortkoordinaten bleiben technisch im Klartext, soweit sie für Distanz- und Umkreissuchen erforderlich sind
- Änderungen an Cookies, LocalStorage, SessionStorage, Geolocation, Tracking oder Drittanbietern erfordern immer auch die Prüfung und Aktualisierung von Consent und rechtlichen Hinweisen

## Hinweis zur internen Ablage
- Endnutzertexte, Landingpages und UI gehören nicht nach `Internal/`
- `Internal/` ist ausschließlich für interne Projekt- und Systemdokumentation gedacht