--- 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:** --- ## 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: → 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: **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 . 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