Architecture

FileFlux folgt dem Clean-Architecture-Ansatz: klare Schichtentrennung, Dependency Inversion und ein domänengetriebenes Design. Dieser Abschnitt beschreibt das Zusammenspiel aller Komponenten.

• System Overview — Gesamtarchitektur und Kommunikationsmuster
• Backend — Go Clean Architecture, Services und Repositories
• Frontend — Lit Web Components und Design System
• Agent — Standalone Go-Binary mit WebSocket-Verbindung
• :material-websocket: WebSocket Protocol — Binary-Protokoll und Nachrichtentypen
• Database — PostgreSQL-Schema und ERD

Schichtenmodell

graph TB
    A[Frontend - Lit/TS] -->|REST API| B[Backend - Go]
    C[Agent - Go] -->|WebSocket| B
    B --> D[(PostgreSQL)]
    B -->|File Storage| E[Filesystem]