Honigtreu-Lager

Kurzanleitung für alle Mitglieder – Stand Oktober 2026

Am Handy: Seite in diesem Link öffnen → Browser-Menü/Teilen → „Zum Startbildschirm hinzufügen“ – die App startet danach wie eine normale App, ohne Adressleiste.

---

1. Anmelden

• Anmeldung mit Google-Konto oder mit E-Mail/Passwort.
• Nur freigeschaltete Mitglieder kommen rein. Neue Zugänge legt ein Admin unter Verwaltung → Mitglieder an.
• Passwort vergessen? Auf der Anmeldeseite E-Mail-Adresse eintragen und auf „Passwort vergessen?“ klicken – funktioniert für alle mit E-Mail/Passwort registrierten Nutzer (nicht für reine Google-Anmeldungen).

2. Aufbau der App

Oben steht in einer Zeile: der Menü-Knopf ☰ (nur wenn der Bereich Unterseiten hat), der aktuelle Bereich mit Unterseite (z. B. „Lager · Eingang“), dein Kürzel und der Hilfe-Knopf. Unten ist das Hauptmenü:

• Lager: Bestand (oben die Knöpfe „Eingang buchen“ und „Ausgang buchen“), Bestellungen, Umlagerung, Abfüllen, Inventur.
• Etiketten: Unterseiten Honigtreu (Karton-Etiketten, Punkt 15) und Imkerei (eigene Etiketten der Imkereien, Punkt 10).
• Handel: Ankauf, Verkauf LEH, Verkauf Online, Verkauf Direkt, Preise, Vergütungssätze, Vergütungs-Auswertung, Übersicht (Punkt 11).
• Imkerei: der eigene Bestand je Imkerei – Übersicht, Rohware, Glasware, Anlieferung, Inventur, Honigtreu gesamt, Sicherung (Punkt 10).
• Verwaltung: Protokoll, Sicherung, für Admins zusätzlich Warenfluss, Mitglieder und Admin-Anleitung (Punkt 14).

• Unterseiten: Oben links auf ☰ (oder auf den Titel) tippen – die Liste der Unterseiten klappt auf. Am PC stehen sie als Leiste unter der Kopfzeile.
• Mehr Platz: Beim Herunterscrollen verschwinden Kopfzeile und Menüleiste, beim Hochscrollen kommen sie wieder. Während du in ein Feld tippst, ist die Menüleiste ausgeblendet.
• Mein Bereich: Dein Kürzel oben antippen – dort stehen Name, Anmelde-E-Mail, Rolle, die Angaben deiner Imkerei für die Etiketten, deine Standorte aus der Märkte-App sowie Hilfe und Abmelden. Ein kleiner Punkt am Kürzel zeigt Administratoren an.
• Listen zuerst, Erfassen als eigene Seite: Wo es Listen gibt (Bestellungen, Handel, Imkerei), stehen zuerst die bisherigen Einträge. Der Knopf „+ … erfassen“ öffnet die Eingabe als eigene Seite mit „‹ Zurück“; nach dem Speichern schließt sie sich und ein kurzer Hinweis bestätigt das Speichern. Bearbeiten öffnet dieselbe Seite.
• Alle Mitglieder sehen dieselben gemeinsamen Lagerdaten – volle Transparenz in der Genossenschaft.

3. Bestand

• Aktueller Lagerbestand je Sorte, Charge (inkl. MHD) und Lagerort.
• Einheitlich in fünf Abschnitten gegliedert, in dieser Reihenfolge: Gläser 360 g, Gläser 900 g, Rohware (kg), Flaschen (Met, Likör) und Sonstige. Dieselbe Reihenfolge gilt auch bei „Mein Bestand“ und in der Inventur.
• Die Gesamtmenge je Sorte ist deutlich hervorgehoben.
• FEHLBESTAND: Wird mehr entnommen, als eine Charge laut Buchbestand hat (oder eine Charge angegeben, die im Lager nicht geführt wird), geht die Charge nicht ins Minus. Der Überhang wird stattdessen auf die Sondercharge FEHLBESTAND gebucht und hier rot angezeigt.
• Neben jedem negativen Bestand (FEHLBESTAND oder ältere negative Chargen) steht „ausgleichen“: Charge mit Bestand wählen, aus der die Ware tatsächlich stammt, Menge bestätigen – die App bucht einen Ausgang aus dieser Charge und einen Eingang auf den negativen Bestand (Buchungsart „Fehlbestand-Ausgleich“). Im Protokoll lässt sich ein Ausgleich nur als Paar löschen.

4. + Eingang buchen (Anlieferung ins Lager)

• Für Wareneingänge ins Honiglager: Sorte, Charge, Menge, Lagerort und Anlieferer eintragen.
• Mit „+ weitere Charge“ lassen sich zu einer Sorte mehrere Chargen mit jeweils eigener Menge erfassen; „+ weitere Position“ fügt eine weitere Sorte hinzu.
• Bei der Sorte ist die Einheit bereits festgelegt (z. B. Glas 360g, Glas 900g, kg lose Ware, Flasche 0,5l/0,75l, Stück) – auch lose Ware (kg) kann jetzt direkt hier gebucht werden, ohne Umweg über „Abfüllen“.
• Eine Chargennummer im festen Format ist nur bei Gläsern Pflicht; bei kg, Flaschen und Stück ist sie optional und frei wählbar (bei kg entfällt sie ganz).
• PDF-Upload: Lieferschein direkt in dieser Maske hochladen – die Positionen werden per KI vorausgefüllt. Vor dem Speichern immer prüfen und ggf. korrigieren!
• „Anlieferung durch“ zeigt die Imkereien im einheitlichen Format Vorname (Kürzel), z. B. „Christian (CHR)“ – oder „Andere (manuell)“ für externe Anlieferer.

5. – Ausgang buchen (Auslieferung / Entnahme)

• Für Lieferungen an Kunden (z. B. LEH wie Rewe) oder sonstige Entnahmen aus dem Lager.
• Sorte und Charge aus dem vorhandenen Bestand wählen; bei lose Ware (kg) wird stattdessen direkt die verfügbare Menge am gewählten Lagerort angezeigt.
• Mit „+ weitere Charge“ kann eine Sorte aus mehreren Chargen entnommen werden (je Charge eine eigene Menge).
• Übersteigt die Menge den Bestand einer Charge, fragt die App nach; der Überhang wird als FEHLBESTAND gebucht (siehe Bestand).
• „Empfänger“ ist ein freies Textfeld (z. B. Kunde, Handelspartner oder Verwendungszweck). Beim PDF-Upload wird der erkannte Empfänger dort eingetragen und kann überschrieben werden.
• PDF-Upload: Lieferschein direkt in dieser Maske hochladen – die Positionen werden per KI vorausgefüllt. Vor dem Speichern immer prüfen und ggf. korrigieren!

6. Bestellungen

Prognose-Werkzeug für eingehende, noch nicht ausgeführte Bestellungen – getrennt von der eigentlichen Ausgangsbuchung.

