# 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: ```text 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: ```text 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: ```text 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: ```text 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.