Files
2026-10-24 18:14:09 +02:00

17 lines
1.8 KiB
Markdown
Raw Permalink 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.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`).
## 📚 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. **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` (`git merge --no-ff develop`) startet das Production-/Standby-Deployment (`/home/lars/docker/karatewiki`, Port `3008`).