3D Project Manager

Eine kleine Docker-basierte Webanwendung, um 3D-Druck-Projekte zu verwalten: Projekte anlegen, STL-/3MF-Dateien per Drag & Drop hochladen und direkt im Browser als 3D-Vorschau betrachten.

Setup

.env.example nach .env kopieren und PROJECTS_DIR auf einen Ordner auf deiner Festplatte setzen, z. B.:
```
PROJECTS_DIR=/home/deinname/3d-projects
```
Das ist der Ordner, in dem deine Projekte als normale Unterordner angelegt werden — den kannst du auch direkt im Dateimanager oder Slicer öffnen.
Container bauen und starten:
```
docker compose up --build -d
```
Im Browser öffnen: http://localhost:8080

Wie es funktioniert

Projekt anlegen → im Container wird PROJECTS_DIR/<Projektname> erstellt (durch den Bind-Mount landet das direkt auf deiner Platte).
Dateien hochladen → per Drag & Drop oder Klick auf die Upload-Fläche, nur .stl und .3mf werden akzeptiert. Sie werden 1:1 in den Projektordner kopiert.
3D-Vorschau → beim Öffnen eines Projekts wird für jede Datei ein eigener Three.js-Viewer (mit Zoom/Rotation per Maus) im Grid angezeigt.
App-Einstellungen/Metadaten liegen ausschließlich im app-settings-Docker-Volume, nicht in deinem Projektordner. Aktuell benötigt die App noch keine eigene Konfiguration, aber der Ordner ist für spätere Erweiterungen (z. B. Nutzerverwaltung) bereits vorbereitet.

Projektstruktur auf der Festplatte

<PROJECTS_DIR>/
  Gehäuse-Prototyp/
    deckel.stl
    boden.3mf
  Ersatzteil/
    halterung.stl

Reine Ordner mit deinen Dateien — du kannst sie auch außerhalb der App öffnen, kopieren oder in deinen Slicer ziehen. Lösch- und Umbenennungen über den Dateimanager wirken sich beim nächsten Laden der Seite ebenfalls auf die App aus.

Bekannte Grenzen (erster Wurf)

Single-User, kein Login.
Projekt-/Dateinamen sind auf Buchstaben, Zahlen, Leerzeichen, - und _ beschränkt (Schutz gegen Pfad-Tricks).
Kein Undo beim Löschen — es wird aber vorher immer nachgefragt.

Stack

Backend: FastAPI (Python), liefert API + statische Frontend-Dateien aus einem einzigen Container.
Frontend: reines HTML/CSS/JS, 3D-Rendering mit Three.js (STLLoader / 3MFLoader) via CDN.
Docker Compose mit Bind-Mount für Projekte und separatem Volume für App-Settings.

2.3 KiB Raw Blame History