papa-kind-treff.info/Internal/de/PROJECT_STRUCTURE.md

Papa-Kind-Treff – Projektstruktur

Stand: 2026-08-10

Projektordner

• config/: Konfigurationen, inklusive prod/ und staging/
• config/secrets.local.php: lokale, nicht versionierte Server-Geheimnisse außerhalb des Webroots; Vorlage: config/secrets.local.php.example
• config/.htaccess: zusätzliche Webserver-Sperre für den gesamten Konfigurationsordner; beide Deployment-Workflows schließen secrets.local.php explizit vom synchronisierenden Löschen aus.
• 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
• Internal/db/: internes Datenbankschema
• Internal/archive/: archivierte frühere interne Root-Dateien

Aktuelle Strukturhinweise

• Avatar-Verwaltung: src/App/Avatar/AvatarManager.php
• aktive Styles: src/App/Avatar/Lorelei.php, src/App/Avatar/Croodles.php
• Profil- und Admin-Bereiche mit getrennten Seitennavigationen: partials/landing/account/dashboard.php, Zugriffskontext in src/App/AccountPages.php, Einstieg über partials/structure/nav.php
• Admin-Freigaben, Community-Moderation, User Management und Migration werden im Dashboard durch src/App/AccountPages.php verarbeitet und in partials/landing/account/dashboard.php dargestellt.
• Event-Quellen aus Datenbank plus Speicherung der Event-Location-Herkunft: partials/landing/account/dashboard.php, src/App/AccountPages.php, Internal/db/schema.sql
• Consent- und rechtliche Texte: public/page/datenschutz.php
• System-Einstellungen: src/App/SystemSettings.php
• Profil-Levels für Owner inklusive Benutzersuche, manueller Community-Punktevergabe und Liste kürzlich erreichter hoher Ränge: partials/landing/account/dashboard.php, src/App/AccountPages.php, src/App/Community.php, src/App/CommunityAccess.php, src/App/SystemSettings.php
• neue Listing-/Ort-Basis: src/App/ListingCatalog.php
• Kalender-Export und abonnierbarer Feed: src/App/CalendarSync.php plus public/page/calendar/export.php und public/page/calendar/feed.php
• UI für getrennte Bereiche Events und Orte & Veranstaltungen im Mitgliederbereich: partials/landing/account/dashboard.php
• eigener Mitgliederbereichspunkt Kategorien für neue Kategorien und deren Zusammenführung per Vorschlagsfeld: partials/landing/account/dashboard.php, src/App/AccountPages.php, src/App/ListingCatalog.php
• Community-Level-Rechte für Kategorien und Orts-/Veranstaltungsfreigaben: config/community.php, src/App/Community.php, src/App/CommunityAccess.php, src/App/AccountPages.php, partials/landing/account/dashboard.php
• Preis-, Bild- und Ortseingabe für Orte und Veranstaltungen sowie reduzierte Event-Maske: partials/landing/account/dashboard.php plus Speicherung in src/App/ListingCatalog.php
• Freigaben sowie Änderungs- und Löschanfragen für Orte und Veranstaltungen: src/App/ListingCatalog.php, src/App/AccountPages.php, partials/landing/account/dashboard.php
• Direktbearbeitung noch nicht veröffentlichter Orts- und Veranstaltungsvorschläge sowie Rechteauflösung für deren Freigabe: src/App/CommunityAccess.php, src/App/AccountPages.php, src/App/ListingCatalog.php, partials/landing/account/dashboard.php
• Server-seitige Ortsanbieter-Suche und sichere Trefferauswahl für die Admin-Freigabe: src/App/PlaceProviderLookup.php, src/App/AccountPages.php, src/App/ListingCatalog.php, partials/landing/account/dashboard.php
• Admin-Listen für bestehende Ortsbearbeitung und fehlende Anbieter-Verknüpfungen: src/App/ListingCatalog.php, src/App/AccountPages.php, partials/landing/account/dashboard.php
• Direkte Admin-Korrekturen veröffentlichter Orts- und Veranstaltungsdaten: src/App/ListingCatalog.php, src/App/AccountPages.php, partials/landing/account/dashboard.php
• Rollenvergabe per Benutzersuche im User Management: src/App/AccountPages.php, partials/landing/account/dashboard.php, src/App/CommunityAccess.php
• Legacy-Eigen-Events wurden erweitert in src/App/AccountPages.php und Internal/db/schema.sql um Kategorie- und Bildfelder
• Kategorien-Prüfung und Zusammenführung für Seiten-Admins liegen ebenfalls in partials/landing/account/dashboard.php mit Logik in src/App/ListingCatalog.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.
• Frühere interne Root-Dokumente liegen jetzt unter Internal/archive/legacy-root-files/.