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>

backend/app/schemas.py

@@ -275,6 +275,9 @@ class CategoryOut(BaseModel):
     # "food" = Chargen+MHD, "object" = Menge je Lagerort.
     tracking: CategoryTracking = CategoryTracking.food
     product_count: int = 0
+    # Haltbarkeit nach dem Anbrechen in Tagen. None = erbt von der
+    # Oberkategorie, zuletzt vom globalen Wert.
+    open_days: int | None = None
 
 
 class CategoryCreate(BaseModel):
@@ -282,12 +285,16 @@ class CategoryCreate(BaseModel):
     parent_id: int | None = None
     # None: erbt vom Elternteil bzw. neue Oberkategorie = Gegenstand.
     tracking: CategoryTracking | None = None
+    open_days: int | None = Field(default=None, ge=1)
 
 
 class CategoryUpdate(BaseModel):
     name: str | None = Field(default=None, min_length=1, max_length=120)
     parent_id: int | None = None
     tracking: CategoryTracking | None = None
+    # 0 ist nicht erlaubt: „sofort verbrauchen" waere keine Frist, und None
+    # heisst schon „erben" – zwei Bedeutungen fuer leer gaebe es sonst.
+    open_days: int | None = Field(default=None, ge=1)
 
 
 # ---- Shops (Bezugsquellen, nur für Gegenstände) ----
@@ -403,6 +410,9 @@ class ProductBase(BaseModel):
     secondary_base: BaseUnit | None = None
     secondary_count: float | None = Field(default=None, gt=0)
     secondary_amount: float | None = Field(default=None, gt=0)
+    # Haltbarkeit nach dem Anbrechen, nur fuer diesen Artikel.
+    # None = erbt von der Kategorie, zuletzt vom globalen Wert.
+    open_days: int | None = Field(default=None, ge=1)
     # Voreingestellte MHD-Genauigkeit dieses Produkts (z.B. Konserven: nur Monat).
     date_precision: DatePrecision = DatePrecision.day
     group_id: int | None = None
@@ -442,6 +452,9 @@ class ProductUpdate(BaseModel):
     secondary_base: BaseUnit | None = None
     secondary_count: float | None = Field(default=None, gt=0)
     secondary_amount: float | None = Field(default=None, gt=0)
+    # Haltbarkeit nach dem Anbrechen, nur fuer diesen Artikel.
+    # None = erbt von der Kategorie, zuletzt vom globalen Wert.
+    open_days: int | None = Field(default=None, ge=1)
     date_precision: DatePrecision | None = None
     group_id: int | None = None
     category_id: int | None = None
@@ -470,6 +483,12 @@ class ProductOut(BaseModel):
     secondary_base: BaseUnit | None = None
     secondary_count: float | None = None
     secondary_amount: float | None = None
+    open_days: int | None = None
+    # Die tatsaechlich geltende Frist und woher sie kommt – damit das
+    # Formular „geerbt: 3 Tage (Kategorie: Molkerei)" zeigen kann, ohne
+    # die Vererbung selbst nachzubauen.
+    effective_open_days: int | None = None
+    open_days_source: str = ""
     # Abgeleitet: Zweit-Basiseinheiten je EINER Basiseinheit des Artikels –
     # damit die Oberflächen nicht selbst dividieren müssen.
     secondary_factor: float | None = None
@@ -574,6 +593,11 @@ class LotOut(BaseModel):
     best_before_precision: DatePrecision = DatePrecision.day
     location_id: str | None
     created_at: datetime
+    # Angebrochen: NULL = zu. MHD und Verbrauchsdatum stehen bewusst
+    # nebeneinander – gewarnt wird nach dem fruheren (Lot.faellig_am).
+    opened_on: date | None = None
+    consume_by: date | None = None
+    opened_quantity: float | None = None
 
 
 class LotUpdate(BaseModel):
@@ -601,6 +625,9 @@ class LotRow(BaseModel):
     best_before_precision: DatePrecision = DatePrecision.day
     location_id: str | None = None
     created_at: datetime
+    opened_on: date | None = None
+    consume_by: date | None = None
+    opened_quantity: float | None = None
 
 
 class BulkLotLocation(BaseModel):
@@ -616,6 +643,72 @@ class LotSplit(BaseModel):
     location_id: str | None = None
 
 
