design final

data/KURSE_QUICKREF.md

@@ -0,0 +1,104 @@
+# Kurse Schnellanleitung / Quick Reference
+
+## 🚀 Kurs hinzufügen (Add Course)
+
+1. Öffne `data/courses.csv` (Open the file)
+2. Füge eine neue Zeile hinzu (Add a new line):
+
+```csv
+Kurs Titel,Beschreibung (optional),Termine (optional),Zielgruppe (optional)
+```
+
+### Beispiele (Examples):
+
+**Vollständiger Kurs (Full course):**
+```csv
+Robotik Workshop,LEGO SPIKE Programmierung,"Mo 11.11. 15:00, Mi 13.11. 15:00",Klasse 8-10
+```
+
+**Nur Titel + Termin (Title + Date only):**
+```csv
+Offene Werkstatt,,"Di 12.11. 14:00-16:00",
+```
+
+**Nur Titel + Zielgruppe (Title + Audience only):**
+```csv
+Kommt bald,,,alle Schüler:innen
+```
+
+## 📋 Spalten (Columns)
+
+| Spalte | Pflicht? | Beispiel |
+|--------|----------|----------|
+| `title` | ✅ JA | `Löten und Leuchten` |
+| `description` | ❌ Nein | `Herstellung von Nachttischleuchten...` |
+| `dates` | ❌ Nein | `Di 15.10. 14:00-16:00` |
+| `offen_fuer` | ❌ Nein | `Klasse 7-9` |
+
+## ⚡ Wichtige Regeln (Important Rules)
+
+1. **Erste Zeile nie löschen!** (Never delete header row)
+   ```csv
+   title,description,dates,offen_fuer
+   ```
+
+2. **Kommas in Terminen:** Anführungszeichen verwenden
+   ```csv
+   Workshop,"Text","Mo 10:00, Di 10:00",Klasse 8
+   ```
+
+3. **Leere Felder:** Einfach leer lassen
+   ```csv
+   Nur Titel,,,
+   ```
+
+4. **Keine Zeilenumbrüche** in den Feldern
+
+## 🎨 Darstellung (Display)
+
+```
+┌─────────────────────────────────────┐
+│ Kurs Titel                          │  ← Immer sichtbar
+│ Beschreibung hier...                │  ← Nur wenn vorhanden
+│ 📅 Di 15.10. 14:00-16:00           │  ← Nur wenn vorhanden
+│ 👥 Offen für: Klasse 7-9           │  ← Nur wenn vorhanden
+└─────────────────────────────────────┘
+```
+
+## 📝 Vorlage zum Kopieren (Template to Copy)
+
+```csv
+Neuer Kurs,Beschreibung hier,Termine hier,Zielgruppe hier
+```
+
+## ✅ Checkliste (Checklist)
+
+- [ ] CSV-Datei geöffnet: `data/courses.csv`
+- [ ] Neue Zeile am Ende hinzugefügt
+- [ ] Titel ausgefüllt (erforderlich!)
+- [ ] Optionale Felder ausgefüllt oder leer gelassen
+- [ ] Bei Kommas in Terminen: Anführungszeichen gesetzt
+- [ ] Datei gespeichert
+- [ ] Website neu laden → Kurs erscheint sofort!
+
+## 🔄 Live-Update
+
+**Kein Server-Neustart nötig!** (No restart needed!)
+Einfach Datei speichern und Website neu laden.
+
+## ❓ Beispiel-Szenarien
+
+### Vergangener Kurs (Past course)
+```csv
+Löten Basics,Grundlagen des Lötens,"Abgeschlossen: 10.10., 12.10.",Klasse 7-8
+```
+
+### Zukünftiger Kurs (Future course)
+```csv
+Drohnen Flug,Erste Schritte mit Drohnen,"Kommt: 20.11. 15:00",ab Klasse 9
+```
+
+### Kurs ohne festen Termin (Course without date)
+```csv
+Makerspace Tour,Kennenlernen des Studios,,alle Interessierten
+```