Architektur
Architektur
Kuglers OS ist als modulare Next.js-Anwendung aufgebaut. Die Architektur trennt Oberfläche, Anwendungslogik, Domainmodule, Persistenz und Integrationen. Dadurch bleibt das Control Panel erweiterbar, ohne zu einer Sammlung loser Skripte zu werden.
Schichten
| Schicht | Aufgabe |
|---|---|
| Oberfläche | Seiten, Layouts und Komponenten für Dashboard, Systemstatus, Projekte, Domains, Runtime und Backups. |
| Anwendung | Server Actions und API-Routen für gezielte Operationen. |
| Domain | Fachmodule für Systemstatus, Projekte, Domains, Runtime-Inventar und Backups. |
| Persistenz | Prisma-Modell als strukturierte Quelle für PostgreSQL. |
| Integration | Kontrollierte Anbindung an Runtime-, Prozess- und Backup-Quellen. |
| Betrieb | Healthcheck, Security Header, Deployment und Monitoring. |
Datenfluss
Runtime-Daten werden nicht erfunden, sondern aus produktiven Quellen gelesen und als Snapshot normalisiert. Kuglers OS speichert daraus nur 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 PostgreSQL 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 nur 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
- keine öffentliche Dokumentation interner Netzwerkdetails
Zuletzt aktualisiert: 1. Juni 2026