Files
Vorrania/backend/app/routers/settings.py
T
ScarriffleandClaude Opus 5 fa5a2bc4fa 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

126 lines
4.6 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
from fastapi import APIRouter, Depends, HTTPException
from sqlalchemy.orm import Session
from ..config import get_settings
from ..database import get_db
from ..deps import get_current_user, require_admin
from ..models import Setting, User
from ..schemas import SettingOut
from ..services.vererbung import globale_oeffnungsfrist
router = APIRouter(prefix="/settings", tags=["settings"])
EXPIRY_WARNING_KEY = "expiry_warning_days"
# Ab wie viel Prozent Übereinstimmung ein Artikel beim Kassenzettel-Scan als
# Treffer vorgeschlagen wird.
RECEIPT_THRESHOLD_KEY = "receipt_match_threshold"
RECEIPT_THRESHOLD_DEFAULT = 45
# Wie lange eine Anmeldung gilt, in Tagen. 0 = unbegrenzt.
SESSION_DAYS_KEY = "session_days"
# Zehn Jahre. Wer laenger will, nimmt "unbegrenzt" – ein Token mit einem
# Ablauf im naechsten Jahrhundert waere dasselbe, nur unehrlicher.
SESSION_DAYS_MAX = 3650
# Wie lange eine angebrochene Packung gilt, wenn weder Artikel noch Kategorie
# etwas sagen. Pflichtwert: Ohne ihn haette eine offene Packung kein
# Verbrauchsdatum, und das Anbrechen waere sinnlos.
OPEN_DAYS_KEY = "open_days"
OPEN_DAYS_MAX = 3650
def get_expiry_warning_days(db: Session) -> int:
row = db.get(Setting, EXPIRY_WARNING_KEY)
if row is None:
return get_settings().expiry_warning_days_default
try:
return int(row.value)
except ValueError:
return get_settings().expiry_warning_days_default
def get_receipt_match_threshold(db: Session) -> int:
"""Schwellwert (0–100) für Kassenzettel-Treffer; auf sinnvollen Bereich geklemmt."""
row = db.get(Setting, RECEIPT_THRESHOLD_KEY)
if row is None:
return RECEIPT_THRESHOLD_DEFAULT
try:
return max(0, min(100, int(row.value)))
except ValueError:
return RECEIPT_THRESHOLD_DEFAULT
def get_session_days(db: Session) -> int:
"""Gueltigkeitsdauer einer Anmeldung in Tagen; **0 heisst unbegrenzt**.
Ohne Eintrag gilt der Rueckfallwert aus der Umgebung
(``JWT_EXPIRE_MINUTES``), damit eine frische Installation nicht erst
eingestellt werden muss.
"""
vorgabe = max(1, round(get_settings().jwt_expire_minutes / (60 * 24)))
row = db.get(Setting, SESSION_DAYS_KEY)
if row is None:
return vorgabe
try:
return max(0, min(SESSION_DAYS_MAX, int(row.value)))
except ValueError:
return vorgabe
def get_session_minutes(db: Session) -> int:
"""Dasselbe in Minuten, wie :func:`create_access_token` es erwartet.
Die 0 fuer "unbegrenzt" ueberlebt die Umrechnung unveraendert.
"""
return get_session_days(db) * 24 * 60
@router.get("", response_model=list[SettingOut])
def list_settings(
db: Session = Depends(get_db), _: User = Depends(get_current_user)
) -> list[SettingOut]:
rows = db.query(Setting).all()
known = {r.key: r.value for r in rows}
known.setdefault(EXPIRY_WARNING_KEY, str(get_expiry_warning_days(db)))
known.setdefault(RECEIPT_THRESHOLD_KEY, str(get_receipt_match_threshold(db)))
known.setdefault(SESSION_DAYS_KEY, str(get_session_days(db)))
known.setdefault(OPEN_DAYS_KEY, str(globale_oeffnungsfrist(db)))
return [SettingOut(key=k, value=v) for k, v in known.items()]
@router.put("/{key}", response_model=SettingOut)
def set_setting(
key: str,
value: str,
db: Session = Depends(get_db),
_: User = Depends(require_admin),
) -> SettingOut:
if key == OPEN_DAYS_KEY:
# Gleiche Begruendung wie unten: ein Tippfehler darf nicht still auf die
# Vorgabe zurueckfallen, waehrend der Admin glaubt, er haette etwas gesetzt.
try:
tage = int(value)
except ValueError:
raise HTTPException(400, "Haltbarkeit nach dem Anbrechen muss eine Zahl in Tagen sein")
if not 1 <= tage <= OPEN_DAYS_MAX:
raise HTTPException(400, f"Haltbarkeit nach dem Anbrechen: 1 bis {OPEN_DAYS_MAX} Tage")
value = str(tage)
if key == SESSION_DAYS_KEY:
# Ohne diese Pruefung wuerde get_session_days einen Tippfehler still
# auf die Vorgabe zurueckdrehen – und der Admin glaubte, es sei gesetzt.
try:
tage = int(value)
except ValueError:
raise HTTPException(400, "Sitzungsdauer muss eine Zahl in Tagen sein (0 = unbegrenzt)")
if not 0 <= tage <= SESSION_DAYS_MAX:
raise HTTPException(400, f"Sitzungsdauer: 0 (unbegrenzt) bis {SESSION_DAYS_MAX} Tage")
value = str(tage)
row = db.get(Setting, key)
if row is None:
row = Setting(key=key, value=value)
db.add(row)
else:
row.value = value
db.commit()
return SettingOut(key=key, value=value)