Plattform-Admin-Bereich¶

Der Plattform-Admin-Bereich ist ausschließlich für Nutzer mit der Plattform-Rolle admin zugänglich. Er ermöglicht die plattformweite Verwaltung aller Mandanten und Nutzer — unabhängig von der mandantengebundenen Tenant-Admin-Rolle.

Voraussetzungen¶

• Plattform-Rolle admin (unterscheidet sich von der Tenant-Admin-Rolle)
• Zugang über /admin/platform (im Full-Modus)

Abgrenzung: Plattform-Admin vs. Tenant-Admin¶

Mandantenverwaltung¶

Im Bereich Admin > Mandanten kannst du:

• Alle Mandanten der Plattform einsehen (Name, Slug, Mitgliederzahl, Erstellungsdatum)
• Einzelne Mandanten deaktivieren oder löschen
• Mandanten-Kontingente und Limits einsehen
• Mitglieder eines Mandanten stellvertretend verwalten

Nutzerverwaltung¶

Im Bereich Admin > Nutzer kannst du:

• Alle Nutzerkonten der Plattform einsehen
• Nutzerkonten sperren oder deaktivieren
• Plattform-Rollen zuweisen (admin, viewer)
• Passwort-Reset für Nutzer auslösen
• DSGVO-Anfragen (Datenlöschung, Datenauskunft) bearbeiten

Statistiken¶

Der Bereich Admin > Statistiken bietet eine Übersicht über:

• Anzahl aktiver Mandanten und Nutzer
• Aktive Pflanzdurchläufe plattformweit
• Celery-Task-Queue-Status
• Speicherverbrauch (ArangoDB, TimescaleDB, Redis)

OIDC-Provider¶

Unter Admin > OIDC-Provider konfigurierst du föderierte Authentifizierungs-Provider (z.B. Google, GitHub, firmeneigene OIDC-Instanzen). Diese Einstellungen gelten plattformweit für alle Mandanten.

Mehr dazu: Authentifizierung.

Pflanzenerkennung per Foto aktivieren¶

Die Foto-Identifikation ist ein optionales Feature, das API-Zugangsdaten eines Drittanbieters erfordert. Solange kein Key konfiguriert ist, meldet das Backend available: false und die gesamte Kamera-/Upload-UI bleibt für alle Nutzer ausgeblendet.

Der Pl@ntNet-API-Key ist eine instanzweite Einstellung — ein einziger Key gilt für alle Nutzer der Instanz. Der Free-Tier erlaubt 500 Identifikationen pro Tag für die gesamte Instanz.

Schritt 1: Kostenlosen Pl@ntNet-Key besorgen¶

1. Öffne my.plantnet.org in einem Browser
2. Erstelle ein Konto oder melde dich an
3. Navigiere zu Account > API key
4. Kopiere den angezeigten API-Key

Schritt 2: Key über die Admin-UI eintragen (empfohlen)¶

Dies ist der bevorzugte Weg — kein Pod-Neustart, keine Datei-Änderung, wirkt sofort.

1. Melde dich als Plattform-Admin an
2. Öffne Konto-Einstellungen (oben rechts auf dein Profilbild klicken)
3. Wähle den Tab Integrationen
4. Scrolle zum Abschnitt Pflanzenerkennung
5. Gib den kopierten API-Key in das Feld Pl@ntNet API-Key ein
6. Klicke auf Speichern

Der Key wird maskiert gespeichert (nie im Klartext in Antworten oder Logs sichtbar). Das Feld zeigt an, ob der Key aus der Datenbank (UI-Eintrag), aus einer Umgebungsvariable oder gar nicht gesetzt ist.

Optional: Key sofort prüfen

Nach dem Speichern kannst du auf Verbindung prüfen klicken. Das Backend sendet eine Testanfrage an Pl@ntNet und meldet, ob der Key gültig ist und wie viele Anfragen heute noch verfügbar sind.

Optional: Key entfernen

Klicke auf Entfernen, um den in der Datenbank gespeicherten Key zu löschen. Ist keine Umgebungsvariable gesetzt, wird die Foto-Identifikation damit deaktiviert.

Alternative: Key als Umgebungsvariable setzen¶

Die Umgebungsvariable PLANTNET_API_KEY bleibt weiterhin gültig — sie eignet sich für automatisierte Deployments, GitOps-Workflows oder wenn kein UI-Zugang genutzt werden soll.

