ApiCore/docs/lastenheft.md

ApiCore – Produktbeschreibung und Lastenheft

Projekt: ApiCore Produktart: Digitale Imkereiverwaltung / Beekeeping Management Platform Einsatzgebiet: Wabenhain und perspektivisch weitere Imkereien Grundprinzip: API-first, mobil nutzbar, revisionsfähig, modular erweiterbar Dokumentstatus: Fachliches Lastenheft – Version 1.0

1. Produktbeschreibung

1.1 Was ist ApiCore?

ApiCore ist die zentrale digitale Verwaltungs-, Dokumentations- und Datenplattform für eine moderne Imkerei.

Die Software bildet den vollständigen Lebenszyklus einer Imkerei digital ab:

Bienenstand → Bienenvolk → Königin → Durchsicht → Behandlung → Fütterung → Ernte → Honigcharge → Lager → Produkt/Verkauf

Dabei sollen nicht einfach nur Notizen zu Bienenvölkern gespeichert werden. ApiCore soll sämtliche relevanten Vorgänge miteinander verknüpfen und damit eine zentrale Datenbasis für die gesamte Imkerei schaffen.

Ein Beispiel: Eine Honigcharge soll später nachvollziehbar machen können, von welchen Bienenständen beziehungsweise Völkern der Honig stammt, wann er geerntet wurde, wann geschleudert wurde, welche Messwerte vorlagen, in welchen Behältern er gelagert wurde und in welche abgefüllte Charge beziehungsweise Produkte er anschließend überführt wurde.

ApiCore dient damit gleichzeitig als:

• digitale Stockkarte
• Völkerverwaltung
• Königinnenverwaltung
• Behandlungs- und Varroadokumentation
• Fütterungsverwaltung
• Aufgaben- und Terminverwaltung
• Ernteverwaltung
• Chargen- und Rückverfolgbarkeitssystem
• Honig- und Lagerverwaltung
• Materialverwaltung
• Dokumentationsplattform
• Reporting-System
• zentrale API für andere Anwendungen

Die selbst entwickelte Wabenhain-Webseite bzw. der Shop soll über die API auf relevante Informationen zugreifen können. ApiCore bildet dabei den fachlichen Kern, während Shop, Webseite, ERP oder Buchhaltung bei Bedarf als eigenständige Systeme angebunden werden können.

2. Zielsetzung

ApiCore soll die bisher teilweise papierbasierte, manuelle oder auf verschiedene Anwendungen verteilte Verwaltung einer Imkerei in einem zentralen System zusammenführen.

Die Software soll insbesondere:

1. jederzeit zeigen, welche Völker existieren und in welchem Zustand sie sind,
2. sämtliche Arbeiten an einem Volk nachvollziehbar dokumentieren,
3. notwendige Arbeiten automatisch ableiten und erinnern,
4. Behandlungen und Fütterungen lückenlos dokumentieren,
5. Ernten und Honigchargen vollständig rückverfolgbar machen,
6. Lagerbestände und Betriebsmittel verwalten,
7. Daten für Website, Shop und andere Systeme bereitstellen,
8. langfristige Auswertungen über Völker, Königinnen, Erträge und Standorte ermöglichen,
9. möglichst wenig zusätzliche Büroarbeit verursachen.

Die Dokumentation soll deshalb vor allem während der praktischen Arbeit am Bienenstand schnell möglich sein.

3. Zielgruppen und Benutzerrollen

3.1 Administrator

Der Administrator darf:

• Benutzer verwalten
• Berechtigungen vergeben
• Stammdaten verändern
• Systemeinstellungen ändern
• API-Zugriffe verwalten
• Daten importieren/exportieren
• Integrationen konfigurieren
• alle Daten einsehen und bearbeiten

3.2 Imker

Der Imker darf insbesondere:

• Bienenstände verwalten
• Völker bearbeiten
• Durchsichten erfassen
• Königinnen verwalten
• Behandlungen dokumentieren
• Fütterungen erfassen
• Ernten dokumentieren
• Aufgaben bearbeiten
• Lagerbewegungen durchführen

3.3 Mitarbeiter

