Systemkonfiguration¶
Anleitung zu Bifolks konfigurierbarem Auswahlsystem zur Verwaltung von Dropdown-Optionen.
Zielgruppe: Systemadministratoren, Organisationsinhaber und -administratoren
Übersicht¶
Bifolk verwendet ein SystemConfig-Modul, das Administratoren ermöglicht, Dropdown-Optionen in der gesamten Anwendung anzupassen. Anstatt fest codierter Auswahlmöglichkeiten werden viele Dropdown-Felder aus konfigurierbaren Datenbankeinträgen befüllt, die zu Ihrer Organisation gehören.
Auswahlkategorien¶
Bei der Ersteinrichtung von Bifolk werden automatisch 28 Auswahlkategorien erstellt. Jede Kategorie gruppiert verwandte Optionen, die in Dropdown-Feldern der gesamten Anwendung erscheinen. Das Lager-Modul fügt eine zusätzliche Kategorie (item_type) für Inventarartikel hinzu.
Die Kategorien sind nach Anwendungsbereichen geordnet.
Bienenstockverwaltung¶
| Kategoriecode | Anzeigename | Verwendet für | Standardoptionen |
|---|---|---|---|
hive_style |
Beutensystem | Bienenstockbauweise (z.B. beim Erstellen oder Bearbeiten eines Bienenstocks) | Langstroth, Top Bar, Warré, Dadant, National |
health_status |
Gesundheitsstatus | Gesundheitsstatus für Bienenstöcke und Königinnen | Ausgezeichnet, Gut, Befriedigend, Schlecht, Kritisch, Unbekannt |
temperament |
Temperament | Völkertemperament bei Durchsichten | Ruhig, Mäßig, Aggressiv |
combine_method |
Vereinigungsmethode | Methode bei der Völkervereinigung | Zeitungsmethode, Direkte Vereinigung, Langsames Zusammenführen, Andere |
Durchsichten¶
| Kategoriecode | Anzeigename | Verwendet für | Standardoptionen |
|---|---|---|---|
inspection_status |
Durchsichtstatus | Arbeitsablaufstatus von Stockkontrollen | Geplant, In Bearbeitung, Abgeschlossen, Abgebrochen |
drone_presence |
Drohnenaktivität | Grad der beobachteten Drohnenaktivität bei einer Durchsicht | Keine, Wenige, Mäßig, Viele, Sehr viele |
Königinnen¶
| Kategoriecode | Anzeigename | Verwendet für | Standardoptionen |
|---|---|---|---|
queen_origin |
Königinnenherkunft | Herkunft der Königin | Hier gezüchtet, Gekauft, Schwarmfang, Umweiselung, Weiselzelle, Unbekannt |
queen_replacement_method |
Königinnenersatzmethode | Methode zur Einführung einer neuen Königin | Direkte Einführung, Käfigzusetzung, Eindrückkäfig, Flugling, Weiselzelle, Andere |
queen_replacement_reason |
Königinnenersatzgrund | Grund für den Austausch einer Königin | Alter, Schlechtes Legemuster, Aggressives Volk, Krankheit/Gesundheitsprobleme, Umweiselung, Zuchtverbesserung, Andere |
Zucht¶
| Kategoriecode | Anzeigename | Verwendet für | Standardoptionen |
|---|---|---|---|
breeding_method |
Zuchtmethode | Methode zur Königinnenzucht | Umlarven, Natürliche Weiselzellen, Jenter-System, Nicot-System, Flugling, Andere |
breeding_status |
Zuchtstatus | Stadien des Zuchtprozesses | Planung, Umgelarft, Angenommen, Verdeckelt, Geschlüpft, Begattet, Eilage, Fehlgeschlagen |
breeding_quality |
Zuchtqualität | Qualitätsbewertung der Zuchtergebnisse | Ausgezeichnet, Gut, Befriedigend, Schlecht |
Völkerteilungen¶
| Kategoriecode | Anzeigename | Verwendet für | Standardoptionen |
|---|---|---|---|
split_type |
Teilungsart | Art der Völkerteilung oder -vermehrung | Standardteilung, Flugling, Ableger, Schwarmfang, Kunstschwarm, Andere |
split_status |
Teilungsstatus | Status einer Völkerteilung | Geplant, Abgeschlossen, Weiselrichtig, Weisellos, Fehlgeschlagen, Wiedervereinigt |
Betriebsarbeiten (Fütterung, Behandlung, Wartung)¶
| Kategoriecode | Anzeigename | Verwendet für | Standardoptionen |
|---|---|---|---|
operation_status |
Betriebsstatus | Arbeitsablaufstatus für alle Betriebsarbeiten (Fütterung, Behandlung, Wartung) | Geplant, In Bearbeitung, Abgeschlossen, Abgebrochen |
operation_priority |
Betriebspriorität | Prioritätsstufe für alle Betriebsarbeiten | Niedrig, Mittel, Hoch, Dringend |
feed_type |
Futterart | Art der Beifütterung | Zuckersirup, Futterteig, Pollenpatty, Proteinergänzung, Andere |
treatment_type |
Behandlungsart | Art der Krankheits- oder Schädlingsbehandlung | Varroabehandlung, Nosemabehandlung, Faulbrutbehandlung, Kleiner Beutenkäfer, Wachsmotte, Andere |
treatment_effectiveness |
Behandlungswirksamkeit | Wirksamkeit einer Behandlung | Ausgezeichnet, Gut, Befriedigend, Schlecht, Unbekannt |
maintenance_type |
Wartungsart | Art der Bienenstock- oder Gerätewartung | Reparatur, Reinigung, Anstrich, Zargen hinzufügen/entfernen, Rahmenwechsel, Geräteaufrüstung, Einwinterung, Andere |
Ernten¶
| Kategoriecode | Anzeigename | Verwendet für | Standardoptionen |
|---|---|---|---|
honey_type |
Honigsorte | Art des Honigs nach Trachtquelle (bei Ernteeinträgen und Honigchargen) | Frühlingsblüte, Wildblume, Klee, Akazie, Waldhonig, Raps, Linde |
Lager & Inventar¶
| Kategoriecode | Anzeigename | Verwendet für | Standardoptionen |
|---|---|---|---|
equipment_type |
Ausrüstungstyp | Arten von Imkerausrüstung | Bienenstockzarge, Rahmen, Mittelwand, Futtergeschirr, Absperrgitter, Werkzeug, Schutzausrüstung, Andere Ausrüstung |
supply_type |
Verbrauchsmaterialart | Arten von Verbrauchsmaterial | Futter, Medikamente/Behandlung, Verpackungsmaterial, Anderes Material |
product_type |
Produkttyp | Arten von Bienenprodukten | Honig, Bienenwachs, Propolis, Pollen, Gelée Royale, Andere Produkte |
unit_type |
Maßeinheit | Maßeinheiten für Lagermengen | Stück, Kilogramm, Liter, Glas, Karton, Rahmen |
item_type |
Artikeltyp | Spezifische Inventaratikeltypen (vom Lager-Modul erstellt) | Zarge, Rahmen, Smoker, Schleier, Handschuhe, Entdeckelungsmesser, Schleuderteile, Glas, Wachsplatte, Eimer, Honig, Pollen, Propolis, Zuckersirup, Futterteig, Pollenpatty, Andere |
Verkauf & Transaktionen¶
| Kategoriecode | Anzeigename | Verwendet für | Standardoptionen |
|---|---|---|---|
transaction_type |
Transaktionstyp | Arten von Inventartransaktionen | Einkauf, Verkauf, Produktion, Verbrauch, Ernte, Verlust/Schaden, Anpassung, Transfer, Rückgabe |
Systemverwaltete Transaktionstypen
Sechs Transaktionstypen werden automatisch von der Anwendung geschrieben und können nicht geändert oder gelöscht werden: Verkauf, Ernte, Verbrauch, Rückgabe, Chargenregistrierung und Anpassung. Diese werden als Informationsbanner auf der Transaktionstyp-Konfigurationsseite (/system/transaction_type/) angezeigt. Sie können weiterhin eigene benutzerdefinierte Typen daneben hinzufügen.
| payment_method | Zahlungsmethode | Zahlungsarten für Verkäufe | Bar, Karte, Banküberweisung, Andere |
Auswahlmöglichkeiten verwalten¶
Systemkonfiguration aufrufen¶
- Gehen Sie zu System > Systemkonfiguration in der Seitenleiste
- Sie sehen eine Liste aller Auswahlkategorien mit der Anzahl der für Ihre Organisation konfigurierten Optionen
Note
Nur Benutzer mit Admin- oder Inhaber-Rolle in mindestens einer Organisation können auf die Systemkonfiguration zugreifen.
Standardoptionen laden¶
Wenn Sie mit einem leeren System beginnen, können Sie einen Satz von Standardoptionen für alle Kategorien laden.
- Öffnen Sie System > Systemkonfiguration
- Klicken Sie auf die Schaltfläche Standardwerte laden
- Standardoptionen werden für Ihre aktuelle Organisation erstellt
Tip
Sie können Standardwerte auch über die Kommandozeile laden: python manage.py load_default_categories
Auswahlmöglichkeit hinzufügen¶
- Wählen Sie eine Kategorie aus der Liste
- Klicken Sie auf Auswahlmöglichkeit hinzufügen
- Füllen Sie aus:
- Bezeichnung: Anzeigetext für diese Option (z.B. "Akazienhonig"). Ein eindeutiger interner Wert wird automatisch aus der Bezeichnung generiert.
- Beschreibung (optional): Zusätzliche Details zu dieser Option
- Aktiv: Ob diese Option zur Auswahl verfügbar ist
- Standard: Ob dies die vorausgewählte Standardoption für diese Kategorie ist. Nur eine Option pro Kategorie und Organisation kann als Standard festgelegt werden.
- Organisation: Welcher Organisation diese Option zugeordnet wird
- Klicken Sie auf Speichern
Neue Optionen werden automatisch am Ende der Liste eingefügt.
Note
Das interne Wert-Feld wird automatisch aus der Bezeichnung als URL-freundlicher Bezeichner generiert (z.B. "Akazienhonig" wird zu akazienhonig). Sie müssen es nicht manuell eingeben.
Auswahlmöglichkeit bearbeiten¶
- Wählen Sie die Option aus der Kategorieliste
- Klicken Sie auf die Schaltfläche Bearbeiten (Stift-Symbol)
- Aktualisieren Sie die gewünschten Felder
- Klicken Sie auf Speichern
Reihenfolge ändern¶
Optionen können direkt in der Liste per Drag-and-Drop umsortiert werden. Halten Sie das Griffsymbol (⠿) links neben einer Zeile gedrückt, ziehen Sie die Zeile an die gewünschte Position und lassen Sie sie los — die neue Reihenfolge wird automatisch gespeichert.
Note
Globale Optionen (erkennbar am Global-Badge) können von Organisations-Administratoren nicht umsortiert werden. Nur Optionen, die zur eigenen Organisation gehören, verfügen über ein verschiebbares Griffsymbol.
Auswahlmöglichkeit löschen¶
Optionen können nur gelöscht werden, wenn keine anderen Datensätze darauf verweisen. Das System prüft automatisch auf Referenzen vor dem Löschen.
- Klicken Sie auf die Schaltfläche Löschen (Papierkorb-Symbol) neben der Option
- Wenn die Option von anderen Datensätzen referenziert wird (z.B. Bienenstöcke, Ernten, Durchsichten), zeigt das System an, welche Datensätze sie verwenden, und verhindert das Löschen
- Wenn die Option nicht referenziert wird, bestätigen Sie das Löschen
Warning
Wenn eine Option nicht gelöscht werden kann, weil sie in Verwendung ist, erwägen Sie stattdessen, sie zu deaktivieren.
Auswahlmöglichkeit deaktivieren¶
Anstatt eine Option zu löschen (was möglicherweise nicht möglich ist, wenn Datensätze sie referenzieren), deaktivieren Sie sie:
- Bearbeiten Sie die Option
- Deaktivieren Sie Aktiv
- Speichern Sie
Deaktivierte Optionen werden nicht mehr in Dropdowns angezeigt, aber bestehende Datensätze, die sie referenzieren, bleiben erhalten.
Spezielle Felder für Beutensysteme¶
Die Kategorie Beutensystem (hive_style) hat zusätzliche Felder zur Konfiguration von Gewichtsparametern, die für die Honigernteschätzung verwendet werden:
| Feld | Beschreibung |
|---|---|
| Brutzargengewicht (kg) | Gewicht einer leeren Brutzarge |
| Honigzargengewicht (kg) | Gewicht einer leeren Honigzarge |
| Wabengewicht (kg) | Gewicht der leeren Wachswaben pro Honigzarge |
Diese zusätzlichen Felder erscheinen nur beim Bearbeiten von Optionen in der Kategorie Beutensystem.
Formel zur Ernteschätzung¶
Bei Stockkontrollen wird, wenn das Gesamtgewicht des Bienenstocks zusammen mit den Zargenanzahlen erfasst wird, der erntbare Honig geschätzt:
Geschätzte Ernte = Gesamtgewicht
- (Brutzargen x Brutzargengewicht)
- (Honigzargen x Honigzargengewicht)
- (Honigzargen x Wabengewicht)
Das Wabengewicht wird abgezogen, da die Wachswaben nach der Honigextraktion erhalten bleiben.
Gewichtswerte einstellen
Geben Sie bei der Konfiguration von Beutensystemen genaue Gewichtswerte für Ihre spezifische Ausrüstung ein. Dies ermöglicht genauere Ernteprognosen bei Stockkontrollen.
Organisationsspezifische Auswahlmöglichkeiten¶
Alle Optionen gehören zu einer bestimmten Organisation. Wenn Sie eine Option erstellen, wird sie Ihrer aktuellen Organisation zugeordnet (oder Sie können eine andere auswählen, wenn Sie mehrere Organisationen verwalten).
Wenn ein Benutzer ein Dropdown in einem Formular öffnet, sieht er nur die Optionen, die für seine aktuelle Organisation konfiguriert sind.
Note
Staff-Benutzer (Superuser) können Optionen für jede Organisation erstellen und Optionen aller Organisationen einsehen.
Benachrichtigungen bei fehlender Konfiguration¶
Wenn Sie sich anmelden, prüft das System automatisch, ob Ihre Organisation für alle aktiven Kategorien Auswahlmöglichkeiten konfiguriert hat. Wenn eine Kategorie keine Optionen hat, erhalten Sie eine Benachrichtigung mit einem Link zur Konfigurationsseite.
Diese Benachrichtigungen:
- Werden einmal pro Anmeldung erstellt (nicht innerhalb von 24 Stunden wiederholt)
- Erscheinen nur für Kategorien, die keine aktiven Optionen für Ihre Organisation haben
- Enthalten einen direkten Link zur entsprechenden Kategorieseite
- Werden nur an Benutzer mit Inhaber- oder Admin-Rolle gesendet
Standardauswahlmöglichkeiten¶
Wenn Bifolk zum ersten Mal installiert wird, werden die 28 Auswahlkategorien automatisch erstellt (ohne Optionen). Optionen können auf drei Arten hinzugefügt werden:
- Schaltfläche Standardwerte laden in der Systemkonfiguration -- erstellt einen Standardsatz von Optionen für Ihre Organisation
- Beispieldaten über das Datenaustausch-Modul -- enthält Optionen als Teil des Beispieldatensatzes
- Manuelle Eingabe -- fügen Sie Optionen einzeln über die Benutzeroberfläche hinzu
Konfigurationslinks in Formularen¶
Wenn ein Dropdown-Feld in einem Formular keine konfigurierten Optionen hat, zeigt das System eine Warnmeldung ("Keine Optionen konfiguriert") und einen Link zur entsprechenden Systemkonfigurationsseite an. So können Sie schnell zur Konfiguration navigieren und die fehlenden Optionen hinzufügen, ohne Ihren aktuellen Arbeitsablauf zu verlassen.
Verwandte Dokumentation¶
- Ersteinrichtung - Auswahlmöglichkeiten nach der Installation einrichten
- Konfiguration - Umgebungsvariablen-Referenz