73 lines
4.8 KiB
Markdown
73 lines
4.8 KiB
Markdown
# Papa-Kind-Treff – Chat-Kontext
|
||
|
||
Stand: 2026-07-29
|
||
|
||
## Kurzbeschreibung
|
||
Papa-Kind-Treff ist eine PHP-basierte Plattform für Väter. Kernbereiche sind lokale Treffen/Events, ein Community-Forum, Mitgliederprofile mit optionalen Kinderinfos und ein Moderations-/Adminbereich.
|
||
|
||
## Technischer Rahmen
|
||
- Kein großes Framework, sondern eigener Front-Controller in `public/index.php`
|
||
- Templates unter `partials/`
|
||
- Geschäftslogik unter `src/App/`
|
||
- MySQL/MariaDB-Schema in `schema.sql`
|
||
- Globales Frontend vor allem über `public/assets/js/app.js` und `public/assets/css/app.css`
|
||
- Avatar-Manager liegt zentral unter `src/App/Avatar/AvatarManager.php`
|
||
- Die aktiven Styles `Lorelei` und `Croodles` liegen getrennt unter `src/App/Avatar/Lorelei.php` und `src/App/Avatar/Croodles.php`
|
||
- Die Avatar-Konfiguration liegt in `config/avatar.php`
|
||
- In `config/avatar.php` sind pro Style auch Beispielpaletten, Komponentenlisten und Beispielprofile dokumentiert
|
||
- Der Avatar-Endpunkt ist als direkte Datei unter `public/api/avatar.php` angebunden und laeuft bewusst ohne vollen App-Bootstrap.
|
||
|
||
## Wichtige Produktentscheidungen
|
||
- Die Ansprache im Frontend soll immer den aktuellen Nutzer direkt ansprechen.
|
||
- Die Hauptnavigation ist bewusst knapp gehalten: `Home`, `Suche`, `Community`.
|
||
- `Termine` ist aktuell kein eigener Hauptpunkt mehr; Events werden über Startseite und Suche erschlossen.
|
||
- Die Community ist hierarchisch aufgebaut: Kategorien -> Boards -> Threads -> Posts.
|
||
- Moderation ist getrennt vom normalen Community-Frontend in einem eigenen Adminbereich.
|
||
- Standortfunktionen sind relevant für lokale Treffen und werden künftig weiter ausgebaut.
|
||
- Profilbilder werden aktuell über die Mehr-Style-Architektur serverseitig erzeugt; aktiv sind derzeit `lorelei` und `croodles`.
|
||
- Beim Style `croodles` startet die Basisfarbe standardmaessig weiss; der Hintergrund ist standardmaessig nicht vorbelegt.
|
||
- Stil, Seed und Varianten werden generisch im Profil gespeichert; das fertige SVG wird lokal pro Benutzer unter `ptk-<userId>.svg` abgelegt.
|
||
- Der Avatar-Editor bietet visuelle Komponenten-Vorschauen statt reiner Text-Dropdowns, laedt nur den aktiven Style/Tab nach, zeigt die Farbfelder direkt im passenden Komponentenabschnitt an und haelt Kopfbereich sowie Komponentenleiste im Modal fixiert.
|
||
|
||
## Navigation / Konto
|
||
- Eingeloggte Nutzer sehen rechts ein Profil-Menü statt einzelner `Dashboard`-/`Logout`-Buttons.
|
||
- Das Profil-Menü enthält aktuell `Profil`, `Kinder`, `Termine`, `Community`, `Einstellungen`, `Abmelden`.
|
||
- Der Mitgliederbereich selbst ist als Layout mit linker Bereichsnavigation aufgebaut.
|
||
- Kinder koennen im Mitgliederbereich angelegt, nachtraeglich bearbeitet und wieder geloescht werden.
|
||
- Wenn ein Geburtsdatum gesetzt ist, wird das Alter im Mitgliederbereich automatisch berechnet und spaeter bei Bedarf anhand des Datums aktualisiert; ohne Geburtsdatum gilt der manuelle Alterswert.
|
||
- Sensible Profildaten wie Vorname, Nachname, Telefonnummer, Beruf, Sprachen und Kurzvorstellung werden app-seitig verschluesselt gespeichert; bestehende Klartextwerte werden bei Nutzung schrittweise in den verschluesselten Zustand ueberfuehrt.
|
||
- Im Profil kann der Nutzer aktuell Komponenten wie Augen, Augenbrauen, Mund, Brille, Haare, Bart und Ohrringe direkt per Vorschaubild auswählen.
|
||
- Der Button `Random Profilbild` setzt Seed und Varianten des aktiven Styles zufaellig neu und aktualisiert die Vorschau sofort.
|
||
- Beim Oeffnen des Avatar-Generators wird nur der aktive Style-/Komponenten-Tab geladen; weitere Varianten werden erst beim Wechsel nachgeladen.
|
||
- Debug ist kein Menüpunkt und erscheint nur als Floating-Käfer für `site_admin` bei aktivem Debug-Modus.
|
||
|
||
## Community und Rechte
|
||
- dekorative Ränge über Punkte
|
||
- Moderationsrollen:
|
||
- `forum_admin`
|
||
- `site_admin`
|
||
- `owner`
|
||
- Bewerbungen für Moderation sind vorgesehen bzw. umgesetzt.
|
||
|
||
## Recht / Consent
|
||
- Nicht notwendige Funktionen laufen nicht automatisch los.
|
||
- Es gibt einen Consent-Manager mit Kategorien:
|
||
- `analytics`
|
||
- `external_services`
|
||
- Matomo wird nur nach Analyse-Einwilligung geladen.
|
||
- Externe Karten-/Standortdienste und lokale Standortspeicherung hängen an `external_services`.
|
||
- Zusätzlich gibt es eine Standortpräferenz im Bereich `Einstellungen`:
|
||
- `disabled`
|
||
- `prompt`
|
||
- `enabled`
|
||
- Im Einstellungsbereich werden außerdem Browser-Grenzen erklärt: Die Browser-Freigabe selbst kann nicht von der Website gesetzt oder aufgehoben werden.
|
||
- Es gibt eine eigene Seite `/datenschutz` für Datenschutz- und Cookie-Hinweise sowie einen Footer-Link auf die Consent-Einstellungen.
|
||
|
||
## Doku-Regel
|
||
Bei jeder künftigen Änderung müssen mindestens diese Dateien mitgeprüft werden:
|
||
- `README.md`
|
||
- `.projektstructure.txt`
|
||
- `PROJECT_CONTEXT.md`
|
||
|
||
Wenn Cookies, LocalStorage, SessionStorage, Tracking, Geolocation oder Drittanbieter neu hinzukommen oder geändert werden, müssen zusätzlich Consent und rechtliche Hinweise angepasst werden.
|