Mitarbeiter erhalten abhängig von ihrer Berechtigung Zugriff auf bestimmte Bienenstände oder Funktionen. Beispielsweise:

• Durchsichten dokumentieren
• Aufgaben abhaken
• Ernten erfassen
• Fütterungen erfassen

Administrative Funktionen können eingeschränkt werden.

3.4 Nur-Lesen-Benutzer

Optional sollen Benutzer ausschließlich Leserechte erhalten können. Dies kann beispielsweise für Beratung, Kontrolle, Betriebsprüfung oder externe Helfer verwendet werden.

3.5 API-Client

Externe Anwendungen müssen über definierte Berechtigungen auf ApiCore zugreifen können. Beispiele: Wabenhain-Webseite, Onlineshop, ERP, Automatisierungen, Analyseplattform, Etikettengenerierung.

4. Fachliche Hauptmodule

4.1 Dashboard

Das Dashboard MUSS einen schnellen Überblick über den aktuellen Zustand der Imkerei ermöglichen. Es MUSS mindestens darstellen:

• Anzahl aktiver Völker
• Anzahl Bienenstände
• zuletzt durchgesehene Völker
• überfällige Durchsichten
• offene Aufgaben
• geplante Behandlungen
• notwendige Fütterungen
• aktuelle Varroawerte
• Auffälligkeiten
• bevorstehende Termine
• aktuelle Ernten
• Honigbestand

Das System SOLL automatisch besonders relevante Meldungen hervorheben. Beispiele:

• Volk 04 wurde seit 18 Tagen nicht kontrolliert.
• Volk 02 weist einen erhöhten Varroawert auf.
• Stand „Wald" besitzt drei Völker mit sehr geringem Futterbestand.

4.2 Bienenstände

ApiCore MUSS beliebig viele Bienenstände verwalten können. Für einen Bienenstand müssen mindestens gespeichert werden können:

• eindeutige ID
• Name
• Beschreibung
• Standort
• GPS-Koordinaten
• Adresse
• Status
• Erstellungsdatum
• Notizen

Optional: Foto, maximale Völkeranzahl, Grundstückseigentümer, Ansprechpartner, Wasserquelle, Trachtgebiet, Besonderheiten.

Ein Bienenstand MUSS mehrere Völker enthalten können. Völker müssen zwischen Bienenständen verschoben werden können. Jede Verschiebung MUSS historisch nachvollziehbar bleiben.

4.3 Völkerverwaltung

Jedes Bienenvolk MUSS eine eindeutige und dauerhaft verwendbare ID erhalten. Ein Volk muss mindestens folgende Informationen besitzen können:

• Volk-ID
• Anzeigename/Nummer
• aktueller Bienenstand
• Beutentyp
• Erstellungsdatum
• Herkunft
• Volkstyp
• Status
• aktuelle Königin
• Volksstärke
• Brutstatus
• Futterstatus
• Gesundheitsstatus
• Notizen

Mögliche Volkstypen: Wirtschaftsvolk, Ableger, Jungvolk, Pflegevolk, Begattungseinheit, Reservevolk.

Mögliche Status: aktiv, schwach, auffällig, weisellos, aufgelöst, verkauft, eingegangen, vereinigt.

Das System MUSS die vollständige Historie eines Volkes darstellen.

4.4 Lebenszyklus eines Volkes

ApiCore MUSS besondere Vorgänge korrekt abbilden können. Dazu gehören:

Ableger bilden – Aus einem bestehenden Volk kann ein neues Volk erzeugt werden. Dabei muss die Abstammung gespeichert werden: Volk A → Ableger B.

Völker vereinigen – Werden zwei Völker vereinigt, müssen beide ursprünglichen Völker historisch erhalten bleiben.

Volk auflösen – Das Volk wird deaktiviert, seine Dokumentation darf jedoch nicht gelöscht werden.

Volk verkaufen – Verkauf und Datum müssen dokumentierbar sein.

Volk eingegangen – Ursache und Datum sollen dokumentiert werden können.

4.5 Königinnenverwaltung

