Architektur
Architektur
Kuglers OS ist als modulare Next.js-Anwendung aufgebaut. Die Architektur trennt UI, Anwendungslogik, Domainmodule, Persistenz und Integrationen. Dadurch kann jedes Modul wachsen, ohne dass die Anwendung zu einer Sammlung loser Skripte wird.
Schichten
| Schicht | Aufgabe |
|---|---|
| Presentation | Seiten, Layouts und Komponenten für Dashboard, Projekte, Domains, Runtime und Backups. |
| Application | Server Actions und API-Routen für gezielte Operationen. |
| Domain | Fachmodule für Systemstatus, Projekte, Domains, Runtime-Inventar und Backups. |
| Data | Prisma-Modell als persistente Quelle für strukturierte Betriebsdaten. |
| Integration | Kontrollierte Anbindung an lokale Runtime-, Prozess- und Backup-Quellen. |
| Operations | Healthcheck, Security Header, Deployment und Monitoring. |
Datenfluss
Runtime-Daten werden nicht als Wahrheit erfunden, sondern aus produktiven Quellen gelesen und als Snapshot normalisiert. Kuglers OS speichert daraus die für Entscheidungen relevanten Felder: Status, Name, Image, Ports, Labels, Netzwerke, Restart-Policy und letzte Sichtung.
Der typische Ablauf:
- Ein Modul liest einen externen Zustand.
- Sensible oder irrelevante Rohdaten werden gefiltert.
- Die normalisierte Sicht wird in der Datenbank aktualisiert.
- UI und Suche greifen auf diese strukturierte Sicht zu.
- Healthchecks melden, ob die benötigten Integrationen erreichbar sind.
Grenzen
Kuglers OS ist kein generisches Admin-Panel für beliebige Server. Die Anwendung ist auf meine Produkt- und Betriebsobjekte zugeschnitten. Standardwerkzeuge bleiben dort stark, wo sie spezialisiert sind. Kuglers OS sammelt die für meine Plattform relevanten Signale und führt sie in einem eigenen Modell zusammen.
Nicht-Ziele:
- kein Ersatz für offizielle Tool-Dokumentationen
- kein vollständiges ERP
- kein Multi-Tenant-SaaS
- keine eigene Kryptografie für Authentifizierung
- keine unnötige Microservice-Zerlegung
Zuletzt aktualisiert: 31. Mai 2026