LehrerApp/LehrerApp.Desktop/Assets/PlanningFormats/Stundenplanung-Format.md

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

{
  "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.