Hans Puettmann
3482356c13
Real-Stand laut Herb: 2x P1S, 1x H2S, 1x A1 mini. X1C/P2S bleiben in drucker_links als Default-Mapping fuer den Fall, dass die Modelle spaeter dazukommen. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
240 lines
8.9 KiB
Markdown
240 lines
8.9 KiB
Markdown
---
|
||
type: anleitung
|
||
fuer: Markus
|
||
projekt: 3d.lehrstun.de
|
||
stand: 2026-05-25
|
||
---
|
||
|
||
# Test-Anleitung — 3d.lehrstun.de
|
||
|
||
> Du testest als Alpha-User. Klick dich durch, brich Sachen, schreib mir
|
||
> wo's unklar war. Feedback gibst du am besten direkt im Alph-Widget
|
||
> (siehe unten).
|
||
|
||
**Live-URL:** <https://3d.lehrstun.de>
|
||
|
||
---
|
||
|
||
## Was die Site ist (Kurzfassung)
|
||
|
||
Eine Web-Anwendung fuer unsere 3D-Druck-AG am Lessing-Gymnasium. Drei
|
||
Aufgaben:
|
||
|
||
1. **SuS-Cockpit** — jeder SuS hat ein Profil, sieht woran er gerade arbeitet,
|
||
reserviert Drucker, dokumentiert sein Projekt.
|
||
2. **Lehrer-Dashboard** — du und Herb sehen wer da ist, was laeuft, was
|
||
Review braucht, welche Drucker frei sind.
|
||
3. **Selbstlern-Loop** — abgeschlossene Projekte landen in einem Katalog,
|
||
andere SuS sehen sie und koennen "Sowas mache ich auch" klicken.
|
||
Die Site waechst durch die SuS selbst.
|
||
|
||
Kein Curriculum, keine Pflicht-Lektionen. Offen, jahrelang, freie Wahl
|
||
nach Onboarding (drei Lektionen L1-L3).
|
||
|
||
---
|
||
|
||
## Deine Zugaenge
|
||
|
||
### Als Schueler
|
||
|
||
| Vorname | Tier | PIN | Wofuer |
|
||
|---------|--------|------|--------|
|
||
| Markus | Fuchs | 1234 | Dein Haupt-Test-Account |
|
||
| Mia | Biene | 5678 | Zweiter Account, damit du Wiederhol-Logik testen kannst |
|
||
|
||
Login: <https://3d.lehrstun.de/login> → Kachel mit Vorname+Tier waehlen → PIN.
|
||
|
||
Beide Accounts sind schon zur **Drucker-Reservierung freigeschaltet**, du
|
||
musst nicht erst durch L1 — diese Freischaltung waere normalerweise ein
|
||
manueller Lehrer-Klick.
|
||
|
||
### Als Lehrer / Admin
|
||
|
||
URL: <https://3d.lehrstun.de/admin/login>
|
||
**Passwort:** `Lessing3d`
|
||
|
||
Nach Login landest du auf dem **Admin-Dashboard** mit Karten zu allen
|
||
Verwaltungs-Bereichen.
|
||
|
||
---
|
||
|
||
## SuS-Flow — was solltest du als Markus durchspielen?
|
||
|
||
### 1. Erstes Einloggen + Cockpit kennenlernen
|
||
|
||
Login als Markus (Fuchs / 1234). Du siehst:
|
||
|
||
- **Check-In-Modal** ("Was machst du heute?") — waehl was aus, der Klick
|
||
fuehrt dich gleich zum passenden Ort. *Wichtig:* "Neues Projekt"
|
||
fuehrt direkt zum Anlege-Formular, "Drucken" zur Drucker-Seite,
|
||
"Onboarding" zu den Lektionen.
|
||
- **Projekt-Karte** ganz oben (am Anfang leer, da kein Projekt) mit
|
||
"+ Neues Projekt anfangen"-Button.
|
||
- **Onboarding-Karte** mit L1-L3.
|
||
- **Paarungs-Karte** unten (Du kannst dich mit Mia paaren — dann arbeitet
|
||
ihr zusammen an einem Projekt).
|
||
|
||
### 2. Onboarding (L1-L3)
|
||
|
||
Klick auf "Lektionen" oben oder die Onboarding-Karte. Drei Pflicht-Lektionen
|
||
fuer Neue. Du kannst selbst auf "fertig" klicken (Selbst-Zertifizierung).
|
||
|
||
### 3. Drucker ansehen
|
||
|
||
Top-Nav → "Drucker". Du siehst alle 4 Bambu-Drucker mit Status, Bambu-Wiki-
|
||
Links und Belegung. Hinweis-Banner wenn Drucker gesperrt sind.
|
||
|
||
### 4. Drucker reservieren
|
||
|
||
Klick auf "+ Diesen Drucker reservieren" bei einem freien Drucker. Form
|
||
mit Start-/Endzeit (15 min Mindest, 24h Max). Achte auf Konflikte —
|
||
wenn du jemand anderen ueberlappst, kriegst du eine Fehlermeldung.
|
||
"Meine Reservierungen" zeigt deine Slots, stornierbar mit einem Klick.
|
||
|
||
### 5. Neues Projekt anlegen
|
||
|
||
"+ Neues Projekt" → Titel eingeben → angelegt. Du landest im
|
||
**Projekt-Detail** mit der **Werkstatt-Sektion** — alles auf einer Seite:
|
||
- Titel + Beschreibung
|
||
- **Hauptsoftware** (Dropdown: TinkerCAD, Onshape, MakerWorld, ...)
|
||
- **Drucker** (Dropdown: P1S #1 / P1S #2 / H2S / A1 mini)
|
||
- **MakerWorld-Link** (optional, wenn du dein Modell dort online stellst)
|
||
- **Dateien-Bereich** mit Drag&Drop fuer STL/3MF/Fotos (max. 30 MB)
|
||
- **Cover-Bild** via Crop-Tool (Strg+V fuer Screenshot — oder klicken)
|
||
|
||
Probiere besonders:
|
||
- Den **Crop-Workflow** fuer Cover (Bild paste mit Strg+V, Ausschnitt waehlen)
|
||
- Den **Drag&Drop-Upload** fuer mehrere Files gleichzeitig
|
||
- Den **Abschluss-Block**: ohne Cover und ohne Files ist der "Abschliessen"-
|
||
Button disabled mit klarer Begruendung.
|
||
|
||
### 6. Projekt abschliessen
|
||
|
||
Wenn Cover + mind. 1 File da sind: "✅ Projekt abschliessen" wird klickbar.
|
||
**3-Achsen-Selbstbewertung:**
|
||
- **Gesamt:** Zufrieden / Mittel / **Gelernt** (= Misserfolg, triggert
|
||
Lehrer-Review)
|
||
- **Planung:** Gut / OK / Schwierig
|
||
- **Ausfuehrung:** Gut / OK / Schwierig
|
||
- Plus 2 Freitexte ("Was gelernt?" + optional "Was klappte nicht?")
|
||
|
||
Bei "Zufrieden"/"Mittel" → automatisch freigegeben, du kannst gleich neues
|
||
Projekt anfangen.
|
||
Bei "Gelernt" → wartet auf Lehrer-Review, du kannst noch nichts Neues.
|
||
|
||
### 7. Katalog stoebern
|
||
|
||
Top-Nav → "Projekte". Sortier-Tabelle mit allen sichtbaren Projekten der
|
||
AG. Spalten-Header klicken sortiert (Titel/Person/Status/Erfolg/Datum).
|
||
Klick auf Zeile → Detail klappt auf mit Cover, Beschreibung, Datei-Downloads.
|
||
|
||
### 8. "Sowas mache ich auch" (Wiederhol-Logik)
|
||
|
||
Logg dich aus, logg dich als **Mia (Biene, 5678)** ein, geh in den Katalog.
|
||
Bei Markus' Projekten siehst du den **"+ Sowas mache ich auch"**-Button.
|
||
Klick → ein neues Projekt wird angelegt mit Verknuepfung zu Markus' Projekt.
|
||
Beide Projekte sehen das via Banner ("Vorlage: X von Y" bzw. "Wurde
|
||
wiederholt von Z").
|
||
|
||
Eigenes Projekt wird nicht zum Wiederholen angeboten (sinnlos sich selbst
|
||
zu kopieren).
|
||
|
||
---
|
||
|
||
## Lehrer-Flow — was solltest du als Admin durchspielen?
|
||
|
||
Admin-Login mit `Lessing3d`. Du landest auf dem Dashboard mit Karten:
|
||
|
||
### Dashboard-Karten
|
||
|
||
- **👥 SuS-Profile** — Profile anlegen, PIN-Reset, PIN-Karten drucken,
|
||
Spalte "Reservieren" toggled die Drucker-Reservierungs-Freigabe pro SuS.
|
||
- **🖥️ Software & Generatoren** — Katalog editieren, neue Tools anlegen,
|
||
Crop-Bilder hochladen.
|
||
- **📚 Lektionen** — fertig befuellt (L1-L14), Bearbeiten kommt spaeter.
|
||
- **🖨️ Drucker** — Status manuell setzen (idle/printing/failed/...),
|
||
Sperren mit Grund (z.B. "Filament-Wechsel laeuft"), Manual-/Trouble-
|
||
shooting-Links pflegen.
|
||
- **🔖 Reservierungen** — alle Slots ansehen, fuer SuS reservieren,
|
||
loeschen.
|
||
- **🎯 Projekte** — alle SuS-Projekte mit Filter (wartet auf Freigabe /
|
||
in Arbeit / abgeschlossen / Rueckfrage). Wartende mit Badge im Header.
|
||
|
||
### Dashboard-Drill-Down (untere Sektionen)
|
||
|
||
- **Wer ist heute hier** — Check-Ins, mit "Notiz hinterlassen"-Quick-Action
|
||
- **Wartet auf Review** — abgeschlossene Projekte, die du noch nicht
|
||
freigegeben hast
|
||
- **Drucker-Status live** — Status aller 4 Drucker auf einen Blick
|
||
- **Wer haengt fest** — SuS, die seit > 2 Wochen nicht eingecheckt haben
|
||
|
||
### Was du als Lehrer testen kannst
|
||
|
||
- **Drucker sperren** (z.B. P1S #1) und mit Mia versuchen zu reservieren
|
||
— sollte gesperrte Drucker nicht in der Auswahl haben.
|
||
- **Status setzen** (H2S auf "printing" mit Job-Name) und gucken, ob es
|
||
in der SuS-Sicht auf /drucker erscheint.
|
||
- **Slot fuer Mia anlegen** ueber /admin/slot/neu — auch wenn Mia
|
||
nicht eingeloggt ist.
|
||
- **Software-Karte neu anlegen** + Bild per Strg+V einfuegen.
|
||
- **Projekt-Review:** logg dich als Markus ein, schliess sein Projekt
|
||
als "Gelernt" ab, dann zurueck zum Admin: das Projekt liegt in der
|
||
Review-Queue (Badge auf der 🎯-Karte). Klick rein → "Freigeben" oder
|
||
"Rueckfrage stellen".
|
||
|
||
---
|
||
|
||
## Alph — das Feedback-Widget
|
||
|
||
Unten rechts auf jeder Seite siehst du eine kleine **Hummel mit
|
||
α-T-Shirt** — das ist **Alph**, unser Alpha-Test-Feedback-Widget.
|
||
|
||
Klick drauf, schreib was dir auffaellt (kaputte Buttons, unklare Texte,
|
||
gute Ideen, …). Optional kannst du auch einen Screenshot machen lassen.
|
||
|
||
**Warum die Hummel?** PummelHummel ist unser internes Feedback-Modul,
|
||
das auch auf arduino.lehrstun.de und meta.lehrstun.de laeuft. SuS finden
|
||
sie suess, schreiben deshalb mehr und ehrlicher.
|
||
|
||
Deine Reports siehst du als Admin unter
|
||
<https://3d.lehrstun.de/admin/feedback>. Dort gibt's auch einen
|
||
"Fuer KI kopieren"-Button — damit kannst du eine Sammelmeldung in den
|
||
Schul-Copilot oder Claude paste und dir Hilfe holen.
|
||
|
||
---
|
||
|
||
## Was du mir bitte zurueckspielst
|
||
|
||
Hauptsaechlich Alph-Reports. Was dabei besonders nuetzlich ist:
|
||
|
||
- **Stelle wo du dich verloren gefuehlt hast** — was hat dir gefehlt
|
||
zum naechsten Schritt?
|
||
- **Texte die nicht passen** — zu langweilig, zu kompliziert, technisch,
|
||
bevormundend?
|
||
- **Layout-Sachen** — was sieht broken aus, ueberlagert sich, ist zu klein?
|
||
- **Mobile** — checks doch mal mit dem Handy (Apple/Android), Layout
|
||
kann da kippen
|
||
- **Magic Moments** — wo war's intuitiv? Wo hat dich was positiv ueberrascht?
|
||
|
||
Wenn du was wirklich Drastisches findest (Datenverlust, etwas Sichtbares
|
||
das nicht sichtbar sein sollte, Admin-Zugang ohne Passwort), dann
|
||
SMS/WhatsApp an Herb — Alph reicht da nicht.
|
||
|
||
---
|
||
|
||
## Technik (falls du neugierig bist)
|
||
|
||
- **Stack:** Flask + SQLite, Python 3, alles auf einem Hetzner-Server
|
||
- **systemd-Service:** `3d-ag.service` (Port intern 5058, nginx + HTTPS via Let's Encrypt)
|
||
- **Repo:** http://46.225.114.15:3000/admin/3d.lehrstun.de
|
||
- **Datenbank:** in SQLite (3dag.db, **nicht** im Git — wird ueber
|
||
Migrationen aktuell gehalten)
|
||
- **Bilder + STL-Files:** als BLOB in der DB (kein Filesystem-Drift,
|
||
ein Backup deckt alles ab)
|
||
- **Schwester-Projekte mit gleichem Design-System:** arduino.lehrstun.de,
|
||
meta.lehrstun.de
|
||
|
||
Viel Spass beim Stoebern! Wenn du was nicht verstehst, frag direkt nach.
|
||
— Herb
|
||
|