Files
3d.lehrstun.de/CLAUDE.md
Hans Puettmann abf96ca8f2 Etappe 2: Cockpit progressiv + Check-In + Paarung + Lehrer-Dashboard
Cockpit (V1, progressives Layout):
- /cockpit zeigt nur Karten, die zum Status passen.
  Onboarding-Karte nur fuer Neue; Paarungs-Karte immer wenn aktiv;
  Drucker-Buchung erst nach L1 fertig.
- Banner-System: ungelesene Lehrer-Notizen, offene Rueckfragen,
  eingegangene Paarungs-Anfragen.

Check-In (V3 + E-021):
- Modal beim ersten Cockpit-Aufruf eines Besuchstages.
- "Ich arbeite weiter" als Default-Ein-Klick-Option.
- Freitext optional.
- POST /cockpit/check-in mit UNIQUE-Constraint pro Tag.

Onboarding-Status (E-019):
- /cockpit/lektion/<nr>/status (selbst-zertifiziert).
- profil_lektion_status-Tabelle, ON CONFLICT-Upsert.

Paarung (E-002):
- profil_anfrage-Tabelle on-demand.
- Anfrage stellen / annehmen / ablehnen / aufloesen.
- Konflikt-Check (keine Doppel-Paarungen).
- Banner im Cockpit des Adressaten.

Lehrer-Dashboard (V5, docs/lehrer-dashboard.md):
- /admin/dashboard mit 4 Sektionen (Wer ist heute hier / Wartet auf
  Review / Drucker-Status / Wer haengt fest) + Schnell-Zahlen + offene
  Rueckfragen.
- "Notiz hinterlassen"-Quick-Action via lehrer_notiz-Tabelle.
- Live-Drucker-Status kommt mit Etappe 5 (aktuell nur DB-Stand).

Daten-Helper getrennt:
- services/cockpit_status.py: Bundle fuer progressives Cockpit
- services/dashboard_status.py: 4-Sektionen-Queries

Vorgezogen aus Etappe 3:
- /lektionen + /lektion/<nr> Minimal-Renderer mit Markdown
- 3 Onboarding-Lektionen als Seeds (Platzhalter-Text fuer Markus)

Smoke-Test bestanden: Login als neuer SuS -> Onboarding ->
Check-In -> L1 fertig -> Paarung mit zweitem SuS -> Admin-Dashboard
-> Lehrer-Notiz -> Banner im Cockpit.
2026-05-24 19:13:19 +02:00

3.5 KiB
Raw Blame History

type, name, status, domain, deployed, next_step, tags
type name status domain deployed next_step tags
project 3d.lehrstun.de entwurf 3d.lehrstun.de false Kurskonzept mit Markus durchgehen, offene Fragen klären
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: Etappe 1+2 läuft lokal (Stand 2026-05-24). Login, progressives Cockpit, Check-In, Onboarding-Status, Paarung, Drill-Down-Lehrer-Dashboard, Lehrer-Notiz-Banner — alles funktional. Smoke-Test bestanden. Repo: http://46.225.114.15:3000/admin/3d.lehrstun.de (SSH: ssh://git@46.225.114.15:2222/admin/3d.lehrstun.de.git) Port intern: 5057 (5055=quiz-collector, 5056=arduino-db). Brand: 3D-Druck-AG Admin-Passwort lokal: lokal-test-123 (in .env)

Kontext (Kurzfassung)

  • Wahl-AG Klasse 8 MINT, 8-10 Einzel-SuS (optional 2er-Paarungen).
  • 4 Bambu-Lab-Drucker: 3× geschlossen (P1S/X1C/P2S) + 1× A1 mini (offen).
  • Eigener Druckraum, dauergelüftet. PLA + PLA+ Default, PETG/ABS unter Aufsicht.
  • Drucker dürfen über Nacht / Freistunden laufen.
  • Herb hat 3D-Druck selbst noch nie unterrichtet — Inhalte folgen mit Markus.
  • Drucker-Status via Bambu Cloud-API (Polling, mit Fallback auf manuell).
  • Login: Vorname + Tier-Icon + 4-stellige PIN. Sichtbarkeit: Lehrer voll, SuS nur Projekttitel.

Quickstart (lokal)

cd D:/Claude-Projekte/3d.lehrstun.de
# Einmalig: venv + Pakete
python -m venv venv
venv/Scripts/python.exe -m pip install -r requirements.txt
cp .env.beispiel .env   # ADMIN_PASSWORT eintragen!
# Schema + Initial-Seeds
venv/Scripts/python.exe seed.py
# App starten
venv/Scripts/python.exe app.py   # http://localhost:5057

Funktionierende Routen (Etappe 1):

  • / Startseite
  • /login Profil-Kacheln (anfangs leer, im Admin anlegen)
  • /login/<id> PIN-Eingabe mit persistentem Lockout (V7)
  • /cockpit Stub (Etappe 2 macht das progressiv)
  • /admin/login Admin-Login mit Passwort aus .env
  • /admin/profile SuS-Profile + Neuanlage + PIN-Reset + aktiv-Toggle
  • /admin/profile/karten Druckbogen für PIN-Karten (CSS-Print)
  • /admin/inline-edit Universal-Endpoint mit Whitelist + Audit-Log

Alle anderen Routen geben 501 + Verweis auf die Etappe.

Update-Workflow auf Hetzner (vor erstem Deploy noch einzurichten)

ssh herb@46.225.114.15
cd ~/3d.lehrstun.de
git pull origin master
sudo systemctl stop 3d-ag
python3 migrations/YYYY-MM-DD_xxx.py
sudo systemctl start 3d-ag

Nächste Schritte

  • Skelett + Obsidian-Vault anlegen (2026-05-23)
  • Reality-Check + Konzept v2 (2026-05-24)
  • Etappe 1: Blueprints + Schema + Login + Admin + Inline-Edit + Lockout (2026-05-24)
  • kurskonzept mit Markus durchgehen
  • offene-fragen klären (Bambu-Account, A1-mini-Firmware)
  • Lokales Git-Repo + Gitea-Push
  • Etappe 2: Cockpit progressiv + Check-In + Paarung + lehrer-dashboard
  • Etappe 3: Lektionen + Software-Sektion + Troubleshooting
  • Etappe 4: Drucker-API-Spike → druckerapi
  • DNS-A-Record 3d.lehrstun.de → 46.225.114.15 (via Hetzner Cloud DNS-CLI, vor Etappe 9)

Querverbindungen

  • Schwester-Projekt: D:/Claude-Projekte/arduino.lehrstun.de/ (Stack + Design + Code-Quelle)
  • PummelHummel/Alph: D:/Claude-Projekte/PummelHummel/ (Integration in Etappe 8)
  • Hetzner-DNS-CLI: D:/Claude-Projekte/hetzner-dns-cli/
  • Detail-Doku: docs/ (22 Markdown-Dateien als Obsidian-Vault verlinkt)