Anleitung zum Planungsprogramm Sittard (Planungskreis, Adresse 127.0.0.1:8791)

Für Planer im Werk ohne Projektwissen. Stand 12.11.2026. Jeder Schritt unten wurde am laufenden Programm nachgespielt; die Knöpfe und Überschriften stehen so, wie sie auf der Seite stehen. Zahlen in den Beispielen sind Beispiele vom 12.11.2026: der Plan ändert sich mit jedem neuen Datenstand. Englische Fassung: ANLEITUNG_PLANUNGSPROGRAMM_EN.md (im Programm: Seite „Anleitung“, Link „English“).

1. Wozu das Programm da ist

Thomas' Ziel (11.11.2026): „ich will ein in echt funktunierendes Toll sehen mit allen echten auflagen und zielen die wir hier in allen chats besprochen haben!“

Das Programm nimmt die Daten des Werks (SAP-Aufträge, Bestand, Material, gemessene Wechsel- und Laufzeiten), legt daraus für jede Woche einen Plan je Linie (welcher Auftrag, auf welcher Linie, in welcher Reihenfolge) und prüft diesen Plan gegen alle Auflagen des Werks, die es kennt. Es sagt, ob der Plan ausgegeben werden darf, und wenn nicht, warum. Was es nicht prüfen kann, weil Werksdaten fehlen, sagt es ausdrücklich.

Wörter und Kürzel: Reiter „Was die Wörter heißen“ (Link oben auf jeder Seite). Kürzel, deren Bedeutung noch niemand belegt hat, stehen in stand/2026-11-10/begriffe_offen.csv.

2. Starten

  1. Im Terminal in den Projektordner wechseln: cd ~/Desktop/Sittard_Planungsanalyse_2026-10.
  2. Programm starten: /usr/bin/python3 programm/start.py 8791. Das Fenster offen lassen.
  3. Im Browser öffnen: http://127.0.0.1:8791/kreis. Es erscheint die Seite „Planungskreis“ mit der ersten Planwoche („Planungskreis · KW … · Woche ab …“). Die Seite lädt einige Sekunden („wird geladen …“).
  4. Oben in der Zeile „Woche:“ stehen die Wochen mit Plan (zum Beispiel KW 47 · KW 48 · KW 49) und die Links „Matrizen“, „M13 Umbau, M14 Raten“, „Simulator“, „Plan von Hand prüfen“, „Was die Wörter heißen“, „Anleitung“.

Hinweis: Port 8769 ist der alte Simulator (Referenz). Er wird nicht angefasst.

3. Neue Daten einlesen

3.1 Eingangsordner

Die Dateien eines Tages werden unverändert in einen Ordner eingang/<JJJJ-MM-TT>/ gelegt (zum Beispiel eingang/2026-11-10/): Every-Angle-Ordner täglich, COID-Liste donnerstags (Wouter), OEE der letzten 8 Tage montags (Shannon), Kundenaufträge, sobald Rick sie liefert. Welche Datei wie heißen muss, steht in programm/importe/datenvertrag.py.

3.2 Import und Lauf

Die Befehle (aus programm/ARCHITEKTUR.md Abschnitt 5 und dem Kopf von programm/lauf.py):

Nicht nachgespielt: Import und Lauf habe ich für diese Anleitung nicht ausgeführt, weil sie einen Stand schreiben, an dem gerade andere rechnen. Nachgespielt ist, was danach auf der Seite steht (3.3).

3.3 Importbericht und Ampel lesen

Auf /kreis oben der Kasten „Daten: was fehlt oder alt ist“. Erste Zeile zum Beispiel: „Stand 2026-11-10: 8 rot, 2 gelb, 22 in Ordnung · Import … · Bericht stand/2026-11-10/importbericht.md“. Darunter die Tabelle mit den Spalten Ampel, Datei, Lieferant, Stichtag, Tage seit Stichtag, was fehlt.

Darunter: „Artikel ohne Zuordnung“ (Artikel, denen Sirup, Dose, Deckel oder Pack fehlt; Liste stand/<Datum>/artikel_ohne_zuordnung.csv) und „Offen (Annahme F3): Als Liefertermin gilt der SAP-Wochenbedarf, weil die Kundenaufträge fehlen.“

4. Planungskreis lesen

4.1 Kopfzahlen „Woche in Zahlen“

Kacheln mit je einer Zahl und dem Vergleich darunter, zum Beispiel: „Aufträge mit Lauf im Wochenplan“, „Aus dieser SAP-Woche gelegt“, „Dosen“, „Stunden laut Kern“ (gegen „SAP-Folge wie geplant“), „Gebrauchte Dosen je Linienstunde“, „Plan ausgebbar“, „Harte Verstöße laut Kern“, „Linien über ihren Stunden“, „Später als Bedarfswoche“, „Linienwechsel“. Darunter „Gebrauchte Dosen je Linienstunde je Linie“ zum Aufklappen.