Königinnen müssen als eigenständige Entitäten behandelt werden. Jede Königin MUSS eine eigene ID erhalten. Folgende Daten sollen gespeichert werden:

• Königin-ID
• Geburts-/Schlupfjahr
• Rasse/Linie
• Herkunft
• Züchter
• Zeichnungsfarbe
• Zeichnungsnummer
• Begattungsart
• Begattungsstand
• Besamungsdaten
• Mutterlinie
• Vaterlinie
• Status
• aktuelles Volk

Mögliche Status: aktiv, Reserve, unbegattet, begattet, verloren, ersetzt, verkauft, verstorben.

Ein Königinnenwechsel MUSS historisch nachvollziehbar sein. ApiCore SOLL später Abstammungsbäume darstellen können.

4.6 Durchsichten / digitale Stockkarte

Die Durchsicht ist eine der wichtigsten Funktionen von ApiCore. Eine Durchsicht MUSS möglichst schnell mobil erfasst werden können. Zu einer Durchsicht müssen unter anderem gespeichert werden können:

• Datum, Uhrzeit, Benutzer, Volk
• Wetter, Temperatur
• Volksstärke, Brutmenge, Brutbild
• offene Brut vorhanden, verdeckelte Brut vorhanden, Stifte vorhanden
• Königin gesehen, Weiselzellen vorhanden
• Schwarmstimmung, Sanftmut, Wabensitz
• Futterbestand, Honigraumstatus
• Gesundheitsauffälligkeiten, Varroaauffälligkeiten
• Maßnahmen, freie Notizen, Fotos

Die Eingabe MUSS stark auf schnelle Bedienung optimiert werden. Häufig verwendete Werte sollen mit wenigen Klicks erfasst werden können.

4.7 Bewertungs- und Scoring-System

Bestimmte Eigenschaften sollen über ein standardisiertes Bewertungssystem dokumentiert werden können. Beispielsweise Skala 1–5 für: Volksstärke, Sanftmut, Wabensitz, Schwarmtrieb, Brutbild, Honigertrag.

Dadurch sollen langfristige Vergleiche zwischen Königinnen und Völkern möglich werden.

4.8 Aufgabenmanagement

ApiCore MUSS Aufgaben verwalten können. Eine Aufgabe kann mit folgenden Objekten verbunden werden: Volk, Bienenstand, Königin, Honigcharge, Lager, allgemeiner Betrieb.

Eine Aufgabe benötigt: Titel, Beschreibung, Priorität, Fälligkeitsdatum, Status, zuständigen Benutzer, verknüpftes Objekt.

Beispiele: „Volk 03 Königin kontrollieren", „Stand Wald Varroakontrolle durchführen", „Honigcharge H-2026-005 Wassergehalt messen".

Aus einer Durchsicht MUSS direkt eine Folgeaufgabe erzeugt werden können.

4.9 Erinnerungen

Das System SOLL Benutzer aktiv an wichtige Tätigkeiten erinnern. Beispiele: nächste Durchsicht, Behandlungskontrolle, Varroakontrolle, Fütterung, Königin kontrollieren, Ernte, Honigmessung, Materialbestellung.

Erinnerungen sollen über mehrere Kanäle realisierbar sein. Mindestens erforderlich: In-App. Später möglich: E-Mail, Push, Webhook.

4.10 Varroamanagement

ApiCore MUSS Varroakontrollen vollständig dokumentieren können. Unterstützte Messverfahren sollen unter anderem sein: natürlicher Milbenfall, Puderzuckermethode, Auswaschmethode, Drohnenbrutkontrolle.

Gespeichert werden: Volk, Datum, Methode, Messdauer, Anzahl Milben, berechneter Wert, Bewertung, Notizen.

Das System SOLL Messwerte automatisch bewerten können. Historische Varroawerte müssen grafisch dargestellt werden können.

4.11 Behandlung / Tierarzneimittel

Behandlungen müssen lückenlos dokumentierbar sein. Eine Behandlung umfasst mindestens: Volk oder Völkergruppe, Datum, Behandlungsmittel, Wirkstoff, Menge, Methode, Grund, behandelnde Person, Charge des Behandlungsmittels, Startdatum, Enddatum, Notizen.

