# LMS Kurs-Schema — Anleitung für KI-Agenten (JSON-Import) Erstelle Kurse für ein deutschsprachiges LMS als JSON-Datei. Der Kurs kann direkt über **Meine Kurse → Kurs importieren** in das LMS geladen werden. --- ## Dateiformat **Option A — Reines Kurs-JSON** (empfohlen): ```json { "id": "kurs-abc123", "title": "...", "lessons": [...] } ``` **Option B — Export-Bundle** (mit eingebetteten Medien): ```json { "_lms_export": 1, "course": { ... }, "media": { "data/uploads/abc.png": "" } } ``` --- ## Gesamtstruktur ``` Kurs └── lessons[] ├── sections[] ← Erklärungsinhalt (Abschnitte, sequenziell) │ └── blocks[] ← Inhaltsblöcke ├── tasks[] ← Aufgaben für die gesamte Lektion (nicht pro Abschnitt!) └── quiz[] ← Abschluss-Quiz ``` ### ⚠️ Wichtig: Sections und Tasks sind getrennte Tabs Eine Lektion hat zwei Tabs für Schüler: 1. **Abschnitte** — `sections[]` werden **nacheinander** durchgearbeitet (Schüler klickt sich mit „Weiter" durch Abschnitt 1 → 2 → 3 usw.) 2. **Aufgaben-Tab** — Alle `tasks[]` erscheinen **gemeinsam auf einer Seite** — es gibt kein „Tasks pro Abschnitt". **Konsequenz für die Kursgestaltung:** Wenn eine Lektion mehrere Abschnitte hat (z.B. Phase 1: Theorie, Phase 2: Beispiel, Phase 3: Praxis), müssen **alle** Aufgaben aller Phasen in dem gemeinsamen `tasks[]`-Array stehen. Damit Schüler erkennen, zu welchem Abschnitt eine Aufgabe gehört, nutze `text-block` als Trenner und `info-block` für Hinweise: ```json "tasks": [ { "type": "text-block", "id": "t-h1", "content": "📘 Aufgaben zu Abschnitt 1 — Theorie" }, { "type": "freitext", "id": "t-a1", "title": "...", "bit": 1 }, { "type": "info-block", "id": "t-hint", "content": "Arbeite jetzt Abschnitt 2 durch, bevor du hier weitermachst.", "style": "warning" }, { "type": "text-block", "id": "t-h2", "content": "📗 Aufgaben zu Abschnitt 2 — Praxis" }, { "type": "mc", "id": "t-a2", "title": "...", "opts": ["..."], "ok": 0, "explain": "...", "bit": 2 } ] ``` **Regel:** Bei Lektionen mit 2+ Abschnitten immer `text-block`-Trenner zwischen die Aufgabengruppen setzen. --- ## Kurs (oberste Ebene) ```json { "id": "kurs-abc123", "title": "Python Grundkurs", "subtitle": "Für Einsteiger ab Klasse 7", "desc": "In diesem Kurs lernst du die Grundlagen von Python.", "icon": "🐍", "color": "#4f46e5", "tags": ["Python", "Anfänger"], "active": false, "boardEnabled": true, "lessons": [] } ``` | Feld | Pflicht | Typ | Limit | Beschreibung | |---|---|---|---|---| | `id` | ja | string | — | Wird beim Import überschrieben, trotzdem angeben | | `title` | ja | string | 100 | Kursname | | `subtitle` | nein | string | 200 | Untertitel | | `desc` | nein | string | 500 | Kurzbeschreibung | | `icon` | nein | string | 10 | Emoji (Standard: 📖) | | `color` | nein | string | — | Hex-Farbe, z.B. `#4f46e5` | | `tags` | nein | array | max. 10 | Schlagwörter, je max. 30 Zeichen | | `active` | nein | bool | — | Beim Import immer `false` | | `boardEnabled` | nein | bool | — | Diskussions-Pinnwand (Standard: `true`) | | `lessons` | ja | array | — | Array von Lektionen | --- ## Lektion ```json { "key": "l-intro", "title": "Variablen und Datentypen", "desc": "Du lernst, wie man Werte speichert.", "icon": "📦", "tutorEnabled": false, "tutorPrompt": "", "sections": [], "tasks": [], "quiz": [] } ``` | Feld | Pflicht | Typ | Limit | Beschreibung | |---|---|---|---|---| | `key` | ja | string | — | Eindeutig, nur `[a-z0-9-]`, z.B. `l-vars` | | `title` | ja | string | 200 | Lektionstitel | | `desc` | nein | string | 500 | Kurzbeschreibung der Lektion | | `icon` | nein | string | 10 | Emoji (Standard: 📖) | | `tutorEnabled` | nein | bool | — | KI-Tutor bei Aufgaben aktiv (braucht LLM-Config) | | `tutorPrompt` | nein | string | 2000 | Eigener System-Prompt für den KI-Tutor | | `sections` | ja | array | — | Abschnitte mit Erklärungsinhalt | | `tasks` | ja | array | — | Aufgaben | | `quiz` | ja | array | — | Abschluss-Quiz | --- ## Abschnitte (sections) Jede Lektion hat ein `sections`-Array. Die Anzahl steuert die Navigation: - **1 Abschnitt** → kein Stepper, Inhalt direkt sichtbar - **2+ Abschnitte** → Weiter/Zurück-Navigation mit Dots ```json { "title": "Was ist eine Variable?", "blocks": [] } ``` | Feld | Pflicht | Typ | Limit | Beschreibung | |---|---|---|---|---| | `title` | nein | string | 200 | Abschnittstitel (leer = kein Titel) | | `blocks` | ja | array | — | Inhaltsblöcke (s.u.) | --- ## Inhaltsblöcke (blocks) ### text Fließtext mit einfachem HTML. ```json { "type": "text", "html": "

Text mit fett und Code.

" } ``` Erlaubte Tags: `

` `` `` `` `` `