• Erfassung genau wie bei „– Ausgang“ (direkt oder per PDF-Upload aus einem Lieferschein/einer Bestellung), aber nur Artikel und Menge – noch ohne Chargennummer, da diese erst beim Ausführen festgelegt wird.
• Jede Bestellung wird einzeln gespeichert (Kunde/Empfänger, gewünschtes Lieferdatum, ein oder mehrere Artikel mit Menge, Bemerkung). „Kunde / Empfänger“ ist ein freies Textfeld; beim PDF-Einlesen wird der erkannte Kunde dort eingetragen und kann überschrieben werden.
• Oben fasst eine Tabelle alle offenen Bestellungen je Artikel zusammen (über alle offenen Bestellungen hinweg): verfügbare Menge, Status, benötigte Menge und die betroffenen Liefertermine. Über die Lager-Auswahl kann die verfügbare Menge wahlweise über alle Lagerorte oder nur für einen einzelnen Lagerort geprüft werden (Standard: alle Lager).
• Jede offene Bestellung hat eine Funktion „Ausführen“: es wird nur noch diese eine Bestellung angezeigt (die übrigen Bestellungen und Abschnitte sind ausgeblendet, bis „Ausführen abbrechen“ geklickt oder gebucht wird). Nach Wahl des Lagerorts zeigt die App je Artikel alle Chargen mit Bestand untereinander (Charge, MHD, Bestand) – rechts daneben das Feld „Entnahme“, auch am Handy im Hochformat sichtbar. Dort wird die tatsächlich entnommene Menge je Charge eingetragen – vorgeschlagen ist die Entnahme nach MHD (älteste zuerst). Eine Summenzeile zeigt, ob die bestellte Menge erreicht ist. Über „+ weitere Charge (manuell)“ lassen sich Chargen ergänzen, die nicht im Buchbestand stehen (wird als FEHLBESTAND gebucht). Beim Buchen entsteht je Charge ein Ausgang, und die Bestellung wird als ausgeführt markiert.
• Wird ein anderer oder zusätzlicher Artikel geliefert: über dem Button „Ausgang jetzt buchen“ auf „+ weiteren Artikel hinzufügen“ tippen, den Artikel aus dem Lagerbestand des gewählten Lagerorts auswählen und je Charge die entnommene Menge eintragen. Das geht beliebig oft. Nicht benötigte bestellte Positionen einfach auf 0 bzw. leer setzen. Zusätzliche Artikel werden mit der Bestellung gebucht (Bemerkung „zusätzlicher Artikel“), in der Historie unter „zusätzlich geliefert“ angezeigt und beim Zurücknehmen der Ausführung mit storniert.
• Ausgeführte Bestellungen erscheinen darunter als Historie. Weicht die tatsächlich entnommene Menge von der bestellten ab (z. B. Position auf 0 gesetzt), steht dort „bestellt 12, geliefert 0“ (rot); stimmt sie überein, nur die Menge. Mit „Ausführung zurücknehmen“ werden alle zugehörigen Ausgangsbuchungen gelöscht und die Bestellung wieder geöffnet. Dasselbe passiert automatisch, wenn im Protokoll eine Buchung einer ausgeführten Bestellung gelöscht wird. Sind die Buchungen bereits weg, erscheint der Hinweis „keine Buchungen mehr im Protokoll“ und der Button „Wieder öffnen“.
• Markt (für die Märkte-App): Beim PDF-Upload liest die App die GLN des Marktes (Kundenbeziehung/Lieferanschrift auf dem Lieferschein). Ist die GLN bei einem Markt der Märkte-App hinterlegt, wird der Markt automatisch gewählt. Sonst schlägt die App passende Märkte vor (Kette, PLZ, Ort, Straße) – nach dem Wählen wird die GLN beim Markt gespeichert, der nächste Lieferschein wird dann automatisch zugeordnet. Ohne PDF lässt sich der Markt über das Suchfeld wählen. Die Lieferung erscheint dann in der Märkte-App beim Markt unter „Lieferungen“ (bestellte Mengen, Lieferdatum, tatsächlich geliefert). Hat der Markt schon eine andere GLN, kommt ein Hinweis; überschrieben wird nichts.
• Lieferschein speichern: Wird beim Anlegen ein PDF hochgeladen, wird es mit der Bestellung gespeichert. In der Bestellung (offen und in der Historie) öffnet „📄 Lieferschein“ das PDF. Fehlt der Lieferschein, lässt er sich über „Lieferschein hinzufügen“ nachreichen (PDF bis 6 MB). Beim Löschen der Bestellung wird der Lieferschein mit gelöscht. Sehen können ihn nur angemeldete Mitglieder.

7. Umlagerung

• Verschiebt Bestand von einem Lagerort zu einem anderen (z. B. Ahrensfelde, Groß Döbbern, Watzkendorf, Messen).
• Bucht automatisch einen Ausgang am alten und einen Eingang am neuen Lagerort.

8. Abfüllen

• Achtung: Betrifft nur Rohware, die bereits an Honigtreu verkauft/angeliefert wurde und im gemeinsamen Lager als lose Kilo-Ware liegt – nicht den eigenen Bestand deiner Imkerei (siehe „Mein Bestand“).
• Lose Ware (kg) im Honigtreu-Lager zu abgefüllten Gläsern verarbeiten.
• Verbrauchte kg-Sorten auswählen, neue Charge/Menge/MHD für die abgefüllten Gläser eintragen.
• Reiner kg-Eingang (z. B. neu angelieferte Fässer) läuft jetzt direkt über „+ Eingang“ (siehe Punkt 4).

9. Inventur

Neuer Reiter für die körperliche Bestandszählung je Lagerort.

• Lagerort auswählen und „Zählung starten“ – die App zeigt alle Sorten/Chargen (und lose Ware in kg) mit aktuellem Buchbestand.
• Tatsächlich gezählte Menge je Position eintragen; Abweichungen werden farbig markiert.
• Nach Bestätigung werden Abweichungen automatisch als Korrekturbuchung im Protokoll erfasst (Bewegungsart „Inventur“) und die Zählung selbst wird als Beleg gespeichert.

10. Imkerei (eigener Bestand)

• Jede Imkerei erfasst hier die eigene Rohware (lose Ware in kg, früher „Ernte/Lager“), Glasware (Abfüllungen in Gläsern, früher „Abfüllung“) und die Anlieferung an die Genossenschaft.
• Lesen dürfen alle Mitglieder alles (Transparenz); buchen kann jedes Mitglied nur für die eigene Imkerei (Kürzel).
• Oben die Imkerei wählen. Start ist die Übersicht: Rohware (kg mit Rest), Glasware (Gläser je Größe), Anlieferungen und letzte Inventur, jeweils mit Knopf zum Erfassen. Antippen einer Kachel öffnet die Liste.
• Erfassen als eigene Seite: Auf den Seiten Rohware, Glasware und Anlieferung steht zuerst die Liste der bisherigen Einträge. „+ … erfassen“ öffnet die Eingabe als eigene Seite mit „‹ Zurück“ (ebenso Bearbeiten). Nach dem Speichern schließt sie sich und die Liste ist wieder da. Dasselbe gilt bei Bestellungen und im Handel.
• Rohware: Solange aus einem Posten noch nicht abgefüllt wurde, wird „noch kg“ automatisch berechnet; danach bitte über das Stift-Symbol den tatsächlichen Rest im Fass/Eimer eintragen. Eine Korrektur auf 0 kg nimmt den Posten aus der Liste.
• In allen Listen steht die Menge direkt hinter der Sorte, Standort und Charge stehen hinten.
• Bei Rohware und Glasware lassen sich mit „+ weitere Position“ mehrere Posten in einem Schritt erfassen. Je Position gibt es das Feld „davon für Honigtreu verfügbar“ (Rohware in kg, Glasware in Gläsern). Ist der Wert größer als die Menge des Postens, erscheint direkt am Feld ein roter Hinweis; beim Speichern wird nichts gespeichert, sondern eine Fehlermeldung angezeigt – der Wert kann dann korrigiert und erneut gespeichert werden.
• Erfasste Rohware-Posten lassen sich über das Stift-Symbol (✎/🖉) vollständig bearbeiten, nicht nur löschen – einschließlich „davon für Honigtreu verfügbar“.
• Die Listen bei Rohware und Glasware zeigen zusätzlich die Spalte „Verfügbar für Honigtreu“ je Position; bei Glasware lässt sich dieser Wert (verfügbare Gläser) dort auch direkt über das Stift-Symbol eintragen oder ändern – höchstens bis zum aktuellen Bestand der Abfüllung.
• Die Liste bei Glasware ist nach Glasgröße in Abschnitte gegliedert (Gläser 360 g, Gläser 900 g, Sonstige) – dieselbe Kategorien-Reihenfolge wie beim Lagerbestand (siehe Punkt 3).
• Reiter Inventur: eigenen Lagerbestand (lose kg) und eigene Abfüllungen (Gläser) zählen; Abweichungen zum Buchbestand werden übernommen. Zusätzlich lässt sich hier je Position eintragen, wie viel aktuell für Honigtreu verfügbar ist – höchstens die gezählte Menge.
• Bei Anlieferung an Honigtreu lässt sich für Gläser statt einer erfassten Abfüllung auch „Sonstige Gläser (ohne Charge/Abfüllung)“ wählen – dann werden Sorte und Anzahl direkt eingetragen, eine Chargennummer ist dabei optional.
• Unterseite Honigtreu gesamt (ohne Imkerei-Auswahl): imkerei-übergreifende Übersicht über die gemeldeten, für Honigtreu verfügbaren Bestände aller Imkereien, sortiert nach Imkerei – mit eigenen Spalten für Rohware (kg), Gläser 360 g und Gläser 900 g; die Detailansicht je Imkerei ist ebenfalls in diese Kategorien gegliedert.
• Bearbeiten-Formulare und Lösch-Symbole werden nur bei der eigenen Imkerei angezeigt (Admins sehen sie überall); alle anderen Imkereien erscheinen nur zur Ansicht.
• Imkerei-Namen werden kompakt angezeigt: Vorname und Kürzel in Klammern, z. B. „Christian (CHR)“.
• Reiter Sicherung (nach Auswahl der Imkerei): lädt den kompletten Bestand der ausgewählten Imkerei – Rohware, Glasware, Anlieferung, Korrekturen und Inventuren – als Excel-Datei oder als PDF-Bericht herunter.
• Eigene Etiketten der Imkerei druckst du im Menü Etiketten → Imkerei: Etiketten für Kartons und Rohware in den eigenen Lagern (80 × 50 mm). Gebinde: Karton (6, 12 oder 30 Gläser à 360 g / 900 g), Eimer (10 / 12,5 / 25 / 40 kg oder andere Größe), Fass (Größe frei). Einzelne Gläser werden nicht etikettiert. Dazu frei: Sorte, Standort (optional), Ernte-/Schleuderdatum, Wassergehalt. Kein MHD.
• Karton: Rahmen oben rechts wie beim Honigtreu-Karton (z. B. „6 Gläser à 360 g je Karton“); das Gewicht brutto je Karton wird automatisch aus der GS1-Liste berechnet (Anzahl × Glas brutto: 360 g = 540 g, 900 g = 1.200 g; z. B. 6er = 3,24 kg, 30er = 16,2 kg) und ist nicht änderbar; dazu Charge/Lager-Nr. und optional eine EAN (dann Strichcode am Rand; Anschrift, Telefon und E-Mail werden dann so auf die Zeilen verteilt, dass nichts in den Strichcode läuft). Fortlaufend nummerieren: Haken setzen, „Nr. von“ und „Nr. bis“ eingeben – die Nummer wird an Charge/Lager-Nr. angehängt (z. B. GR- + 001 bis 012 ergibt GR-001 … GR-012).
• Eimer und Fass: Anzahl Gebinde und erste Nummer (Charge/Lager-Nr., frei, z. B. GR-26-001) eingeben – die Zahl am Ende wird je Gebinde fortlaufend hochgezählt (GR-26-001, GR-26-002, …). Für jedes Gebinde erscheinen Felder für das Gewicht netto in kg (nur Honig, ohne Eimer bzw. Fass) und den gemessenen Wassergehalt in % (optional). Auf dem Etikett steht das Gewicht netto oben rechts im Rahmen, die Gebindegröße (z. B. „Eimer 25 kg“) unter „Gebinde“. Beispiel: 10 Eimer à 25 kg → Anzahl 10, erste Nr. eingeben, 10 Gewichte und Wassergehalte eintragen → 10 Etiketten.
• Aus Bestand übernehmen: ein Rohware-Posten füllt Eimer/Fass, Größe, Sorte, Lager-Nr. als erste Nummer, Anzahl Gebinde (Menge ÷ Gebindegröße), Standort, Wassergehalt und Datum vor; ein Glasware-Posten füllt einen Karton (Glasgröße, Sorte, Charge, Standort) vor – alles bleibt änderbar.
• Stammdaten für Etiketten (Name der Imkerei, Straße, PLZ, Ort, Telefon, E-Mail, Logo) pflegt jede Imkerei selbst (Admins für alle). Vorbelegt mit bekannten Daten (Anschrift aus dem Wohnort der Märkte-App). Ohne Logo steht oben links der Name der Imkerei. Bioland und DE-ÖKO-006 stehen fest auf dem Etikett.
• Druck auf dem Etikettendrucker im Lager (80 × 50 mm) oder als A4-Bogen (2 × 5 Etiketten zum Ausschneiden bzw. auf A4-Etikettenpapier) mit jedem normalen Drucker. Die Etiketten jeder Imkerei lassen sich unter Etiketten → Imkerei drucken – auch offline.