Wiederholungsbehandlungen müssen unterstützt werden. Die Behandlungshistorie eines Volkes MUSS jederzeit abrufbar sein. Das System SOLL entsprechende Dokumentationsberichte exportieren können.

4.12 Fütterung

Fütterungen müssen dokumentiert werden können. Gespeichert werden: Volk, Datum, Futtermittel, Art, Menge, Einheit, Charge, Benutzer, Notiz.

Futterarten können beispielsweise sein: Zuckerwasser, Futtersirup, Futterteig, eigener Honig.

ApiCore SOLL die gesamte Futtermenge pro Volk und Saison berechnen.

4.13 Ernte

ApiCore MUSS Honigernten erfassen können. Eine Ernte kann sich auf ein einzelnes Volk, mehrere Völker oder einen vollständigen Bienenstand beziehen.

Gespeichert werden mindestens: Ernte-ID, Datum, Bienenstand, beteiligte Völker, Honigart/Tracht, Anzahl Honigräume, Rohgewicht, Nettomenge, Bemerkungen.

Die Ernte bildet den Ausgangspunkt für die spätere Chargenverfolgung.

4.14 Schleuderungen

Eine oder mehrere Ernten können einer Schleuderung zugeordnet werden. Gespeichert werden: Schleuder-ID, Datum, beteiligte Ernten, Menge, Schleuderraum, Benutzer, Wassergehalt, Temperatur, Messungen, Bemerkungen.

Aus einer Schleuderung MUSS eine Honigcharge erzeugt werden können.

4.15 Honigchargen

Das Chargensystem ist eine Kernfunktion von ApiCore. Jede Honigcharge MUSS eine eindeutige Chargennummer besitzen. Beispiel: WH-2026-0001.

Eine Charge enthält mindestens: Chargennummer, Erntedatum, Schleuderdatum, beteiligte Bienenstände, beteiligte Völker, Honigart, Menge, Wassergehalt, Lagerbehälter, Status.

Mögliche Status: roh, geschleudert, geklärt, gerührt, lagernd, abgefüllt, verkauft, verbraucht.

4.16 Lückenlose Rückverfolgbarkeit

ApiCore MUSS eine vollständige Rückverfolgbarkeit ermöglichen. Beispielsweise:

Honigglas → Abfüllcharge → Honigcharge → Schleuderung → Ernten → Bienenstand → Völker

Dadurch muss später nachvollziehbar sein, woher ein bestimmtes Produkt stammt.

4.17 Honigmessungen

Zu Honigchargen sollen Messwerte gespeichert werden können. Mindestens: Wassergehalt, Messdatum, Messgerät, Temperatur, Benutzer.

Optional später: Leitfähigkeit, pH-Wert, HMF, Invertase, Laborergebnisse.

Mehrere Messungen pro Charge müssen möglich sein.

4.18 Lagerbehälter

Honig muss konkreten Lagerbehältern zugeordnet werden können. Beispiele: Hobbock 01, Hobbock 02, Abfüllkübel 01.

Gespeichert werden: Behälter-ID, Behältertyp, Fassungsvermögen, aktuelle Charge, aktuelle Menge, Standort, Status.

Umlagerungen zwischen Behältern müssen dokumentiert werden.

4.19 Abfüllungen

ApiCore MUSS Abfüllvorgänge verwalten. Eine Abfüllung enthält: Abfüll-ID, verwendete Honigcharge, Datum, Glasgröße, Anzahl Gläser, Gesamtmenge, Mindesthaltbarkeitsdatum, Los-/Chargennummer, Benutzer.

Aus einem Honigbehälter beispielsweise 25 kg Charge WH-2026-001 können anschließend beispielsweise 50 × 500-g-Gläser erzeugt werden. Der Lagerbestand muss entsprechend automatisch reduziert werden.

4.20 Produktverwaltung

ApiCore SOLL Produkte verwalten können. Beispielsweise: Frühjahrshonig, Sommerhonig, Waldhonig, Met, Bienenwachs, weitere Imkereiprodukte.

