System-Architektur

Überblick

Internet
    │
    ▼
┌─────────────────────────────────────┐
│         Caddy (TLS + Proxy)         │  stoat-caddy-1
│  chat.dreylo.com / dreylo.com       │
└──────────────┬──────────────────────┘
               │
    ┌──────────┼──────────┐
    ▼          ▼          ▼
┌────────┐ ┌──────┐ ┌──────────────────┐
│  Web   │ │ API  │ │  Profile API     │
│ (SolidJS│ │(Rust)│ │  (Express/Node)  │
│  :80   │ │:14702│ │  :3010           │
└────────┘ └──┬───┘ └───────┬──────────┘
              │              │
    ┌─────────┴─────────┐    │
    ▼         ▼         ▼    ▼
┌───────┐ ┌──────┐ ┌───────────────┐
│MongoDB│ │Redis │ │  MongoDB      │
│:27017 │ │:6379 │ │  dreylo-      │
│(Stoat)│ │      │ │  profiles DB  │
└───────┘ └──────┘ └───────────────┘

Container-Details

stoat-api-1 (Backend)

  • Sprache: Rust mit Rocket Framework
  • Image: ghcr.io/stoatchat/api:v0.11.1 (pre-built, nicht änderbar)
  • Funktion: REST API für alle Chat-Operationen (Messages, Users, Server, etc.)
  • Auth: Session Tokens (X-Session-Token Header)

stoat-web-1 (Frontend)

  • Sprache: TypeScript / SolidJS
  • Image: dreylo-web (lokal gebaut aus /home/dreylo-web/)
  • Build: pnpm monorepo, Vite bundle
  • Besonderheit: Fork des Stoat-Frontends mit Dreylo-Anpassungen

dreylo-profile-api (Custom Microservice)

  • Sprache: TypeScript / Express.js
  • Image: Lokal gebaut aus /home/revolt/dreylo-profile-api/
  • Funktion: Speichert Avatar-Ringe, Banner-Farben, Server-Folder
  • Auth: Delegiert an stoat-api-1 (/users/@me check)
  • DB: Eigene MongoDB Collection dreylo-profiles

stoat-database-1 (MongoDB)

  • Version: MongoDB (aktuell)
  • Daten: Alle Stoat-Daten + dreylo-profiles Collection
  • Zugriff intern: mongodb://database:27017

stoat-caddy-1 (Reverse Proxy)

  • Konfiguration: /home/revolt/Caddyfile
  • Funktion: TLS-Terminierung, Routing zu den Services
  • Automatisches TLS: Let's Encrypt / ZeroSSL

Netzwerk-Kommunikation

Alle Container sind im selben Docker-Netzwerk stoat_default und kommunizieren über ihre Service-Namen:

# Von dreylo-profile-api zu stoat-api:
http://api:14702/users/@me

Von Frontend zu Backend (über Caddy):

https://chat.dreylo.com/api/...

Profile API intern:

http://dreylo-profile-api:3010

Authentication Flow

User → Frontend → /auth/session/login → stoat-api-1
                                              │
                              Session Token ◄─┘

User → Frontend → /profile-api/api/profile/me
                        │
              X-Session-Token Header
                        │
              dreylo-profile-api
                        │
              GET http://api:14702/users/@me
              mit X-Session-Token
                        │
              User-ID ◄─┘
                        │
              MongoDB Write/Read