Dateien nach "/" hochladen

README.md

@@ -0,0 +1,72 @@
+# 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
+
+1. `.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.
+
+2. Container bauen und starten:
+
+   ```
+   docker compose up --build -d
+   ```
+
+3. Im Browser öffnen: [http://localhost:8080](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.