Produkte können besitzen: Produkt-ID, Name, Beschreibung, SKU, Gebindegröße, Gewicht, Verkaufseinheit, Status.

Die Produktinformationen sollen über die API anderen Anwendungen bereitgestellt werden können.

4.21 Lagerverwaltung

ApiCore MUSS Lagerbestände verwalten können. Unterschieden werden mindestens:

• Honig: Rohhonig, Honigchargen, abgefüllte Gläser
• Verbrauchsmaterial: Gläser, Deckel, Etiketten, Futtermittel, Behandlungsmittel
• Imkereimaterial: Zargen, Böden, Deckel, Rähmchen, Absperrgitter, Honigräume

Lagerbewegungen müssen dokumentiert werden.

4.22 Inventar

Ausrüstungsgegenstände sollen individuell erfasst werden können. Beispielsweise: Honigschleuder, Refraktometer, Dampfwachsschmelzer, Abfüllbehälter.

Mögliche Daten: Inventarnummer, Bezeichnung, Hersteller, Kaufdatum, Zustand, Standort, Wartungsdatum.

4.23 QR-Code-System

ApiCore SOLL für wichtige Objekte QR-Codes erzeugen können. Insbesondere: Volk, Bienenstand, Königin, Honigbehälter, Honigcharge, Inventar.

An einem Bienenvolk kann beispielsweise ein QR-Code angebracht werden. Nach dem Scan soll unmittelbar die entsprechende Volkseite beziehungsweise eine neue Durchsicht geöffnet werden. Dies reduziert den manuellen Auswahlaufwand am Bienenstand erheblich.

4.24 Dokumente und Bilder

ApiCore MUSS Dateien mit Objekten verknüpfen können. Beispiele: Fotos einer Durchsicht, Königinnenbilder, Laborberichte, Rechnungen, Zertifikate, Analyseberichte, Standortdokumente.

4.25 Kalender

ApiCore SOLL einen zentralen Betriebskalender besitzen. Dargestellt werden: geplante Durchsichten, Aufgaben, Behandlungen, Fütterungen, Ernten, Königinnenarbeiten, allgemeine Termine.

4.26 Statistik und Reporting

ApiCore MUSS Daten langfristig auswerten können. Mindestens folgende Auswertungen sollen möglich sein:

• Völker: Entwicklung Volksstärke, Völkerverluste, Anzahl Völker, Ablegerentwicklung
• Königinnen: Ertrag, Sanftmut, Schwarmtrieb, Volksentwicklung, Lebensdauer
• Bienenstände: durchschnittlicher Honigertrag, Völkerverluste, Volksentwicklung
• Varroa: Milbenentwicklung, Behandlungserfolg
• Honig: Erntemenge, Ertrag pro Volk, Ertrag pro Stand, Ertrag pro Jahr, Ertrag pro Tracht
• Futter: Futterverbrauch pro Volk, Futterverbrauch pro Saison

5. Suche

ApiCore MUSS eine globale Suche besitzen. Durchsuchbar sollen mindestens sein: Völker, Bienenstände, Königinnen, Chargen, Ernten, Aufgaben, Produkte, Lager, Inventar.

6. Filter

Listen müssen umfangreich filterbar sein. Beispiel Völker: Standort, Status, Königinnenjahr, Volksstärke, letzte Durchsicht, Varroastatus. Filter müssen miteinander kombinierbar sein.

7. API

ApiCore wird als API-first-System konzipiert. Alle wesentlichen fachlichen Funktionen müssen auch über eine dokumentierte API verfügbar sein.

Die API MUSS mindestens CRUD-Operationen für zentrale Objekte ermöglichen: Standorte, Völker, Königinnen, Durchsichten, Aufgaben, Behandlungen, Fütterungen, Ernten, Chargen, Lager, Produkte.

Darüber hinaus müssen unterstützt werden: Suche, Filter, Sortierung, Pagination, Authentifizierung, Berechtigungsprüfung.

8. API-Dokumentation

