# Karate-Wiki (Goju-Kai Dojo) – Infrastruktur & Eigene Erweiterungen Dieses Repository enthält **ausschließlich** die Konfiguration, das Docker-Setup und unsere selbst entwickelten Erweiterungen für das Karate-Wiki (`https://www.gojukai-dojo.de`). Der MediaWiki-Core (~20.000 Dateien), Passwörter (`.env`) und die Mediendateien (`images/`, ca. 8,3 GB Videos) werden bewusst **nicht** im Git gespeichert. > 📖 **Vollständige Projektdokumentation (für nahtloses Weiterarbeiten auf jedem Rechner):** > * **[`docs/ARCHITECTURE_AND_STATUS.md`](docs/ARCHITECTURE_AND_STATUS.md)** – Ist-Analyse (Strato), Architektur-Entscheidungen, alle Einstellungen & aktueller Arbeitsstand / Roadmap > * **[`docs/DEPLOYMENT.md`](docs/DEPLOYMENT.md)** – Gitea Runner CI/CD auf dem Raspberry Pi 5 (`192.168.2.49`), Ports (`3093` Dev / `3008` Prod) & Datenbank-Sync > * **[`AGENTS.md`](AGENTS.md)** – Einstiegspunkt und Sicherheitsregeln für Coding Agents --- ## 📁 Verzeichnisstruktur ```text C:\dev\Karatewiki\ ├── .gitea/workflows/ # Automatische Deployments auf den Raspberry Pi 5 (develop & main) ├── assets/ │ └── logo_goju-kai_Bleistift.png # Vereinslogo ├── config/ │ ├── LocalSettings.php # Bereinigte Wiki-Konfiguration (für Docker UND Strato nutzbar) │ └── php-uploads.ini # Erhöht Upload-Limit auf 500 MB für Karate-Videos ├── docs/ │ ├── ARCHITECTURE_AND_STATUS.md # Umfassende Analyse-, Entscheidungs- & Status-Dokumentation │ └── DEPLOYMENT.md # Deployment-Architektur & Port-Übersicht auf dem Pi 5 ├── extensions-custom/ │ └── KarateMedia/ # Eigene HTML5-Video-Extension (inkl. Zeitlupe 0.5x/0.25x & Loop) ├── scripts/ │ ├── ensure-db-schema.php # Initialisiert DB-Schema bei leeren Erst-Installationen │ ├── sync-from-strato.ps1 # Holt DB-Dump (rein lesend) unter Windows │ └── sync-from-strato.sh # Holt DB-Dump & Videos (per rsync) unter Linux ├── .env.example # Vorlage für Datenbank-Zugangsdaten & Keys ├── .gitignore # Schützt Passwörter (.env), DB-Dumps & Videos vor Git-Upload ├── AGENTS.md # Leitfaden für Coding Agents beim Rechnerwechsel ├── Dockerfile # Baut MediaWiki 1.43 LTS (PHP 8.3/8.4) + KarateMedia Extension ├── docker-compose.dev-env.yml # Development-Stack auf dem Pi 5 (Port 3093) └── docker-compose.yml # Production-/Standby-Stack auf dem Pi 5 (Port 3008) ``` --- ## 🥋 Die eigene Extension: `KarateMedia` Im bisherigen Produktiv-Wiki waren zwei veraltete Plugins gleichzeitig aktiv (`Html5mediator` und `EmbedVideo v2.9.0`), die unter PHP 8.3/8.4 und neuen MediaWiki-Versionen Fehler verursachen. Unsere eigene Extension **`KarateMedia`** ([`extension.json`](extensions-custom/KarateMedia/extension.json)) ersetzt **beide** komplett wartungsfrei: 1. **Abwärtskompatibel für alle 87 Seiten mit ``:** ```xml File:SeienchinOsaeUke.mp4 ``` 2. **Abwärtskompatibel für alle ~71 Seiten mit Standard-Datei-Links:** ```wikitext [[Datei:Seienchin2.mp4|mini|Seienchin von vorne]] [[File:Shisoshin_Funsako_Sensei.mp4|300x169px]] ``` 3. **Trainings-Features direkt integriert:** Unter jedem Video befindet sich eine kompakte Steuerleiste mit **`1x` | `0.5x` | `0.25x` | `Loop`**, um Kata- und Bunkai-Sequenzen direkt in Zeitlupe oder Endlosschleife zu studieren.