Raffinerie

Raffinerie

/refinery-orders — Raffinerie-Aufträge bilden Refining-Jobs (Erz → SCU) inkl. Stammdaten, Laufzeit und Material-Ergebnissen ab. Im UI heißt der Bereich Raffinerieverwaltung. Sie sind org-scoped: jede Org-Einheit sieht nur ihre eigenen Aufträge. Wer keiner Org-Einheit angehört, legt rein persönliche Aufträge an, die nur er selbst sieht.

Die aktive Org-Einheit (Staffel oder SK) steht im Anwendungstitel (Kopfzeile + Browser-Tab) und wird über den Sidebar-Umschalter „Aktiver Bereich" gewechselt. Sie bestimmt, in welche Org-Einheit ein neuer Auftrag gestempelt wird und welche Aufträge du in der Liste siehst.

Lifecycle

Status	Bedeutung
Offen	Geplant, noch nicht gestartet.
In Bearbeitung	Läuft (von „Gestartet" bis „Ende").
Abgeschlossen	Fertig — Materialien können ins Lager gebucht werden.
Abgebrochen	Abgebrochen / verworfen.

Liste

/refinery-orders zeigt ID, Besitzer, Status, Ende, Ort, Einsatz, Materialien und Aktionen. Das Startdatum steht (zur Platzersparnis) nur noch in den Auftragsdetails. Im Admin-Modus „Alle Bereiche" gibt es zusätzlich die Spalte Staffel.

Filter

• Status — Mehrfachauswahl (Offen / In Bearbeitung / Abgeschlossen / Abgebrochen).
• Meine Aufträge — Haken setzen, um nur die eigenen Aufträge zu sehen.

Auftrag anlegen

/refinery-orders/create:

• Ort (Refinery / Station)
• Eingabe-Material(ien) mit Menge
• Erwartete Ausgabe-Material(ien) mit Menge
• Laufzeit (Gestartet / Ende)
• Verknüpfter Einsatz (optional)

Logistiker können Aufträge auch für andere Nutzer anlegen.

Zeiten werden in UTC gespeichert und in deiner lokalen Zeit (Europe/Berlin) angezeigt. Jeder Auftrag trägt eine Version: Speichert jemand parallel, bekommst du einen 409-Konflikt-Hinweis („bitte neu laden").

Auftrag aus Screenshot vorausfüllen (Extractor-Import)

Statt alle Zeilen von Hand abzutippen kannst du einen Raffinerie-Auftrag aus einem Screenshot des In-Game-Raffinerie-Bildschirms vorausfüllen lassen. Den Screenshot liest der Desktop-Extractor lokal auf deinem Rechner aus und erzeugt daraus eine JSON-Datei. Bilder verlassen deinen Rechner nie — nur das ausgelesene JSON geht an das Basetool.

So läuft es ab:

1. Du erstellst mit dem Desktop-Extractor die JSON-Datei (Setup-Panel des Raffinerie-Bildschirms, nach „GET QUOTE").
2. Du bringst das JSON ins Anlege-Formular — entweder per Datei-Import auf /refinery-orders/create (Button zum Hochladen der JSON-Datei) oder per Ein-Klick-Versand direkt aus dem Extractor (siehe Desktop-Extractor).
3. Das Basetool gleicht Materialien, Ort und Methode gegen die Stammdaten ab und füllt das Formular vor. Du bekommst einen ungespeicherten Entwurf zur Kontrolle — nichts wird automatisch gespeichert.
4. Du prüfst den Entwurf, korrigierst Hinweise und klickst erst dann auf Speichern.

Das Speichern läuft danach über denselben normalen Anlege-Weg wie ein von Hand erfasster Auftrag — mit voller Prüfung und Org-Einheits-Zuordnung. Der Import legt also nie selbst einen Auftrag an.

Was der Entwurf dir zeigt

Über dem Formular fasst ein Banner zusammen, wie viele Zeilen erkannt und wie viele übersprungen wurden. Zusätzlich markiert das Basetool einzelne Felder mit Hinweisen, z. B.:

• Nicht erkanntes Material — der Name ließ sich nicht eindeutig zuordnen. Wenn es nahe Treffer gibt, kannst du sie per Klick-Chip ins Auswahlfeld übernehmen; sonst wählst du das Material selbst.
• Unsicherer Treffer — ein Material wurde übernommen, aber mit niedriger Trefferwahrscheinlichkeit (als Prozentwert angezeigt). Bitte kurz gegenprüfen.
• Ort / Methode nicht erkannt — bleibt leer und muss von dir gesetzt werden (normal, wenn der Screenshot die Kopfzeile nicht enthält).
• Zeile übersprungen — z. B. weil der REFINE-Schalter aus war, die Zeile nicht „gequotet" wurde oder die Menge 0 war.
• Ungültige Qualität — ein Qualitätswert außerhalb des erlaubten Bereichs; im Formular korrigierbar, aber nicht speicherbar, bis er stimmt.

Solche Hinweise blockieren das Speichern nicht pauschal — leere Pflichtfelder (z. B. ein nicht erkanntes Material) musst du aber vor dem Speichern ausfüllen. Die Startzeit übernimmt das Basetool, wenn möglich, aus dem Aufnahmezeitpunkt der Screenshots.

Große Aufträge: Lange Materiallisten, die über mehrere Screenshots aufgenommen wurden, werden unterstützt — der Extractor fügt die Bilder zu einer zusammenhängenden Auftragsliste zusammen.

Den Extractor selbst, seine Installation und den Ein-Klick-Versand beschreibt die Seite Desktop-Extractor.

Abschluss

Wenn der Auftrag läuft und endet, setzt du den Status auf Abgeschlossen. Beim Abschluss kannst du die Ergebnis-Materialien direkt ins Lager buchen.

Rundungsverhalten (Units → SCU)

Die Raffinerie rechnet in Units, das Lager in SCU. Die Konvertierung rundet je nach Systemeinstellung Auf (UP), Ab (DOWN) oder kaufmännisch (HALF_UP). Konfiguration durch Admins unter Administration → Systemeinstellungen.

Wer darf was?

Aktion	Mitglied	Logistiker	Offizier	Admin
Auftrag ansehen	x	x	x	x
Eigene Aufträge anlegen / bearbeiten / abschließen	x	x	x	x
Auftrag aus Screenshot vorausfüllen (Import-Entwurf)	x	x	x	x
Aufträge der Org-Einheit verwalten / für andere anlegen		x	x	x

Den Screenshot-Import darf jedes angemeldete Mitglied nutzen — er erzeugt nur einen Entwurf, keine gespeicherten Daten. Bearbeiten, löschen und ins Lager buchen darf neben dem Besitzer der Auftrags-Zeile auch ein Logistiker. Die maßgebliche Rollen-Matrix steht in Rollen und Berechtigungen und in ROLES_AND_PERMISSIONS.md. Bei Abweichungen zählt immer der Code.