diff --git a/MARKUS-TEST.md b/MARKUS-TEST.md new file mode 100644 index 0000000..557e13c --- /dev/null +++ b/MARKUS-TEST.md @@ -0,0 +1,239 @@ +--- +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 / X1C / ...) +- **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** (P2S 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 +