Papa-Kind-Treff – Start-Doku

Stand: 2026-08-07

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
• Im Mitgliederbereich Events gibt es jetzt zusätzlich einen ICS-Download und einen persönlichen abonnierbaren Kalender-Feed für alle eigenen Events und Event-Teilnahmen
• Der Bereich Events ist im Mitgliederbereich jetzt zusätzlich in die Tabs Meine Events, Synchronisation und Abgelaufene Events gegliedert
• Für später vorgemerkt: direkte Kalender-Anbindung großer Anbieter wie Google und Microsoft/Outlook per OAuth, zusätzlich zum bestehenden ICS-Feed

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
• persönliche Kalender-Feed-Tokens werden verschlüsselt gespeichert und zusätzlich über einen separaten SHA-256-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