kubectl create secret generic kamerplanter-secrets \
  --from-literal=PLANTNET_API_KEY="dein-api-key" \
  --namespace kamerplanter

# helm/kamerplanter/values.yaml (Auszug)
backend:
  envFrom:
    - secretRef:
        name: kamerplanter-secrets

# helm/kamerplanter/values.yaml (lokal, nicht committen)
backend:
  env:
    PLANTNET_API_KEY: "dein-api-key"

# .env (nicht committen)
PLANTNET_API_KEY=dein-api-key

docker compose up -d

Schritt 3: Aktivierung per API prüfen¶

Rufe den Status-Endpunkt auf:

curl -s http://localhost:8000/api/v1/recognition/status | python3 -m json.tool

Erwartete Antwort, wenn der Key korrekt gesetzt ist:

{
  "available": true,
  "adapter": "plantnet",
  "daily_limit": 500,
  "remaining_today": 498
}

Nach erfolgreicher Konfiguration erscheinen in der UI automatisch die Kamera-/Upload-Funktion und die Schaltfläche Per Foto hinzufügen in der Artenübersicht. Nutzer sehen beim ersten Aufruf den Einwilligungs-Dialog — die Funktion ist ab diesem Moment vollständig nutzbar.

Optionale Feineinstellung¶

Die folgenden Variablen müssen in der Regel nicht geändert werden. Sie sind mit sinnvollen Standardwerten vorbelegt. Eine vollständige Beschreibung findet sich in der Umgebungsvariablen-Referenz:

Datenschutz-Hinweis¶

Fotos werden nicht auf dem Kamerplanter-Server gespeichert — sie werden ausschließlich zur Analyse an Pl@ntNet (CIRAD/INRIA, Frankreich/EU) übertragen und danach verworfen. EXIF-Metadaten (GPS, Kameramodell) werden vor der Übertragung entfernt. Jeder Nutzer muss einmalig der Bildübertragung zustimmen. Weitere Details: Datenschutz (DSGVO) — Foto-Identifikation.

Schädlingserkennung aktivieren¶

Die Schädlingserkennung ist standardmäßig deaktiviert (PEST_DETECTION_ENABLED=false). Solange kein Adapter konfiguriert ist, meldet das Backend adapter: null und der Button „Auf Schädlinge prüfen" bleibt für alle Nutzer ausgeblendet.

Adapter 1: Lokaler Schadbild-Adapter (Self-Hosted, empfohlen)¶

Der lokale Adapter erkennt Schadbilder und Symptome (Gespinste, Honigtau, Saugschäden) direkt auf der Instanz — kein Drittanbieter, kein Datenschutz-Consent für Nutzer erforderlich.

Aktivieren via Umgebungsvariable:

PEST_DETECTION_ENABLED=true
PEST_DETECTION_SYMPTOM_ENABLED=true
PEST_DETECTION_PRIMARY_ADAPTER=local_pest_symptom

kubectl create secret generic kamerplanter-secrets \
  --from-literal=PEST_DETECTION_ENABLED="true" \
  --from-literal=PEST_DETECTION_SYMPTOM_ENABLED="true" \
  --from-literal=PEST_DETECTION_PRIMARY_ADAPTER="local_pest_symptom" \
  --namespace kamerplanter

# helm/kamerplanter/values.yaml (Auszug)
backend:
  envFrom:
    - secretRef:
        name: kamerplanter-secrets

# .env (nicht committen)
PEST_DETECTION_ENABLED=true
PEST_DETECTION_SYMPTOM_ENABLED=true
PEST_DETECTION_PRIMARY_ADAPTER=local_pest_symptom

docker compose up -d

# helm/kamerplanter/values.yaml (lokal, nicht committen)
backend:
  env:
    PEST_DETECTION_ENABLED: "true"
    PEST_DETECTION_SYMPTOM_ENABLED: "true"
    PEST_DETECTION_PRIMARY_ADAPTER: "local_pest_symptom"

Adapter 2: Cloud-Erkennung (Kindwise — optional, einwilligungspflichtig)¶

Der Kindwise-Cloud-Adapter sendet Fotos zur Analyse an den Kindwise-Dienst (Brno, Tschechien — EU). Er ist standardmäßig deaktiviert und erfordert eine explizite Nutzereinwilligung (Consent-Zweck pest_detection_cloud).

