Doberaner Zwergen-Börse - Projekt-Dokumentation

Willkommen in der Dokumentation für die Website der Doberaner Zwergen-Börse.

Überblick

Die Zwergen-Börse ist eine Website für einen Kinder-Flohmarkt in Bad Doberan. Das System besteht aus:

• Statischer Website (Frontend) mit Informationsseiten
• PHP-Backend für Anmeldeverwaltung
• Admin-Bereich zur Konfiguration und Verwaltung

Schnellstart

1. Installation & Setup
2. Projekt-Landkarte (Code-getrieben)
3. Glossar
4. Lokale Entwicklung
5. Tests
6. Mitwirken (Contributing)
7. Architektur-Übersicht
8. Mail-Queue (Erklärung)
9. Performance & Optimierungen
10. Roadmap / Offene Aufgaben
11. Entscheidungen & Historie

Dokumentation

Grundlagen

• Architektur - Technische Architektur und Struktur
• Installation - Setup und Konfiguration
• Deployment - Deployment-Prozess (inkl. Forgejo Actions CI/CD)

Entwicklung

• Backend-Dokumentation - PHP-Backend Details
• Frontend-Build - Build-System und Content-Management
• Datenbank-Schema - Datenbankstruktur

Betrieb

• Sicherheit - Sicherheitsrichtlinien und Best Practices
• Admin-Bereich - Admin-Funktionen und Konfiguration
• Wartung - Wartungsaufgaben und Troubleshooting

Technologie-Stack

• Frontend: HTML, CSS, JavaScript (Vanilla)
• Build: Node.js (ESM), markdown-it
• Backend: PHP 8+ (strict types)
• Datenbank: SQLite
• E-Mail: PHP mail()

Repository-Struktur

zgb_www/
├── content/          # Content-Dateien (Markdown/HTML)
├── static/           # Statische Assets
├── zgb-backend/      # Backend-Quellcode
├── scripts/          # Build-Skripte
└── public/           # Build-Output (wird deployed)

Wichtige Links

• Produktions-URL: https://www.doberaner-zwergenboerse.de
• Git-Repository: ssh://forgejo@home.schumbi.de/ralf/zgb_www.git
• Wiki-Repository: ssh://forgejo@home.schumbi.de/ralf/zgb_www.wiki.git

Status

✅ Funktional: System ist produktiv im Einsatz

• Anmeldesystem funktioniert
• Admin-Bereich verfügbar
• E-Mail-Versand konfiguriert

📋 Offen: Siehe todo.md für aktuelle Aufgaben