4.2 Die zehn Stationen

Abschnitt „Die zehn Stationen: was das Programm in dieser Woche an jeder Station entschieden hat“. Die Reihenfolge der Abhängigkeit steht darüber: 1 Kundenauftrag → 2 Liefertermin → 3 Bestand → 4 Nettobedarf → 5 Material → 6 Kapazität → 7 Linie → 8 Reihenfolge → 9 Warenfluss → 10 Rückmeldung. Jede Station ist ein Knopf mit Frage (zum Beispiel Station 5 „Material – Ist alles da?“), Satz der Woche, Zahl grün/gelb/rot und „hängt ab von …“.

Knopf drücken: darunter erscheint die Station mit ihren Prüfungen (zum Beispiel 5.1 „Dose und Deckel: Abruf in 1 Tag möglich“) und je Prüfung der Zahl grün, gelb, rot, nicht geprüft; dazu Listen wie „Aus der Woche genommen“ mit Auftrag, Artikel, Linie, Woche und Warum.

4.3 „Plan ausgebbar“ und die Ursachen

Die Kachel „Plan ausgebbar“ zeigt ja oder nein. Bei nein steht darunter die Zahl der Ursachen und jede Ursache in einem Satz, zum Beispiel (12.11.2026, KW 47): „Der Wochenplan KW 47 verletzt 2 harte Auflagen an 3 Stellen · Über die Wochenpläne des Stands liegen 5-mal zwei Läufe zugleich auf einer Linie · 15 Aufträge der Planwochen stehen in SAP, aber in keinem Wochenplan des Stands“. Solange „nein“ steht, gibt es keine Änderungsliste für SAP (Abschnitt 9).

4.4 Jeder Auftrag durch alle zehn Stationen

Tabelle „Jeder Auftrag durch alle zehn Stationen“: je Auftrag Linie, Platz, Auftrag, Artikel, Dosen, Start, h, dann je Station ein Punkt (grün in Ordnung, gelb Achtung, rot Verstoß, grau offen, weil Daten fehlen) und die Spalte „Planer“ (zum Beispiel „bleibt“, „vorgezogen aus KW 48“, „andere Linie (PL6 → PL5)“). Zeile anklicken: darunter stehen je Station die Prüfungen mit Urteil, Grund und Quelle (Beispiel: „1.3 Menge plausibel: gegen Mindestlos und Palettenrundung: grün · …“).

5. Verstöße lesen

5.1 Verstöße laut Kern (Station 8)

Unter „Station 8: Reihenfolge“ die Tabelle „Verstöße laut Kern in dieser Woche“ mit den Spalten Art (hart oder weich), Linien, Was. Beispiel: „weich · PL3, PL5 · Lauge zugleich auf PL3 und PL5 (17.11. 04:27): Laugenkonditionierung“. Darunter „Läufe über die Wochengrenze“ (Linie, Auftrag und Artikel, was der Wochenplan sagt) und „Weiche Regeln je Abteilung: was es diese Woche kostet, wenn die Abteilung sie verlangt“ (Regel, Preis in Stunden, harte Verstöße danach).

5.2 Regelprüfung des Werks (Auflage, Linie, Zeit, Auftrag)

Abschnitt „Regelprüfung des Werks (Regelwache: jede harte Auflage gegen den Wochenplan)“. Erste Zeile: „Plan ausgebbar: …“ mit der Zahl verletzter, eingehaltener und nicht gerechneter Auflagen. Darunter vier Listen:

6. Plan von Hand prüfen (Seite „Plan von Hand prüfen“)

Zweck: einen Wochenplan an einzelnen Stellen ändern und prüfen lassen, ob er ausführbar wäre. Der Wochenplan des Planers selbst bleibt unverändert.

6.1 Beispiel Schritt für Schritt

