Dieses Repository verwaltet die MediaWiki-Konfiguration (`config/LocalSettings.php`), das Docker-Setup (MediaWiki 1.43 LTS + MariaDB 11.8) und unsere eigenen Erweiterungen (`extensions-custom/KarateMedia`) für das Vereins-Wiki des Goju-Kai Dojo (`https://www.gojukai-dojo.de`).
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`).
## Wichtige Regeln für Agenten
## 📚 Pflichtlektüre beim Start einer neuen Session (z.B. auf einem anderen PC)
1.**Strato-Produktivsystem niemals ungefragt verändern:** Auf `51539426.ssh.w1.strato.hosting` (`Karate_Wiki_135`) darf ohne ausdrückliche Freigabe nur **lesend** zugegriffen werden.
2.**Kein MediaWiki-Core und keine Mediendateien ins Git:** Weder der MediaWiki-Core noch Datenbank-Dumps (`*.sql`) oder der `images/`-Ordner (8,3 GB Videos) gehören in dieses Repository.
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.**Branch- & Deployment-Modell:**
- Gearbeitet wird auf `develop`. Ein Push auf `develop` startet über den Gitea-Runner automatisch das Deployment auf dem Raspberry Pi 5 (`/home/lars/docker/karatewiki-dev`, Port `3093`).
- Ein Merge nach `main` startet das Production-/Standby-Deployment (`/home/lars/docker/karatewiki`, Port `3008`).
- Ein Merge nach `main` (`git merge --no-ff develop`) startet das Production-/Standby-Deployment (`/home/lars/docker/karatewiki`, Port `3008`).
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):**
├── 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)
```
---
@@ -43,22 +55,3 @@ Unsere eigene Extension **`KarateMedia`** ([`extension.json`](extensions-custom/
```
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.
> **Hinweis für Entwickler & Coding Agents auf anderen Rechnern:**
> Dieses Dokument enthält den vollständigen Kontext aus der initialen Systemanalyse und Architekturplanung. Wenn du eine neue Session auf einem anderen Computer startest, lies zuerst dieses Dokument sowie [`docs/DEPLOYMENT.md`](DEPLOYMENT.md).
---
## 1. Ausgangslage & Zielsetzung
Das Goju-Kai Dojo betreibt seit vielen Jahren ein geschlossenes Vereins-MediaWiki (`https://www.gojukai-dojo.de`) mit umfangreichen Karate-Lernmaterialien, Kata- und Bunkai-Beschreibungen sowie **über 150 direkt im Wiki hochgeladenen Trainingsvideos (`.mp4`)**.
### Bisherige Hauptprobleme im Betrieb:
1.**PHP-Updates legen die Webseite lahm:** Jedes PHP-Upgrade beim Hoster (Strato) führt zu Ausfällen oder Inkompatibilitäten, weil das installierte MediaWiki (1.35.1 von 2020) und alte Drittanbieter-Plugins nicht für PHP 8.3 / 8.4 gebaut wurden.
2.**Wackelige Video-Plugins:** Für die Anzeige von Videos mussten immer wieder Drittanbieter-Extensions (`Html5mediator`, `EmbedVideo`, etc.) ausgetauscht und getestet werden.
3.**Fehlende Test-/Staging-Umgebung & Versionsverwaltung:** Änderungen konnten bisher kaum gefahrlos vorab getestet werden.
### Zielarchitektur:
* **Schlankes Git-Repository in Gitea:** Nur unsere eigene Konfiguration, das Docker-Setup und selbst entwickelte Extensions liegen im Git –**kein** MediaWiki-Core (~20.000 Dateien) und **keine** Mediendateien (`images/`, 8,3 GB).
* **Automatisiertes Staging & Failover auf dem eigenen Server (Raspberry Pi 5):** Über Gitea Actions wird bei jedem Push auf `develop` automatisch eine Testumgebung und bei Merge auf `main` eine Standby-/Produktionsumgebung auf dem Raspberry Pi 5 (`192.168.2.49`) als Docker-Stack gebaut.
* **Wartungsfreie Eigenbau-Extension (`KarateMedia`):** Ersetzt alle fremden Video-Plugins durch 100 % eigenen, schlanken PHP-8-Code ohne externe Abhängigkeiten.
---
## 2. Technische Ist-Analyse des Strato-Produktivsystems (Stand 24.10.2026)
> **WICHTIG:** Das System auf Strato ist das laufende Produktivsystem des Vereins. Alle Zugriffe im Rahmen der Analyse erfolgten strikt **lesend (`read-only`)**.
* **Pfad zum Produktiv-Wiki:** `~/Karate_Wiki_135`
* **PHP-Version (Web):** PHP 8.3.36
* **PHP-CLI auf Server:** `/opt/RZphp84/bin/php-cli`
* **MediaWiki-Version (Live):** `1.35.1` (ursprünglich installiert mit `1.25.1`, nie im Core gepatcht; im Ordner liegt bereits ein ungenutztes `mediawiki-1.39.3.tar.gz` vom März 2023)
* Stammt aus ca. 2012 (ca. 100 Zeilen Code) und stellt das `<html5media>`-Tag bereit.
* **Kritischer Fehler 1 (Mixed Content):** Bindet bei jedem Video `<script src="http://api.html5media.info/1.1.5/html5media.min.js"></script>` unverschlüsselt per `http://` von einer fremden, verwaisten Domain ein. Moderne Browser blockieren dies auf `https://www.gojukai-dojo.de`.
* **Kritischer Fehler 2 (Veraltete MediaWiki-APIs):** Nutzt `wfFindFile()` und `Xml::encodeJsVar()`, die in neueren MediaWiki-Versionen entfernt wurden.
* **Kritischer Fehler 3 (Namespace-Bug):** Prüft `substr($data, 0, 5)` auf `datei:`, was wegen 6 Zeichen Länge niemals greift (funktionierte nur mit `File:`).
2.**`EmbedVideo` (v2.9.0 von 2020):**
* War mit `$wgEmbedVideoEnableVideoHandler = true;` aktiviert, um normale Datei-Links (`[[Datei:Kata.mp4|mini]]`) als Video-Player darzustellen.
* Version 2.9.0 ist für MediaWiki 1.35 / PHP 7.4 geschrieben und unter PHP 8.3/8.4 sowie neuen MediaWiki-Versionen nicht mehr lauffähig.
### 2.4 Übersicht aller weiteren Extensions auf dem Strato-Server
#### A. Standard-Extensions (im offiziellen MediaWiki-Image bereits enthalten)
* *(Hinweis: `LocalisationUpdate` und `Renameuser` waren in 1.35 noch eigene Extensions; `Renameuser` ist ab MW 1.40 fest im MediaWiki-Core integriert, `LocalisationUpdate` wurde ab MW 1.38 obsolet.)*
#### B. Drittanbieter-Extensions (in `LocalSettings.php` aktiv)
1.**`EmbedVideo`** → **Ersetzt durch unsere eigene Extension `KarateMedia`**
2.**`Html5mediator`** → **Ersetzt durch unsere eigene Extension `KarateMedia`**
3.**`UploadWizard`** (Mehrstufiger Datei-Upload)
4.**`MsUpload`** (Drag & Drop Mehrfach-Upload direkt im Editor)
6.**`LinkTitles`** (Automatisches Verlinken von Seitentiteln)
7.**`CookieWarning`** (Cookie-Hinweisbanner)
8.**`EditUser`** (Benutzerprofile durch Bürokraten/Admins bearbeiten)
9.**`EmailPage`** (Seiten per E-Mail versenden)
#### C. Im Ordner vorhandene, aber in `LocalSettings.php` bereits auskommentierte Extensions (Altlasten)
*`ConfirmAccount` (Zeile `### require_once "$IP/extensions/ConfirmAccount/ConfirmAccount.php";` war auskommentiert)
*`Collection` (Zeile `#+ wfLoadExtension( 'Collection' );` war auskommentiert)
*`BlueSpiceInsertFile`, `EditAccount`, `UserExport`, `ReplaceText`, `MultimediaViewer` (nicht aktiv geladen)
---
## 3. Architektur- & Design-Entscheidungen
### Entscheidung 1: Kein MediaWiki-Core im Git-Repository
Da am MediaWiki-Core niemals manuell herumgepatcht wurde, wird der MediaWiki-Core **nicht** in Gitea eingecheckt. Stattdessen kommt der Core im Docker-Betrieb direkt aus dem offiziellen Multi-Arch-Image `mediawiki:1.43` (LTS). Das hält das Git-Repository winzig (< 100 KB) und erlaubt zukünftige MediaWiki- oder PHP-Versionssprünge durch Ändern einer einzigen Versionsnummer im [`Dockerfile`](../Dockerfile).
### Entscheidung 2: Eigene Kombi-Extension `KarateMedia` statt Drittanbieter-Video-Plugins
Anstatt erneut fremde Video-Plugins zu installieren, haben wir unter [`extensions-custom/KarateMedia/`](../extensions-custom/KarateMedia/) eine eigene, exakt auf das Karate-Wiki zugeschnittene MediaWiki-Extension entwickelt:
***100 % Abwärtskompatibel:** Sie implementiert sowohl den Parser-Hook `<html5media>` ([`KarateMediaHooks.php`](../extensions-custom/KarateMedia/src/KarateMediaHooks.php)) für die 87 alten Seiten als auch den `MediaHandler` ([`KarateVideoHandler.php`](../extensions-custom/KarateMedia/src/KarateVideoHandler.php)) für die ~71 Seiten mit `[[Datei:*.mp4|mini|...]]`. Es muss **keine einzige Wiki-Seite** umgeschrieben werden!
***Mehrwert fürs Karate-Training:** Unter jedem Video rendert `KarateMedia` automatisch kompakte Steuerbuttons für **`1x` | `0.5x` | `0.25x` | `Loop`** ([`karatemedia.js`](../extensions-custom/KarateMedia/resources/karatemedia.js)), damit Kata- und Bunkai-Techniken direkt in Zeitlupe und Endlosschleife studiert werden können.
### Entscheidung 3: Fehlertolerante `LocalSettings.php` für Docker UND Strato
Die neue [`config/LocalSettings.php`](../config/LocalSettings.php) ist so aufgebaut, dass sie:
1. Zugangsdaten und Keys primär aus Umgebungsvariablen (`getenv('MW_...')` aus `.env`) liest und als Fallback eine lokale `LocalSettings.secrets.php` unterstützt.
2. Alle Extensions vor dem Laden per `file_exists("$IP/extensions/$extName/extension.json")` prüft. Fehlt eine optionale Drittanbieter-Extension, stürzt das Wiki **niemals** mit einem `Fatal Error` ab.
---
## 4. Wichtige Einstellungen & Berechtigungen im Detail
Alle spezifischen Einstellungen des Vereins-Wikis wurden 1:1 in [`config/LocalSettings.php`](../config/LocalSettings.php) übernommen:
* **Geschlossenes Vereins-Wiki:**
* Unangemeldete Besucher (`*`) haben weder Lese- noch Schreib- noch Registrierungsrechte (`createaccount = false`, `edit = false`, `read = false`).
* **Öffentliche Ausnahmen (`$wgWhitelistRead`):**
*`Spezial:Userlogin` / `Spezial:Anmelden`
*`Karate:Datenschutz`
*`Karate:Impressum`
*`Spezial:Benutzerkonto_beantragen`
*`Karate:Nutzungsbedingungen`
* **Eigene Benutzergruppe `Trustworthy`:**
* Erbt alle Rechte von `user` und erhält zusätzlich: `delete`, `protect`, `patrol`, `purge`, `createaccount`, `block`.
- [x] Push von `main` und `develop` nach `https://gitea.stommer.de/Lars/karatewiki.git`.
### 🔜 Offene Punkte / Nächste Schritte:
- [ ]**1. Gitea-Runner-Lauf prüfen:** Kontrollieren, ob `deploy-dev.yml` auf dem Raspberry Pi 5 (`http://192.168.2.49:3093`) erfolgreich durchläuft (ggf. Runner-Konfiguration mit aktuellem Repo abgleichen).
- [ ]**2. Live-Datenbank & Beispiel-Videos in `karatewiki-dev` einspielen:** Mit [`scripts/sync-from-strato.sh`](../scripts/sync-from-strato.sh) einen aktuellen DB-Abzug und ausgewählte (oder alle) Videos von Strato nach `/home/lars/docker/karatewiki-dev` holen und das Upgrade-Skript (`php maintenance/run.php update --quick`) gegen die echten Vereinsdaten testen.
- [ ]**3. Drittanbieter-Extensions im `Dockerfile` ergänzen (nach Bedarf):** Prüfen, welche der optionalen Extensions (`MsUpload`, `UploadWizard`, `MobileFrontend`, `LinkTitles`, `EditUser`) in MediaWiki 1.43 weiterhin gewünscht sind, und diese im `Dockerfile` automatisch in das Image einbauen.
- [ ]**4. Gewünschte Vereins-Modifikationen umsetzen:** Neue Features und Anpassungen auf dem `develop`-Branch entwickeln und unter `http://192.168.2.49:3093` testen.
- [ ]**5. Strato-Deployment / Cutover planen:** Entscheiden, ob Strato beim Merge auf `main` ebenfalls automatisiert aktualisiert wird oder ob das Wiki langfristig über den Reverse-Proxy komplett auf der eigenen Infrastruktur läuft.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.