+class LotOpen(BaseModel):
+    """Eine Packung der Charge anbrechen.
+
+    ``quantity`` in Basiseinheiten; leer = eine Artikeleinheit (Packung), bzw.
+    die ganze Charge, wenn sie kleiner ist.
+    """
+    quantity: float | None = Field(default=None, gt=0)
+
+
+class LotConsume(BaseModel):
+    """Teilmenge aus einer Charge verbrauchen.
+
+    ``unit`` nimmt alles, was auch beim Auslagern geht – Basiseinheit, verwaltete
+    Einheit, „package" und die Hausmaße der Kategorie („EL", „Tasse").
+    ``auto_open`` bricht eine noch geschlossene Charge dabei an; die Rückfrage
+    dazu stellt die Oberfläche, nicht der Server.
+    """
+    quantity: float = Field(gt=0)
+    unit: str
+    note: str | None = Field(default=None, max_length=255)
+    auto_open: bool = True
+
+
+class LotConsumeOut(BaseModel):
+    """Was der Verbrauch bewirkt hat."""
+    affected_lots: list[dict] = []
+    # Die offene Charge danach – None, wenn sie dabei leer geworden ist.
+    lot: LotOut | None = None
+    # Ob die Charge durch diesen Vorgang angebrochen wurde.
+    opened: bool = False
+
+
+# ---- Hausmaße ----
+class MeasureIn(BaseModel):
+    """Name eines Hausmaßes. Die Menge steht an Kategorie bzw. Artikel."""
+    name: str = Field(min_length=1, max_length=40)
+    short: str | None = Field(default=None, max_length=10)
+    position: int = 0
+
+
+class MeasureOut(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+    id: int
+    name: str
+    short: str | None = None
+    position: int = 0
+    is_builtin: bool = False
+
+
+class MeasureAmountIn(BaseModel):
+    """Was ein Hausmaß hier wiegt bzw. fasst: ``amount`` in ``base``."""
+    amount: float = Field(gt=0)
+    base: BaseUnit
+
+
+class MeasureAmountOut(BaseModel):
+    """Ein für einen Artikel (oder eine Kategorie) geltendes Maß samt Herkunft."""
+    measure_id: int
+    name: str
+    short: str | None = None
+    amount: float
+    base: BaseUnit
+    # „Artikel", „Kategorie: Mehl & Zucker" oder „–" (nicht hinterlegt).
+    herkunft: str = ""
+
+
 # ---- Kassenzettel-Abgleich ----
 class MatchRequest(BaseModel):
     """Kassenzettel-Zeilen (OCR) → beste Lebensmittel-Treffer je Zeile."""
@@ -956,8 +1049,17 @@ class ExpiringItem(BaseModel):
     product_name: str
     quantity: float          # in Basiseinheiten
     base_unit: BaseUnit
-    best_before: date
+    # Darf fehlen: Eine angebrochene Packung ohne aufgedrucktes MHD hat nur ein
+    # Verbrauchsdatum – und genau die soll hier auftauchen.
+    best_before: date | None = None
     best_before_precision: DatePrecision = DatePrecision.day
+    # Angebrochen: Öffnungstag und das daraus gerechnete Verbrauchsdatum.
+    opened_on: date | None = None
+    consume_by: date | None = None
+    # Das Datum, nach dem gewarnt wird (das frühere der beiden), und welches es
+    # ist – damit die Anzeige „läuft ab" von „angebrochen" unterscheiden kann.
+    warn_date: date
+    warn_source: str = "best_before"      # best_before | consume_by
     days_left: int
     # Für die Anzeige in Artikeleinheiten:
     package_size: float | None = None
@@ -1113,6 +1215,9 @@ class ExpirySplit(BaseModel):
     ok: float
     soon: float
     expired: float
+    # Angebrochen und noch nicht in der Warnfrist. Was offen ist UND bald
+    # abläuft, zählt als "soon" – Dringlichkeit schlägt Zustand.
+    opened: float = 0.0
     no_date: float              # Chargen ohne MHD zählen separat, nicht als "ok"
 
 
@@ -1123,6 +1228,7 @@ class CategoryShare(BaseModel):
     ok: float
     soon: float
     expired: float
+    opened: float = 0.0
     no_date: float