Einführung in KiroCloud

KiroCloud ist eine dedizierte Hosting-Plattform für Discord-Bots, Minecraft-Server und Community-Tools. Jede Bot-Instanz läuft in einer isolierten Prozess-Umgebung mit fest zugewiesenen CPU- und Arbeitsspeicher-Ressourcen.

Architektur und Zielsetzung

Die Plattform stellt Entwicklern und Administratoren Werkzeuge für Skalierbarkeit, Echtzeit-Monitoring und standardisierte API-Schnittstellen bereit:

• Entwickler-Fokus: Moderne Web-Architektur (Nuxt 4, Vue 3, Drizzle ORM) mit typisierten Endpunkten und direkter CLI-/API-Kontrolle.
• Transparenz und Metriken: Sekundengenaues Monitoring für RAM-, CPU- und Event-Dispatch-Auslastung.
• Sicherheits-Architektur: Token-Envelope-Verschlüsselung mit AES-256-GCM, HMAC-Integritätsprüfungen und granulare Rate-Limits.

Kernkomponenten

KiroCloud kombiniert Bot-Laufzeitumgebungen, Telemetrie und Server-Administration.

1. Dedizierte Ressourcen-Zuteilung

Jeder Bot läuft in seiner eigenen isolierten Umgebung. Ein fehlerhafter Code in einem anderen Bot kann deinen Bot niemals beeinträchtigen. Dies wird durch strikte Containerisierung und Ressourcen-Limits sichergestellt.

2. Modulares Plug & Play System

Aktiviere nur die Funktionen, die du für deinen Server benötigst:

• Willkommensnachrichten: Personalisiere den Eintritt neuer Mitglieder.
• Ticket-System: Professioneller Support direkt in Discord.
• Moderations-Tools: Automatisierte Filter für Spam und unangebrachte Inhalte.
• Level-System: Belohne Aktivität mit XP und Rollen.

3. Echtzeit-Monitoring & Telemetrie

Über WebSockets streamt das Backend kontinuierlich Performance-Metriken an das Frontend.

• CPU-Auslastung in Prozent
• Speichernutzung (RAM) in Megabyte
• Netzwerk-Latenz (Ping zur Discord API)
• Uptime-Tracking und automatische Neustarts bei Abstürzen

4. Tiefe Minecraft-Integration

KiroCloud schlägt eine Brücke zwischen Discord und Minecraft:

• Synchronisiere Ränge und Rollen zwischen Discord und dem Minecraft-Server.
• Sende Befehle via RCON direkt aus dem KiroCloud-Dashboard an den Server.
• Verwalte Whitelists, Bans und Spieler-Inventare zentralisiert.

Architektur-Übersicht

Das System ist als monolithische Applikation mit Microservice-Eigenschaften (via Nitro) konzipiert, was schnelle Ladezeiten und geringe Latenz bei API-Anfragen ermöglicht.

┌────────────────────────────────┐      ┌──────────────────────────────┐
│        Benutzer-Browser        │ <──> │        KiroCloud Web         │
│  (Vue 3, Nuxt UI, Tailwind)    │      │    (SSR, Nuxt 4, Vue Use)    │
└────────────────────────────────┘      └──────────────┬───────────────┘
                                                       │
                                        ┌──────────────┴───────────────┐
                                        │       Nitro Backend          │
                                        │ (API, WebSockets, Worker)    │
                                        └──────────────┬───────────────┘
                                                       │
                ┌───────────────────────┬──────────────┴───────┬──────────────────────┐
                │                       │                      │                      │
     ┌──────────┴──────────┐   ┌────────┴──────────┐   ┌───────┴──────────┐   ┌───────┴──────────┐
     │   PostgreSQL 16     │   │     Redis 7       │   │   Discord API    │   │ Minecraft RCON   │
     │   (Drizzle ORM)     │   │ (Caching, PubSub) │   │ (OAuth2, Bots)   │   │ (Live-Console)   │
     └─────────────────────┘   └───────────────────┘   └──────────────────┘   └──────────────────┘

Der Technologie-Stack

• Frontend: Nuxt 4, Vue 3 (Composition API), TailwindCSS, Nuxt UI, Lucide Icons.
• Backend: Nitro Server, H3, WebSockets, Zod für Validierung.
• Datenbank: PostgreSQL (gesteuert durch Drizzle ORM) für persistente Daten.
• Caching & State: Redis für Rate-Limiting, Session-Management und Echtzeit-Events.

Erste Schritte

Um mit KiroCloud zu starten, folge diesen einfachen Schritten:

1. Authentifizierung: Klicke auf der Startseite auf "Login" und melde dich sicher über Discord (OAuth2) an. Wir speichern keine Passwörter von Discord, sondern verifizieren dich über offizielle Tokens.
2. Profil einrichten: Ergänze (optional) eine E-Mail-Adresse und richte die Zwei-Faktor-Authentifizierung (2FA) ein, um deinen Account maximal zu schützen.
3. Bot erstellen / verknüpfen: Navigiere zum Dashboard und füge deinen Discord-Bot-Token ein. Unser System validiert den Token sofort und stellt eine sichere Verbindung her.
4. Module konfigurieren: Aktiviere die gewünschten Features (z.B. Minecraft-Sync oder Ticket-System) über die grafische Oberfläche. Kein Code erforderlich!

Nächster Schritt: Einen Bot hinzufügen – Erfahre, wie du deinen Discord-Bot erstellst und mit KiroCloud verknüpfst.