11. Handel

• Ankauf: Honigeinkauf von Mitglieds-Imkereien, jetzt mit derselben Einheiten-Auswahl (Glas 360g/900g, kg, Flasche, Stück) wie bei Eingang/Ausgang. PDF-Upload: Einkaufsrechnung hochladen – Positionen werden per KI vorausgefüllt.
• Verkauf LEH: Verkauf an den Lebensmitteleinzelhandel. PDF-Upload: Verkaufsrechnung hochladen – Positionen werden per KI vorausgefüllt. Über die GLN auf der Rechnung wird der Markt zugeordnet (wie bei Bestellungen, Kunde/Kanal wird passend gesetzt); der Umsatz erscheint dann in der Märkte-App beim Markt unter „Umsatz“ – sichtbar für alle Mitglieder.
• Verkauf Online (inkl. Shopify-CSV-Import) und Verkauf Direkt (z. B. Messen) – ohne PDF-Upload. Beim CSV-Import werden zwei Shopify-Exportformate automatisch erkannt: der Bestellungen-Export (Shopify: Bestellungen → Exportieren) mit echtem Datum je Bestellposition – empfohlen, keine Differenzbildung nötig, ein erneuter Import ersetzt automatisch nur die zuvor importierten Datensätze im Datumsbereich der Datei; sowie alternativ der ältere Analytics-Export „Bestellungen und stornierte Menge nach Produkt“ (Year-to-Date, ohne Einzeldatum) – hier ermittelt die App die Differenz zum zuletzt importierten Stand je Sorte (am besten regelmäßig, z. B. monatlich, importieren).
• Preise und Vergütungssätze: Grundlage für die Vergütungsberechnung je Imkerei – beide Listen lassen sich jetzt direkt bearbeiten, nicht nur löschen.
• Vergütungs-Auswertung und Übersicht je Sorte: Umsätze und Mengen über alle Vertriebswege, je Artikel zusammengefasst (Rohware-Ankauf und Gläser 360g/900g einer Sorte in einer Zeile), mit frei wählbarem Zeitraum (von/bis oder Presets wie aktueller Monat/aktuelles Jahr/Vorjahr) sowie Summenzeile für alle €-Beträge. In der Übersicht je Sorte lässt sich zusätzlich per Häkchen „Vergleich mit Vorzeitraum anzeigen“ ein Vergleich mit dem unmittelbar vorangehenden Zeitraum gleicher Länge einblenden (z. B. Vorjahr bei Preset „Dieses Jahr“) – mit prozentualer Veränderung (grün = Zuwachs, rot = Rückgang), sowohl als Gesamtsumme als auch je Artikel. Die Übersicht je Sorte ist außerdem wie der Lagerbestand in Abschnitte gegliedert (Gläser 360 g, Gläser 900 g, Rohware (kg), Flaschen, Sonstige, siehe Punkt 3) – mit einer zusätzlichen Gruppe Bundles für Honig-Abos (3/6/12 Monate) und Bundles/Pakete (mehrere Gläser zusammengefasst) – und lässt sich als Excel-Datei (je Gruppe ein Tabellenblatt) oder als PDF-Bericht herunterladen.

Bei allen PDF-Uploads (Eingang, Ausgang, Bestellungen, Ankauf, Verkauf LEH) gilt: Datei hochladen, „Analysieren“ klicken, den ausgefüllten Vorschlag sorgfältig prüfen/korrigieren, erst dann speichern.

Neue Einträge, Änderungen und Uploads (PDF-Rechnungen, Shopify-CSV) im gesamten Bereich Handel sind auf Administratoren beschränkt. Alle Mitglieder können die Listen und Auswertungen weiterhin einsehen.

12. Protokoll

• Vollständiges Bewegungsprotokoll aller Ein- und Ausgänge, inkl. Umlagerungen, Abfüllungen und Inventur-Korrekturen.
• Filterbar nach Lagerort, Sorte, Typ, Zeitraum (auch Schnellauswahl wie „Dieser Monat“) und Volltextsuche.
• Angezeigt werden zuerst die neuesten 200 Buchungen; darunter „Weitere 200 anzeigen“ bzw. „Alle anzeigen“. Filter und Export berücksichtigen immer alle Buchungen.
• Export als CSV, Excel oder PDF-Bericht.

13. Sicherung

• Lädt eine vollständige Excel-Sicherung aller Daten herunter (Bestand, Bewegungen, Handel, Imkerei-Bestand, Bestellungen, Inventuren).
• Empfehlung: regelmäßig (z. B. monatlich) herunterladen und sicher ablegen.

14. Warenfluss (nur Admins)

