scripts/auto-deploy.sh lebte bisher nur auf dem dev-Server unter
/opt/gwoe-antragspruefer-dev/scripts/. Ohne Repo-Tracking war eine
Aenderung des Skripts nicht versionierbar und ein Disaster-Recovery
muehsam (manuelles Wiederherstellen aus Restic).
.gitignore-Ergaenzungen:
- backups/ — neu eingefuehrt mit dem 2.0-Cut + dem backup-db.sh-Fix,
der jetzt projekt-relativ schreibt. Das Verzeichnis ist Daten-Volume,
gehoert nicht ins Repo.
- ._* — macOS-AppleDouble-Resource-Forks; tauchen auf wenn das
Repo-Verzeichnis ueber AFP/SMB/Nextcloud-Sync gegangen ist.
mkdocs Material-Theme konfiguriert (mkdocs.yml). Build-Output wird in
den gh-pages-Branch gepusht, von dort served caddy-gitea-pages den
statischen Content als separater Container unter docs.gwoe.toppyr.de.
Neuer docker-compose-Service gwoe-docs:
- Image: ghcr.io/d7z-project/caddy-gitea-pages:nightly
- Liest automatisch aus dem gh-pages-Branch via Gitea-API
- Traefik-Labels für docs.gwoe.toppyr.de (SSL via Let's Encrypt)
- Token via GITEA_TOKEN in .env (bereits auf dem Server hinterlegt)
Wildcard-DNS *.toppyr.de zeigt bereits auf den VServer — kein
DNS-Eingriff nötig, Traefik + Let's Encrypt erledigen den Rest.
Doku-Update-Workflow:
1. ADR oder docs/ editieren
2. `mkdocs build` lokal
3. `git checkout gh-pages && cp -r site/* . && git add -A && git commit && git push`
4. caddy-gitea-pages refreshed automatisch
.gitignore: site/ ausgeschlossen (Build-Artefakt).
Refs: #62 (Phase 2)
