Umfassende Projektdokumentation (Analyse, Entscheidungen, Einstellungen & Status) fuer Rechnerwechsel
Deploy Development / deploy (push) Failing after 0s

This commit is contained in:
Lars committed 2026-10-24 18:14:09 +02:00
1 parent 5f212e7338
commit f4e6417be7
8 files changed
+203 -33

No files matched your search

+19 -26
View File
@@ -3,26 +3,38 @@
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):**
> * **[`docs/ARCHITECTURE_AND_STATUS.md`](docs/ARCHITECTURE_AND_STATUS.md)** – Ist-Analyse (Strato), Architektur-Entscheidungen, alle Einstellungen & aktueller Arbeitsstand / Roadmap
> * **[`docs/DEPLOYMENT.md`](docs/DEPLOYMENT.md)** – Gitea Runner CI/CD auf dem Raspberry Pi 5 (`192.168.2.49`), Ports (`3093` Dev / `3008` Prod) & Datenbank-Sync
> * **[`AGENTS.md`](AGENTS.md)** – Einstiegspunkt und Sicherheitsregeln für Coding Agents
---
## 📁 Verzeichnisstruktur
```text
C:\dev\Karatewiki\
├── .env.example # Vorlage für Datenbank-Zugangsdaten & Keys (nach .env kopieren)
├── .gitignore # Schützt Passwörter (.env), DB-Dumps & Videos vor Git-Upload
├── Dockerfile # Baut MediaWiki 1.43 LTS (PHP 8.3/8.4) + KarateMedia Extension
├── docker-compose.yml # Startet MediaWiki + MariaDB 10.11
├── .gitea/workflows/ # Automatische Deployments auf den Raspberry Pi 5 (develop & main)
├── assets/
│ └── logo_goju-kai_Bleistift.png # Vereinslogo
├── config/
│ ├── LocalSettings.php # Bereinigte Wiki-Konfiguration (für Docker UND Strato nutzbar)
│ └── php-uploads.ini # Erhöht Upload-Limit auf 500 MB für Karate-Videos
├── docs/
│ ├── ARCHITECTURE_AND_STATUS.md # Umfassende Analyse-, Entscheidungs- & Status-Dokumentation
│ └── DEPLOYMENT.md # Deployment-Architektur & Port-Übersicht auf dem Pi 5
├── extensions-custom/
│ └── KarateMedia/ # Eigene HTML5-Video-Extension (inkl. Zeitlupe 0.5x/0.25x & Loop)
└── scripts/
├── sync-from-strato.ps1 # Holt DB-Dump (rein lesend) unter Windows
└── sync-from-strato.sh # Holt DB-Dump & Videos (per rsync) unter Linux
├── scripts/
│ ├── ensure-db-schema.php # Initialisiert DB-Schema bei leeren Erst-Installationen
│ ├── sync-from-strato.ps1 # Holt DB-Dump (rein lesend) unter Windows
│ └── sync-from-strato.sh # Holt DB-Dump & Videos (per rsync) unter Linux
├── .env.example # Vorlage für Datenbank-Zugangsdaten & Keys
├── .gitignore # Schützt Passwörter (.env), DB-Dumps & Videos vor Git-Upload
├── AGENTS.md # Leitfaden für Coding Agents beim Rechnerwechsel
├── Dockerfile # Baut MediaWiki 1.43 LTS (PHP 8.3/8.4) + KarateMedia Extension
├── 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.
---
## 🚀 Schnellstart (Docker-Umgebung / Failover-Server)
1. **`.env` anlegen:**
Kopiere `.env.example` nach `.env` und trage die gewünschten Passwörter ein.
2. **Datenbank-Dump von Strato holen (rein lesend):**
* Windows: `.\scripts\sync-from-strato.ps1`
* Linux: `./scripts/sync-from-strato.sh`
3. **Container starten:**
```bash
docker compose up -d --build
```
4. **Datenbank-Schema auf die neue MediaWiki-Version aktualisieren (im Container):**
```bash
docker compose exec mediawiki php maintenance/run.php update --quick
```
Danach ist das Wiki unter `http://localhost:8080` erreichbar!