• Reine Mengen-Gegenüberstellung ohne Preise: a) Summe der Wareneingänge im Lager gegen Summe der Ankäufe, b) Summe der Warenausgänge im Lager gegen Summe der Verkäufe (LEH, Online, Direkt) – je Einheit-Gruppe sowie zusätzlich je Artikel.
• Lager und Handel werden bewusst getrennt geführt (Lager: freier Zugriff, Anlieferungen/Entnahmen per Direkteingabe oder Lieferschein, nur Gläser und Rohware; Handel: alle finanziell relevanten Ankäufe/Verkäufe, admin-geführt, inkl. Waren, die gar nicht im Lager erfasst werden, z. B. Cremes). Verglichen werden daher nur die beiden Gruppen, die es in beiden Bereichen gibt: Gläser (360 g/900 g) und Rohware (kg). Flaschen und Sonstige (nur in Handel geführt) tauchen hier bewusst nicht auf.
• Dies ist ein Plausibilitätsvergleich, kein exakter Soll-Ist-Abgleich: eine kleinere Differenz ist normal, eine große und dauerhafte Differenz kann auf eine fehlende oder doppelte Buchung hindeuten.
• Nur normale Ein-/Ausgangsbuchungen zählen als externe Warenbewegung; Umlagerungen, Abfüllen und Inventur-Korrekturen sind interne Umbuchungen und bleiben unberücksichtigt.
• Die Differenz wird farbig hervorgehoben (grün = positiv/mehr gebucht als ein-/verkauft, rot = negativ).
• Zeitraum frei wählbar (von/bis oder Presets) wie bei Bestand/Übersicht, mit optionalem Vergleich zum Vorzeitraum/Vorjahr.
• Download als Excel-Datei (je Gruppe ein Tabellenblatt) oder als PDF-Bericht.

---

15. Etiketten (Karton-Etiketten drucken)

• Menü Etiketten → Honigtreu: Artikel wählen (alle Gläser, mit Glasgröße 360 g / 900 g), Kartongröße wählen, Charge eingeben – bekannte Chargen aus den Eingängen werden vorgeschlagen, das MHD wird aus der Charge übernommen (änderbar).
• Gläser gesamt (optional) rechnet die Zahl der vollen Kartons aus und setzt die Anzahl Etiketten; die Anzahl lässt sich auch direkt eingeben. Als Sortenname wird der Artikelname ohne Glasgröße vorgeschlagen (z. B. „Robinienhonig“); er ist änderbar.
• Strichcode und Artikelnummer kommen automatisch: 30er Karton = Glas-EAN, 6er Karton = Karton-EAN. Ist für eine Kartongröße noch keine Karton-EAN hinterlegt (z. B. 900-g-Kartons), steht vorerst die Glas-EAN im Strichcode – mit Hinweis.
• Drucken: Knopf „Etiketten drucken“, im Druckdialog Drucker Etexco/Rongta, Papierformat „Honigtreu 80x50“, Ränder Keine, Skalieren Standard (100 %), Kopf- und Fußzeilen aus. Etikett 80 × 50 mm.
• Karton-Nummer (nur 30er Karton): Jedes 30er Etikett bekommt groß oben rechts im Rahmen eine fortlaufende Nummer, z. B. 26-005 (Jahr zweistellig + laufende Nummer). Gezählt wird über alle Sorten, Chargen und Drucker hinweg; jedes Jahr beginnt wieder bei 001. Gezählt wird erst nach dem Druck: Nach dem Druckdialog fragt die App „Wurden die Etiketten … gedruckt?“ – nur bei „Ja“ werden die Nummern gezählt; bei „Nein“ (Druck abgebrochen, Anzahl geändert) bleiben sie frei. Bis zur Antwort sind weitere 30er gesperrt; die Frage bleibt auch nach einem Neustart stehen. Über dem Druckknopf stehen der aktuelle Stand („zuletzt vergeben“), die Nummern dieses Drucks und die letzten 5 Drucke mit Knopf „Nachdruck“: druckt den ganzen Druck mit denselben Nummern noch einmal oder – über die Auswahl daneben – nur eine einzelne Nummer (z. B. bei beschädigtem Etikett); zählt nicht weiter. Mit dem Jahreswechsel beginnt die Zählung automatisch mit der neuen Jahreszahl wieder bei 001 (z. B. 27-001).
• Karton-Nummer ohne Internet (Lager-PC): Die Nummern werden auf dem Gerät ab dem zuletzt bekannten Stand vergeben; bei der Frage nach dem Druck steht der Hinweis, dass sie danach über eine Online-Verbindung synchronisiert werden müssen. Beim nächsten Start der App mit Internet werden sie automatisch nachgetragen. Wurde das versäumt, sind nach einem Neustart ohne Internet keine 30er Etiketten mehr möglich, bis einmal mit Internet verbunden wurde (6er und Imkerei-Etiketten gehen weiter). Wurde eine Nummer doppelt vergeben (z. B. offline im Lager und gleichzeitig online an einem anderen Gerät), erscheint ein roter Hinweis mit beiden Kartons – Kartons prüfen, ggf. neu etikettieren, dann „Geprüft“.
• Kartongrößen und EAN je Artikel pflegen nur Admins (Bereich unter der Vorschau). Prüfziffern werden geprüft.
• Abgleich mit der GS1-Liste (Admins): Knopf „GS1-Liste: alle Artikel prüfen / abgleichen“. Die Tabelle zeigt je Artikel die zugeordnete GS1-Sorte, Glas-EAN und Kartons bisher und danach; Abweichungen sind rot. Ohne Haken bei „Abweichende EANs ersetzen“ werden nur fehlende Werte ergänzt (auch leere Karton-EANs), mit Haken werden abweichende Glas- und Karton-EANs durch die GS1-Werte ersetzt. Nur passende Zeilen angehakt lassen, dann „Angehakte übernehmen“. Artikel ohne Zuordnung stehen darunter und werden von Hand gepflegt. Die GS1-Werte sind in der App hinterlegt (Stand der Excel-Liste WaWi\EAN-Codes vom 02.10.2026); ändert sich die Excel-Liste, muss die App angepasst werden.
• Über den Titel umschalten zwischen Honigtreu (Karton-Etiketten) und Imkerei (eigene Etiketten der Imkereien, siehe Punkt 10).
• Ohne Internet geht nur der Etikettendruck: beim Start ohne Verbindung erscheint „Keine Internetverbindung“ mit dem Knopf „Nur Etiketten drucken (offline)“. Gedruckt wird mit der Artikelliste vom letzten Start mit Internet (geht erst, nachdem die App auf dem Gerät einmal mit Internet geöffnet wurde).

Chargennummer – Aufbau und Beispiel

Gilt für Gläser (bei anderen Einheiten optional/frei). Die Chargennummer setzt sich aus drei Teilen zusammen:

• 2 Ziffern: Nummer der Imkerei (siehe Tabelle unten).
• 6 Ziffern: Datum der Abfüllung im Format JJMMTT (Jahr/Monat/Tag, je zweistellig).
• Danach ein Schrägstrich „/“, gefolgt von 4 Ziffern: Mindesthaltbarkeitsdatum (MHD) im Format JJJJ (nur das Jahr).

Nr.	Kürzel	Name	Imkerei
01	GES	Gesine Conrad	Bienenklang
02	JOE	Jörg Weigelt	Weigelt
03	CHR	Christian Grune	Grune
04	KAR	Karsten Kalita	Pollenräuber
05	CWE	Christian Wendt	Wendt
06	UWE	Uwe Kabath	Biogemüse Watzkendorf
07	OLI	Oliver Devrient	Devrient
98	EXL	Lieferant extern	–
99	EXI	Imkerei extern	–
00	HTR	Honigtreu allgemein	–

Gut zu wissen

• Internet ist Pflicht für alles, was den Lagerbestand betrifft (Buchungen, Bestellungen, Inventur, Imkerei-Bestand, Handel) – sonst würden Geräte mit unterschiedlichem Stand arbeiten. Ohne Verbindung beim Start: Hinweis „Keine Internetverbindung“ – Hotspot (Handy) oder WLAN verbinden und „Erneut prüfen“ tippen. Bricht die Verbindung während der Arbeit ab, erscheint oben ein roter Balken und Speichern ist gesperrt, bis die Verbindung wieder steht. Nur Etiketten können weiter gedruckt werden.
• Änderungen werden sofort für alle sichtbar (Live-Synchronisierung) – kein manuelles Neuladen nötig.
• Neue App-Version: Die App aktualisiert sich selbst. Wird eine neue Version veröffentlicht, lädt sie sich beim nächsten Zurückholen aus dem Hintergrund neu (spätestens nach 30 Minuten wird nachgesehen); die Anmeldung bleibt erhalten, die App beginnt danach auf der Startansicht. Sind gerade ungespeicherte Eingaben offen, eine Bestellung in Ausführung oder Änderungen noch nicht übertragen, erscheint stattdessen unten „Neue Version der App verfügbar“ mit „Jetzt aktualisieren“ – erst speichern, dann tippen.
• Zurück-Taste / Zurück-Geste am Handy: schließt nicht die App, sondern geht in der App einen Schritt zurück – zuerst wird ein offenes Fenster (z. B. diese Hilfe) geschlossen bzw. „Bestellung ausführen“ abgebrochen, danach geht es zum vorher angezeigten Bereich/Reiter. Auf der Startansicht fragt die App „Echt jetzt? Soll die App wirklich geschlossen werden?“ – „Weiterarbeiten“ lässt sie offen, „App schließen“ oder noch einmal Zurück schließt sie sofort, ohne weitere Rückfrage. Sind in einem Formular noch ungespeicherte Eingaben, fragt die App vorher „Zurück und Eingaben verwerfen?“ – „Weiter bearbeiten“ bleibt im Formular, „Verwerfen“ geht zurück. (Die Rückfrage gilt nur für die Zurück-Taste, nicht beim Antippen eines anderen Reiters.)
• Diese Anleitung ist jederzeit über den „Hilfe“-Button in der App abrufbar.
• Bei Fragen, Problemen oder für neue Mitgliedszugänge: an Christian wenden.

