homelab/docs/ARCHITECTURE_RULES.md

KalliLab CORE – Architecture Rules

Grundprinzipien

• Das Git-Repository ist die zentrale Quelle für alle Konfigurationen
• Änderungen werden zuerst im Repo vorgenommen und danach deployed
• Jeder Service hat einen eigenen Stack

Netzwerk

• Öffentlich erreichbare Services laufen im frontend_net
• Interne Services laufen im backend_net
• Keine unnötigen Portfreigaben auf dem Host

Ports

• 80/443 sind ausschließlich für Traefik reserviert
• Jeder Service bekommt einen eigenen, festen Port
• Keine Doppelbelegung von Ports

Struktur

• Jeder Service hat einen eigenen Ordner unter /stacks
• Compose-Dateien liegen immer im jeweiligen Service-Ordner
• Keine gemischten oder globalen Compose-Files

Sicherheit

• Secrets gehören nicht ins Repository
• Zugangsdaten werden über .env oder externe Files geregelt

Ziel

Ein stabiles, nachvollziehbares und skalierbares Homelab-System