91 lines
2.7 KiB
Markdown
91 lines
2.7 KiB
Markdown
# LehrerApp-Austauschformat: einzelne Stundenplanung
|
||
|
||
Dieses Dokument beschreibt Version 1 des JSON-Formats `lehrerapp.lesson-planning`.
|
||
Es dient zum Austausch genau einer Stunde mit ihrem Verlaufsplan.
|
||
|
||
## Grundregeln
|
||
|
||
- Die Datei enthält reines UTF-8-JSON. Beim Import wird auch ein einzelner Markdown-Codeblock akzeptiert.
|
||
- Datum: `JJJJ-MM-TT`; Uhrzeit: `HH:MM` oder `HH:MM:SS`.
|
||
- Interne IDs werden nicht übertragen. Der Import legt eine neue Stunde in der aktuell ausgewählten Einheit an.
|
||
- `context` ist nur Bearbeitungshilfe und entscheidet nicht über das Importziel.
|
||
- Unbekannte zusätzliche Felder werden ignoriert.
|
||
|
||
## Beispiel
|
||
|
||
```json
|
||
{
|
||
"schema": "lehrerapp.lesson-planning",
|
||
"version": 1,
|
||
"context": {
|
||
"group": "8a",
|
||
"subject": "Physik",
|
||
"gradeLevel": 8,
|
||
"unitTitle": "Optik"
|
||
},
|
||
"lesson": {
|
||
"date": "2026-09-08",
|
||
"lessonNumber": 3,
|
||
"topic": "Reflexionsgesetz",
|
||
"startTime": "09:50:00",
|
||
"status": "planned",
|
||
"homework": "Versuchsprotokoll fertigstellen",
|
||
"reflection": null,
|
||
"phases": [
|
||
{
|
||
"name": "Einstieg",
|
||
"durationMinutes": 8,
|
||
"activity": "Alltagsbeispiele für Reflexion sammeln",
|
||
"material": "Spiegel",
|
||
"shorthand": "UG",
|
||
"alternativePath": null
|
||
},
|
||
{
|
||
"name": "Experiment",
|
||
"durationMinutes": 27,
|
||
"activity": "Einfalls- und Ausfallswinkel messen",
|
||
"material": "Optikbox, AB 03",
|
||
"shorthand": "PA",
|
||
"alternativePath": null
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
## Felder
|
||
|
||
### Dokument
|
||
|
||
- `schema` (Pflicht): exakt `lehrerapp.lesson-planning`
|
||
- `version` (Pflicht): aktuell `1`
|
||
- `context` (optional): `group`, `subject`, `gradeLevel`, `unitTitle`
|
||
- `lesson` (Pflicht): die neue Stundenplanung
|
||
|
||
### Stunde
|
||
|
||
- `date` (Pflicht, Datum)
|
||
- `lessonNumber` (optional, Ganzzahl 1–20 oder `null`)
|
||
- `topic` (Pflicht, Text)
|
||
- `startTime` (optional, Uhrzeit oder `null`)
|
||
- `status` (optional: `planned` oder `conducted`, Standard `planned`)
|
||
- `homework`, `reflection` (optional, Text oder `null`)
|
||
- `phases` (Liste, darf leer sein)
|
||
|
||
### Phase
|
||
|
||
- `name`: Bezeichnung, z. B. `Einstieg` oder `Sicherung`
|
||
- `durationMinutes`: Ganzzahl 0–180
|
||
- `activity`: Lehrer-/Schüler-Tätigkeit
|
||
- `material`: benötigte Medien und Materialien
|
||
- `shorthand`: Kurzsymbol oder Sozialform
|
||
- `alternativePath` (optional): Name eines alternativen Verlaufs. Ein vorhandener gleichnamiger Ablauf wird wiederverwendet, andernfalls neu angelegt.
|
||
|
||
## Hinweise für KI-Bearbeitung
|
||
|
||
- JSON-Struktur, `schema` und `version` unverändert lassen.
|
||
- Keine IDs ergänzen.
|
||
- Das Datum muss gesetzt sein; die Stundennummer darf fehlen.
|
||
- Die Summe der `durationMinutes` sollte zur verfügbaren Unterrichtszeit passen.
|
||
|