Admin-Anleitung: Wartung, Notfall & Übergabe

Nur für Admins – Stand Oktober 2026. Dieselbe Anleitung liegt als PDF im Ordner WaWi\Hilfe (automatisch aus diesem Text erzeugt) und dient auch als Übergabedokument für Nachfolger.

1. Worum es geht

Die Lagerverwaltung ist die Web-App der Honigtreu eG für Lagerbestände je Sorte, Charge und Lagerort, Ein-/Ausgänge, Umlagerung, Abfüllen, Inventur, Bestellungen, „Mein Bestand“ der Imkereien und (nur Admins) den Bereich Handel.

Die App läuft komplett online bei Google Firebase. Es gibt keinen eigenen Server und keinen Build-Schritt: Die ganze App ist eine einzige Datei index.html (HTML, CSS, JavaScript ohne Framework).

Teil	Wo	Wofür
App (Hosting)	https://lager.honigtreu.de (bisher und weiterhin: https://honigtreu-lagerverwaltung.web.app)	Aufruf durch alle Mitglieder, auch am Handy (als App installierbar)
Datenbank (Firestore)	Firebase-Projekt honigtreu-lagerverwaltung	Alle Daten: Bestände, Buchungen, Bestellungen, Handel, Mitglieder
Anmeldung (Auth)	dasselbe Firebase-Projekt	Login per Google-Konto oder E-Mail/Passwort
KI-Belegerkennung	Cloud Function sampleJson, Region europe-west3	Liest hochgeladene Lieferscheine/Rechnungen (PDF) über die Anthropic-API aus
Quellcode	Ordner WaWi (bisher OneDrive von Christian)	Hier wird geändert; per firebase deploy hochgeladen
Firebase-Werkzeug (CLI)	auf dem Rechner des Admins (Node.js/npm)	Offizielles, kostenloses Programm von Google (firebase-tools). CLI = „Command Line Interface“, ein Programm ohne Fenster, das über eingetippte Befehle bedient wird (Eingabeaufforderung oder PowerShell). Nur zum Hochladen; Update-Hinweise betreffen nur das Werkzeug, nicht die App

2. Zugänge

• Firebase-Konsole: console.firebase.google.com/project/honigtreu-lagerverwaltung – Login mit einem Google-Konto, das als Projektmitglied eingetragen ist (Zahnrad → Nutzer und Berechtigungen; Rolle „Inhaber“ für volle Verantwortung, „Bearbeiter“ für reine Wartung). Das ist unabhängig von der Mitgliederliste der App.
• Rollen in der App: Button „Mitglieder“ → Spalte „Rolle“ direkt umstellen (wird sofort gespeichert, auch bei bestehenden Zugängen). Administrator = Mitglied mit vollem Zugriff; Mitglied = normaler Zugang; Mitglied inaktiv = darf sich anmelden und lesen, erscheint aber in keiner Auswahlliste (Imkerei-Auswahl, Märkte-Zuordnung, Touren, Übersichten) und ist kein Markt-Admin mehr; Externer Administrator = kein Mitglied (z. B. Dienstleister), voller Zugriff auf Apps, Einstellungen und Daten, aber keine Zuordnung zu Aufgaben und keine Anzeige in Auswahlmenüs. Technisch: Feld rolle (admin, mitglied, inaktiv, extern) plus admin: true/false, auf das die Sicherheitsregeln prüfen. Sich selbst kann ein Administrator die Rechte nicht entziehen.
• Abrechnung: Die Cloud Function setzt den Firebase-Tarif „Blaze“ (nutzungsabhängig, Zahlungsart hinterlegt) voraus. Bei Übergabe in der Google-Cloud-Konsole unter „Abrechnung“ klären, wessen Zahlungsmittel hinterlegt ist.
• Anthropic-Konto (console.anthropic.com) für die KI-Belegerkennung. Der API-Key liegt verschlüsselt als Secret ANTHROPIC_API_KEY bei Google. Neuen Key hinterlegen: firebase functions:secrets:set ANTHROPIC_API_KEY, danach firebase deploy --only functions.
• serviceAccountKey.json ist ein Generalschlüssel mit vollem Datenbankzugriff ohne Anmeldung. Nie kopieren, mailen oder weitergeben. Bei Bedarf selbst erzeugen (Projekteinstellungen → Dienstkonten → „Neuen privaten Schlüssel generieren“). Aufbewahrt wird er nur im Ordner WaWi/Vertraulich/, nie im Ordner firebase/public.

3. Arbeitsplatz einrichten (einmalig)

• Node.js (LTS) installieren: nodejs.org.
• Firebase-Werkzeug installieren und anmelden: npm install -g firebase-tools, dann firebase login.
• In den Ordner WaWi\firebase wechseln und mit firebase projects:list prüfen, ob honigtreu-lagerverwaltung erscheint (Zuordnung steht in .firebaserc).
• Für die Hilfe-PDFs: Python 3 und pip install reportlab.
• Warnungen beim Update des Werkzeugs („deprecated“, „funding“, „install-scripts“) sind harmlos. Für die Install-Skripte einmalig: npm install -g --allow-scripts=protobufjs,re2 firebase-tools.

4. Ordnerstruktur

