Angebrochene Packungen, Teilverbrauch und Hausmasse (Backend)

Eine Teilmenge auszulagern ging rechnerisch schon, aber es blieb keine Spur davon: Eine Charge mit 900 von urspruenglich 1000 ml war von einer frisch eingelagerten 900-ml-Charge nicht zu unterscheiden, und eine geoeffnete Milch galt weiter bis zum aufgedruckten MHD. Anbrechen spaltet jetzt eine Packung ab. Aus 4 x 1 l wird eine offene Charge mit 1 l und eine ungeoeffnete mit 3 l - sonst truegen die restlichen 3 l das kurze Verbrauchsdatum mit, obwohl sie noch zu sind. Der Gesamtbestand aendert sich dabei nicht, es ist eine Umbuchung wie das Aufteilen und schreibt wie dieses keine Bewegung. Verbrauchen geht in einem Schritt: Wer "100 ml verbraucht" eintraegt, bricht die Charge dabei an (abschaltbar ueber auto_open). Gerechnet wird vor dem Anbrechen - scheitert die Einheit, soll keine Packung grundlos offen stehen. MHD und "zu verbrauchen bis" stehen nebeneinander und bleiben beide sichtbar; gewarnt wird nach dem FRUEHEREN (Lot.faellig_am). Dafuer musste in /expiring die Vorbedingung "best_before IS NOT NULL" weg, sonst fehlte ausgerechnet die angebrochene Packung ohne aufgedrucktes MHD. ExpiringItem traegt beide Daten plus warn_date und warn_source, und best_before ist dort jetzt optional. Die Frist kommt aus drei Ebenen: Artikel schlaegt Kategorie, Kategorie schlaegt ueber ihre Oberkategorien hinweg den globalen Wert. Der Helfer dafuer (services/vererbung.py) liest die Kategoriekette von services/fields.py rueckwaerts - dort werden Felder ALLER Vorfahren gesammelt, hier gewinnt der naechste. Dieselbe Mechanik traegt die Hausmasse. Hausmasse sind der zweite Teil: "2 EL Mehl" liess sich bisher nicht buchen, weil eine globale Einheit "Essloeffel" bei Mehl und Zucker zwangslaeufig gleich schwer waere. Der Name ist deshalb global, die Menge haengt an Kategorie und Artikel. to_base loest sie nur mit hausmasse=True auf - beim Auslagern und Verbrauchen ja, beim Einlagern und bei Mindestbestaenden ausdruecklich nicht, denn ein Loeffel ist ein Schaetzwert. Verwaltete Einheiten werden zuerst geprueft, damit ein Mass namens "Liter" die echte Einheit nicht verdeckt. Zwei Stellen waeren sonst still kaputtgegangen: - Die Konsolidierung haette die offene Packung beim naechsten Einlagern am selben Ort einkassiert und ihr Verbrauchsdatum verschluckt. Angebrochene Chargen werden deshalb nie zusammengefasst - in consolidate_lot_group und im Start-Aufraeumer, beide bisher ohne jeden Test. Das Netz dafuer ist jetzt da (test_konsolidierung.py). - FEFO sortiert nach dem wirksamen Datum statt nur nach dem MHD. Eine offene Packung kommt damit meist von selbst zuerst, aber eine ungeoeffnete, die morgen ablaeuft, geht vor - Verderb schlaegt Bequemlichkeit. Erst bei gleichem Datum wird das Angebrochene vorgezogen. Dashboard bekommt "angebrochen" als fuenften Zustand, mit Vorrang abgelaufen > bald > angebrochen > in Ordnung: Was offen ist und morgen ablaeuft, gehoert in die Warnung, nicht in den ruhigeren Zustand. Oberflaechen in Web und App folgen in eigenen Commits. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-10-02 11:25:36 +02:00
parent 254737086e
commit fa5a2bc4fa
22 changed files with 2073 additions and 51 deletions
@@ -0,0 +1,255 @@
+"""Hausmaße: „2 EL" wiegt bei Mehl anders als bei Zucker.
+
+Die Menge gehört an die Kategorie bzw. den Artikel, nicht an den Namen – ein
+globaler Faktor wie bei den verwalteten Einheiten wäre hier zwangsläufig falsch.
+"""
+
+import pytest
+
+from app.models import (
+    BaseUnit,
+    Category,
+    CategoryMeasure,
+    CategoryTracking,
+    Measure,
+    Product,
+    ProductMeasure,
+)
+from app.seed import ensure_builtin_measures
+from app.services.conversion import ConversionError, to_base
+from app.services.stock import check_in, check_out, current_stock
+from app.services.vererbung import mass_aufloesen, verfuegbare_masse
+
+
+@pytest.fixture()
+def masse(db):
+    ensure_builtin_measures(db)
+    return {m.name: m for m in db.query(Measure).all()}
+
+
+def _kategorie(db, name, parent=None):
+    cat = Category(
+        name=name,
+        parent_id=parent.id if parent else None,
+        tracking=CategoryTracking.food.value,
+    )
+    db.add(cat)
+    db.commit()
+    db.refresh(cat)
+    return cat
+
+
+def _artikel(db, name, cat, base=BaseUnit.gram, package_size=1000):
+    product = Product(
+        name=name, base_unit=base, package_size=package_size,
+        category_id=cat.id, source="manual",
+    )
+    db.add(product)
+    db.commit()
+    db.refresh(product)
+    return product
+
+
+def _mass_an_kategorie(db, measure, cat, amount, base=BaseUnit.gram):
+    db.add(CategoryMeasure(
+        measure_id=measure.id, category_id=cat.id, amount=amount, base=base.value
+    ))
+    db.commit()
+
+
+# --------------------------------------------------------------------------
+# Derselbe Löffel, zwei Gewichte
+# --------------------------------------------------------------------------
+def test_esslöffel_wiegt_je_kategorie_anders(db, masse):
+    el = masse["Esslöffel"]
+    mehl_kat = _kategorie(db, "Mehl")
+    zucker_kat = _kategorie(db, "Zucker")
+    mehl = _artikel(db, "Weissmehl", mehl_kat)
+    zucker = _artikel(db, "Kristallzucker", zucker_kat)
+    _mass_an_kategorie(db, el, mehl_kat, 10)
+    _mass_an_kategorie(db, el, zucker_kat, 12)
+
+    assert to_base(db, mehl, 2, "EL", hausmasse=True) == 20
+    assert to_base(db, zucker, 2, "EL", hausmasse=True) == 24
+
+
+def test_kurzform_und_grossschreibung(db, masse):
+    el = masse["Esslöffel"]
+    kat = _kategorie(db, "Mehl")
+    mehl = _artikel(db, "Weissmehl", kat)
+    _mass_an_kategorie(db, el, kat, 10)
+
+    for token in ("EL", "el", "Esslöffel", "esslöffel", " EL "):
+        assert to_base(db, mehl, 1, token, hausmasse=True) == 10
+
+
+def test_tasse_in_millilitern(db, masse):
+    tasse = masse["Tasse"]
+    kat = _kategorie(db, "Molkerei")
+    milch = _artikel(db, "Vollmilch", kat, base=BaseUnit.milliliter)
+    _mass_an_kategorie(db, tasse, kat, 200, base=BaseUnit.milliliter)
+
+    assert to_base(db, milch, 1.5, "Tasse", hausmasse=True) == 300
+
+
+# --------------------------------------------------------------------------
+# Vererbung: Artikel > nächste Kategorie > Oberkategorie
+# --------------------------------------------------------------------------
+def test_unterkategorie_erbt_von_oben(db, masse):
+    el = masse["Esslöffel"]
+    trocken = _kategorie(db, "Trockenwaren")
+    mehl_kat = _kategorie(db, "Mehl", parent=trocken)
+    mehl = _artikel(db, "Weissmehl", mehl_kat)
+    _mass_an_kategorie(db, el, trocken, 11)
+
+    assert to_base(db, mehl, 1, "EL", hausmasse=True) == 11
+    angabe = mass_aufloesen(db, mehl, "EL")
+    assert angabe.herkunft == "Kategorie: Trockenwaren"
+
+
+def test_naehere_kategorie_schlaegt_die_obere(db, masse):
+    el = masse["Esslöffel"]
+    trocken = _kategorie(db, "Trockenwaren")
+    mehl_kat = _kategorie(db, "Mehl", parent=trocken)
+    mehl = _artikel(db, "Weissmehl", mehl_kat)
+    _mass_an_kategorie(db, el, trocken, 11)
+    _mass_an_kategorie(db, el, mehl_kat, 9)
+
+    assert to_base(db, mehl, 1, "EL", hausmasse=True) == 9
+
+
+def test_artikel_schlaegt_die_kategorie(db, masse):
+    el = masse["Esslöffel"]
+    kat = _kategorie(db, "Zucker")
+    puder = _artikel(db, "Puderzucker", kat)
+    _mass_an_kategorie(db, el, kat, 12)
+    db.add(ProductMeasure(
+        measure_id=el.id, product_id=puder.id, amount=8, base=BaseUnit.gram.value
+    ))
+    db.commit()
+
+    assert to_base(db, puder, 1, "EL", hausmasse=True) == 8
+    assert mass_aufloesen(db, puder, "EL").herkunft == "Artikel"
+
+
+# --------------------------------------------------------------------------
+# Lücken und Fehler
+# --------------------------------------------------------------------------
+def test_mass_ohne_menge_meldet_sich_deutlich(db, masse):
+    """Die Meldung ist die Grundlage für „Maß jetzt anlegen" im Rezeptabgleich."""
+    kat = _kategorie(db, "Hülsenfrüchte")
+    linsen = _artikel(db, "Berglinsen", kat)
+
+    with pytest.raises(ConversionError) as fehler:
+        to_base(db, linsen, 1, "Tasse", hausmasse=True)
+    assert "kein Maß 'Tasse' hinterlegt" in str(fehler.value)
+
+
+def test_voellig_unbekannte_einheit_bleibt_unbekannte_einheit(db, masse):
+    kat = _kategorie(db, "Mehl")
+    mehl = _artikel(db, "Weissmehl", kat)
+
+    with pytest.raises(ConversionError) as fehler:
+        to_base(db, mehl, 1, "furlong", hausmasse=True)
+    assert "Unbekannte Einheit" in str(fehler.value)
+
+
+def test_artfremdes_mass_braucht_die_zweiteinheit(db, masse):
+    """Ein Gramm-Maß an einem Stück-Artikel geht nur über die Brücke."""
+    el = masse["Esslöffel"]
+    kat = _kategorie(db, "Backwaren")
+    broetchen = _artikel(db, "Brötchen", kat, base=BaseUnit.piece, package_size=6)
+    _mass_an_kategorie(db, el, kat, 20)      # in Gramm
+
+    with pytest.raises(ConversionError) as fehler:
+        to_base(db, broetchen, 1, "EL", hausmasse=True)
+    assert "Zweiteinheit" in str(fehler.value)
+
+    # Mit Brücke „3 Stück ≙ 150 g" sind 20 g dann 0,4 Stück.
+    broetchen.secondary_base = BaseUnit.gram.value
+    broetchen.secondary_count = 3
+    broetchen.secondary_amount = 150
+    db.commit()
+    assert to_base(db, broetchen, 1, "EL", hausmasse=True) == pytest.approx(0.4)
+
+
+def test_packung_schlaegt_das_hausmass(db, masse):
+    """„package" wird zuerst geprüft – daran darf ein Hausmaß nichts ändern."""
+    kat = _kategorie(db, "Mehl")
+    mehl = _artikel(db, "Weissmehl", kat, package_size=1000)
+    neu = Measure(name="Packung", short="Pck", position=99)
+    db.add(neu)
+    db.commit()
+    _mass_an_kategorie(db, neu, kat, 7)
+
+    assert to_base(db, mehl, 1, "package", hausmasse=True) == 1000
+
+
+def test_ohne_schalter_gilt_das_hausmass_nicht(db, masse):
+    """Einlagern und Mindestbestände dürfen keine Schätzwerte annehmen."""
+    el = masse["Esslöffel"]
+    kat = _kategorie(db, "Mehl")
+    mehl = _artikel(db, "Weissmehl", kat)
+    _mass_an_kategorie(db, el, kat, 10)
+
+    with pytest.raises(ConversionError) as fehler:
+        to_base(db, mehl, 2, "EL")              # ohne hausmasse=True
+    assert "Unbekannte Einheit" in str(fehler.value)
+
+
+def test_einlagern_nimmt_kein_hausmass(db, masse):
+    el = masse["Esslöffel"]
+    kat = _kategorie(db, "Mehl")
+    mehl = _artikel(db, "Weissmehl", kat)
+    _mass_an_kategorie(db, el, kat, 10)
+
+    with pytest.raises(ConversionError):
+        check_in(db, mehl, 2, "EL", None, None, None)
+
+
+def test_auslagern_nimmt_ein_hausmass(db, masse):
+    el = masse["Esslöffel"]
+    kat = _kategorie(db, "Mehl")
+    mehl = _artikel(db, "Weissmehl", kat)
+    _mass_an_kategorie(db, el, kat, 10)
+    check_in(db, mehl, 1, "package", None, None, None)
+    db.commit()
+
+    check_out(db, mehl, 2, "EL", None)
+    db.commit()
+
+    assert current_stock(db, mehl.id) == 980
+
+
+def test_einheit_schlaegt_gleichnamiges_hausmass(db, masse):
+    """Ein Maß „Liter" darf die echte Einheit nicht verdecken."""
+    kat = _kategorie(db, "Getränke")
+    saft = _artikel(db, "Apfelsaft", kat, base=BaseUnit.milliliter, package_size=1000)
+    liter_mass = Measure(name="Liter", short="Ltr", position=99)
+    db.add(liter_mass)
+    db.commit()
+    _mass_an_kategorie(db, liter_mass, kat, 5, base=BaseUnit.milliliter)
+
+    assert to_base(db, saft, 1, "Liter", hausmasse=True) == 1000
+
+
+def test_verfuegbare_masse_listet_nur_hinterlegte(db, masse):
+    el = masse["Esslöffel"]
+    kat = _kategorie(db, "Mehl")
+    mehl = _artikel(db, "Weissmehl", kat)
+    _mass_an_kategorie(db, el, kat, 10)
+
+    liste = verfuegbare_masse(db, mehl)
+
+    assert [a.measure.name for a in liste] == ["Esslöffel"]
+    assert liste[0].amount == 10
+    assert liste[0].herkunft == "Kategorie: Mehl"
+
+
+def test_artikel_ohne_kategorie_hat_keine_masse(db, masse):
+    product = Product(name="Irgendwas", base_unit=BaseUnit.gram, source="manual")
+    db.add(product)
+    db.commit()
+
+    assert verfuegbare_masse(db, product) == []
+    assert mass_aufloesen(db, product, "EL") is None