# Vogelalbum zu Hause: Sammlung und Erkennung auf einer Maschine.
#
#   cp .env.beispiel .env     # VOGELALBUM_SOURCE eintragen
#   docker compose -f docker-compose.heim.yml up -d
#
# Danach laeuft die Sammlung auf http://localhost:8000 und der Detector
# schaut in die Kamera. Kein venv, keine Modelle von Hand, kein systemd.
#
# Warum eine eigene Datei und nicht ein Profil in docker-compose.yml? Die
# andere Datei beschreibt das oeffentliche Hosting der Web-App allein (dort
# gibt es keine Kamera im Netz). Beide Faelle brauchen andere Vorgaben —
# in einer Datei mit Schaltern waeren beide schwerer zu lesen.

name: vogelalbum

services:
  web:
    build:
      context: .
      dockerfile: Dockerfile
    restart: unless-stopped
    environment:
      DJANGO_DEBUG: "0"
      # Ohne gesetzten Schluessel erzeugt der Entrypoint beim ersten Start
      # einen und legt ihn aufs Volume. Wer einen eigenen will, traegt ihn
      # in die .env ein.
      DJANGO_SECRET_KEY: ${DJANGO_SECRET_KEY:-}
      DJANGO_ALLOWED_HOSTS: ${DJANGO_ALLOWED_HOSTS:-*}
      DJANGO_CSRF_TRUSTED_ORIGINS: ${DJANGO_CSRF_TRUSTED_ORIGINS:-}
      # Derselbe Token, den der Detector als Bearer schickt. Fuer eine
      # einzelne Kamera reicht das — 'manage.py camera add' braucht man erst
      # ab der zweiten.
      VOGELALBUM_INGEST_TOKEN: ${VOGELALBUM_INGEST_TOKEN:?bitte in der .env setzen}
      # Beides MUSS aufs Volume zeigen, sonst sind Sammlung und Fotos nach
      # jedem Neubau weg.
      SQLITE_DIR: /data
      MEDIA_ROOT: /data/media
    volumes:
      - vogelalbum-data:/data
    ports:
      - "${VOGELALBUM_PORT:-8000}:8000"

  detector:
    build:
      context: .
      dockerfile: Dockerfile.detector
    restart: unless-stopped
    depends_on:
      - web
    environment:
      VOGELALBUM_SOURCE: ${VOGELALBUM_SOURCE:?Stream-URL der Kamera, siehe .env.beispiel}
      # Im selben Compose-Netz erreichbar — nichts davon muss nach aussen offen sein.
      VOGELALBUM_API: http://web:8000
      VOGELALBUM_TOKEN: ${VOGELALBUM_INGEST_TOKEN:?bitte in der .env setzen}
      # 'detector' ignoriert Bewegung und laesst das Modell entscheiden.
      # Noetig, sobald die Kamera auf etwas dauerhaft Bewegtes schaut — eine
      # Hecke im Wind loest sonst rund um die Uhr aus. Mit ruhigem Hintergrund
      # spart 'motion' Rechenzeit.
      VOGELALBUM_GATE: ${VOGELALBUM_GATE:-detector}
      VOGELALBUM_SAVE_TO: /daten/rohdaten
      VOGELALBUM_PROTOKOLL: /daten/protokoll.csv
      # Kamera mit Infrarot? Dann hier "1" setzen, sonst pausiert die Analyse
      # nachts von selbst.
      VOGELALBUM_NACHTSICHT: ${VOGELALBUM_NACHTSICHT:-}
      # Live-Bild: der Detector verteilt seinen eigenen Bildstrom weiter,
      # damit Zuschauer der Kamera nichts wegnehmen. Leer = aus.
      VOGELALBUM_LIVE_PORT: ${VOGELALBUM_LIVE_PORT:-0}
    command:
      - watch
      - --classify-every=2
      - --cooldown=5
      - --min-bird-frames=1
      - --verbose
    # 🔴 Hier stand bis zum 09.10.2026 "${VOGELALBUM_LIVE_PORT:-0}:..." — und damit
    # war der Schnellstart aus dem README fuer jeden kaputt, der die .env so
    # liess wie sie ist: Compose weist "0:0" mit "missing a target port" ab,
    # noch bevor irgendetwas gebaut wird.
    #
    # Aufgefallen ist es nie, weil jeder, der das je gestartet hat, den Port
    # gesetzt hatte. Der Standardweg war der einzige ungetestete.
    #
    # Deshalb jetzt eine gueltige Portnummer als Vorgabe. Ob tatsaechlich
    # etwas lauscht, entscheidet VOGELALBUM_LIVE_PORT in der Umgebung oben: auf 0
    # startet der Detector keinen Live-Server, dann fuehrt diese
    # Veroeffentlichung ins Leere — das stoert nicht. Wer den Port aendert,
    # aendert beide Seiten mit derselben Variablen.
    ports:
      - "${VOGELALBUM_LIVE_PORT:-8131}:${VOGELALBUM_LIVE_PORT:-8131}"
    volumes:
      - vogelalbum-rohdaten:/daten

volumes:
  # Diese Namen sind neu und duerfen es sein: Wer mit dieser Datei anfaengt,
  # hat noch keine Daten.
  #
  # ⚠️ Wer den Namen an einer LAUFENDEN Anlage aendert, muss die Daten
  # mitnehmen — siehe die Anleitung in docker-compose.yml. Ein Volume-Name
  # ist kein Text, sondern eine Adresse.
  vogelalbum-data:
  vogelalbum-rohdaten: