Zum Inhalt

Datenverwaltung

Anleitung zur Verwaltung von Anwendungsdaten, einschließlich Datenexport, Datenimport, Beispieldaten und der Django-Admin-Oberfläche.

Zielgruppe: Organisationsinhaber, Organisationsadministratoren, Superuser

Datenexport

Organisationsinhaber und -administratoren können eine vollständige Sicherung der Daten ihrer Organisation erstellen, indem sie diese in eine JSON-Datei exportieren.

Exportierte Daten

Ein Export umfasst alle Daten der ausgewählten Organisation:

Kategorie Enthaltene Daten
Bienenstöcke Bienenstock-Details, Fotos, Zuchtstock-Erweiterungen
Königinnen Königinnen-Datensätze, Abstammung (Mutterkönigin), Zuchtaufzeichnungs-Verknüpfungen
Durchsichten Alle Durchsichts-Datensätze
Arbeiten Fütterung, Behandlungen, Wartung, Völkervereinigungen, Königinnenwechsel
Ernten Ernteaufzeichnungen, Honigchargen, Eimer und Gläser
Zucht Königinnenzucht-Datensätze, Ableger
Lager Lagerartikel, Lagerorte, Transaktionen, Produktverkäufe
Konfiguration Organisationseinstellungen, konfigurierbare Auswahlmöglichkeiten pro Kategorie
Fotos Arbeitsfotos und Bienenstock-Fotos (optional, base64-kodiert)

Export erstellen

  1. Navigieren Sie zu Datenaustausch in der Seitenleiste
  2. Öffnen Sie die Exports-Liste
  3. Klicken Sie auf Export erstellen
  4. Wählen Sie, ob Mediendateien (Fotos) einbezogen werden sollen:
    • Aktiviert (Standard): Fotos werden als base64-kodierte Daten in die JSON-Datei eingebettet. Dies erhöht die Dateigröße erheblich.
    • Deaktiviert: Es werden nur Daten ohne Fotos exportiert. Dies erzeugt eine kleinere Datei.
  5. Klicken Sie auf Export erstellen
  6. Der Export wird verarbeitet und erscheint nach Abschluss in der Exportliste

Export herunterladen

  1. Gehen Sie zur Exports-Liste
  2. Suchen Sie den abgeschlossenen Export (Status: Abgeschlossen)
  3. Klicken Sie auf die Schaltfläche Herunterladen

Die heruntergeladene Datei heißt export_<Organisation>_<Zeitstempel>.json.

Exportdateiformat

Exporte verwenden das JSON-Format (Version 2.0.0) mit folgender Struktur:

  • export_version: Formatversion zur Kompatibilitätsprüfung
  • export_date: Zeitstempel der Exporterstellung
  • organization_id / organization_name: Quellorganisation
  • data: Alle exportierten Datensätze, nach Modellname organisiert
  • metadata: Datensatzanzahl, Liste der exportierten Modelle, SHA-256-Prüfsumme

Export löschen

  1. Gehen Sie zur Exports-Liste
  2. Klicken Sie auf die Schaltfläche Löschen neben dem Export, den Sie entfernen möchten
  3. Bestätigen Sie die Löschung

Das Löschen eines Exports entfernt sowohl den Datenbankeintrag als auch die zugehörige Datei vom Server. Alte Exporte werden automatisch bereinigt, wenn mehr als 10 abgeschlossene Exporte für eine Organisation vorhanden sind.

Note

Nur Inhaber und Administratoren können Exporte erstellen, herunterladen und löschen. Mitglieder und Betrachter haben keinen Exportzugang.

Datenimport

Organisationsinhaber, -administratoren und Superuser können Daten aus einer zuvor exportierten JSON-Datei in eine Organisation importieren.

Importstrategien

Beim Importieren von Daten wählen Sie eine von zwei Strategien:

Strategie Verhalten Risikostufe
Zusammenführen (empfohlen) Bestehende Daten bleiben erhalten. Neue Datensätze werden hinzugefügt. Wenn ein Datensatz mit dem gleichen Namen bereits existiert, wird der importierte Datensatz automatisch umbenannt (z. B. wird "Mein Bienenstock" zu "Mein Bienenstock (importiert)"). Niedrig
Vollständige Wiederherstellung Löscht zunächst alle bestehenden Organisationsdaten und importiert dann alle Datensätze aus der Datei. Hoch -- alle aktuellen Daten werden dauerhaft gelöscht

Danger

Vollständige Wiederherstellung löscht dauerhaft alle bestehenden Daten der Organisation vor dem Import. Diese Aktion kann nicht rückgängig gemacht werden. Erstellen Sie immer eine aktuelle Exportsicherung, bevor Sie die vollständige Wiederherstellung verwenden.

Daten importieren

  1. Navigieren Sie zu Datenaustausch in der Seitenleiste
  2. Öffnen Sie die Imports-Liste
  3. Klicken Sie auf Hochladen & Importieren
  4. Wählen Sie eine JSON-Exportdatei (.json, maximal 50 MB)
  5. Wählen Sie die Importstrategie: Zusammenführen oder Vollständige Wiederherstellung
  6. Klicken Sie auf Hochladen & Validieren
  7. Überprüfen Sie die Importvorschau-Seite:
    • Validierungsstatus (bestanden oder fehlgeschlagen mit Fehlerdetails)
    • Eventuelle Warnungen (z. B. Versionsmigration, vorhandene Daten erkannt)
    • Gesamtanzahl der Datensätze und Aufschlüsselung nach Modell
  8. Wenn die Validierung bestanden wurde, klicken Sie auf Import ausführen, um den Import zu starten
  9. Nach Abschluss zeigt die Import-Detail-Seite eine Zusammenfassung der importierten Daten

Validierungsprüfungen

Vor dem Import wird die Datei geprüft auf:

  • Dateiformat: Muss eine gültige JSON-Datei mit der Endung .json sein
  • Dateigröße: Maximal 50 MB
  • Struktur: Muss erforderliche Felder enthalten (export_version, export_date, organization_id, data, metadata)
  • Versionskompatibilität: Exportversion muss zwischen 1.0.0 und 2.0.0 (aktuell) liegen
  • Prüfsumme: Integritätsprüfung, wenn eine SHA-256-Prüfsumme in der Datei vorhanden ist
  • Konflikterkennung: Warnung, wenn die Zielorganisation bereits vorhandene Daten enthält

Versionsmigration

Importdateien älterer Exportversionen (1.0.0) werden beim Import automatisch in das aktuelle Format (2.0.0) migriert. Die Migration behandelt umbenannte Felder und entfernte Modelle aus früheren Versionen.

Details zum Importverhalten

Während des Imports führt das System folgende Schritte aus:

  • Trennt vorübergehend Signale (Gesundheitsstatus-Verfolgung, automatische Chargenerstellung, Lagertransaktionen), um unbeabsichtigte Nebeneffekte zu vermeiden
  • Ordnet alte Datensatz-IDs neuen IDs zu, damit Beziehungen zwischen Datensätzen erhalten bleiben
  • Löst Fremdschlüssel-Referenzen in einem zweistufigen Prozess auf: Erstellt zuerst Datensätze, verknüpft dann verzögerte Beziehungen (Königin-zu-Bienenstock-Zuordnungen, Ernte-zu-Chargen-Verknüpfungen)
  • Führt den gesamten Import innerhalb einer Datenbanktransaktion aus -- bei einem Fehler werden alle Änderungen zurückgesetzt
  • Überspringt benutzerspezifische Felder (erstellt_von, Prüfer usw.), da Benutzer nicht zwischen Systemen übertragen werden
  • Bewahrt eindeutige Kennungen (Chargen-Nummern, Eimer-Nummern, Glas-Nummern) nach Möglichkeit

Importverlauf anzeigen

  1. Gehen Sie zur Imports-Liste, um alle vergangenen Importe zu sehen
  2. Klicken Sie bei einem Import auf Details anzeigen, um Folgendes zu sehen:
    • Importtyp und Status
    • Abschlusszeitstempel
    • Zusammenfassung der erstellten Datensätze (nach Modell)
    • Eventuelle Fehler
    • Umbenannte Datensätze (bei Zusammenführungs-Importen)

Import-Datensatz löschen

  1. Gehen Sie zur Imports-Liste
  2. Klicken Sie auf die Schaltfläche Löschen neben dem Import, den Sie entfernen möchten
  3. Bestätigen Sie die Löschung

Note

Das Löschen eines Import-Datensatzes entfernt nur den Import-Auftragseintrag und die hochgeladene Datei. Bereits importierte Daten werden dadurch nicht rückgängig gemacht.

Beispieldaten

