admin/3d.lehrstun.de
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
625efc3993a403934f66a932f9dde176e1588565
3d.lehrstun.de/CLAUDE.md

84 lines
3.5 KiB
Markdown
Raw Normal View History

Initial commit: Konzept v2 + Etappe 1 (Blueprints + Login + Profile) Schwester-Projekt zu arduino.lehrstun.de fuer die 3D-Druck-AG am Lessing-Gymnasium. Offene jahrelange Nachmittags-AG (kein Trimester), 8-10 Einzel-SuS mit optionalen 2er-Paarungen, 4 Bambu-Lab-Drucker (3 geschlossen + 1 A1 mini). Konzept v2 (Reality-Check-Iteration 2026-05-24): - Onboarding-Pfad statt Pflicht-Lektionen (L1-L3 selbst-zertifiziert) - Selbstlern-Loop als Kern: SuS-Projekte wachsen die interne Bibliothek - Drill-Down-Lehrer-Dashboard (Wer ist hier / Wartet Review / Haengt fest) - Cockpit progressiv: zeigt nur was zum Status passt - Bambu-Cloud-API fuer Drucker-Live-Status (fragil + Fallback manuell) - Three.js-Vorschau fuer Cover-aus-3D-Ansicht (Etappe 6) - Vollstaendige Doku als Obsidian-Vault (24 Markdown-Dateien) - Entscheidungen E-001 bis E-022 in docs/decisions.md Etappe 1 lauffaehig (~1800 Zeilen Code): - Blueprint-Struktur (V8): routes/oeffentlich+profil+admin+api, services/auth+bambu+datei - Komplettes Schema in database.py (14 Tabellen, idempotent) - Login mit bcrypt + persistentem Lockout in DB (V7, verbessert ggue Arduino-Kurs der In-Memory-Dict nutzt) - Admin-Login + Profile-CRUD + PIN-Reset + PIN-Karten-Druckbogen - Inline-Edit-Endpunkt mit Whitelist + Audit-Log - Seeds: AG lessing-3d-ag + 4 Drucker + Default-Einstellungen - Smoke-Test bestanden (Login, Profil-Anlage, Lockout-Logging) Nicht im Repo (.gitignore): .env, *.db, venv/, .obsidian/workspace.json
2026-05-24 18:56:59 +02:00
---
type: project
name: 3d.lehrstun.de
status: entwurf
domain: 3d.lehrstun.de
deployed: false
next_step: "Kurskonzept mit Markus durchgehen, offene Fragen klären"
tags: [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]].
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
**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.
Doku: Repo-URL + CHANGELOG-Eintrag fuer Gitea-Anlage
2026-05-24 18:59:10 +02:00
**Repo:** http://46.225.114.15:3000/admin/3d.lehrstun.de (SSH: `ssh://git@46.225.114.15:2222/admin/3d.lehrstun.de.git`)
Initial commit: Konzept v2 + Etappe 1 (Blueprints + Login + Profile) Schwester-Projekt zu arduino.lehrstun.de fuer die 3D-Druck-AG am Lessing-Gymnasium. Offene jahrelange Nachmittags-AG (kein Trimester), 8-10 Einzel-SuS mit optionalen 2er-Paarungen, 4 Bambu-Lab-Drucker (3 geschlossen + 1 A1 mini). Konzept v2 (Reality-Check-Iteration 2026-05-24): - Onboarding-Pfad statt Pflicht-Lektionen (L1-L3 selbst-zertifiziert) - Selbstlern-Loop als Kern: SuS-Projekte wachsen die interne Bibliothek - Drill-Down-Lehrer-Dashboard (Wer ist hier / Wartet Review / Haengt fest) - Cockpit progressiv: zeigt nur was zum Status passt - Bambu-Cloud-API fuer Drucker-Live-Status (fragil + Fallback manuell) - Three.js-Vorschau fuer Cover-aus-3D-Ansicht (Etappe 6) - Vollstaendige Doku als Obsidian-Vault (24 Markdown-Dateien) - Entscheidungen E-001 bis E-022 in docs/decisions.md Etappe 1 lauffaehig (~1800 Zeilen Code): - Blueprint-Struktur (V8): routes/oeffentlich+profil+admin+api, services/auth+bambu+datei - Komplettes Schema in database.py (14 Tabellen, idempotent) - Login mit bcrypt + persistentem Lockout in DB (V7, verbessert ggue Arduino-Kurs der In-Memory-Dict nutzt) - Admin-Login + Profile-CRUD + PIN-Reset + PIN-Karten-Druckbogen - Inline-Edit-Endpunkt mit Whitelist + Audit-Log - Seeds: AG lessing-3d-ag + 4 Drucker + Default-Einstellungen - Smoke-Test bestanden (Login, Profil-Anlage, Lockout-Logging) Nicht im Repo (.gitignore): .env, *.db, venv/, .obsidian/workspace.json
2026-05-24 18:56:59 +02:00
**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)
```bash
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)
```bash
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
- [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 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|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)
Reference in New Issue Copy Permalink