Die API MUSS automatisch dokumentiert werden. Die Dokumentation soll mindestens enthalten: Endpunkte, Parameter, Datenmodelle, Authentifizierung, Beispielrequests, Beispielresponses, Fehlercodes.

Eine OpenAPI-kompatible Beschreibung ist erforderlich.

9. Webhooks

ApiCore SOLL Ereignisse an andere Anwendungen übertragen können. Mögliche Events:

colony.created
colony.updated
inspection.created

queen.created
queen.replaced

harvest.created

batch.created
batch.updated

product.stock_changed

task.created
task.completed

Damit kann beispielsweise die Wabenhain-Webseite oder eine Automatisierungsplattform unmittelbar auf Änderungen reagieren.

10. Import und Export

ApiCore MUSS Daten exportieren können. Mindestens: CSV, JSON, PDF für ausgewählte Berichte.

Es MUSS möglich sein, Stammdaten über CSV oder einen vergleichbaren strukturierten Import zu übernehmen.

11. Mobile Nutzung

Die Anwendung MUSS vollständig auf Smartphones bedienbar sein. Das betrifft insbesondere: Durchsicht, Fütterung, Behandlung, Varroakontrolle, Aufgaben, QR-Scan.

Die Oberfläche am Bienenstand muss mit möglichst wenigen Interaktionen funktionieren.

12. Offlinefähigkeit

Langfristig SOLL eine eingeschränkte Offlinefähigkeit vorhanden sein. Der Benutzer muss beispielsweise eine Durchsicht auch dann erfassen können, wenn am Bienenstand kein Mobilfunkempfang vorhanden ist. Sobald wieder eine Verbindung besteht, werden die Daten synchronisiert.

13. Datenmodell – Kernobjekte

Das grundlegende Datenmodell besteht mindestens aus:

User
│
├── Apiary
│   └── Colony
│       ├── Queen
│       ├── Inspection
│       ├── Feeding
│       ├── VarroaMeasurement
│       ├── Treatment
│       ├── Task
│       └── Harvest
│
├── Queen
│
├── Harvest
│   └── Extraction
│       └── HoneyBatch
│           ├── Measurement
│           ├── StorageContainer
│           └── BottlingBatch
│               └── Product
│
├── Inventory
├── StockMovement
├── Equipment
├── Document
└── Notification

Historische Beziehungen dürfen nicht durch spätere Änderungen verloren gehen.

14. Audit-Log

Wichtige Änderungen MUSS ApiCore protokollieren. Mindestens: wer, wann, welche Daten, vorheriger Wert, neuer Wert.

Besonders relevant sind: Behandlungen, Chargen, Ernten, Benutzer, Lagerbewegungen.

15. Benutzer- und Rechteverwaltung

ApiCore MUSS rollenbasierte Zugriffssteuerung unterstützen. Berechtigungen sollen mindestens nach folgenden Bereichen definierbar sein: lesen, erstellen, bearbeiten, löschen, exportieren, administrieren.

Perspektivisch soll eine Einschränkung auf bestimmte Bienenstände möglich sein.

16. Authentifizierung

Die Software MUSS eine sichere Benutzeranmeldung bereitstellen. Erforderlich: Benutzername/E-Mail + Passwort, sichere Passwortspeicherung, Sessionverwaltung, Passwortzurücksetzung.

SOLL: Zwei-Faktor-Authentifizierung, Passkeys/WebAuthn, OIDC/SSO.

17. Datensicherheit

ApiCore MUSS so aufgebaut sein, dass keine fachlich wichtigen Daten unbemerkt verloren gehen können. Insbesondere erforderlich: Datenbank-Backups, Dateibackups, Wiederherstellbarkeit, Zugriffskontrolle, verschlüsselte Kommunikation, Protokollierung administrativer Änderungen.

18. Datenschutz

Personenbezogene Daten müssen gemäß geltenden Datenschutzanforderungen verwaltet werden können. Erforderlich sind unter anderem: definierte Berechtigungen, Datenexport, Datenlöschung soweit gesetzlich zulässig, Protokollierung relevanter Zugriffe, Datenminimierung.

Betriebliche Dokumentationen dürfen dabei nicht durch das Löschen eines Benutzerkontos zerstört werden.

