# Karatewiki (Goju-Kai Dojo) – Agenten-Leitfaden Dieses Repository verwaltet die MediaWiki-Konfiguration ([`config/LocalSettings.php`](config/LocalSettings.php)), das Docker-Setup (MediaWiki 1.43 LTS + MariaDB 11.8) und unsere eigenen Erweiterungen ([`extensions-custom/KarateMedia`](extensions-custom/KarateMedia)) für das Vereins-Wiki des Goju-Kai Dojo (`https://www.gojukai-dojo.de`). ## 📚 Pflichtlektüre beim Start einer neuen Session (z.B. auf einem anderen PC) 1. **[`docs/ARCHITECTURE_AND_STATUS.md`](docs/ARCHITECTURE_AND_STATUS.md):** Umfassende Gesamtdokumentation (Ist-Analyse des Strato-Systems, Datenbank-Auswertung der Video-Tags, Architektur-Entscheidungen, alle Einstellungen und aktueller Arbeitsstand / offene Aufgaben). 2. **[`docs/DEPLOYMENT.md`](docs/DEPLOYMENT.md):** Details zur CI/CD-Pipeline mit dem Gitea Runner auf dem Raspberry Pi 5 (`192.168.2.49`), Port-Belegung (`3093` Dev / `3008` Prod) und Befehle zum Spiegeln der Strato-Datenbank. ## 🛡️ Wichtige Grundregeln für Agenten 1. **Strato-Produktivsystem niemals ungefragt verändern:** Auf `51539426.ssh.w1.strato.hosting` (`Karate_Wiki_135`) darf ohne ausdrückliche Freigabe nur **lesend (`read-only`)** zugegriffen werden. 2. **Kein MediaWiki-Core und keine Mediendateien ins Git:** Weder der MediaWiki-Core noch Passwörter (`.env`), Datenbank-Dumps (`*.sql`) oder der `images/`-Ordner (8,3 GB Videos) gehören in dieses Repository. 3. **Striktes Branch- & Deployment-Modell:** - **Ausschließlicher Push auf `develop`:** Von der lokalen Entwicklungsumgebung aus darf **nur** auf den `develop`-Branch committed und gepusht werden (`git push origin develop`). Ein Push auf `develop` startet über den Gitea-Runner (`Raspi5-Paperless`) automatisch das Deployment nach `/home/lars/docker/karatewiki-dev` (Port `3093`). - **Kein lokaler Push auf `main`:** Der Merge von `develop` nach `main` wird **ausschließlich manuell durch den Benutzer direkt in Gitea** ausgelöst (damit `develop` und `main` bewusst getrennte Reifegrade behalten).