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

17 lines
2.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Karatewiki (Goju-Kai Dojo) – Agenten-Leitfaden
Dieses Repository verwaltet die MediaWiki-Konfiguration ([`config/LocalSettings.php`](config/LocalSettings.php)), das Docker-Setup (MediaWiki 1.46 + 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).