diff --git a/CLAUDE.md b/CLAUDE.md index b62a135..b849d51 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,10 +1,10 @@ --- type: project name: 3d.lehrstun.de -status: entwurf +status: live-alpha domain: 3d.lehrstun.de -deployed: false -next_step: "Kurskonzept mit Herr Rechmann durchgehen, offene Fragen klären" +deployed: true +next_step: "Markus' Alpha-Feedback abwarten + Bambu-Cloud-Account klaeren" tags: [schule, 3d-druck, web, ag] --- @@ -13,71 +13,67 @@ tags: [schule, 3d-druck, web, ag] > Vault-Startseite: [[COCKPIT]]. Hauptkonzept: [[kurskonzept]]. Architektur: [[architektur]]. > Offene Klärungen: [[offene-fragen]]. Entscheidungen: [[decisions]]. Etappen: [[etappen]]. -**Status:** **LIVE auf https://3d.lehrstun.de** (Stand 2026-05-25). 14 Lektionen + Login + Cockpit progressiv + Check-In + Paarung + Lehrer-Dashboard + PummelHummel/Alph für Lektions-Feedback. Markus testet via Schüler-Login. Drucker-API + Slot-System + Selbstlern-Loop kommen in späteren Etappen. -**Repo:** http://46.225.114.15:3000/admin/3d.lehrstun.de (SSH: `ssh://git@46.225.114.15:2222/admin/3d.lehrstun.de.git`) -**Live:** https://3d.lehrstun.de — systemd-Service `3d-ag.service`, Port intern **5058** (5057 von meta.lehrstun.de belegt; lokal nutzen wir 5057 weiterhin). -**Brand:** 3D-Druck-AG -**Admin-Passwort:** `Lessing3d` (live + Server-`.env`), lokal `lokal-test-123` +**Status (2026-05-25 abends):** **LIVE auf https://3d.lehrstun.de mit Kern-Funktionalitaet.** +Etappen 0-3 + 5-vorgezogen + 6 + 7-vorgezogen + 9 durch. Bambu-Cloud-API (Etappe 4) +bleibt offen, weil Account-Klaerung mit Schule noch aussteht. Alpha-Test laeuft: +Markus (Fuchs/1234) + Mia (Biene/5678) auf prod angelegt, Anleitung in +[[MARKUS-TEST]]. -## Kontext (Kurzfassung) +**Repo:** http://46.225.114.15:3000/admin/3d.lehrstun.de · Branch: `main` +**Live:** https://3d.lehrstun.de · systemd `3d-ag.service` · Port intern **5058** +**Admin-Passwort:** `Lessing3d` (live) · `lokal-test-123` (lokal) -- 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 Herr Rechmann. -- Drucker-Status via **Bambu Cloud-API** (Polling, mit Fallback auf manuell). -- **Login:** Vorname + Tier-Icon + 4-stellige PIN. Sichtbarkeit: Lehrer voll, SuS nur Projekttitel. +## Was funktioniert (alles end-to-end getestet) + +- **Login** Vorname+Tier+PIN, persistenter Lockout in DB +- **Cockpit progressiv** mit Check-In, Quick-Actions, Modus-Aendern, Onboarding (L1-L3), + Projekt-Karte ganz oben mit "Hier weitermachen" +- **14 Lektionen** (L1-L14) voll befuellt, selbst-zertifiziert +- **Software-Sektion** (Karten-Katalog, 7 Tools + Generator, Admin-Verwaltung mit Crop-Upload) +- **Drucker-Verwaltung** Status-Override, Sperre mit Grund, Manual-Links pflegen +- **Slot-Reservierung** mit Konflikt-Check, Lehrer schaltet SuS frei, Lehrer kann fuer SuS + reservieren +- **Selbstlern-Loop:** max. 1 Projekt pro SuS, Werkstatt-Sektion (Software/Drucker/MakerWorld/ + Files-Upload), Cover-Crop, Abschluss mit 3-Achsen-Eval, Lehrer-Review-Queue, oeffentlicher + Katalog (sortierbar+aufklappbar), Wiederhol-Verknuepfung mit bidirektionalen Lineage-Bannern +- **Alph-Widget** aktiv fuer SuS-Feedback +- **Admin-Dashboard-Hub** mit Karten zu allen Bereichen, Badge bei Review-Wartung + +## Was offen ist + +- **Bambu-Cloud-API** (Etappe 4) — Account-Klaerung mit Schule +- **Slot-Verschiebung bei Drucker-Sperre** (Iteration B3) — Lehrer-Vorschlag fuer + betroffene Slots, nicht kritisch fuer Alpha +- **QR-Codes** fuer Bambu-Handy Store-Links — Folge-Schritt +- **ZSL-Material-Import** (Etappe 8) — gemeinsam mit Herr Rechmann +- **Three.js STL-Preview** im Katalog — Nice-to-have, spaeter +- **Aufraeumen:** `projekt_bearbeiten.html` + `admin_projekt_queue.html` sind durch Werkstatt + bzw. `admin_projekte.html` ersetzt, alte Routen koennen weg ## Quickstart (lokal) ```bash cd D:/Claude-Projekte/3d.lehrstun.de -# Einmalig: venv + Pakete +venv/Scripts/python.exe app.py # http://localhost:5057 +# Erstes Setup: python -m venv venv venv/Scripts/python.exe -m pip install -r requirements.txt -cp .env.beispiel .env # ADMIN_PASSWORT eintragen! -# Schema + Initial-Seeds +cp .env.beispiel .env # ADMIN_PASSWORT eintragen venv/Scripts/python.exe seed.py -# App starten -venv/Scripts/python.exe app.py # http://localhost:5057 +for m in migrations/2026-*.py; do venv/Scripts/python.exe $m; done ``` -**Funktionierende Routen (Etappe 1):** -- `/` Startseite -- `/login` Profil-Kacheln (anfangs leer, im Admin anlegen) -- `/login/` 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) +## Update-Workflow auf Hetzner ```bash ssh herb@46.225.114.15 cd ~/3d.lehrstun.de -git pull origin master +git pull origin main sudo systemctl stop 3d-ag -python3 migrations/YYYY-MM-DD_xxx.py +venv/bin/python3 migrations/YYYY-MM-DD_xxx.py # falls neue da sudo systemctl start 3d-ag ``` -## Nächste Schritte -- [x] Skelett + Obsidian-Vault anlegen (2026-05-23) -- [x] Reality-Check + Konzept v2 (2026-05-24) -- [x] **Etappe 1: Blueprints + Schema + Login + Admin + Inline-Edit + Lockout** (2026-05-24) -- [ ] [[kurskonzept]] mit Herr Rechmann durchgehen -- [ ] [[offene-fragen]] klären (Bambu-Account, A1-mini-Firmware) -- [ ] Lokales Git-Repo + Gitea-Push -- [ ] **Etappe 2:** Cockpit progressiv + Check-In + Paarung + [[lehrer-dashboard|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) +- Markus-Anleitung: [[MARKUS-TEST]] +- Schwester-Projekt: `D:/Claude-Projekte/arduino.lehrstun.de/` (Stack, Design, Code-Quelle) +- PummelHummel/Alph: `D:/Claude-Projekte/PummelHummel/` +- Detail-Doku: `docs/` (Obsidian-Vault mit ~24 Dateien)