2 Erster Start und Verwaltung
Ralf Warmuth edited this page 2026-08-30 21:44:09 +02:00

Erster Start und Verwaltung

Nach der Serverinstallation werden Rollen und der erste Administrator einmalig per Management-Command angelegt. Die weitere Verwaltung erfolgt in der normalen PLM-Web-Oberfläche.

Rollen initial anlegen

cd /opt/freecad-plm
docker compose -f docker-compose.image.yml exec web \
  python manage.py setup_plm_roles

Dadurch entstehen die Gruppen reader, editor und admin.

Ersten Superuser anlegen

docker compose -f docker-compose.image.yml exec web \
  python manage.py createsuperuser

Der Superuser kann die normale Web-UI und den technischen Django-Admin unter /admin/ verwenden.

Anmeldung

Die normale Anmeldung liegt unter /login/. Danach führt die Anwendung zur Projektübersicht. Der Django-Admin ist nur die technische Fallback-Verwaltung.

Benutzerverwaltung

Admins finden links Verwaltung. Dort lassen sich:

  • Benutzer anlegen und bearbeiten,
  • Benutzer aktivieren oder deaktivieren,
  • Rollen setzen,
  • Passwörter neu setzen,
  • API-Tokens anlegen, bearbeiten und widerrufen,
  • Integrationen wie Bambuddy prüfen.

Der vollständige Arbeitsablauf steht unter Benutzer und API-Tokens verwalten.

Rollen im Alltag

  • reader: ansehen, suchen und herunterladen.
  • editor: Teile, Revisionen, Projektstände, Notizen und Anmerkungen bearbeiten.
  • admin: zusätzlich Projekte und Benutzer verwalten, Revisionen freigeben oder obsolet setzen und Integrationen prüfen.

API-Tokens

API-Tokens dienen dem FreeCAD-Addon und anderen Maschinenzugriffen. Sie ersetzen keine Browseranmeldung.

Presets:

  • Nur Lesen: read,
  • Addon Standard: read write checkout,
  • Admin/Vollzugriff: zusätzliche administrative API-Rechte.

Der Klartext wird nur einmal angezeigt. Danach bleibt lediglich der Prefix sichtbar. Verwende getrennte Tokens pro Rechner und widerrufe verlorene oder nicht mehr benötigte Tokens.

Hintergrundjobs

Die Seitenleiste zeigt eigene wartende, laufende, erfolgreiche und fehlgeschlagene Analyse-, Export- und PNG-Jobs. Bleiben Jobs dauerhaft stehen, prüfe den Worker anhand von Troubleshooting.