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
co-authored by
Claude Opus 5
Claude Opus 5
parent
254737086e
commit
fa5a2bc4fa
@@ -3,7 +3,7 @@
|
||||
from __future__ import annotations
|
||||
|
||||
from collections.abc import Sequence
|
||||
from datetime import date
|
||||
from datetime import date, timedelta
|
||||
|
||||
from sqlalchemy import asc, func
|
||||
from sqlalchemy.orm import Session
|
||||
@@ -18,7 +18,7 @@ from ..models import (
|
||||
Product,
|
||||
User,
|
||||
)
|
||||
from .conversion import to_base
|
||||
from .conversion import article_unit, to_base
|
||||
from .dates import clean_precision, normalize_best_before
|
||||
from .loans import nicht_verliehen
|
||||
|
||||
@@ -414,10 +414,17 @@ def consolidate_lot_group(
|
||||
Wird nach jedem Umlagern/Aufteilen aufgerufen – zwei gleich gelagerte Chargen
|
||||
mit demselben MHD sind für den Nutzer dieselbe Charge und sollen als eine
|
||||
erscheinen. Der Bestand bleibt unverändert, die Historie (Bewegungen) auch.
|
||||
|
||||
**Angebrochene Chargen sind davon ausgenommen und werden NIE zusammengefasst.**
|
||||
Eine offene Packung mit eigenem Verbrauchsdatum ist etwas anderes als eine
|
||||
ungeöffnete mit demselben MHD; ohne diese Ausnahme würde die offene Packung
|
||||
beim nächsten Einlagern am selben Ort still einkassiert und ihr kürzeres
|
||||
Verbrauchsdatum ginge verloren. Bitte beim nächsten Umbau hier stehen lassen.
|
||||
"""
|
||||
query = db.query(Lot).filter(
|
||||
Lot.product_id == product_id,
|
||||
Lot.best_before_precision == best_before_precision,
|
||||
Lot.opened_on.is_(None),
|
||||
)
|
||||
query = (
|
||||
query.filter(Lot.best_before.is_(None))
|
||||
@@ -452,6 +459,8 @@ def consolidate_duplicate_lots(db: Session) -> int:
|
||||
db.query(
|
||||
Lot.product_id, Lot.best_before, Lot.best_before_precision, Lot.location_id
|
||||
)
|
||||
# Angebrochene bleiben ausgenommen, siehe consolidate_lot_group.
|
||||
.filter(Lot.opened_on.is_(None))
|
||||
.group_by(
|
||||
Lot.product_id, Lot.best_before, Lot.best_before_precision, Lot.location_id
|
||||
)
|
||||
@@ -467,6 +476,7 @@ def consolidate_duplicate_lots(db: Session) -> int:
|
||||
Lot.best_before_precision == precision,
|
||||
Lot.best_before.is_(None) if best_before is None else Lot.best_before == best_before,
|
||||
Lot.location_id.is_(None) if location_id is None else Lot.location_id == location_id,
|
||||
Lot.opened_on.is_(None),
|
||||
)
|
||||
.scalar()
|
||||
)
|
||||
@@ -487,7 +497,8 @@ def check_out_lot(
|
||||
note: str | None = None,
|
||||
) -> list[dict]:
|
||||
"""Bucht gezielt von EINER Charge ab (manuelle Auswahl statt FEFO)."""
|
||||
needed = to_base(db, product, quantity, unit)
|
||||
# Hausmasse sind beim Auslagern erlaubt („2 EL"), beim Einlagern nicht.
|
||||
needed = to_base(db, product, quantity, unit, hausmasse=True)
|
||||
if needed > lot.quantity + 1e-9:
|
||||
raise StockError(
|
||||
f"Diese Charge hat nur {lot.quantity:g} {product.base_unit.value} "
|
||||
@@ -512,19 +523,140 @@ def check_out_lot(
|
||||
return affected
|
||||
|
||||
|
||||
# --------------------------------------------------------------------------
|
||||
# Anbrechen und Teilverbrauch
|
||||
# --------------------------------------------------------------------------
|
||||
def abspalten(
|
||||
db: Session,
|
||||
lot: Lot,
|
||||
quantity: float,
|
||||
location_id: str | None,
|
||||
*,
|
||||
gleicher_ort_erlaubt: bool = False,
|
||||
) -> Lot:
|
||||
"""``quantity`` Basiseinheiten als neue Charge mit gleichem MHD abzweigen.
|
||||
|
||||
Reine Umbuchung, keine Bewegung – der Gesamtbestand ändert sich nicht. Gibt
|
||||
die neue Charge zurück (noch nicht konsolidiert; das entscheidet der
|
||||
Aufrufer, denn beim Anbrechen darf gerade NICHT konsolidiert werden).
|
||||
|
||||
``gleicher_ort_erlaubt`` ist der Unterschied zwischen den beiden Anlässen:
|
||||
Beim Aufteilen auf einen anderen Lagerort wäre derselbe Ort sinnlos, beim
|
||||
Anbrechen ist er der Normalfall – die offene Packung bleibt dort liegen,
|
||||
wo sie war.
|
||||
"""
|
||||
if quantity <= 0:
|
||||
raise StockError("Menge muss größer als 0 sein")
|
||||
if quantity > lot.quantity - 1e-9:
|
||||
raise StockError(
|
||||
f"So viel enthält die Charge nicht (vorhanden: {lot.quantity:g})."
|
||||
)
|
||||
if not gleicher_ort_erlaubt and (location_id or None) == (lot.location_id or None):
|
||||
raise StockError("Bitte einen anderen Lagerort als den aktuellen wählen.")
|
||||
|
||||
lot.quantity -= quantity
|
||||
neu = Lot(
|
||||
product_id=lot.product_id,
|
||||
quantity=quantity,
|
||||
best_before=lot.best_before,
|
||||
best_before_precision=lot.best_before_precision,
|
||||
location_id=location_id,
|
||||
)
|
||||
db.add(neu)
|
||||
db.flush()
|
||||
return neu
|
||||
|
||||
|
||||
def anbrechen(db: Session, product: Product, lot: Lot, quantity: float | None = None) -> Lot:
|
||||
"""Eine Packung der Charge anbrechen und als eigene Charge führen.
|
||||
|
||||
Aus 4000 ml (4 × 1 l) wird eine offene Charge mit 1000 ml und eine
|
||||
ungeöffnete mit 3000 ml. Ohne das Abspalten würden die restlichen 3 l das
|
||||
kurze Verbrauchsdatum der geöffneten Packung mittragen, obwohl sie noch zu
|
||||
sind.
|
||||
|
||||
``quantity`` leer = eine Artikeleinheit (Packung, sonst Anzeigeeinheit);
|
||||
ist die Charge kleiner, wird sie als Ganzes angebrochen.
|
||||
"""
|
||||
from .vererbung import oeffnungsfrist
|
||||
|
||||
if lot.opened_on is not None:
|
||||
return lot # schon offen – nichts zu tun
|
||||
|
||||
menge = quantity
|
||||
if menge is None:
|
||||
faktor, _label = article_unit(product)
|
||||
menge = faktor or lot.quantity
|
||||
menge = min(menge, lot.quantity)
|
||||
|
||||
ziel = lot if menge >= lot.quantity - 1e-9 else abspalten(
|
||||
db, lot, menge, lot.location_id, gleicher_ort_erlaubt=True
|
||||
)
|
||||
|
||||
heute = date.today()
|
||||
ziel.opened_on = heute
|
||||
ziel.opened_quantity = ziel.quantity
|
||||
ziel.consume_by = heute + timedelta(days=oeffnungsfrist(db, product))
|
||||
db.flush()
|
||||
return ziel
|
||||
|
||||
|
||||
def verbrauchen(
|
||||
db: Session,
|
||||
product: Product,
|
||||
lot: Lot,
|
||||
quantity: float,
|
||||
unit: str,
|
||||
user: User | None,
|
||||
note: str | None = None,
|
||||
auto_open: bool = True,
|
||||
) -> tuple[list[dict], Lot | None, bool]:
|
||||
"""Teilmenge aus einer Charge verbrauchen, bei Bedarf vorher anbrechen.
|
||||
|
||||
Gibt (betroffene Chargen, offene Charge oder None wenn leer, angebrochen?)
|
||||
zurück. Die Umrechnung läuft über ``to_base`` und kennt damit auch die
|
||||
Hausmaße („2 EL") – deshalb wird hier zuerst gerechnet und danach
|
||||
angebrochen: Scheitert die Einheit, soll keine Packung offen sein.
|
||||
"""
|
||||
# Erst rechnen: Scheitert die Einheit, soll keine Packung grundlos offen sein.
|
||||
menge_base = to_base(db, product, quantity, unit, hausmasse=True)
|
||||
angebrochen = False
|
||||
ziel = lot
|
||||
if lot.opened_on is None and auto_open:
|
||||
ziel = anbrechen(db, product, lot, max(menge_base, article_unit(product)[0] or 0.0))
|
||||
angebrochen = True
|
||||
# Bewusst mit der ROH-Eingabe weiter, nicht mit menge_base: ``unit_used`` an
|
||||
# der Bewegung soll festhalten, was der Nutzer getippt hat („2 EL"), nicht
|
||||
# das Ergebnis der Umrechnung. Die zweite Umrechnung liefert denselben Wert.
|
||||
affected = check_out_lot(db, product, ziel, quantity, unit, user, note)
|
||||
offen = None if ziel.quantity <= 1e-9 else ziel
|
||||
return affected, offen, angebrochen
|
||||
|
||||
|
||||
def _fefo_lots(db: Session, product_id: int) -> list[Lot]:
|
||||
"""Lots eines Produkts, sortiert nach Ablaufdatum (NULL zuletzt), dann Alter."""
|
||||
"""Lots eines Produkts, sortiert nach dem WIRKSAMEN Datum (NULL zuletzt).
|
||||
|
||||
Wirksam ist das frühere aus MHD und Verbrauchsdatum (``Lot.faellig_am``).
|
||||
Eine angebrochene Packung kommt damit meist von selbst zuerst, weil ihr
|
||||
Verbrauchsdatum näher liegt – aber eine ungeöffnete Charge, die morgen
|
||||
abläuft, geht vor. Erst bei gleichem Datum wird das Angebrochene vorgezogen,
|
||||
damit nicht eine zweite Packung aufgeht, während eine offen ist.
|
||||
"""
|
||||
lots = (
|
||||
db.query(Lot)
|
||||
.filter(Lot.product_id == product_id, Lot.quantity > 0)
|
||||
.order_by(asc(Lot.created_at))
|
||||
.all()
|
||||
)
|
||||
# NULL-best_before ans Ende (nach Datum aufsteigend). In Python sortieren, damit
|
||||
# es über SQLite und Postgres identisch funktioniert.
|
||||
# In Python sortieren, damit es über SQLite und Postgres identisch arbeitet.
|
||||
return sorted(
|
||||
lots,
|
||||
key=lambda lot: (lot.best_before is None, lot.best_before or date.max, lot.id),
|
||||
key=lambda lot: (
|
||||
lot.faellig_am is None,
|
||||
lot.faellig_am or date.max,
|
||||
lot.opened_on is None,
|
||||
lot.id,
|
||||
),
|
||||
)
|
||||
|
||||
|
||||
@@ -541,7 +673,7 @@ def check_out(
|
||||
Gibt die Liste der betroffenen Chargen mit abgebuchter Menge zurück.
|
||||
Wirft StockError, wenn der Gesamtbestand nicht ausreicht.
|
||||
"""
|
||||
needed = to_base(db, product, quantity, unit)
|
||||
needed = to_base(db, product, quantity, unit, hausmasse=True)
|
||||
available = current_stock(db, product.id)
|
||||
if needed > available + 1e-9:
|
||||
raise StockError(
|
||||
|
||||
Reference in New Issue
Block a user