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>
This commit is contained in:
Scarriffle
2026-10-02 11:25:36 +02:00
co-authored by Claude Opus 5
parent 254737086e
commit fa5a2bc4fa
22 changed files with 2073 additions and 51 deletions
+109
View File
@@ -349,6 +349,10 @@ class Category(Base):
default=CategoryTracking.object.value,
server_default=CategoryTracking.food.value,
)
# Wie lange eine angebrochene Packung dieser Kategorie noch haelt.
# NULL = erbt von der Oberkategorie, zuletzt vom globalen Wert
# (services/vererbung.py::oeffnungsfrist).
open_days: Mapped[int | None] = mapped_column(Integer, nullable=True)
class Product(Base):
@@ -385,6 +389,11 @@ class Product(Base):
secondary_base: Mapped[str | None] = mapped_column(String(16), nullable=True)
secondary_count: Mapped[float | None] = mapped_column(Float, nullable=True)
secondary_amount: Mapped[float | None] = mapped_column(Float, nullable=True)
# Frist nach dem Anbrechen, nur fuer diesen Artikel. NULL = erbt von der
# Kategorie (und die von ihren Oberkategorien, zuletzt vom globalen Wert).
# Noetig fuer Ausnahmen: H-Milch haelt geoeffnet so lange wie Frischmilch,
# steckt aber in derselben Kategorie.
open_days: Mapped[int | None] = mapped_column(Integer, nullable=True)
# Welche MHD-Genauigkeit bei diesem Produkt sinnvoll ist. Steuert nur die
# Voreinstellung der Eingabe (z.B. Konserven: nur Monat/Jahr aufgedruckt).
date_precision: Mapped[str] = mapped_column(
@@ -511,10 +520,35 @@ class Lot(Base):
location_id: Mapped[str | None] = mapped_column(
String(10), ForeignKey("locations.id", ondelete="SET NULL"), nullable=True
)
# Angebrochen: NULL = ungeoeffnet. Bewusst KEIN eigenes Statusfeld – das
# Datum traegt den Zustand mit und wird fuer die Frist sowieso gebraucht;
# ein zweites Feld koennte ihm widersprechen.
opened_on: Mapped[date | None] = mapped_column(Date, nullable=True)
# „Zu verbrauchen bis" = opened_on + Frist (services/vererbung.py). Beim
# Oeffnen gerechnet und GESPEICHERT: so bleibt das Datum an der offenen
# Packung stehen, wenn die Frist spaeter geaendert wird, und die
# Ablaufliste muss nicht je Zeile die Kategorie-Vererbung aufloesen.
consume_by: Mapped[date | None] = mapped_column(Date, nullable=True)
# Menge beim Oeffnen, damit „noch 400 ml von 1 l" anzeigbar ist.
opened_quantity: Mapped[float | None] = mapped_column(Float, nullable=True)
created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=_now)
product: Mapped[Product] = relationship(back_populates="lots")
@property
def ist_angebrochen(self) -> bool:
return self.opened_on is not None
@property
def faellig_am(self) -> date | None:
"""Das frueheste der beiden Daten – danach wird gewarnt.
MHD und Verbrauchsdatum bleiben getrennt sichtbar; fuer Ablaufliste,
Zustand und Erinnerungen zaehlt aber immer das naehere von beiden.
"""
termine = [d for d in (self.best_before, self.consume_by) if d is not None]
return min(termine) if termine else None
class Movement(Base):
__tablename__ = "movements"
@@ -561,6 +595,81 @@ class PackageType(Base):
is_builtin: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
class Measure(Base):
"""Ein Hausmaß wie „Esslöffel" – nur der NAME, ohne Menge.
Die Menge gehört nicht an den Namen, sondern an die Kategorie bzw. den
Artikel: 1 EL Mehl sind 10 g, 1 EL Zucker 12 g, 1 EL Öl 15 ml. Ein globaler
Faktor wie bei :class:`Unit` wäre also schlicht falsch. Auch die ART
(Gramm/Milliliter/Stück) steckt deshalb in der Menge, nicht hier.
Der Name ist trotzdem global, damit „EL" überall dasselbe Maß bezeichnet –
sonst wären „EL" und „Esslöffel" in zwei Kategorien zwei verschiedene Dinge
und ein Rezept fände keines davon wieder.
"""
__tablename__ = "measures"
id: Mapped[int] = mapped_column(Integer, primary_key=True)
name: Mapped[str] = mapped_column(String(40), nullable=False, unique=True)
# Kurzform fuer Rezepte und schmale Spalten: „EL", „TL".
short: Mapped[str | None] = mapped_column(String(10), nullable=True)
position: Mapped[int] = mapped_column(Integer, nullable=False, default=0)
is_builtin: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
class CategoryMeasure(Base):
"""Was ein Hausmaß in DIESER Kategorie wiegt bzw. fasst.
Gilt über den Kategorie-Baum auch für die Unterkategorien; der nächste
Vorfahr mit Eintrag gewinnt (services/vererbung.py). Eigene Tabelle statt
nullbarer Spalten in einer gemeinsamen, wie es
:class:`ProductLocationMinStock` und :class:`GroupLocationMinStock` schon
vormachen.
"""
__tablename__ = "category_measures"
__table_args__ = (
UniqueConstraint("measure_id", "category_id", name="uq_cat_measure"),
)
id: Mapped[int] = mapped_column(Integer, primary_key=True)
measure_id: Mapped[int] = mapped_column(
ForeignKey("measures.id", ondelete="CASCADE"), nullable=False, index=True
)
category_id: Mapped[int] = mapped_column(
ForeignKey("categories.id", ondelete="CASCADE"), nullable=False, index=True
)
# Menge in ``base`` – also 10 fuer „1 EL = 10 g".
amount: Mapped[float] = mapped_column(Float, nullable=False)
# Art der Menge: BaseUnit-Wert (piece/gram/milliliter). Als String wie
# ``Product.secondary_base``, damit kein Postgres-Enumtyp nachzuziehen ist.
base: Mapped[str] = mapped_column(String(16), nullable=False)
class ProductMeasure(Base):
"""Hausmaß-Menge für EINEN Artikel – schlägt die der Kategorie.
Für Ausnahmen innerhalb einer Kategorie: Puderzucker ist deutlich leichter
als Kristallzucker, steckt aber in derselben Kategorie.
"""
__tablename__ = "product_measures"
__table_args__ = (
UniqueConstraint("measure_id", "product_id", name="uq_prod_measure"),
)
id: Mapped[int] = mapped_column(Integer, primary_key=True)
measure_id: Mapped[int] = mapped_column(
ForeignKey("measures.id", ondelete="CASCADE"), nullable=False, index=True
)
product_id: Mapped[int] = mapped_column(
ForeignKey("products.id", ondelete="CASCADE"), nullable=False, index=True
)
amount: Mapped[float] = mapped_column(Float, nullable=False)
base: Mapped[str] = mapped_column(String(16), nullable=False)
class ProductImage(Base):
"""Lokale Kopie des Artikelbilds.