Validierung & Export

​

Was ist die Validierung?

​

Der Validierungsprozess

​

Automatische Prüfung

​

Validierungs-Ergebnis

​

✅ Bestanden (Passed)

• Keine Fehler gefunden
• Keine Warnungen gefunden
• Szenario ist export-bereit

​

⚠️ Warnungen (Warnings)

⚠️ Warnungen gefunden
5 Warnung(en) gefunden. Sie können trotzdem exportieren.

• Keine blockierenden Fehler
• Empfohlene Verbesserungen gefunden
• Export ist möglich, aber Qualität könnte besser sein

• Event sehr kurz (<300 Zeichen)
• Event sehr lang (>2.500 Zeichen)
• Großer Zeitsprung (>8 Stunden ohne Erklärung)
• NPC erscheint ohne vorherige Erwähnung
• Assessment-Frage möglicherweise zu leicht
• Wenig sensorische Details

1. “Probleme beheben”: Auto-Fix für Warnungen
2. “Trotzdem exportieren”: Bestätigung erforderlich
3. Zurück zu Review: Manuelle Bearbeitung

​

❌ Fehler (Errors)

❌ Validierung fehlgeschlagen
3 Fehler gefunden, die vor dem Export behoben werden müssen.

• Blockierende Probleme gefunden
• Export nicht möglich
• Fehler müssen behoben werden

• Zeit fließt rückwärts (z.B. e5: 10:00 Uhr → e6: 09:00 Uhr)
• Event-Referenz existiert nicht (leads_to: “e99” aber e99 existiert nicht)
• NPC-Name ändert sich (e3: “Dr. Müller” → e7: “Dr. Mueller”)
• Verwaister Event (kein Pfad führt zu diesem Event)
• Toter Pfad (Event führt nirgendwo hin)
• Assessment ohne korrekte Antwort
• Branching-Option führt zu nicht-existierendem Event

​

Validierungsprobleme verstehen

​

Problem-Darstellung

• Severity-Badge: ERROR | WARNING | SUGGESTION (farbcodiert)
• Type-Badge: Timeline | Continuity | Character | Structure
• Beschreibung: Was ist das Problem?
• Vorschlag: Wie beheben? (wenn verfügbar)
• Betroffene Events: Klickbare Event-IDs

┌─────────────────────────────────────────┐
│ [ERROR] [Timeline]                      │
│                                         │
│ Zeit fließt rückwärts zwischen e5       │
│ und e6. Event e5 hat 10:20 Uhr, aber   │
│ e6 hat 09:15 Uhr.                       │
│                                         │
│ 💡 Vorschlag: Zeit in e6 auf 10:25 Uhr  │
│    oder später ändern.                  │
│                                         │
│ 🔗 Betroffene Events: [e5] [e6]         │
└─────────────────────────────────────────┘

​

Problem-Kategorien

​

Probleme beheben

​

Auto-Fix (Empfohlen)

1. System analysiert jedes Problem
2. Lokale Fixes (instant):
   • Zeit-Korrekturen
   • Format-Angleichungen
3. Backend Micro-Edits (~5-10 Sek pro Problem):
   • NPC-Namen korrigieren
   • Event erweitern/kürzen
   • Content-Anpassungen

Behebe Probleme... 3/7 behoben
├─ ✅ Zeit in e6 korrigiert
├─ ✅ Zeit in e12 korrigiert
├─ ✅ NPC-Name in e15 korrigiert
└─ ⏳ Event e23 wird erweitert...

​

Manuelle Behebung

1. Klicken Sie auf Event-ID in der Problem-Karte
2. Sie werden zu Event-Review zurückgeleitet
3. Bearbeiten Sie den Event manuell
4. Zurück zur Validierung
5. “Erneut validieren” klicken

• Sie möchten größere inhaltliche Änderungen
• Auto-Fix-Ergebnis ist nicht zufriedenstellend
• Problem erfordert kreative Lösung

​

Export-Prozess

​

Wann ist Export möglich?

​

Export starten

┌──────────────────────────────────────┐
│ Mit Warnungen exportieren?           │
│                                      │
│ Ihr Szenario hat 5 Warnung(en).     │
│ Möchten Sie trotzdem exportieren?   │
│                                      │
│  [Abbrechen]  [Ja, exportieren]     │
└──────────────────────────────────────┘

​

Export-Format

