Files
karatewiki/AGENTS.md
T
2026-10-24 21:02:32 +02:00

2.0 KiB
Raw Blame History

Karatewiki (Goju-Kai Dojo) – Agenten-Leitfaden

Dieses Repository verwaltet die MediaWiki-Konfiguration (config/LocalSettings.php), das Docker-Setup (MediaWiki 1.46 + MariaDB 11.8) und unsere eigenen Erweiterungen (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: 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: 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).