19. Performance

Für normale Benutzeraktionen soll ApiCore bei üblicher Server- und Netzwerkverbindung eine subjektiv unmittelbare Reaktion ermöglichen. Zielwerte:

• typische API-Anfrage: < 500 ms
• normale Seitenansicht: < 2 Sekunden
• Suche: < 1 Sekunde bei normalen Datenmengen

Große Reports und Exporte dürfen länger dauern.

20. Verfügbarkeit und Betrieb

ApiCore soll für Self-Hosting geeignet sein. Die Anwendung muss containerisiert betrieben werden können und darf keine zwingende Abhängigkeit von proprietären Cloud-Diensten besitzen.

Datenbank, Dateien und Anwendung müssen getrennt gesichert werden können.

21. Anforderungen an die Bedienoberfläche

Die Oberfläche soll modern, übersichtlich, schnell, mobiloptimiert, konsistent und möglichst selbsterklärend sein.

Das System soll Informationen nicht nur in Tabellen darstellen, sondern relevante Zusammenhänge visuell aufbereiten. Besonders häufig verwendete Aktionen müssen mit möglichst wenigen Klicks erreichbar sein.

22. Schnellaktionen

ApiCore SOLL eine zentrale Schnellaktion anbieten. Beispielsweise „+ Neu" mit anschließender Auswahl: Durchsicht, Fütterung, Behandlung, Varroamessung, Aufgabe, Ernte, Volk, Königin.

Auf Smartphones soll diese Funktion permanent leicht erreichbar sein.

23. Automatisierungen

ApiCore SOLL aus vorhandenen Daten automatisch Aktionen ableiten können. Beispiele:

• Durchsicht: Wenn Durchsicht → Königin nicht gesehen → keine Stifte, kann ApiCore vorschlagen: „Kontrolle auf Weisellosigkeit in 3 Tagen."
• Varroa: Wenn ein definierter Schwellenwert überschritten wird: „Behandlung prüfen."
• Fütterung: Wenn der Futterstatus als kritisch markiert wird: Fütterungsaufgabe erstellen.

Die Automatisierungen sollen konfigurierbar sein.

24. Benachrichtigungssystem

Ereignisse sollen unterschiedliche Prioritäten besitzen: Information, Hinweis, Warnung, Kritisch.

Beispiel: „KRITISCH – Volk WH-V-012 – Keine Königin gesehen und keine junge Brut vorhanden."

25. Jahres- und Saisonverwaltung

ApiCore SOLL Daten automatisch nach Imkereijahren beziehungsweise Saisons strukturieren. Dadurch können beispielsweise die Jahre 2026, 2027, 2028 direkt miteinander verglichen werden.

26. Anforderungen nach Priorität

MUSS – MVP

Für eine erste produktiv nutzbare Version sind zwingend erforderlich:

1. Benutzerverwaltung
2. Bienenstände
3. Völker
4. Königinnen
5. Durchsichten
6. Aufgaben
7. Varroamessungen
8. Behandlungen
9. Fütterungen
10. Ernten
11. Honigchargen
12. grundlegende Lagerverwaltung
13. Dashboard
14. Suche und Filter
15. responsive Smartphone-Oberfläche
16. API
17. API-Dokumentation
18. Rollen und Berechtigungen
19. Audit-Log
20. Backupfähigkeit
21. Datenexport

SOLL – Version 1.x

Nach dem MVP sollen folgen: QR-Codes, Abfüllchargen, detailliertes Inventar, Kalender, Benachrichtigungen, umfangreiche Statistiken, Webhooks, Fotoverwaltung, automatische Folgeaufgaben, Königinnenbewertung, Lagerbehälterverwaltung, Produktverwaltung, Importfunktionen.

KANN – spätere Erweiterungen

Langfristig denkbar: vollständig offlinefähige PWA, native Smartphone-App, NFC-Tags, Wetterintegration, Wetterhistorie je Bienenstand, Trachtprognosen, Kartenansicht, KI-Auswertung von Völkerdaten, automatische Anomalieerkennung, Fotoanalyse, Spracherfassung am Bienenstand, automatische Zusammenfassung einer Durchsicht, Sensorintegration, Stockwaagen, Temperatur-/Feuchtesensoren, öffentliche Herkunftsseiten für Honigchargen, Kunden-QR-Code auf Honiggläsern.

