Files
skrift-programme/Produktion/skrift-agent
Lucas Orth f77ddb6a4c Formate zentral aus Directus + Kuvert-/Agent-/Login-Fixes
Formate zentralisiert (Phase 1)
- Neue Collection render_formats (Seitengröße, Ränder, Zeilenhöhe/-limit +
  Plotter-Template) als einzige Quelle. Backend liest sie gecacht (Start +
  stündlich, synchroner Zugriff → keine Latenz) mit eingebauten Defaults als
  Fallback; manueller Trigger via POST /api/formats/refresh.
- Ermöglicht frei definierbare Formate ohne Codeänderung.

Kuvert-Templates
- Werte 1:1 aus dem alten Job-Manager übernommen (falsche/vertauschte Maße
  korrigiert, per Upsert) und je Format die zweite Variante ergänzt
  (individuelle Beschriftung). Druck-Popup schlägt bei freiem Text Variante 2 vor.

Produktions-Agent
- Datei-Endpunkt liefert {files} ohne data-Hülle → eigener get_raw statt des
  data-auspackenden get; Dokumentauswahl positionsbasiert (robust gegen 0-/1-
  basierte Dateinamen).

Bootstrap
- Ungültiger DIRECTUS_TOKEN wird erkannt und fällt auf ADMIN_EMAIL/PASSWORD
  zurück, statt mit einem 401 abzubrechen.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-24 09:05:09 +02:00
..

Skrift Produktions-Agent

Schlanker lokaler Agent (Windows) neben dem Plotter. Steuerung läuft über Directus – der Agent macht nur: Heartbeat → Job holen → drucken → melden.

Einrichtung

  1. In Directus einen Nutzer der Rolle Service anlegen und einen statischen Token erzeugen.
  2. Die Maschine in Directus unter Einstellungen → Maschinen anlegen (base_url, ggf. mid/Login). Die numerische ID der Maschine ist die machine_id für die Agent-Config.
  3. config.example.json → config.json kopieren und ausfüllen (directus_url, directus_token, machine_id).
  4. Abhängigkeiten installieren und starten:
python -m venv .venv
.venv\Scripts\pip install -r requirements.txt
.venv\Scripts\python agent.py

Ablauf

  • Der Agent meldet zyklisch machines.status + last_seen (Heartbeat).
  • Er zieht den nächsten jobs-Eintrag seiner Maschine mit status=queued (sortiert nach priority, dann Alter).
  • Er lädt die SVGs des Auftrags passend zum Job-Typ (Schriftstück/Umschlag) über den Directus-Datei-Endpoint (/skrift-orders/files/...) und schickt sie mit den Template-Werten (Maße/Position/Rotation) an den Plotter.
  • Status zurück: printing → printed bzw. failed (+ Fehlermeldung).
  • Bei Maschinenfehler (z. B. Papierende) ruft er recover_write auf.

Jobs entstehen

Über den Admin-Trigger POST /skrift-orders/enqueue { order, machine } (bzw. später ein Button in der Webapp). Pro Auftrag entsteht ein Brief-Job und – falls Kuvert beschriftet – ein Umschlag-Job, jeweils mit aufgelöstem Template.

Signaturen / AutoRecover

Der Signatur-Service bleibt vorerst unberührt. Das win32-AutoRecover (klickt das Java-Fenster) kann weiter separat laufen; der Agent nutzt zusätzlich den API-recover_write der Maschine.