124-webapp/data/KURSE_QUICKREF.md
2025-10-07 13:02:29 +02:00

104 lines
2.8 KiB
Markdown

# 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
```