Zum Inhalt springen

App-Dokumentation · DE

Reststoffe

Screenshot der App

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 (Standard kg), utilization_path (food|feed|fuel|waste), disposition_status (pending|utilized|disposed), optional source_production_ref, source_lot_id und byproduct_lot_id.
  • Verwertungsweg: food- und feed-Reststoffe kehren als Reststoff-Los in den Bestand zurück; fuel und waste verlassen 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

  1. Erfassen Sie einen Reststoff mit Material, Menge und Verwertungsweg.
  2. Filtern Sie die Liste nach Verwertungsweg und Disposition, um zu sortieren, was noch offen ist.
  3. Markieren Sie jeden offenen Reststoff als verwertet oder entsorgt.