yxcyxc

Internal/de/PROJECT_CONTEXT.md

@@ -0,0 +1,34 @@
+# Papa-Kind-Treff – Projektkontext
+
+Stand: 2026-08-03
+
+## Kurzbeschreibung
+Papa-Kind-Treff ist eine PHP-basierte Plattform für Väter. Kernbereiche sind lokale Events, Termine und Treffen, ein Community-Forum, Mitgliederprofile mit optionalen Kinderinfos und ein Moderations-/Adminbereich.
+
+## Wichtige Produktentscheidungen
+- Die Hauptnavigation ist bewusst knapp gehalten: `Home`, `Event Suche`, `Community`.
+- `Events` ist der Primärbegriff im Produkt.
+- `Termine` und `Treffen` werden ergänzend in SEO- und Erklärungstexten genutzt.
+- Die Community ist hierarchisch aufgebaut: Kategorien -> Boards -> Threads -> Posts.
+- Moderation ist vom normalen Community-Frontend getrennt.
+- Standortfunktionen sind relevant für lokale Events, Termine und Treffen.
+
+## Konto / Mitgliederbereich
+- Profil-Menü aktuell: `Profil`, `Kinder`, `Events`, `Community`, `Einstellungen`, `Abmelden`
+- Kinder können angelegt, bearbeitet und gelöscht werden.
+- Wenn ein Geburtsdatum gesetzt ist, wird das Alter automatisch berechnet und später bei Bedarf aktualisiert.
+- Die Konto-E-Mail wird app-seitig verschlüsselt gespeichert und über einen separaten HMAC-Lookup-Hash adressiert.
+- Profiladresse kann per Suche oder Browser-Standort übernommen werden.
+
+## Technischer Rahmen
+- eigener Front-Controller in `public/index.php`
+- Templates unter `partials/`
+- Geschäftslogik unter `src/App/`
+- Globales Frontend vor allem über `public/assets/js/app.js` und `public/assets/css/app.css`
+
+## Pflegehinweis
+Bei Änderungen immer auch die parallelen Dateien in `Internal/en/` prüfen und inhaltlich gleichziehen.
+
+## Dokumentationsprinzip
+- `Internal/de/` und `Internal/en/` werden bewusst parallel gepflegt.
+- Die Root-`README.md` dient als Start-Doku für neue Chats und muss bei grundlegenden Änderungen ebenfalls mitgeprüft werden.

Internal/de/PROJECT_STRUCTURE.md

@@ -0,0 +1,29 @@
+# Papa-Kind-Treff – Projektstruktur
+
+Stand: 2026-08-03
+
+## Projektordner
+- `config/`: Konfigurationen, inklusive `prod/` und `staging/`
+- `partials/`: Templates, aufgeteilt in `landing/` und `structure/`
+- `public/`: Webroot mit Assets und Seiten-Entry-Points
+- `src/`: Backend-/Business-Logik und Kernklassen
+- `debug/`: Debug-Hilfen und Logs
+- `api/`: technische Endpunkte
+- `Internal/`: interne Projektdokumentation in Deutsch und Englisch
+
+## Aktuelle Strukturhinweise
+- Avatar-Verwaltung: `src/App/Avatar/AvatarManager.php`
+- aktive Styles: `src/App/Avatar/Lorelei.php`, `src/App/Avatar/Croodles.php`
+- Profil-/Kinder-/Event-Logik im Mitgliederbereich: `partials/landing/account/dashboard.php`
+- Consent- und rechtliche Texte: `public/page/datenschutz.php`
+
+## Dokumentationsregel
+Kanonische interne Dokumentation:
+- `Internal/de/README.md`
+- `Internal/de/PROJECT_CONTEXT.md`
+- `Internal/de/PROJECT_STRUCTURE.md`
+- entsprechende englische Spiegel unter `Internal/en/`
+
+Zusätzlich:
+- `README.md` im Hauptordner bleibt als Start-Doku für neue Chats bestehen.
+- Änderungen an der internen Struktur müssen immer in Deutsch und Englisch parallel dokumentiert werden.

Internal/de/README.md

@@ -0,0 +1,53 @@
+# Papa-Kind-Treff
+
+Stand: 2026-08-03
+
+Papa-Kind-Treff ist eine PHP-basierte Plattform für Väter mit Fokus auf lokale Events, Termine und Treffen, Community-Austausch und einen geschützten Mitgliederbereich.
+
+## Produktumfang
+- lokale Events, Termine und Treffen finden
+- Community/Forum mit Kategorien, Boards, Threads und Antworten
+- Mitgliederbereich für Profil, optionale Kinderinfos und eigene Events
+- Community-Moderation mit Rollenmodell
+
+## Aktueller Stand
+- Startseite mit Hero, Event-Suche, Event-Karussell, Community-Vorschau und Mitgliederbereichs-Block
+- Community mit Board-Navigation und separater Thread-Ansicht
+- Community-Admin-Bereich für Bewerbungen, Meldungen, Rollen und Migration
+- standortbasierte Sortierung für die neuesten Events
+- Mitgliederbereich mit linker Bereichsnavigation
+- Profil-Menü mit `Profil`, `Kinder`, `Events`, `Community`, `Einstellungen`
+- Konto-E-Mails sowie sensible Profilfelder werden app-seitig verschlüsselt gespeichert
+- Kinder können angelegt, bearbeitet und gelöscht werden
+- Profiladresse mit verschlüsselter Straße/Hausnummer, Adresssuche, Browser-Übernahme und Validierung
+
+## Wording-Regel
+- Primärbegriff im Produkt: `Events`
+- Ergänzende SEO-/Erklärbegriffe: `Termine`, `Treffen`
+- Navigation, Buttons und Kern-UI verwenden konsequent `Events`
+
+## Technik
+- Einstieg: `public/index.php`
+- Templates: `partials/`
+- App-Logik: `src/App/`
+- Assets: `public/assets/`
+- Datenbankschema: `schema.sql`
+
+## Datenschutz und Sicherheit
+- Passwort-Hashes über Argon2id
+- Konto-E-Mails verschlüsselt plus separater HMAC-Lookup-Hash
+- Profilfelder wie Vorname, Nachname, Straße/Hausnummer, Telefonnummer, Beruf, Sprachen und Kurzvorstellung verschlüsselt
+- Standortkoordinaten (`lat`, `lng`) bleiben für Distanz- und Umkreissuchen technisch im Klartext
+- nicht notwendige Analyse- und Drittanbieterfunktionen erst nach Einwilligung aktiv
+
+## Dokumentationspflicht bei Änderungen
+Bei jeder Änderung im Projekt mitprüfen und bei Bedarf aktualisieren:
+- `Internal/de/README.md`
+- `Internal/de/PROJECT_CONTEXT.md`
+- `Internal/de/PROJECT_STRUCTURE.md`
+- die parallelen englischen Dateien unter `Internal/en/`
+
+## Parallelpflege DE / EN
+- Die Dokumentation in `Internal/de/` und `Internal/en/` ist inhaltlich vollständig parallel zu halten.
+- Deutsch und Englisch sind beide verbindliche interne Referenzen.
+- Die Root-`README.md` im Hauptordner bleibt der feste Einstieg für neue Chats und verweist auf diese Struktur.