Datei / Ordner	Inhalt
firebase/public/index.html	Die komplette App, inkl. Hilfe (help-panel) und dieser Admin-Anleitung (admin-help-panel)
firebase/firestore.rules	Zugriffsregeln der Datenbank
firebase/firebase.json, .firebaserc	Konfiguration des Werkzeugs. "public": "public" – veröffentlicht wird nur der Ordner firebase/public
firebase/public/sw.js, manifest.json, icons/	Installierbarkeit am Handy; sw.js lädt App-Seite und Hilfe-PDF zuerst aus dem Netz
firebase/public/hilfe/kurzanleitung.pdf	Kurzanleitung für Mitglieder (aus der Hilfe erzeugt)
firebase/functions/	Cloud Function für die KI-Belegerkennung (Node 22)
firebase/migrate*.js, verify-*.js, package.json, node_modules/	Einmalige Migrationsskripte der Datenübernahme (erledigt; für den Betrieb nicht nötig, können entfernt werden – functions/node_modules dagegen bleibt)
firebase/README.md	Einrichtungsanleitung für einen Neuaufbau von null
firebase-maerkte/public/	Märkte-App (Adresse maerkte.honigtreu.de, bisher honigtreu-maerkte.web.app), gleiche Regeln: nur public wird veröffentlicht
Werkzeuge/deploy_pruefung.js	Läuft automatisch vor jedem Hosting-Deploy (beide Apps) und bricht ab, wenn im Ordner public etwas anderes liegt als index.html, sw.js, manifest.json, icons/*.png, hilfe/kurzanleitung.pdf
Vertraulich/	Schlüssel und Rohdaten (serviceAccountKey.json, migration-data.zip) – nie veröffentlichen, nie weitergeben
Werkzeuge/hilfe_dokumente_erzeugen.py	Erzeugt beide Hilfe-PDFs (Kurzanleitung und Admin-Anleitung) aus index.html
Sicherung/	Frühere App-Stände und Excel-Sicherungen
Hilfe/	Kurzanleitung für Mitglieder und diese Admin-Anleitung als PDF (nicht öffentlich)

Seit 30.09.2026 wird nur noch der Unterordner public veröffentlicht (vorher der ganze Ordner firebase – dabei waren u. a. serviceAccountKey.json und migration-data.zip öffentlich abrufbar). In public gehören ausschließlich die App-Dateien; Werkzeuge, Skripte, Schlüssel, Daten und Dokumente nie dort ablegen. Die Prüfung Werkzeuge/deploy_pruefung.js verhindert einen Deploy, falls doch. Welche Dateien zuletzt hochgeladen wurden, steht in firebase/.firebase/hosting..cache.

5. Änderungen durchführen

• Vorher die aktuelle index.html nach Sicherung/ kopieren (Dateiname mit Datum).
• Änderung in firebase/public/index.html vornehmen und testen.
• Bei jeder Änderung Hilfe (help-panel) und, falls Aufbau, Zugänge oder Abläufe betroffen sind, diese Admin-Anleitung (admin-help-panel) in index.html anpassen. Danach im Ordner WaWi ausführen: python Werkzeuge/hilfe_dokumente_erzeugen.py – das erzeugt im Ordner Hilfe/ die Kurzanleitung und die Admin-Anleitung als PDF und legt zusätzlich eine Kopie der Kurzanleitung nach firebase/public/hilfe/kurzanleitung.pdf (die in der App verlinkte, öffentliche Version). Die PDFs nie direkt bearbeiten, sondern immer diesen Text.
• Veröffentlichen (Abschnitt 6), App ein- bis zweimal neu laden und prüfen.
• Änderung im Änderungsprotokoll dokumentieren (webapp-stand-kontext.md im Claude-Projekt „Honigtreu Lagerverwaltung“).

6. Veröffentlichen (Deploy)

Alle Befehle im Ordner WaWi\firebase ausführen. Vor jedem Hosting-Deploy prüft Werkzeuge/deploy_pruefung.js automatisch den Ordner public (braucht Node.js); meldet sie „Deploy abgebrochen“, die genannten Dateien aus public entfernen.

Befehl	Wann
firebase deploy --only hosting	Nach Änderungen an index.html, sw.js, Hilfe-PDF (Normalfall)
firebase deploy --only firestore:rules	Nach Änderungen an firestore.rules
firebase deploy --only storage,functions	Nach Änderungen an storage.rules bzw. der Funktion dateiHolen (Dateiablage für Lieferscheine und Fotos). Beim ersten Mal fragt die CLI, ob Storage auf Firestore zugreifen darf (für die Mitgliederprüfung) – mit Y bestätigen.
firebase deploy --only functions	Nach Änderungen im Ordner functions oder neuem API-Key
firebase deploy	Alles zusammen
firebase login --reauth	Wenn die Anmeldung abgelaufen ist
npx firebase-tools deploy --only hosting	Wenn „firebase“ nicht gefunden wird

Was beim Deploy passiert: Die Firebase CLI prüft zuerst mit deploy_pruefung.js, ob in public nur erlaubte Dateien liegen. Dann vergleicht sie die Dateien mit dem, was online ist, und lädt nur die geänderten zu Google Firebase Hosting hoch; bei firestore:rules werden die Sicherheitsregeln übertragen. Nach wenigen Sekunden ist die neue Version unter der App-Adresse für alle erreichbar. Geöffnete Apps laden sich beim nächsten Zurückholen aus dem Hintergrund bzw. spätestens nach 30 Minuten selbst neu (Abfrage des ETag von index.html, gemeinsamer Kern createAutoUpdate in beiden Apps); bei ungespeicherten Eingaben erscheint nur ein Hinweis. Fenster mit einer alten Version ohne diese Funktion lädt der Service Worker (sw.js, beide Apps) neu: Bei jeder neuen sw.js fragt er alle offenen Fenster per Nachricht ab; wer nicht als aktuelle Version antwortet, wird neu geladen, sobald er im Hintergrund ist (spätestens nach rund 24 Stunden, wenn der Browser die neue sw.js holt). Damit der Browser keine alte Kopie aus seinem Zwischenspeicher nimmt, setzt firebase.json für alle Dateien Cache-Control: no-cache (Prüfung per ETag, unverändert = kein erneuter Download). Die Daten in der Datenbank werden dabei nicht verändert. Welche Dateien hochgeladen wurden, steht danach in firebase/.firebase/hosting.cHVibGlj.cache.

Warum kein Passwort abgefragt wird: Bei firebase login meldet man sich einmal im Browser mit dem Google-Konto an. Die CLI speichert daraufhin einen Anmeldeschlüssel im Windows-Benutzerprofil (nicht im Ordner WaWi) und meldet sich damit bei jedem Deploy selbst an – ähnlich wie „angemeldet bleiben“ im Browser. Folgen:

• Wer an diesem Windows-Konto sitzt, kann deployen – Rechner mit Passwort/PIN sperren, beim Google-Konto die Zwei-Faktor-Anmeldung einschalten.
• firebase logout meldet ab (danach wieder firebase login); abgelaufene Anmeldung: firebase login --reauth.
• Auf jedem weiteren Rechner einmalig Node.js, npm install -g firebase-tools und firebase login (Abschnitt 3). Das Google-Passwort wird nur im Google-Anmeldefenster eingegeben, nie in der Kommandozeile.

Alternativen: In der Firebase-Konsole lassen sich für Hosting keine Dateien hochladen (nur Versionen ansehen und zurückholen); die Sicherheitsregeln kann man dort aber von Hand einfügen und veröffentlichen. Ein automatischer Deploy über GitHub wäre möglich, braucht aber mehr Einrichtung und einen dort hinterlegten Schlüssel – für Honigtreu nicht nötig. Zugangsdaten zum Firebase-Projekt nie an Dritte oder an eine KI weitergeben; der Deploy bleibt beim Admin.

Zurück auf einen früheren Stand: Datei aus Sicherung/ als firebase/public/index.html einsetzen und erneut deployen – oder in der Firebase-Konsole unter Hosting → Versionsverlauf eine frühere Version wiederherstellen.

7. Technischer Aufbau in Kürze

• Rahmen (beide Apps, gemeinsamer Kern createRahmen + CSS-Block „Rahmen“, in beiden Dateien identisch halten): Kopfzeile: Menü-Knopf #hdr-menue (☰, nur am Handy und nur mit Unterseiten), #hdr-titel zeigt „Bereich · Unterseite“; kein Logo in der Kopfzeile; die Unterseiten sind das Element mit Klasse subnav-quelle im Inhaltsbereich (Lager: .group-subnav, #handel-subnav, #mb-subnav, #etk-modus; Märkte: Verwaltungs-Chips) – am Handy als aufklappende Liste, ab 900 px als Leiste. Hauptmenü unten (Lager: #tabs mit data-group, Märkte: #bottom-nav). Kopfzeile/Leiste werden beim Herunterscrollen ausgeblendet (body.rahmen-weg), die Leiste beim Tippen am Handy (body.tippt). Kürzel #user-badge öffnet „Mein Bereich“ (Reiter profil); Abmelden nur dort (window.APP_LOGOUT).
• Eingabeseiten (nur Lager-App): Abschnitte mit data-eingabe-seite="schlüssel" (Imkerei Rohware/Glasware/Anlieferung, Neue Bestellung, Handel Ankauf/Verkauf/Direkt/Preise/Vergütung) werden von eingabeSeitenEinrichten() versteckt und über einen Knopf „+ … erfassen“ als Vollbild-Seite geöffnet (section.es-offen, state.esOffen). Überschrift mit „bearbeiten“ öffnet automatisch; eine Erfolgsmeldung (showBanner(…, 'success', …)) schließt die Seite und zeigt einen Hinweis; Zurück/Verwerfen baut die Ansicht neu auf. Neues Formular: einfach den Abschnitt markieren. Lager-Untermenü ohne Eingang/Ausgang (OHNE_UNTERMENUE, Knöpfe im Bestand).
• Live-Daten: Ein globales Objekt state hält jede Firestore-Sammlung als Liste; je Sammlung ein onSnapshot-Listener über abo(sammlung, feld), Änderungen erscheinen sofort bei allen. Beim Start werden nur die Kern-Daten abonniert (Artikel, Buchungen, Bestellungen, Zugänge, Etiketten); die Daten von „Mein Bestand“, „Handel“, Inventur und Sicherung erst beim ersten Öffnen des Bereichs (ABO_GRUPPEN, TAB_DATEN, abosFuer) – neue Sammlungen dort eintragen. Die Vollsicherung wartet, bis alles geladen ist (datenDa). maybeRerenderOnData() fasst Datenänderungen kurz hintereinander zu einem Neuaufbau des sichtbaren Reiters zusammen (40 ms). Das Protokoll zeigt seitenweise 200 Buchungen (PROTOKOLL_SEITE).
• Firebase gekapselt: Die Geschäftslogik nutzt nur claude.use('db') / claude.use('downloads'); ein Block am Anfang von index.html bildet das auf Firebase ab. Neue Funktionen genauso schreiben.
• Bestand wird berechnet: Summe aller Buchungen in movements (Eingang +, Ausgang −) je Sorte, Charge und Lagerort. Bestände nie direkt ändern, sondern immer über Buchungen oder Inventur.
• Batches: Zusammengehörige Schreibvorgänge (z. B. Ausgänge einer Bestellung plus Statusänderung) in einem Firestore-Batch – ganz oder gar nicht.
• Sondercharge FEHLBESTAND: Chargen gehen nicht ins Minus; Überhang landet auf FEHLBESTAND und wird in der Übersicht per „ausgleichen“ einer echten Charge zugeordnet (bewegungsart: 'ausgleich', gemeinsame ausgleichId).
• Internetpflicht: Beim Start prüft die App die Verbindung (Abruf von firestore.googleapis.com). Offline: Hinweis #netz-panel, nur Etikettendruck (HT_startOffline, Artikel-Cache localStorage htl_etk_cache, Mitglied htl_member_cache). Während der Sitzung: Prüfung alle 30 s und bei online/offline-Ereignissen; ohne Verbindung roter Balken und alle Schreibvorgänge (add/set/update/delete/commit) werden abgelehnt. Beim Schließen Warnung, falls ein Schreibvorgang noch nicht bestätigt ist. Firestore-Offline-Speicher ist bewusst NICHT aktiv.
• Service Worker (sw.js, Cache v3): App-Seite network-first, Firebase-Programmteile (gstatic.com/firebasejs/8.10.1) werden zwischengespeichert, damit die App offline startet; Daten nie aus dem Cache.
• Imkerei-Etiketten: Imkerei → Etiketten bzw. Etiketten → Imkerei (renderIke); Stammdaten in imkereiEtikett, offline aus localStorage htl_ike_cache; Vorbelegung der Anschrift aus mk_standorte (Wohnort der Märkte-App). Druck 80×50 mm oder A4 (2×5, 80×50 mit 10/5 mm Abstand). Gebinde nur Karton/Eimer/Fass (kein Einzelglas); Eimer/Fass: Startnummer wird fortlaufend hochgezählt (ikeFolge), je Gebinde eigenes Gewicht netto (Rahmen oben rechts) und Wassergehalt. Karton: Gewicht brutto = Anzahl × Glas brutto (IKE_GLAS_BRUTTO, Werte aus der GS1-Liste). GS1-Werte fest in ETK_GS1 (Abgleich mit der Excel-Liste bei Änderungen nötig); Zuordnung etkGs1Treffer: speziellere Sorte vor basis-Sorte; Abgleich etkGs1Ziel. Karton-Nr. 30er: Zähler etkZaehler/{JJJJ} (Feld stand, darf laut Regeln nur steigen) per Transaktion, Protokoll je Nummer in etkKartonNr (jahr, nr, nummer, sorte, charge, mhd, geraet, offline, geprueft); offline vergebene Nummern in localStorage htl_etk_nr, Nachtrag beim Online-Start (etkNrSync); Doppelte = gleiche nummer mehrfach im Protokoll. Fußzeile wird nach gemessener Textbreite umbrochen (ikeFussHtml; mit EAN max. 54 mm). Honigtreu-Karton: Sortenname-Vorschlag = Artikelname ohne Glasgröße (etkSorteAusName).
• Etiketten: Reiter etiketten; Design 80×50 mm fest (siehe Projekt-Dokument etikett-design-karton.md). Strichcode als 1-Bit-Bild, 3 Druckpunkte je Modul (203 dpi), auf ganze Druckpunkte positioniert – nicht verändern, sonst nicht lesbar.
• Bestellungen: Ausgänge aus einer Bestellung tragen bestellungId. Löschen einer solchen Buchung nimmt die ganze Ausführung zurück und setzt die Bestellung wieder auf „offen“.

Sammlung	Inhalt
members	Freigeschaltete Nutzer (Dokument-ID = E-Mail klein geschrieben; kuerzel, name, admin)
products	Artikel/Sorten mit Einheit und Kategorie; gtin = Glas-EAN; kartons = Liste {anzahl, ean, mitGlasEan} für Karton-Etiketten (Pflege nur Admins im Reiter Etiketten)
Dateiablage (Storage)	Firebase Storage, Bucket honigtreu-lagerverwaltung.firebasestorage.app (Region europe-west3). lieferscheine/{bestellungId}.pdf (Feld bestellungen.lieferschein = pfad, name, groesse, am, von) und Fotos der Märkte-App mk_fotos/{marktId}/{kontaktId}-{n}.jpg (Feld mk_kontakte.fotos), Preislisten der Märkte-App mk_preislisten/{ketteId}.pdf (Feld mk_ketten.preislistePdf; hochladen/löschen nur Admins und Markt-Admins). Regeln in firebase/storage.rules: nur angemeldete Mitglieder (Prüfung gegen members), PDF max. 6 MB, Fotos max. 5 MB; Lesen ist für die Apps gesperrt. Angezeigt wird nur über die Cloud Function dateiHolen (Region europe-west3): sie prüft die Mitgliedschaft, liest die Datei und gibt sie direkt an die App zurück, die sie lokal (blob:-Adresse) anzeigt – es entstehen keine weitergebbaren Download-Links. Deploy: firebase deploy --only storage,functions.
Marktbezug	bestellungen und verkaeufe_leh haben optional marktId, marktName, gln (Verkauf zusätzlich marktKette) = Dokument-ID in mk_maerkte. Zuordnung über die GLN des Belegs (belegGlns, Prüfziffer, eigene Nummern 426241354… ausgeschlossen; zusätzlich KI-Feld kunde.gln), unbekannte GLN wird nach Auswahl beim Markt gespeichert (mk_maerkte.gln, glnQuelle: 'Beleg'). Kennungen eines Markts (gln, glnQuelle, glnAm, marktnr, kundennr) darf jedes Mitglied bei jedem Markt ändern; alles andere am Markt nur Admins bzw. das betreuende Mitglied, Lieferantennr./GLN Honigtreu am Markt nur Admins.
Kundendaten & Preise (Märkte-App)	mk_ketten/{ketteId} (z. B. rewe, edeka, marktkauf, terra, honigtreuallgemein): kundennr, lieferantennr, glnHonigtreu, stammVon (Marktkauf → EDEKA), beliefertUeber (Bio Company → Terra), felder, preisblatt {gueltigAb, hinweis, positionen[artikel, einheit, ek, vk, gtin, sorteId, ekGH nur allgemein]}, preislistePdf. Lesen alle Mitglieder (auch für die Lager-App nutzbar), schreiben nur Admins/Markt-Admins. Artikel ohne Preis gelten als nicht gelistet; ohne eigenes Preisblatt gilt honigtreuallgemein (EK Einzelhandel für Strecke, EK Großhandel für Großhandel). Die Märkte-App zeigt daraus je Markt „Lieferungen“ und „Umsatz“.
etkZaehler, etkKartonNr	Karton-Nummern der Honigtreu-30er-Etiketten: Zähler je Jahr (Dokument-ID = Jahr, Feld stand) und Protokoll aller vergebenen Nummern (Sorte, Charge, MHD, Gerät, offline, geprüft). Zählerstand korrigieren nur nach oben (Regeln)
movements	Alle Lagerbuchungen (Charge, Lagerort, Menge, ggf. bewegungsart, bestellungId, zusatzArtikel)
bestellungen	Bestellungen mit Positionen und Status offen/ausgeführt; nach dem Ausführen ggf. zusatzPositionen (nicht bestellte, zusätzlich gelieferte Artikel)
inventuren	Belege der Lager-Inventuren
imkereiEtikett	Stammdaten für eigene Etiketten je Imkerei (Dokument-ID = Kürzel): name, strasse, plz, ort, telefon, email, logo (Logo als Graustufen-PNG, data-URL, max. 600×240 px). Lesen: alle Mitglieder; schreiben: die Imkerei selbst und Admins (Regel in firestore.rules)
member…	Mein Bestand je Imkerei: memberErnte = Rohware, memberAbfuellung = Glasware (je mit verfuegbarHonigtreu), dazu Anlieferungen, Korrekturen, Inventuren
ankaeufe, verkaeufe_*, preise, verguetungssaetze	Bereich Handel (nur Admins dürfen schreiben)

8. Sicherheitsregeln (firestore.rules)

• Nur eingeloggte, in members eingetragene Adressen dürfen lesen/schreiben.
• Handel, preise und verguetungssaetze dürfen nur Admins ändern (alle dürfen lesen).
• „Mein Bestand“-Sammlungen darf jede Imkerei nur für das eigene Kürzel anlegen/ändern; Admins für alle.
• products: alle Mitglieder dürfen Artikel anlegen/ändern, die Etiketten-Felder gtin (Glas-EAN) und kartons aber nur Admins.
• etkZaehler: alle Mitglieder lesen/hochzählen, der Stand darf nur steigen; etkKartonNr: alle Mitglieder lesen/anlegen, ändern nur den Vermerk „geprüft“, löschen nur Admins.
• imkereiEtikett (Stammdaten eigene Etiketten): alle lesen; ändern nur die Imkerei selbst (Dokument-ID = eigenes Kürzel) oder Admins; Logo höchstens 400 kB.
• Regeln immer in der Datei firestore.rules ändern und deployen, nie dauerhaft über die Konsole – sonst ist der lokale Stand veraltet.

9. Notfall: direkter Datenzugriff

• Firebase-Konsole → Firestore Database: Dokumente in members, products, movements usw. lassen sich von Hand ansehen und reparieren.
• Admin ausgesperrt? In members das eigene Dokument (ID = eigene E-Mail, klein geschrieben) öffnen oder anlegen und admin auf true setzen.
• Wartungsskripte (z. B. node migrate-update-2026-09.js, falls noch vorhanden bzw. aus einer Sicherung): brauchen Node.js, npm install im Ordner firebase und vorübergehend eine serviceAccountKey.json (aus Vertraulich/ in den Ordner firebase kopieren – nicht nach public – und danach wieder löschen). Alle bisherigen Skripte sind idempotent. Vorher eine Excel-Sicherung ziehen.

10. Sicherung & Wiederherstellung

• Reiter „Sicherung“ in der App: Excel-Komplettsicherung (Bestand, Bewegungen, Handel, Mein Bestand, Inventuren). Monatlich herunterladen und außerhalb von Firebase ablegen (z. B. WaWi/Sicherung).
• Vollständige Kopie aller Sammlungen zusätzlich über gcloud firestore export (Google-Cloud-CLI, braucht einen Cloud-Storage-Bucket) – für den Fall einer Massenlöschung.
• Einzelne gelöschte Dokumente am schnellsten aus der letzten Excel-Sicherung manuell in der Firestore-Konsole wieder anlegen.

11. Empfehlungen & offene Punkte

• Git-Repository: Der Code liegt bisher nur in einem OneDrive-Ordner. Für eine saubere Übergabe ein privates Repository (z. B. GitHub) anlegen; serviceAccountKey.json und node_modules ausschließen (.gitignore).
• Die Fehlbestand-Logik gilt bisher nur für Ausgang und Bestellungen; Umlagerung, Abfüllen und Inventur arbeiten noch nach der alten Logik.

12. Zusätzlichen Admin einrichten (Zugriff auf App, Code und Werkzeuge)

Für die Arbeit in der App genügt Schritt 1. Wer die Apps auch pflegen und weiterentwickeln soll, braucht zusätzlich die Schritte 2 bis 6.

• 1. Admin in der App (bestehender Admin in der App): Button „Mitglieder“ → E-Mail-Adresse des neuen Admins anlegen bzw. in der Liste die Rolle auf „Administrator“ (Mitglied) oder „Externer Administrator“ (Dienstleister) stellen. Damit sieht er Handel, Kartongrößen/EAN, alle Imkereien usw.
• 2. Google-Konto (neuer Admin): Eigenes Google-Konto mit Zwei-Faktor-Anmeldung. Keine gemeinsamen Konten oder weitergegebenen Passwörter.
• 3. Firebase-Projekt (Projektinhaber, bisher Christian): Firebase-Konsole → Zahnrad → Nutzer und Berechtigungen → Mitglied hinzufügen: Google-Konto des neuen Admins, Rolle „Bearbeiter“ (Wartung, Deploy) oder „Inhaber“ (volle Verantwortung inkl. Rechte vergeben). Nötig für Deploy und Datenbank-Konsole.
• 4. Quellcode (Projektinhaber): Ordner WaWi per OneDrive freigeben – aber ohne Vertraulich/: Den Ordner vorher aus WaWi herausnehmen oder nur die Unterordner firebase, firebase-maerkte, Werkzeuge, Hilfe, Sicherung freigeben. Besser für die Zukunft: privates Git-Repository (Abschnitt 11). Absprechen, wer gerade ändert – zwei gleichzeitige Änderungen an index.html über OneDrive erzeugen Konflikt-Kopien.
• 5. Arbeitsplatz (neuer Admin): Node.js, npm install -g firebase-tools, firebase login mit dem eigenen Google-Konto, Python 3 mit pip install reportlab (Abschnitt 3). Test: im Ordner WaWi\firebase den Befehl firebase projects:list ausführen – das Projekt honigtreu-lagerverwaltung muss erscheinen.
• 6. Dokumentation (Projektinhaber): Diese Anleitung, firebase/README.md (Neuaufbau), das Änderungsprotokoll webapp-stand-kontext.md und die Konzepte im Claude-Projekt „Honigtreu Lagerverwaltung“. Ein Claude-Projekt lässt sich nur innerhalb eines Team-/Enterprise-Tarifs mit anderen teilen; sonst die Projekt-Dokumente herunterladen und dem neuen Admin geben (enthalten keine Schlüssel).

Was der neue Admin vorfindet:

• Apps: Lagerverwaltung (firebase/public/index.html) und Märkte-App (firebase-maerkte/public/index.html) – jeweils eine Datei, ohne Build-Schritt, mit jedem Texteditor änderbar (z. B. Visual Studio Code).
• Werkzeuge (WaWi/Werkzeuge, für diese Apps erstellt): deploy_pruefung.js (Sicherheitsprüfung vor jedem Deploy, läuft automatisch), hilfe_dokumente_erzeugen.py (Kurzanleitung + Admin-Anleitung als PDF), markt_hilfe_erzeugen.py (Kurzanleitung der Märkte-App), etiketten_erzeugen.py (Muster-Etiketten als PDF; der Etikettendruck selbst läuft in der App).
• Sicherheitsregeln firebase/firestore.rules und die Cloud Function in firebase/functions.
• Nicht nötig für die normale Arbeit: serviceAccountKey.json und der Anthropic-API-Key. Wird der Schlüssel doch einmal gebraucht (Notfall, Abschnitt 9), erzeugt der Admin selbst einen eigenen in der Firebase-Konsole und löscht ihn danach wieder (Projekteinstellungen → Dienstkonten).

Admin scheidet aus: In der App die Rolle auf „Mitglied“ bzw. „Mitglied inaktiv“ stellen oder den Zugang entfernen, in der Firebase-Konsole aus „Nutzer und Berechtigungen“ entfernen, OneDrive-Freigabe beenden; hatte er einen eigenen Dienstkonto-Schlüssel, diesen unter Dienstkonten löschen.

12a. Eigene Adressen lager.honigtreu.de / maerkte.honigtreu.de

Zusätzlich zu den bisherigen Adressen (honigtreu-lagerverwaltung.web.app, honigtreu-maerkte.web.app, beide bleiben gültig):

• Firebase-Konsole → Hosting → Website honigtreu-lagerverwaltung → „Benutzerdefinierte Domain hinzufügen“ → lager.honigtreu.de. Die Konsole nennt die DNS-Einträge (meist ein TXT-Eintrag zur Bestätigung und ein A- oder CNAME-Eintrag); diese beim Domain-Anbieter von honigtreu.de für die Subdomain lager anlegen. Dasselbe für die Website honigtreu-maerkte mit maerkte.honigtreu.de.
• Firebase-Konsole → Authentication → Einstellungen → Autorisierte Domains: lager.honigtreu.de und maerkte.honigtreu.de hinzufügen (sonst geht die Google-Anmeldung dort nicht).
• Nur für die Märkte-App (meldet sich über die eigene Adresse an): Google Cloud Console → APIs & Dienste → Anmeldedaten → OAuth-2.0-Client „Web client“ → Autorisierte Weiterleitungs-URIs: https://maerkte.honigtreu.de/__/auth/handler hinzufügen und speichern.
• DNS bei IONOS: „Schnelle Einrichtung“ in Firebase wählen – je Adresse ein CNAME-Eintrag (Hostname lager bzw. maerkte, Wert wie von Firebase angezeigt); andere Einträge für denselben Hostnamen vorher löschen.
• Das SSL-Zertifikat stellt Firebase automatisch aus (bis zu 24 Stunden). Kein neuer Deploy nötig.
• Wichtig für die Mitglieder: Die Anmeldung gilt je Adresse – unter der neuen Adresse einmal neu anmelden und die App ggf. neu auf den Startbildschirm legen.

13. Ansprechpartner

Christian Grune, Vorstand Honigtreu eG – bisheriger Projektinhaber des Firebase-Projekts.