Files
Vorrania/backend/app/routers/maintenance.py
Scarriffle eaacfd03e5 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>
2026-08-15 21:48:14 +02:00

127 lines
4.2 KiB
Python
Raw Permalink 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.
"""Gefahrenbereich: Daten in großem Stil löschen.
Bewusst in drei Stufen, damit man nicht mehr wegwirft als nötig:
1. ``/reset/stock`` Chargen und Bewegungsverlauf. Der Katalog bleibt.
2. ``/reset/products`` zusätzlich alle Artikel samt EAN-Codes.
3. ``/reset/all`` zusätzlich Gruppen, Kategorien, Lagerorte, Einheiten.
Benutzer, API-Tokens, Einstellungen und das eigene Logo bleiben in **allen**
Stufen erhalten: Sonst würde man sich aussperren und müsste externe Zugriffe
(Home Assistant) neu einrichten.
Nach Stufe 3 werden die eingebauten Einheiten und die Kategorie-Startliste
sofort neu angelegt ohne Einheiten ließe sich nichts mehr einlagern.
"""
from fastapi import APIRouter, Depends
from pydantic import BaseModel
from sqlalchemy.orm import Session
from ..database import get_db
from ..deps import require_admin
from ..models import (
Barcode,
Category,
Group,
group_parents,
Location,
Lot,
Movement,
Product,
Unit,
User,
)
from ..seed import ensure_builtin_categories, ensure_builtin_units
router = APIRouter(prefix="/maintenance", tags=["maintenance"])
class ResetSummary(BaseModel):
"""Was gerade in der Datenbank steht für die Rückfrage vor dem Löschen."""
lots: int = 0
movements: int = 0
products: int = 0
groups: int = 0
categories: int = 0
locations: int = 0
units: int = 0
def _summary(db: Session) -> ResetSummary:
return ResetSummary(
lots=db.query(Lot).count(),
movements=db.query(Movement).count(),
products=db.query(Product).count(),
groups=db.query(Group).count(),
categories=db.query(Category).count(),
locations=db.query(Location).count(),
units=db.query(Unit).count(),
)
def _delete_stock(db: Session) -> None:
"""Chargen und Verlauf. Zuerst die Bewegungen, sie verweisen auf Chargen."""
db.query(Movement).delete(synchronize_session=False)
db.query(Lot).delete(synchronize_session=False)
def _delete_products(db: Session) -> None:
_delete_stock(db)
# EAN-Codes hängen an Artikeln UND an Gruppen. Hier gehen nur die der
# Artikel weg; die Gruppen-Codes bleiben, solange die Gruppen bleiben.
db.query(Barcode).filter(Barcode.product_id.isnot(None)).delete(
synchronize_session=False
)
db.query(Product).delete(synchronize_session=False)
@router.get("/summary", response_model=ResetSummary)
def summary(db: Session = Depends(get_db), _: User = Depends(require_admin)) -> ResetSummary:
return _summary(db)
@router.post("/reset/stock", response_model=ResetSummary)
def reset_stock(
db: Session = Depends(get_db), _: User = Depends(require_admin)
) -> ResetSummary:
"""Alle Bestände auf null Artikel, Gruppen und Stammdaten bleiben."""
_delete_stock(db)
db.commit()
return _summary(db)
@router.post("/reset/products", response_model=ResetSummary)
def reset_products(
db: Session = Depends(get_db), _: User = Depends(require_admin)
) -> ResetSummary:
"""Katalog leeren: Artikel samt Chargen, Verlauf und ihren EAN-Codes."""
_delete_products(db)
db.commit()
return _summary(db)
@router.post("/reset/all", response_model=ResetSummary)
def reset_all(
db: Session = Depends(get_db), _: User = Depends(require_admin)
) -> ResetSummary:
"""Zusätzlich Gruppen, Kategorien, Lagerorte und Einheiten."""
_delete_products(db)
# Restliche EAN-Codes (die an Gruppen hängen) mitnehmen.
db.query(Barcode).delete(synchronize_session=False)
# Ober-/Untergruppen-Kanten ausdrücklich: ein Core-DELETE räumt die n:m-
# Zeilen nicht mit ab, und SQLite erzwingt keine Fremdschlüssel sonst
# blieben verwaiste Kanten stehen und hefteten sich an neu vergebene IDs.
db.execute(group_parents.delete())
db.query(Group).delete(synchronize_session=False)
db.query(Category).delete(synchronize_session=False)
db.query(Location).delete(synchronize_session=False)
db.query(Unit).delete(synchronize_session=False)
db.commit()
# Ohne Einheiten wäre die Installation unbrauchbar, deshalb sofort zurück
# auf den Auslieferungsstand.
ensure_builtin_units(db)
ensure_builtin_categories(db)
return _summary(db)