16 KiB
Karate-Wiki (Goju-Kai Dojo) – Gesamtdokumentation: Analyse, Entscheidungen, Einstellungen & Arbeitsstand
Letzte Aktualisierung: 2026-10-24
Repository: https://gitea.stommer.de/Lars/karatewiki.git (intern: http://192.168.2.144:3000/Lars/karatewiki.git)
Produktiv-Domain: https://www.gojukai-dojo.de
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 sowiedocs/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:
- 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.
- Wackelige Video-Plugins: Für die Anzeige von Videos mussten immer wieder Drittanbieter-Extensions (
Html5mediator,EmbedVideo, etc.) ausgetauscht und getestet werden. - 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
developautomatisch eine Testumgebung und bei Merge aufmaineine 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).
2.1 Server- & Umgebungsdaten (Strato)
- SSH-Host:
51539426.ssh.w1.strato.hosting - SSH-Benutzer:
stu100093250(SSH-Key:~/.ssh/strato_fewo) - 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 mit1.25.1, nie im Core gepatcht; im Ordner liegt bereits ein ungenutztesmediawiki-1.39.3.tar.gzvom März 2023) - Datenbank-Server:
rdbms.strato.de(MySQL5.7.42-log) - Datenbank-Name:
dbs1754262 - Datenbank-Benutzer:
dbu1061679 - Tabellen-Präfix:
Karate_(ENGINE=InnoDB, DEFAULT CHARSET=binary) - Größe des
images/-Ordners: 8,3 GB (enthält.htaccessund alle hochgeladenen Videos/Bilder) - Vereins-Logo:
resources/assets/logo_goju-kai_Bleistift.png(im Repo unterassets/logo_goju-kai_Bleistift.pnggesichert)
2.2 Datenbank-Auswertung der Wiki-Inhalte & Video-Syntax
Eine lesende SQL-Auswertung über die aktuellen Seitenrevisionen (Karate_page → Karate_revision → Karate_slots → Karate_content → Karate_text) ergab folgendes exaktes Bild:
| Metrik | Anzahl Seiten | Details / Beispiele aus dem Wiki |
|---|---|---|
| Gesamtanzahl Wiki-Seiten | 1.028 | Aktive Seiten im Wiki |
Seiten mit .mp4-Videos |
158 | Alle Videos liegen lokal im images/-Ordner |
davon mit <html5media>-Tag |
87 | z.B. <html5media height="200">File:SeienchinOsaeUke.mp4</html5media> |
davon mit [[Datei:...]] / [[File:...]] |
~71 | z.B. [[Datei:Seienchin2.mp4|mini]], [[File:Shisoshin_Funsako_Sensei.mp4|300x169px]] |
davon mit {{#ev:...}} (EmbedVideo-Parserfunktion) |
0 | Wird im gesamten Wiki nicht verwendet! |
Seiten mit .mp3-Dateien |
0 | Keine MP3-Einbindungen |
Seiten mit .ogg-Dateien |
1 | 1 Seite mit OGG |
Seiten mit .webm-Dateien |
0 | Keine WebM-Einbindungen |
2.3 Analyse der bisherigen Video-Plugins (Ursache der Probleme)
In der bisherigen LocalSettings.php auf Strato waren zwei veraltete Video-Extensions gleichzeitig aktiv:
Html5mediator(extensions/Html5mediator/Html5mediator.php):- 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 perhttp://von einer fremden, verwaisten Domain ein. Moderne Browser blockieren dies aufhttps://www.gojukai-dojo.de. - Kritischer Fehler 2 (Veraltete MediaWiki-APIs): Nutzt
wfFindFile()undXml::encodeJsVar(), die in neueren MediaWiki-Versionen entfernt wurden. - Kritischer Fehler 3 (Namespace-Bug): Prüft
substr($data, 0, 5)aufdatei:, was wegen 6 Zeichen Länge niemals greift (funktionierte nur mitFile:).
- Stammt aus ca. 2012 (ca. 100 Zeilen Code) und stellt das
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.
- War mit
2.4 Übersicht aller weiteren Extensions auf dem Strato-Server
A. Standard-Extensions (im offiziellen MediaWiki-Image bereits enthalten)
Cite,Gadgets,ImageMap,InputBox,Interwiki,Nuke,ParserFunctions,PdfHandler,SpamBlacklist,SyntaxHighlight_GeSHi,TitleBlacklist,WikiEditor- (Hinweis:
LocalisationUpdateundRenameuserwaren in 1.35 noch eigene Extensions;Renameuserist ab MW 1.40 fest im MediaWiki-Core integriert,LocalisationUpdatewurde ab MW 1.38 obsolet.)
B. Drittanbieter-Extensions (in LocalSettings.php aktiv)
EmbedVideo→ Ersetzt durch unsere eigene ExtensionKarateMediaHtml5mediator→ Ersetzt durch unsere eigene ExtensionKarateMediaUploadWizard(Mehrstufiger Datei-Upload)MsUpload(Drag & Drop Mehrfach-Upload direkt im Editor)MobileFrontend(Mobile Ansicht + SkinMinervaNeue)LinkTitles(Automatisches Verlinken von Seitentiteln)CookieWarning(Cookie-Hinweisbanner)EditUser(Benutzerprofile durch Bürokraten/Admins bearbeiten)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.46 (1.46.2). 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.
Entscheidung 2: Eigene Kombi-Extension KarateMedia & Vereins-Anmeldeseite
Anstatt erneut fremde Video-Plugins zu installieren, haben wir unter 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) für die 87 alten Seiten als auch denMediaHandler(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
KarateMediaautomatisch kompakte Steuerbuttons für1x|0.5x|0.25x|Loop(karatemedia.js), damit Kata- und Bunkai-Techniken direkt in Zeitlupe und Endlosschleife studiert werden können. - Moderne Vereins-Anmeldeseite & Direkter Login-Redirect: Unangemeldete Besucher werden ohne Zwischenseite (
Special:Badtitle/ „Anmeldung erforderlich“) sofort per302-Redirect aufSpezial:Anmeldengeleitet. Dort erscheint eine maßgeschneiderte Anmelde-Card im Design von Goju-Kai Dojo Heilbronn e.V. mit dem offiziellen Vektor-Vereinslogo (assets/logo-light.svgauf dunklem Header,assets/logo.svgin der hellen Wiki-Seitenleiste) und dem direkten Link zum Beantragen von Zugangsdaten im Vereinsshop (https://shop.karate.hn/produkt/zugang-zu-vereinseigenem-karatewiki-20).
Entscheidung 3: Fehlertolerante LocalSettings.php für Docker UND Strato
Die neue config/LocalSettings.php ist so aufgebaut, dass sie:
- Zugangsdaten und Keys primär aus Umgebungsvariablen (
getenv('MW_...')aus.env) liest und als Fallback eine lokaleLocalSettings.secrets.phpunterstützt. - 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 einemFatal Errorab.
4. Wichtige Einstellungen & Berechtigungen im Detail
Alle spezifischen Einstellungen des Vereins-Wikis wurden 1:1 in 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:AnmeldenKarate:DatenschutzKarate:ImpressumSpezial:Benutzerkonto_beantragenKarate:Nutzungsbedingungen
- Unangemeldete Besucher (
- Eigene Benutzergruppe
Trustworthy:- Erbt alle Rechte von
userund erhält zusätzlich:delete,protect,patrol,purge,createaccount,block.
- Erbt alle Rechte von
- iOS / Safari Video-Streaming-Fix (
Phabricator T235554):$wgDisableOutputCompression = true;ist zwingend aktiv, damit iPhones und iPads MP4-Videos überHTTP Byte-Range Requestsabspielen können.
- Upload-Limits für Videos:
- In
config/php-uploads.ini:upload_max_filesize = 500M,post_max_size = 500M,max_execution_time = 600. - Erlaubte Dateiendungen (
$wgFileExtensions): u.a.png,gif,jpg,jpeg,webp,svg,pdf,doc/docx,xls/xlsx,ppt/pptx,odt/ods/odp,ogg,mp3,mp4,webm,mov.
- In
5. CI/CD & Server-Umgebung (Raspberry Pi 5 & Gitea Runner)
Details zum Deployment stehen in docs/DEPLOYMENT.md. Kurzfassung:
- Docker-Host: Raspberry Pi 5 (
192.168.2.49, ARM64) - Development (
develop-Branch):- Pfad auf Pi:
/home/lars/docker/karatewiki-dev - Compose-Datei:
docker-compose.dev-env.yml - Port:
3093(http://192.168.2.49:3093) - Workflow:
.gitea/workflows/deploy-dev.yml
- Pfad auf Pi:
- Production / Pi-Standby (
main-Branch):- Pfad auf Pi:
/home/lars/docker/karatewiki - Compose-Datei:
docker-compose.yml - Port:
3008(http://192.168.2.49:3008) - Workflow:
.gitea/workflows/deploy-prod.yml
- Pfad auf Pi:
6. Neue Strato-Parallelinstallation (~/Karatewiki & ~/karatewiki-shared)
Um auf Strato ohne Ausfallzeit des bestehenden Systems (~/Karate_Wiki_135) auf die neueste MediaWiki-Version (1.46.2), PHP 8.4 und MariaDB 11.8 umzustellen und gleichzeitig den über Jahre angesammelten Dateimüll (3,5 GB Temp-/Archiv-/Waisen-Dateien) zu beseitigen, wurde folgende saubere Struktur auf Strato aufgebaut:
- Neues Anwendungsverzeichnis (versionsunabhängig):
~/Karatewiki(MediaWiki1.46.2, PHP8.4via.htaccess,MsUploadfür Drag-&-Drop-Mehrfach-Uploads bis500M,KarateMediasowie Datei- und Beschleuniger-Caching). - Zentrales, bereinigtes Medien- & Secrets-Verzeichnis:
~/karatewiki-shared/~/karatewiki-shared/images(per Symlink in~/Karatewiki/imageseingebunden): Enthält ausschließlich die 566 tatsächlich im Wiki verlinkten Mediendateien (4,79 GB) per Hardlink (0 Byte zusätzlicher Speicherplatzverbrauch, 0 Byte Altlasten).~/karatewiki-shared/LocalSettings.secrets.php(chmod 600, per Symlink in~/Karatewiki/LocalSettings.secrets.phpeingebunden).
- Neue MariaDB 11.8 Datenbank auf Strato:
- Host:
database-5021739551.webspace-host.com - Datenbank:
dbs16266664 - Benutzer:
dbu3366014 - Tabellen-Präfix:
Karate_
- Host:
- Altsystem (
~/Karate_Wiki_135+ alte MySQL 5.7 DBdbs1754262): Bleibt während der gesamten Testphase auf einer Testdomain zu 100 % unverändert als sofortiges Fallback bestehen, bis die Hauptdomainwww.gojukai-dojo.deim Strato-Kundenmenü auf/Karatewikiumgestellt wird.
7. Aktueller Arbeitsstand & Nächste Schritte (Roadmap)
✅ Bereits erledigt:
- Rein lesende Bestandsaufnahme des Strato-Produktivsystems (
Karate_Wiki_135) und der MySQL-Datenbank (dbs1754262). - Auswertung aller 1.028 Wiki-Seiten und Identifikation aller Video-Einbindungen (87×
<html5media>, ~71×[[Datei:*.mp4]]). - Auswertung des Medienbestands: Von 8,3 GB
images/auf Strato sind 566 Dateien (4,79 GB) tatsächlich auf Seiten eingebunden (Rest: 1,8 GBtemp/, 514 MBarchive/, 648 MB verwaiste Uploads). - Entwicklung der eigenen Extension
KarateMedia(extensions-custom/KarateMedia/) als Ersatz fürHtml5mediatorundEmbedVideo(inkl. Zeitlupe0.5x/0.25xundLoop). - Gestaltung der modernen Goju-Kai Dojo Heilbronn e.V. Vereins-Anmeldeseite (
Spezial:Anmelden) inkl. Direkt-Redirect für geschützte Seiten, offiziellem Vektor-Logo (logo.svg/logo-light.svg) vonkarate.hnund Shop-Link. - Bereinigung und Modernisierung der
LocalSettings.php(config/LocalSettings.php) inkl.MsUpload-Integration (Multi-File Drag & Drop bis 500 MB) und Performance-Caching. - Aufbau der Docker-Konfiguration und Upgrade auf MediaWiki 1.46.2 + MariaDB 11.8 (
Dockerfile,docker-compose.yml,docker-compose.dev-env.yml). - Gemeinsames Medien-Volume (
karatewiki-dev_dev-karatewiki-images) auf dem Raspberry Pi 5 (http://192.168.2.49:3093) eingerichtet und erfolgreich getestet. - Aufbau der neuen Strato-Parallelinstallation unter
~/Karatewikimit zentralem Medienordner~/karatewiki-shared/images(4,79 GB bereinigt) und neuer MariaDB 11.8 (dbs16266664aufdatabase-5021739551.webspace-host.com).
🔜 Nächste Schritte:
- 1. Testdomain bei Strato auf
/Karatewikizeigen lassen: Im Strato-Kundenmenü eine Testdomain/Subdomain auf das Verzeichnis/Karatewikirichten und Login, Videos undMsUploadlive auf Strato prüfen. - 2. Domain-Umschaltung (
www.gojukai-dojo.de): Nach erfolgreichem Test die Hauptdomainwww.gojukai-dojo.deim Strato-Kundenmenü von/Karate_Wiki_135auf/Karatewikiumstellen. - 3. Altlasten-Bereinigung nach Bewährungsphase: Sobald
/Karatewikiim Live-Betrieb stabil läuft, kann das alte Verzeichnis~/Karate_Wiki_135(inkl. 3,5 GB Dateimüll) und die alte MySQL 5.7 Datenbankdbs1754262gelöscht werden (die 566 Hardlinks in~/karatewiki-shared/imagesbleiben dabei vollständig erhalten!).