Aktivieren via Umgebungsvariablen:

PEST_DETECTION_ENABLED=true
PEST_DETECTION_CLOUD_ENABLED=true
PEST_DETECTION_CLOUD_API_KEY=dein-kindwise-api-key
PEST_DETECTION_PRIMARY_ADAPTER=local_pest_symptom   # lokal bleibt Default; Cloud als Fallback oder primär wählbar

Die Schaltfläche erscheint nach dem nächsten Backend-Neustart automatisch in der UI. Nutzer, die den Cloud-Adapter nutzen möchten, werden beim ersten Aufruf zur Einwilligung aufgefordert.

Status prüfen¶

Rufe den Status-Endpunkt auf (tenant-scoped, JWT erforderlich):

curl -H "Authorization: Bearer <JWT>" \
  http://localhost:8000/api/v1/t/{tenant_slug}/pests/status | python3 -m json.tool

Erwartete Antwort, wenn ein Adapter aktiv ist:

{
  "adapter": "local_pest_symptom",
  "pest_detection_enabled": true,
  "symptom_enabled": true,
  "detector_enabled": false,
  "cloud_enabled": false
}

Ist pest_detection_enabled: false oder adapter: null, bleibt der Button in der UI ausgeblendet.

Optionale Feineinstellungen¶

Die folgenden Variablen müssen in der Regel nicht geändert werden. Eine vollständige Beschreibung findet sich in der Umgebungsvariablen-Referenz:

Datenschutz-Hinweis¶

• Lokaler Adapter: Fotos verlassen die Instanz nicht; kein Consent erforderlich; EXIF wird vor jeder Verarbeitung entfernt.
• Cloud-Adapter: Fotos gehen an Kindwise (EU); Nutzer müssen einmalig für den Zweck pest_detection_cloud einwilligen; AVV vertraglich erforderlich; EXIF zweifach gestrippt (Frontend + Backend).
• Fotos werden nie dauerhaft gespeichert — nur Erkennungsergebnis und anonymer Bild-Hash bleiben.

Weitere Details: Datenschutz (DSGVO).

Referenzbilder für die Bilderkennung kuratieren¶

Die Self-Hosted-Bilderkennung (DINOv2) vergleicht Nutzer-Fotos mit einem gespeicherten Referenz-Index. Enthält dieser Index unscharfe, falsch bestimmte oder anderweitig ungeeignete Bilder, verschlechtert sich die Erkennungsgenauigkeit für die betroffene Art.

Als Platform-Admin kannst du einzelne Referenzbilder nach einem Sichttest abwählen — sie werden dann aus der Erkennung ausgeschlossen, bleiben aber im System erhalten (Soft-Delete, reaktivierbar). Die vollständige Anleitung einschließlich Coverage-Schwellenwert (< 5 aktive Bilder), API-Endpunkten und FAQ findest du auf der Seite:

Referenzbilder kuratieren

Nutzer-Schädlingsbilder freigeben (Moderation)¶

Nutzer können in der Schädlings-Detailseite eigene Fotos zu einem Schädling beitragen. Diese Bilder sind zunächst privat (nur für den jeweiligen Garten/Mandanten sichtbar). Als Platform-Admin kannst du besonders gute Aufnahmen global freigeben.

Die Moderation findest du im Admin-Bereich in der Karte „Beigesteuerte Schädlingsbilder":

1. Wähle den betreffenden Schädling aus.
2. Du siehst alle beigesteuerten Bilder aller Mandanten mit Vorschau, Herkunft (Nutzer/Mandant/Datum) und Status (privat/global).
3. Mit Freigeben wird ein Bild auf global gesetzt — es ist dann für alle Nutzer in der Galerie sichtbar (über einen globalen, schreibgeschützten Auslieferungspfad, der ausschließlich freigegebene Bilder bereitstellt). Zurücknehmen macht die Freigabe rückgängig (mit Bestätigung).

Häufige Fragen¶

Siehe auch¶

• Mandanten & Gärten — Mandantenverwaltung als Tenant-Admin (REQ-024)
• Datenschutz (DSGVO) — Betroffenenrechte und DSGVO-Compliance
• Authentifizierung — JWT, OAuth2/OIDC, Service Accounts
• Pflanze per Foto identifizieren — Endnutzer-Anleitung
• Umgebungsvariablen — Vollständige Variablen-Referenz