MARKUS-TEST.md: Alpha-Test-Anleitung fuer Markus
Erklaert Site-Zweck, SuS-/Lehrer-Flows, Alph-Widget und Test-Zugaenge. Profile auf prod angelegt: Markus (Fuchs/1234), Mia (Biene/5678), beide schon zur Drucker-Reservierung freigeschaltet. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
239
MARKUS-TEST.md
Normal file
239
MARKUS-TEST.md
Normal file
@@ -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:** <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 / 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
|
||||
<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
|
||||
|
||||
Reference in New Issue
Block a user