02 – Grundgerüst

Datum: 08.10.2026 · Version: 0.2.0 · Status: gebaut und lokal getestet, Proxmox-Test durch Philip steht aus

Was gebaut wurde

Warum so

• Ein Dockerfile, drei Ziele: Bot und Dashboard teilen sich Abhängigkeiten und Build-Cache, und das Update muss nur einen Build anstoßen.
• Migrationen als eigener Dienst: docker compose up startet Bot und Dashboard erst, wenn die Migration durchgelaufen ist. Beim Update laufen die Migrationen bewusst einzeln, damit ein Fehler klar zugeordnet und zurückgerollt werden kann.
• Schneller Rollback über Image-Tags: Vor jedem Update werden die laufenden Images als :previous markiert. Ein Rollback braucht deshalb keinen erneuten Build.
• Nur der Intent Guilds: Das Grundgerüst braucht nichts weiter. Privilegierte Intents kommen erst mit den Modulen dazu, die sie benötigen.
• Eigener Installer statt Community-Script-Engine: Deren build.func lädt Installationsskripte fest aus dem eigenen Repo und ändert sich häufig (siehe Recherche).
• Demo-Modus: Damit Screenshots und Klick-Tests ohne echten Discord-Login automatisch laufen. Im Demo-Modus erscheint ein deutliches gelbes Banner. Installer und setup-app.sh erzwingen DASHBOARD_DEMO=false.
• Design „Hafen bei Nacht“: Tinten-Blau, Koralle als Akzent (Julia), Türkis für „aktiv“. Eigene Schriften (Bricolage Grotesque, Manrope) statt Template-Optik.

Wie getestet

Auf dem Entwicklungsrechner gibt es kein Docker (Virtualisierung im BIOS aus). Deshalb so getestet:

Update – erfolgreicher Durchlauf (Simulation)

 Moin_Julia Update – aktuell v0.1.0 (66b6251)

 … Suche nach Updates (origin/main)
 ✓ Neuer Stand gefunden: 975206d
 … Sichere Datenbank
 ✓ Backup: /opt/moin-julia/backups/moin-julia-20261008-091616-v0.1.0-vor-update.dump
 … Hole neuen Stand
 ✓ Code aktualisiert auf v0.2.0 (975206d)
 … Baue Images neu (dauert ein paar Minuten, Log: /var/log/moin-julia/update-20261008-091615.log)
 ✓ Images gebaut
 … Führe Datenbank-Migrationen aus
 ✓ Migrationen angewendet
 … Starte Dienste neu
 ✓ Dienste gestartet
 … Warte auf Healthcheck (max. 240s)
 ✓ Alle Dienste gesund (bot dashboard)

 ✓ Update erfolgreich: v0.1.0 (66b6251)  →  v0.2.0 (975206d)

 Erreichbarkeit
   IP-Adresse ........ 192.168.178.50
   Dashboard-Port .... 3000
   Lokale URL ........ http://192.168.178.50:3000

Update – Healthcheck schlägt fehl → automatischer Rollback (Simulation)

 … Warte auf Healthcheck (max. 240s)
 ✗ bot: unhealthy
 ✗ dashboard: unhealthy
 ! Rolle zurück auf v0.1.0 (66b6251) …
 … Spiele Datenbank-Backup zurück
 ✓ Datenbank wiederhergestellt
 … Warte auf Healthcheck (max. 240s)
 ✓ Alle Dienste gesund (bot dashboard)
 ✓ Rollback erfolgreich – es läuft wieder v0.1.0
 ✗ Update fehlgeschlagen. Details: /var/log/moin-julia/update-20261008-091626.log

Screenshots

Start	Server-Auswahl
Einstellungen	Bauprotokoll

Mobil:

Bot-Antwort /ping (Vorschau)

Nachgebaute Vorschau mit Beispielwerten. Den echten Screenshot aus Discord ergänze ich nach dem Proxmox-Test.

Bitte nach dem Test als Screenshot schicken: deine /ping-Antwort in Discord. Darauf sollten zu sehen sein: der Titel „Pong! 🏓“, drei Felder (Gateway, Antwortzeit, Datenbank) und die Fußzeile „Moin_Julia · Version 0.2.0“.

Bekannte Grenzen

• Installer, Docker-Build und Bot live sind noch nicht auf echter Hardware gelaufen, das ist der nächste Schritt (Philip, Proxmox).
• Der VM-Weg braucht ein Proxmox-Storage mit „snippets“. Der Installer bietet an, das bei local freizuschalten.
• Mod-Rollen sehen das Dashboard nur lesend. Feinere Rechte pro Modul kommen bei Bedarf später.
• Die Dashboard-Oberfläche ist vorerst nur auf Deutsch, die Bot-Texte sind schon zweisprachig.
• Ein privates Repo würde im Installer Token-Unterstützung brauchen (aktuell nicht nötig, das Repo ist öffentlich).

Nachtrag v0.8.3 – Update hing in der Rollback-Schleife (Rückmeldung von Philip)

Was passiert ist: update brach mit „relation ConfigBackup already exists“ ab und rollte zurück. Dahinter stecken zwei Fehler:

1. Rollback ließ Reste liegen. pg_restore --clean löscht nur Tabellen, die im Backup vorkommen. Ein früher gescheitertes Update hatte die Tabelle ConfigBackup schon angelegt. Sie blieb nach dem Rollback stehen, während Prisma die Migration als „nicht angewendet“ führte. Ab da scheiterte jede Migration.
2. Der Healthcheck verlangte eine Discord-Verbindung. Kann sich der Bot nicht mit Discord verbinden (falscher Token, Netz), galt er als „ungesund“, und jedes Update wurde zurückgerollt. Diesen Fehler kann aber kein Update beheben.

Behoben:

• Der Rollback leert vor dem Zurückspielen das ganze Datenbank-Schema. Danach sieht die DB exakt wie das Backup aus.
• Migrationen ab den Rollen-Panels nutzen IF NOT EXISTS und laufen deshalb auch auf einer DB mit solchen Resten durch.
• Der Bot gilt als gesund, wenn sein Prozess läuft und die Datenbank antwortet. Den Discord-Zustand zeigt das Dashboard mit Grund an (seit v0.8.1).
• Das Docker-Image enthält jetzt OpenSSL, damit die Prisma-Warnung „failed to detect libssl“ bei den Migrationen verschwindet.