generated importent files

README.md

@@ -1,2 +1,50 @@
-# Workshop-Wahlen
+# Workshop-Wahlen – Entwickler-Übersicht
+
+## Überblick
+
+Dieses WordPress-Plugin ermöglicht die Verwaltung und Durchführung von Workshop-Wahlen für Konfi-Castle-Events. Es bietet ein vollständiges Backend für Admins (Wahlen, Workshops, Teilnehmer, Teamer, Zuteilungen) und ein Frontend-Formular für Teilnehmer.
+
+## Architektur & Hauptkomponenten
+
+- **Haupt-Plugin-Datei:** `konficastle-workshopwahl.php` – Registriert Hooks, lädt Assets, initialisiert Admin-Menüs.
+- **Backend-Module (im `includes/`-Verzeichnis):**
+	- `admin-wahlen.php`, `admin-workshops.php`, `admin-teilnehmer.php`, `admin-teamer.php`, `admin-zuteilungen.php`, `admin-data.php`, `force-zuteilung.php`: Jeweils eigene Admin-Seiten für die Verwaltung der zugehörigen Entitäten.
+	- `zuteilungslogik.php`: Kernlogik für die automatische Zuteilung von Teilnehmern zu Workshops (inkl. Force-Zuteilungen und Kapazitätsprüfung).
+- **Frontend:**
+	- `frontend-form.php`: Shortcode `[konficastle_workshopwahl wahl=ID]` für das Teilnehmer-Formular.
+	- `frontend-ergebnis.php`: Shortcode `[konficastle_workshop_ergebnis wahl=ID]` für Ergebnisanzeige.
+- **Styles & Assets:**
+	- `assets/`: Enthält CSS für Admin und Frontend.
+
+## Datenbank & Installation
+
+- Tabellen werden über `install.php` beim Aktivieren angelegt (z.B. `kc_wahlen`, `kc_workshops`, `kc_teilnehmer`, `kc_zuteilung`, ...).
+- Tabellenpräfix wird dynamisch über `$wpdb->prefix` verwendet.
+
+## Entwickler-Workflows
+
+- **Testdaten:** Über die Admin-Seite "Datenverwaltung" (`admin-data.php`) können Testdaten generiert werden (nur User ID 1).
+- **CSV-Export:** Zuteilungen können über die Admin-Seite exportiert werden (`admin-zuteilungen.php`).
+- **Zuteilungslogik:** Anpassungen an der Kernlogik erfolgen in `zuteilungslogik.php`.
+- **Shortcodes:**
+	- `[konficastle_workshopwahl wahl=ID]` – Teilnehmer-Frontend
+	- `[konficastle_workshop_ergebnis wahl=ID]` – Ergebnisanzeige
+
+## Besondere Konventionen & Hinweise
+
+- **Namensschema:** Alle Plugin-Funktionen und Tabellen sind mit `kc_` (Konfi-Castle) prefixiert.
+- **Admin-Tabs:** Navigation zwischen Admin-Seiten über `kc_admin_tabs()`.
+- **Force-Zuteilungen:** Manuelle Zuweisungen haben Vorrang vor automatischer Logik.
+- **Teamer-Passwort:** Verwaltung über eigene Admin-Seite, Passwort-Hash in WP-Optionen.
+- **Frontend-Validierung:** Erfolgt serverseitig, keine komplexe JS-Logik im Frontend.
+
+## Einstiegspunkte & Beispiele
+
+- **Admin-Menüstruktur:** Siehe `konficastle-workshopwahl.php` und `includes/admin-wahlen.php`.
+- **Zuteilungslogik:** Siehe `includes/zuteilungslogik.php` (Funktionen wie `kc_run_zuteilung`).
+- **Frontend-Formular:** Siehe `includes/frontend-form.php` (Shortcode-Handler).
+
+---
+
+Für Detailfragen zu Datenbankstruktur, Shortcodes oder Zuteilungslogik siehe die jeweiligen Dateien im `includes/`-Verzeichnis.