Gruppen: Obergruppen + Mindestbestaende nur noch je Lagerort (Backend)

Zwei zusammenhaengende Umbauten, weil sie dieselben Stellen betreffen.

Obergruppen: Gruppen bilden jetzt einen gerichteten azyklischen Graphen statt
einer flachen Liste. Eine Gruppe darf unter MEHREREN Obergruppen haengen -
"Grillwurst" unter "Wurst" UND unter "Grillgut"; mit einem einzelnen parent_id
waere genau das nicht abbildbar. Bestand und Mindestbestand einer Gruppe zaehlen
den gesamten Untergraphen, wobei eine ueber zwei Wege erreichbare Untergruppe
nur einmal zaehlt (services/gruppen.py arbeitet durchgaengig mit Mengen).
Product.group_id bleibt unveraendert - ein Artikel haengt weiter an genau einer
Gruppe.

Mindestbestaende: der separate Gesamt-Mindestbestand entfaellt. Er wird zur
Zeile mit location_id NULL ("Ueberall") und ist damit die Wurzel ueber allen
Lagerorten - dieselbe Verrechnung wie bei verschachtelten Orten greift jetzt
auch zwischen Ueberall und Kueche, wodurch derselbe Artikel nicht mehr doppelt
in der Einkaufsliste steht. Alle Werte liegen einheitlich in Basiseinheiten
statt in drei verschiedenen Einheiten nebeneinander; das Umrechnen beim
Umschalten der Erfassungseinheit entfaellt dadurch ersatzlos.

_netted_topups nimmt die Hierarchie jetzt als Parameter und faltet damit
Lagerort-Baum und Gruppen-Graph. Verrechnet wird zwischen zwei Gruppen nur,
wenn die zaehlenden Artikel der Untergruppe eine Teilmenge der Obergruppe sind -
zaehlt die Obergruppe in Kilogramm und die Untergruppe in Stueck, kommt ein Kauf
dort oben nicht an.

Die vierfach kopierte Bestandssumme wandert in Sammelabfragen
(summe_bestand_base), sonst vervielfacht der transitive Teilgraph die Abfragen.

Einmalige Datenwanderung beim Start (Merker in den Einstellungen), 18 neue
Tests - darunter Doppelzaehlung ueber zwei Wege, Ringschutz und die bewusst
offene Grenze bei zwei Obergruppen mit gemeinsamer Untergruppe.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Scarriffle
2026-08-15 21:48:14 +02:00
parent df65d9583c
commit eaacfd03e5
16 changed files with 1327 additions and 238 deletions

View File

@@ -9,9 +9,10 @@ Packungen haben können).
import pytest
from app.models import BaseUnit, Group, PackageType, Product, Role, Unit, User
from app.routers.groups import update_group
from app.routers.groups import _group_to_out, update_group
from app.routers.views import group_shopping_list, shopping_list
from app.schemas import GroupUpdate
from app.services.min_stock import schreibe_ueberall
@pytest.fixture()
@@ -27,12 +28,20 @@ def _gramm(db) -> Unit:
return db.query(Unit).filter(Unit.name == "Gramm").one()
def _ueberall(db, besitzer, menge_base: float) -> None:
"""Mindestbestand „Überall" setzen Mengen immer in Basiseinheiten."""
schreibe_ueberall(db, besitzer, menge_base)
db.commit()
def test_produkt_bedarf_in_ganzen_gebinden(db, user):
"""500 g fehlen bei 195-g-Gläsern -> 3 Gläser (aufgerundet), 500 g als Hinweis."""
db.add(PackageType(singular="Glas", plural="Gläser"))
db.add(Product(name="Pesto", base_unit=BaseUnit.gram, package_size=195,
package_label="Glas", min_stock=500))
pesto = Product(name="Pesto", base_unit=BaseUnit.gram, package_size=195,
package_label="Glas")
db.add(pesto)
db.commit() # kein Bestand -> es fehlt der volle Mindestbestand
_ueberall(db, pesto, 500)
(item,) = shopping_list(db=db, _=user)
assert item.need is not None
@@ -45,11 +54,12 @@ def test_produkt_bedarf_in_ganzen_gebinden(db, user):
def test_gruppe_mit_gruppen_gebinde(db, user):
"""Gruppe mit eigenem Richt-Gebinde (1 Glas ≈ 150 g), Mindestbestand 3 Gläser."""
db.add(PackageType(singular="Glas", plural="Gläser"))
gruppe = Group(name="Pesto alla Genovese", min_stock=3, min_stock_unit=_gramm(db),
gruppe = Group(name="Pesto alla Genovese", min_stock_unit=_gramm(db),
package_size=150, package_label="Glas", min_stock_in_packages=True)
db.add(gruppe)
db.add(Product(name="Pesto Barilla", base_unit=BaseUnit.gram, package_size=99, group=gruppe))
db.commit() # kein Bestand -> es fehlen 3 Gläser (450 g)
_ueberall(db, gruppe, 3 * 150) # 3 Gläser à 150 g
(item,) = group_shopping_list(db=db, _=user)
assert item.need is not None
@@ -61,10 +71,11 @@ def test_gruppe_mit_gruppen_gebinde(db, user):
def test_gruppe_ohne_gebinde_bleibt_basiseinheit(db, user):
"""Ohne aktives Gruppen-Gebinde bleibt es bei der verwalteten Einheit."""
gruppe = Group(name="Mehl", min_stock=500, min_stock_unit=_gramm(db))
gruppe = Group(name="Mehl", min_stock_unit=_gramm(db))
db.add(gruppe)
db.add(Product(name="Mehl 405", base_unit=BaseUnit.gram, group=gruppe))
db.commit()
_ueberall(db, gruppe, 500)
(item,) = group_shopping_list(db=db, _=user)
assert item.need is not None
@@ -74,11 +85,17 @@ def test_gruppe_ohne_gebinde_bleibt_basiseinheit(db, user):
def test_gruppe_umschalten_haelt_physischen_bedarf(db, user):
"""Umschalten g -> Gebinde rechnet den gespeicherten Wert um (500 g / 150 = 3,33 Glas)."""
gruppe = Group(name="Pesto", min_stock=500, min_stock_unit=_gramm(db))
"""Umschalten g -> Gebinde laesst den physischen Bedarf unveraendert.
Gespeichert wird in Basiseinheiten, deshalb bleiben die 500 g stehen und es
ist NUR die Anzeige, die auf ~3,33 Glaeser wechselt. Frueher musste der
gespeicherte Wert dafuer umgerechnet werden.
"""
gruppe = Group(name="Pesto", min_stock_unit=_gramm(db))
db.add(gruppe)
db.add(Product(name="Pesto Barilla", base_unit=BaseUnit.gram, group=gruppe))
db.commit()
_ueberall(db, gruppe, 500)
update_group(
group_id=gruppe.id,
@@ -87,4 +104,7 @@ def test_gruppe_umschalten_haelt_physischen_bedarf(db, user):
)
db.refresh(gruppe)
assert gruppe.min_stock_in_packages is True
assert gruppe.min_stock == pytest.approx(500 / 150, abs=0.01) # ~3,33 Gläser
# Gespeichert unveraendert in Basiseinheiten …
assert gruppe.location_min_stocks[0].min_stock == pytest.approx(500)
# … angezeigt jetzt in Glaesern.
assert _group_to_out(db, gruppe).min_stock == pytest.approx(500 / 150, abs=0.01)