{
  "metadata": {
    "id": "uuid-v4",
    "title": "Ransomware-Angriff auf Klinikum",
    "version": "1.0.0",
    "created_at": "2025-01-15T14:23:11Z",
    "creator": "user@example.com",
    "language": "de"
  },
  "settings": {
    "industry": "Healthcare",
    "organization_type": "Hospital",
    "organization_size": "Large",
    "incident_type": "Ransomware Attack",
    "severity": "Major",
    "duration": "3 days"
  },
  "learning_objectives": [
    {
      "id": "lo1",
      "category": "Decision Making",
      "description": "Entscheidungen unter Zeitdruck treffen"
    }
  ],
  "events": [
    {
      "event_id": "e1",
      "event_number": 1,
      "title": "Erste Warnsignale",
      "phase": "Opening",
      "time_marker": "Tag 1, 08:00 Uhr",
      "content": "Du betrittst...",
      "npcs": ["Dr. Müller", "IT-Leiter Schmidt"],
      "tension_level": 1,
      "leads_to": "e2"
    },
    ...
  ],
  "assessments": [
    {
      "assessment_id": "a1",
      "after_event": "e5",
      "topic": "Priorisierung unter Druck",
      "question": "Welche Maßnahme...",
      "options": [...],
      "correct_answer": "opt_a",
      "explanation": "..."
    }
  ],
  "validation": {
    "passed": true,
    "issues": [],
    "validated_at": "2025-01-15T14:22:45Z"
  },
  "usage": {
    "toc_generation": {
      "tokens": 8234,
      "cost_usd": 0.15
    },
    "event_generation": {
      "tokens": 45678,
      "cost_usd": 0.89
    },
    "total_tokens": 53912,
    "total_cost_usd": 1.04
  }
}

​

Was wird exportiert?

• Alle Events mit vollständigen narrativen Texten
• Alle Branching-Optionen
• Alle Assessments
• NPC-Definitionen
• Timeline-Struktur
• Metadata & Settings
• Validierungs-Status
• Token & Kosten-Tracking

• Review-Notizen (nur lokal im Browser)
• Bearbeitungshistorie
• Temporäre Zwischenstände

​

Nach dem Export

​

Datei nutzen

1. Import in Trainingsplattform: Direkt in crisisIQ Trainingsmodul hochladen
2. Archivierung: Als Backup speichern
3. Versionsmanagement: Mit anderen Versionen vergleichen
4. Weitergabe: An Kollegen oder Trainer senden

​

Erneut bearbeiten

1. Öffnen Sie Builder erneut
2. Auto-Resume: System erkennt gespeicherten Workflow
3. Wählen Sie “Fortsetzen”
4. Sie sind genau dort, wo Sie aufgehört haben

​

Validierungs-Kosten

• Pro lokalem Fix: $0 (instant)
• Pro Backend Micro-Edit: ~$0.005-0.01

​

Häufige Validierungsprobleme & Lösungen

​

Validierungs-Checkliste

​

Strukturelle Integrität

​

Timeline-Konsistenz

​

Content-Qualität

​

Logische Kohärenz

​

Troubleshooting

​

”Validierung läuft ewig”

1. Warten Sie weitere 2 Minuten
2. Seite neu laden (F5) - Auto-Resume greift
3. Erneut validieren

​

”Auto-Fix funktioniert nicht”

• Verwaiste Events: Verbindung im TOC herstellen
• Fehlende Referenzen: Event-IDs im TOC korrigieren
• Konvergenz-Probleme: Timeline im TOC anpassen

​

”Export-Button ist ausgegraut”

1. Scrollen Sie nach oben zu den Error-Karten
2. Beheben Sie alle ERRORS
3. Re-validieren
4. Export sollte nun möglich sein

​

Best Practices

​

Validierung früh & oft

​

Auto-Fix bevorzugen

• ✅ Schneller (5-10 Sek vs. 2-3 Min manuell)
• ✅ Günstiger (~50-70% Tokens gespart)
• ✅ Konsistenter (einheitlicher Stil)

• Auto-Fix-Ergebnis nicht zufriedenstellend
• Strukturelle Änderungen nötig
• Kreative Lösung gewünscht

​

Warnungen ernst nehmen

​

Export-Backups

1. v1.0: Nach erster erfolgreicher Validierung
2. v1.1: Nach Warnung-Fixes
3. v2.0: Nach inhaltlichen Verbesserungen

​

Nächste Schritte