3d.lehrstun.de/CLAUDE.md

---
type: project
name: 3d.lehrstun.de
status: live-alpha
domain: 3d.lehrstun.de
deployed: true
next_step: "Markus' Alpha-Feedback abwarten + Bambu-Cloud-Account klaeren"
tags: [schule, 3d-druck, web, ag]
---

# 3D-Druck-AG — 3d.lehrstun.de

> Vault-Startseite: [[COCKPIT]]. Hauptkonzept: [[kurskonzept]]. Architektur: [[architektur]].
> Offene Klärungen: [[offene-fragen]]. Entscheidungen: [[decisions]]. Etappen: [[etappen]].

**Status (2026-05-25 abends):** **LIVE auf https://3d.lehrstun.de mit Kern-Funktionalitaet.**
Etappen 0-3 + 5-vorgezogen + 6 + 7-vorgezogen + 9 durch. Bambu-Cloud-API (Etappe 4)
bleibt offen, weil Account-Klaerung mit Schule noch aussteht. Alpha-Test laeuft:
Markus (Fuchs/1234) + Mia (Biene/5678) auf prod angelegt, Anleitung in
[[MARKUS-TEST]].

**Repo:** http://46.225.114.15:3000/admin/3d.lehrstun.de · Branch: `main`
**Live:** https://3d.lehrstun.de · systemd `3d-ag.service` · Port intern **5058**
**Admin-Passwort:** `Lessing3d` (live) · `lokal-test-123` (lokal)

## Was funktioniert (alles end-to-end getestet)

- **Login** Vorname+Tier+PIN, persistenter Lockout in DB
- **Cockpit progressiv** mit Check-In, Quick-Actions, Modus-Aendern, Onboarding (L1-L3),
  Projekt-Karte ganz oben mit "Hier weitermachen"
- **14 Lektionen** (L1-L14) voll befuellt, selbst-zertifiziert
- **Software-Sektion** (Karten-Katalog, 7 Tools + Generator, Admin-Verwaltung mit Crop-Upload)
- **Drucker-Verwaltung** Status-Override, Sperre mit Grund, Manual-Links pflegen
- **Slot-Reservierung** mit Konflikt-Check, Lehrer schaltet SuS frei, Lehrer kann fuer SuS
  reservieren
- **Selbstlern-Loop:** max. 1 Projekt pro SuS, Werkstatt-Sektion (Software/Drucker/MakerWorld/
  Files-Upload), Cover-Crop, Abschluss mit 3-Achsen-Eval, Lehrer-Review-Queue, oeffentlicher
  Katalog (sortierbar+aufklappbar), Wiederhol-Verknuepfung mit bidirektionalen Lineage-Bannern
- **Alph-Widget** aktiv fuer SuS-Feedback
- **Admin-Dashboard-Hub** mit Karten zu allen Bereichen, Badge bei Review-Wartung

## Was offen ist

- **Bambu-Cloud-API** (Etappe 4) — Account-Klaerung mit Schule
- **Slot-Verschiebung bei Drucker-Sperre** (Iteration B3) — Lehrer-Vorschlag fuer
  betroffene Slots, nicht kritisch fuer Alpha
- **QR-Codes** fuer Bambu-Handy Store-Links — Folge-Schritt
- **ZSL-Material-Import** (Etappe 8) — gemeinsam mit Herr Rechmann
- **Three.js STL-Preview** im Katalog — Nice-to-have, spaeter
- **Aufraeumen:** `projekt_bearbeiten.html` + `admin_projekt_queue.html` sind durch Werkstatt
  bzw. `admin_projekte.html` ersetzt, alte Routen koennen weg

## Quickstart (lokal)
```bash
cd D:/Claude-Projekte/3d.lehrstun.de
venv/Scripts/python.exe app.py   # http://localhost:5057
# Erstes Setup:
python -m venv venv
venv/Scripts/python.exe -m pip install -r requirements.txt
cp .env.beispiel .env   # ADMIN_PASSWORT eintragen
venv/Scripts/python.exe seed.py
for m in migrations/2026-*.py; do venv/Scripts/python.exe $m; done
```

## Update-Workflow auf Hetzner
```bash
ssh herb@46.225.114.15
cd ~/3d.lehrstun.de
git pull origin main
sudo systemctl stop 3d-ag
venv/bin/python3 migrations/YYYY-MM-DD_xxx.py   # falls neue da
sudo systemctl start 3d-ag
```

## Querverbindungen
- Markus-Anleitung: [[MARKUS-TEST]]
- Schwester-Projekt: `D:/Claude-Projekte/arduino.lehrstun.de/` (Stack, Design, Code-Quelle)
- PummelHummel/Alph: `D:/Claude-Projekte/PummelHummel/`
- Detail-Doku: `docs/` (Obsidian-Vault mit ~24 Dateien)