Bifolk enthält eine Funktion zum Importieren von Beispieldaten für Demonstrations- und Testzwecke. Dies ist nützlich für neue Organisationen, die die Anwendung mit realistischen Imkerei-Daten erkunden möchten.

Inhalt der Beispieldaten

Datensatzgröße Inhalt Ungefähre Anzahl
Schnelldemo (Minimal) 5 Bienenstöcke, 5 Königinnen, grundlegende Durchsichten, Ernteaufzeichnungen, Zuchtaufzeichnungen, Lagerartikel ~30 Datensätze
Vollständiger Datensatz (Umfassend) 10-15 Bienenstöcke, 15-20+ Königinnen, umfangreicher Durchsichtsverlauf, Ernteaufzeichnungen, Zucht-Abstammung, Lagerartikel ~200+ Datensätze

Der umfassende Datensatz bietet zusätzliche Optionen:

  • Beispielfotos einbeziehen: Bienenstock-Fotos und Arbeitsdokumentationsbilder
  • Lagertransaktionen einbeziehen: Transaktionsverlauf und Produktverkaufsdatensätze

Beispieldaten importieren

  1. Navigieren Sie zu Datenaustausch in der Seitenleiste
  2. Klicken Sie auf Beispieldaten
  3. Wählen Sie eine Datensatzgröße: Schnelldemo oder Vollständiger Datensatz
  4. Bei Verwendung des vollständigen Datensatzes konfigurieren Sie die erweiterten Optionen (Fotos, Transaktionen)
  5. Wenn Ihre Organisation bereits Daten enthält, setzen Sie das Häkchen zur Bestätigung, dass Beispieldaten neben den bestehenden Datensätzen hinzugefügt werden
  6. Klicken Sie auf Beispieldaten importieren
  7. Nach Abschluss zeigt eine Zusammenfassungsseite, was erstellt wurde

Tip

Es wird empfohlen, Beispieldaten in eine leere Organisation zu importieren. Wenn Sie Ihre echten Daten getrennt halten möchten, erstellen Sie zunächst eine neue Testorganisation.

Beispieldaten über die Kommandozeile

Systemadministratoren können Beispieldaten auch über die Kommandozeile laden:

docker compose exec bifolk-app python manage.py load_sample_data

Dies erstellt einen vollständigen Satz von Beispieldaten einschließlich Benutzer, Organisationen, Bienenstöcke, Durchsichten und mehr.

Django-Admin-Oberfläche

Die Django-Admin-Oberfläche bietet direkten Datenbankzugang für Superuser.

Django-Admin aufrufen

  • URL: http://ihre-domain/admin/
  • Erfordert: Superuser-Konto

Verfügbare Abschnitte

Abschnitt Modelle
Authentifizierung Benutzer, Gruppen
Organisationen Organisationen, Mitgliedschaften, Einladungen, Einstellungen
Bienenstöcke Bienenstöcke, Königinnen, Durchsichten, Ernten, Arbeiten
Zucht Königinnenzucht, Ableger
Lager Lagerartikel, Transaktionen, Verkäufe
Systemkonfiguration Auswahlkategorien, Konfigurierbare Auswahlmöglichkeiten
Benachrichtigungen Benachrichtigungen
Datenaustausch Export-Aufträge, Import-Aufträge

Häufige Admin-Aufgaben

  • Massenlöschung: Mehrere Datensätze auswählen, Aktion "Ausgewählte löschen" verwenden
  • Suche: Suchleiste verwenden, um bestimmte Datensätze zu finden
  • Filter: Seitenleistenfilter verwenden, um Ergebnisse einzugrenzen
  • Verlauf anzeigen: Änderungsverlauf jedes Datensatzes prüfen
  • Export-/Import-Aufträge anzeigen: Status der Datenaustausch-Vorgänge überwachen

Berechtigungen

Datenaustausch-Vorgänge erfordern bestimmte Rollen:

Vorgang Erforderliche Rolle
Daten exportieren Inhaber oder Administrator
Export herunterladen Inhaber oder Administrator
Export löschen Inhaber oder Administrator
Daten importieren Inhaber, Administrator oder Superuser
Import löschen Inhaber oder Administrator
Beispieldaten importieren Inhaber, Administrator oder Superuser
Django-Admin-Zugang Superuser

Note

Die Organisation muss aktiv sein, damit Export- und Importvorgänge verfügbar sind. Superuser können Importvorgänge unabhängig von der Mitgliedschaft immer durchführen.

Verwandte Dokumentation