Simplify Athena stack and recovery

This commit is contained in:
Mikei386
2026-08-25 22:27:26 +02:00
parent c4851305d1
commit 069da8b4f0
70 changed files with 887 additions and 5806 deletions
+11 -14
View File
@@ -9,7 +9,7 @@ Fehlersuche sie benötigt.
- Host: Debian, ohne lokalen Notfallzugriff oder KVM.
- Arbeitsbaum und laufender Stack: `/opt/mike-ai/stack`.
- Persistente Daten, Modelle und Recovery: `/data`.
- Persistente Daten, Modelle und Backups: `/data`.
- Lokale Konfiguration und Secrets: `/etc/mike-ai` (niemals in Git).
- Benutzerzugriff auf KI-Dienste: über WireGuard, nicht über das Uni-LAN.
- OpenAI-kompatible Modell-API: Profile Router auf Port 8081.
@@ -23,7 +23,7 @@ Fehlersuche sie benötigt.
|---|---|
| `/opt/mike-ai/stack` | Einziger Git-Checkout und einzige Quelle für Deployments |
| `/data/models` | GGUF-Modelle, Projektoren und weitere große Modelldateien |
| `/data` | Persistente Anwendungsdaten und Recovery-Koffer |
| `/data` | Persistente Anwendungsdaten und Docker-Backups |
| `/etc/mike-ai` | Lokale Env-Dateien, API-Schlüssel und SSH-Schlüssel |
| `/tmp` | Einmalige Hilfsprogramme und temporäre Arbeitsdateien |
@@ -52,7 +52,7 @@ eingebunden werden; das richtet sich nach dem Auftrag.
4. Änderung über `athena_operator_change` ausführen.
5. Syntax, Compose, Dienstzustand und eine kleine Funktionsprobe prüfen.
6. Geänderte Dateien committen und pushen.
7. Recovery nur nach abgeschlossenen, funktionierenden Änderungen erneuern.
7. Ein manuelles Datenbackup nur nach speicherrelevanten Änderungen auslösen.
Nicht bei jedem Zwischenschritt die gesamte Plattform neu untersuchen. Keine
vollständigen Compose-, Installations- oder Dokumentationsdateien in den Chat
@@ -64,9 +64,10 @@ Werkzeugaufruf wird höchstens einmal wiederholt.
Für einen neuen MCP sind gewöhnlich nur diese Teile nötig:
1. Servercode und Dockerfile unter `platform/mcp/`.
2. Ein Service in `platform/mcp/compose.yaml`.
2. Ein Service im eingebundenen `platform/mcp/compose.yaml`.
3. Eine Env-Beispieldatei unter `config/`; echte Werte nach `/etc/mike-ai`.
4. Registrierung in Hermes und optional OpenWebUI.
4. Genau ein Eintrag in `config/mcp-registry.json`; daraus werden Hermes und
OpenWebUI automatisch erzeugt.
5. Ein kleiner Test sowie ein kurzer Eintrag in dieser Datei oder in der
Komponentenübersicht, falls wirklich zusätzliche Erklärung nötig ist.
@@ -104,17 +105,13 @@ Eine Änderung ist erst fertig, wenn:
- der betroffene Dienst den neuen Stand verwendet,
- ein fokussierter Test erfolgreich war,
- Git-Status und Commit bekannt sind,
- bei einer wesentlichen Änderung der Recovery-Koffer aktualisiert wurde.
- das automatische Backup läuft und bei Datenänderungen ein Archiv geprüft wurde.
Bei Unsicherheit wird der konkrete offene Punkt genannt. Es werden keine
Ergebnisse, Werkzeugaufrufe oder erfolgreichen Deployments erfunden.
## Detailreferenzen
- Installation und Wiederherstellung: `docs/INSTALLATION.md`,
`docs/DISASTER_RECOVERY.md`
- Aktuelle Modellprofile: `docs/STANDARD_PROFILE_MATRIX.md`
- Netzwerk und externer Standort: `docs/WIREGUARD_HOME_PEER.md`,
`docs/VPN_SERVICE_PORTS.md`
- Historische Entscheidungen und Benchmarks: übrige Dateien unter `docs/`
## Referenzen
- Installation und Überblick: `README.md`
- Wiederherstellung: `docs/RECOVERY.md`
- Modellprofile: `docs/STANDARD_PROFILE_MATRIX.md`