Reststoffe

Mit Reststoffe verwalten Sie Produktionsreststoffe auf Basis des ERP-Byproducts-Backends: Erfassen Sie jeden bei der Lebensmittelproduktion anfallenden Reststoff, klassifizieren Sie ihn nach einem Verwertungsweg, listen Sie Reststoffe nach Verwertungsweg mit Dispositions-Badges auf und überführen Sie einen offenen Reststoff in seine endgültige Disposition.
Bereiche
- Reststoffe: eine Filterleiste (Verwertungsweg + Disposition) und die Reststoffliste. Offene Zeilen zeigen farbige Dispositions-Badges sowie die Aktionen Verwerten / Entsorgen; abgeschlossene Zeilen sind schreibgeschützt.
- Erfassen: ein Formular zum Erfassen eines Reststoffs (Material, Menge, Verwertungsweg, optionale Einheit, Produktionsreferenz und Quell-Los).
- Während des Speicherns ist das Formular als beschäftigt markiert und die Schaltfläche gesperrt. Ein Doppelklick erzeugt daher nur einen Vorgang; nach Abschluss kann derselbe Reststoff bewusst erneut erfasst werden.
- Hilfe: In-App-Hinweise.
Felder und Konzepte
- Reststoff:
material_id,qty(Dezimalzeichenkette),unit(Standardkg),utilization_path(food|feed|fuel|waste),disposition_status(pending|utilized|disposed), optionalsource_production_ref,source_lot_idundbyproduct_lot_id. - Verwertungsweg:
food- undfeed-Reststoffe kehren als Reststoff-Los in den Bestand zurück;fuelundwasteverlassen die Lebensmittelkette (es wird kein Los erstellt). - Disposition: der Lebenszyklus
pending -> utilized | disposed. Ein abgeschlossener Reststoff kann nicht erneut überführt werden.
Backend-Vertrag
Alle Routen liegen unter /api/erp/byproducts, mandantenbezogen, mit dem {success, data}-Umschlag.
POST /— einen Reststoff erfassen. Body (snake_case):{material_id, qty, utilization_path, user_id?, unit?, source_production_ref?, source_lot_id?}. Gibt 201 zurück, oder 422 bei Validierungsfehlern.GET /?utilization_path=&disposition_status=&limit=— Reststoffe auflisten; Zeilen sind in{byproducts: [...]}verpackt.GET /{id}— einen Reststoff lesen.POST /{id}/utilize— einen offenen Reststoff als verwertet markieren. Body:{note?}.POST /{id}/dispose— einen offenen Reststoff als entsorgt markieren. Body:{note?}. Das erneute Überführen eines abgeschlossenen Reststoffs gibt 409 zurück.
Die Authentifizierung verwendet httpOnly-Cookie + CSRF über @it-tremmel.de/platform-http authedFetch (credentials: 'include'); es werden keine Tokens aus dem localStorage gelesen.
Typischer Ablauf
- Erfassen Sie einen Reststoff mit Material, Menge und Verwertungsweg.
- Filtern Sie die Liste nach Verwertungsweg und Disposition, um zu sortieren, was noch offen ist.
- Markieren Sie jeden offenen Reststoff als verwertet oder entsorgt.