Beispiel vom 12.11.2026 (Lauf und Ergebnis ändern sich mit dem Plan):

  1. Auf /kreis oben „Plan von Hand prüfen“ anklicken (oder http://127.0.0.1:8791/pruefplan).
  2. „1. Woche“: KW 47 (ab 16.11.) wählen.
  3. „2. Lauf im Wochenplan“: den Lauf „PL8 · Mo 23.11. 10:42 · 50BLA Mon Mango Loco FR 116558 12x …“ wählen.
  4. „3. Eingriff“: „Lauf auf eine andere Linie legen“. Bei „Neue Linie“ PL9 wählen; „Neue Startzeit“ leer lassen (gleiche Zeit); „Reinigung davor“ „wie bisher“; „Folgeläufe auf der neuen Linie“ „nach hinten schieben“.
  5. Knopf „Eingriff zur Liste“. Unter „Ihre Eingriffe“ steht jetzt „PL8 Mo 23.11. 10:42 50BLA Mon Mango Loco FR 116558 12x (Auftrag 6181371) → auf PL9“ (mit „entfernen“).
  6. Knopf „Geänderten Plan prüfen“. Es erscheint „Das Programm prüft und rechnet nach (etwa eine halbe bis eine Minute) …“.
  7. Ergebnis lesen: „Plan KW 47 ausführbar: NEIN“, dann „Was geändert wurde“ und „Verstöße, die durch Ihre Eingriffe neu sind“ mit Auflage, Linie, Tag und Uhrzeit, Auftrag und Artikel, Was genau. Im Beispiel unter anderem H056 (Mango Loco 50 cl laut Fassung 2026 nur PL8), H075 („Dose Standard laut BDR nicht auf PL9“), H064 (auf PL9 nie gelaufen, keine gemessene Leistung) und eine Doppelbelegung auf PL9. Weiter unten „Was der Rechenkern von sich aus anders legt“ und „Nicht gerechnet, weil Werksdaten fehlen“.
  8. „Liste leeren“ setzt die Eingriffe zurück.

6.2 Die anderen Eingriffe

Unter „3. Eingriff“ gibt es außerdem: „Lauf zeitlich legen (Startzeit)“, „Lauf verlängern (Menge oder Stunden)“, „Reinigung vor dem Lauf ändern oder weglassen“, „Umbau zeitlich legen“, „Lauf eines Artikels einfügen“, „Lauf streichen“. Mehrere Eingriffe können nacheinander zur Liste gegeben und zusammen geprüft werden.

7. Weiche Regeln schalten und ihren Preis ablesen

  1. Auf /kreis die Station 8 öffnen (Knopf „Station 8 · Herzstück“, Abschnitt „Station 8: Reihenfolge“) und dort „Abteilungen: weiche Regeln schalten“ anklicken. Es öffnet sich die Seite „Sittard Wochenplan · einfach“ für die gewählte Woche (direkt: http://127.0.0.1:8791/einfach). Der Link „Simulator“ oben führt dagegen zur vollen Seite (Punkt 5).
  2. Links oben „Diese Woche braucht der Plan … h Linienzeit“, rechts „Weiche Regeln eingeschaltet: 0 von 5“ und „Preis diese Woche“.
  3. Je Abteilung (Produktion, Technik) die Regeln mit Schalter. Beispiel: unter Produktion „Wochenreinigung an einem Werktag, 08:00 bis 17:00“ einschalten. Das Programm rechnet neu; am 12.11.2026 stand dann rechts „+36,3 h Preis diese Woche“ und unter der Regel „je Stelle: Linie, Tag, Umbau, Lösung, Preis“.
  4. Schalter wieder aus: Preis zurück auf 0 h.
  5. „Erweiterte Ansicht →“ führt zur vollen Seite mit Reitern (Woche, Spezifikation je Auftrag, Alle Matrizen, Regelprüfung dieser Woche, Regeln des Werks, die im Programm fehlen, Abteilungen, Gemessen, Monat und Jahr, Was die Wörter heißen).

8. Matrizen

9. Änderungsliste für SAP

Was sie ist: je Auftrag, wie er heute in SAP steht (alt) und wie er im Wochenplan steht (neu), was in SAP zu tun ist und warum. Sie steht auf /kreis unter „Änderungsliste für SAP“ und füllt sich beim Laden der Seite (steht dort noch der Knopf „Änderungsliste dieser Woche rechnen und zeigen“, ihn drücken). Darunter „Anleitung für den Planer“ mit den Schritten je Zeilenart („bleibt“, „aus der Woche genommen“, „hereingeholt“, „andere Linie“, „zusammengelegt“, „neue Reihenfolge“) und dem Donnerstag-12:00-Takt.

Wann sie gesperrt ist: wenn der Plan nicht ausgebbar ist, vor allem wenn die Regelwache eine verletzte harte Auflage findet (die Seite nennt dazu auch zwei Läufe zugleich auf einer Linie und Aufträge, die in keinem Wochenplan stehen). Dann steht dort „Keine Änderungsliste für SAP.“ und statt der Liste die Verstöße (Abschnitt 5.2). Am 12.11.2026 war die Liste für KW 47 und KW 48 gesperrt.

10. Was das Programm heute nicht kann