Bambuddy anbinden

FreeCAD-PLM kann die aktuelle synchronisierte Slicer-3MF automatisch als Source-Datei an einen laufenden Bambuddy-Druck hängen. Zusätzlich erhält das Druckarchiv einen externen Link auf die konkrete PLM-Revision. Die Verbindung läuft ausschließlich vom PLM-Server zu Bambuddy; auf den FreeCAD-Arbeitsplätzen ist keine zusätzliche Software nötig.

Voraussetzungen

• Bambuddy ist vom PLM-Server erreichbar.
• Der Drucker ist in Bambuddy eingerichtet.
• Das FreeCAD-Addon synchronisiert das Slicerprojekt bereits zum PLM.
• Ein eigener Bambuddy-API-Key besitzt Read Status und Manage Archives.

Manage Archives entspricht effektiv der Berechtigung archives:update_all. Ein nur lesender Key reicht für den Verbindungstest, aber nicht für den Source-Upload oder das Setzen des externen Links.

Konfiguration

In der .env des PLM-Servers:

BAMBUDDY_URL=https://bambuddy.example.local
BAMBUDDY_API_KEY=bb_...
BAMBUDDY_TIMEOUT_SECONDS=10
BAMBUDDY_SOURCE_SYNC_ENABLED=1
BAMBUDDY_SOURCE_SYNC_PRINTER_IDS=1
PLM_PUBLIC_URL=https://plm.example.local

Mehrere ausdrücklich erlaubte Bambuddy-Drucker-IDs werden kommasepariert angegeben. Verwende nicht pauschal alle Drucker: Die explizite Liste verhindert eine versehentliche Zuordnung zu einem anderen Gerät.

Nach einer Änderung:

docker compose -f docker-compose.image.yml up -d --force-recreate web worker

Verbindung prüfen

Unter Verwaltung -> Integrationen zeigt das PLM:

• konfigurierte Bambuddy-URL,
• öffentliche PLM-URL für den Revisionslink,
• ob ein API-Key gesetzt ist,
• ob der Source-Sync aktiv ist,
• die erlaubten Drucker-IDs.

Mit Verbindung testen wird zusätzlich geprüft, ob der Key den Source-Upload und das Setzen des Revisionslinks ausführen darf. Der Key selbst erscheint nie in der Web-Oberfläche.

Ein sicherer Dry-Run auf dem Server:

docker compose -f docker-compose.image.yml exec worker \
  python manage.py sync_bambuddy_sources --dry-run --limit 20

Der Dry-Run ordnet nur zu und lädt keine Datei hoch.

Sichere Zuordnungsregeln

Source-Upload und Revisionslink verwenden dieselbe eindeutige Zuordnung:

• Archivstatus ist printing oder completed. Die Source-3MF wird nur im Status printing ergänzt; der Revisionslink darf auch nach Druckende gesetzt werden.
• printer_id steht in BAMBUDDY_SOURCE_SYNC_PRINTER_IDS.
• Der Druckname entspricht exakt <Teilenummer>_<Revisionscode>, zum Beispiel A-001_R0007.
• Im PLM gibt es genau ein nicht obsoletes Slicerprojekt mit diesem Namen.

Ähnliche Namen werden nicht verwendet. Mehrdeutige Treffer werden übersprungen. Direkt vor jedem Schreibzugriff liest das PLM das konkrete Archiv erneut. Eine inzwischen vorhandene Source-Datei oder ein vorhandener externer Link wird nicht ersetzt.

Nachweis

Ein erfolgreicher Abgleich wird sichtbar als:

• Source-3MF im Bambuddy-Archiv,
• externer Link auf die Revisionskarte im PLM,
• bambuddy_source_archives in den Metadaten der PLM-Fertigungsdatei,
• bambuddy_revision_links in denselben Metadaten,
• Audit-Ereignisse 3MF an Bambuddy-Druck angehängt und PLM-Revision mit Bambuddy-Druck verknüpft.

Der Worker prüft regelmäßig erneut, lädt eine bereits vorhandene Source-Datei aber nicht ein zweites Mal hoch und überschreibt keinen vorhandenen externen Link.

Verwendung

Für den normalen Anwender ist keine Aktion in Bambuddy nötig. Der tägliche Ablauf steht unter Source-3MF an den Bambuddy-Druck hängen.