27. Wabenhain-Integration

ApiCore soll als zentrale fachliche Datenquelle für Wabenhain dienen. Beispielsweise könnte die Webseite Informationen wie:

GET /api/v1/products
GET /api/v1/honey-batches/{id}
GET /api/v1/public/batches/{lot}
GET /api/v1/harvests

abrufen. Ein QR-Code auf einem Honigglas könnte beispielsweise auf folgende öffentliche Seite führen: wabenhain.com/herkunft/WH-2026-001.

Dort könnten kontrolliert freigegebene Informationen angezeigt werden, z.B.:

Sommerhonig 2026 — Geerntet: August 2026 — Herkunft: Bienenstand Wald — Geschleudert: 12.08.2026 — Wassergehalt: 16,8 % — Charge: WH-2026-001

Damit verbindet ApiCore interne Rückverfolgbarkeit direkt mit der Außendarstellung von Wabenhain.

28. Bewusste Systemgrenzen

ApiCore sollte nicht versuchen, jedes Unternehmenssystem vollständig zu ersetzen. Insbesondere folgende Bereiche können über dedizierte Systeme realisiert und über APIs angebunden werden: vollständige Finanzbuchhaltung, Steuerbuchhaltung, Zahlungsabwicklung, vollständiges CRM, Onlineshop, Versanddienstleister, Newsletterplattform.

ApiCore bleibt dabei das führende System für imkereispezifische Daten. Das verhindert, dass aus einer spezialisierten Imkereiplattform ein schwer wartbares ERP-Monolithsystem entsteht.

29. Fachliche Kernanforderung

Die wichtigste fachliche Eigenschaft von ApiCore ist die Verknüpfung aller Informationen. Es genügt nicht, Daten lediglich isoliert zu speichern. Das System muss Zusammenhänge herstellen können:

Stand → Volk → Königin → Durchsicht → Behandlung → Ernte → Schleuderung → Honigcharge → Lagerbehälter → Abfüllung → Produkt

Damit entsteht über mehrere Jahre eine vollständige digitale Historie der Imkerei.

30. Erfolgskriterien

ApiCore gilt fachlich als erfolgreich, wenn folgende Fragen innerhalb weniger Sekunden beantwortet werden können:

• Völker: Wie viele aktive Völker habe ich? Welche Völker wurden zu lange nicht kontrolliert? Welche Völker sind aktuell auffällig?
• Königinnen: Welche Königin sitzt aktuell in welchem Volk? Welche Königinnen liefern langfristig die besten Ergebnisse?
• Varroa: Welche Völker haben problematische Werte? Wann wurde welches Volk womit behandelt?
• Fütterung: Wie viel wurde Volk 4 dieses Jahr gefüttert?
• Honig: Wie viel Honig hat Standort A dieses Jahr produziert? Von welchen Völkern stammt Charge WH-2026-004?
• Lager: Wie viel verkaufsfertiger Honig ist vorhanden?
• Rückverfolgbarkeit: Aus welcher Ernte stammt dieses konkrete Glas Honig?

Wenn ApiCore diese Zusammenhänge ohne manuelle Recherche beantworten kann, erfüllt es seinen eigentlichen Zweck.

31. Produktvision

Die langfristige Vision lautet: ApiCore wird das digitale Betriebssystem der Imkerei.

Der Imker dokumentiert seine Arbeit nur einmal – möglichst direkt dort, wo sie stattfindet. ApiCore nutzt diese Informationen anschließend automatisch für: Stockkarten, Historien, Erinnerungen, Behandlungsauswertungen, Ertragsstatistiken, Chargennachweise, Lagerbestände, Herkunftsnachweise, Websiteinformationen, Schnittstellen, Berichte.

Damit entsteht nicht nur eine digitale Dokumentation, sondern ein echtes datenbasiertes Managementsystem für die Imkerei.