wiki/training/handover_einarbeitungsplan.md

Einarbeitungsplan: Ida & Stephan bis Weihnachten

Zeitraum: 19.11.2025 bis Weihnachten
Trainingsziel: Verstehen & Starten
Ziel: Vollständige Übernahme der Code-Entwicklung und Dokumentation

---

Übersicht: 4 Phasen

Phase 1: Grundlagen (Woche 1-2)
    ↓
Phase 2: Praktische Einarbeitung (Woche 3-4)
    ↓
Phase 3: Selbstständige Entwicklung (Woche 5-6)
    ↓
Phase 4: Konsolidierung (bis Weihnachten)

Info - Parallele Refactors: Patrick macht parallel:

• RBAC Refactoring: RBAC in DB überführen mit klaren Rollenmodellen und Berechtigungen für UI-Komponenten
• Finalisierung Separation der Gateway Funktionsblöcke: Core, Messaging, Workflow, AI & Chat

---

Phase 1: Grundlagen (Woche 1-2)

Ziel

Dokumentationen geradeziehen und nachführen, Struktur der Dokumentation klären, Integrationen planen

Aufgaben für Ida

Hinweis: Ida kennt die App bereits und entwickelt darauf.

Woche 1: Dokumentationen geradeziehen & nachführen

• Tag 1-2: Bestehende Dokumentationen analysieren und aktualisieren
  • doc_gateway_architecture_overview.md auf Aktualität prüfen
  • doc_gateway_development_framework.md mit aktueller Codebase abgleichen
  • doc_diagram_components.md vervollständigen
  • doc_dev_workflow.md aktualisieren
  • Dokumentationen nachführen, wo Code weiterentwickelt wurde
• Tag 3-4: Althaus Chat Integration analysieren
  • Bestehende Althaus Chat-Implementierung analysieren (features/chatAlthaus/)
  • Architektur verstehen und dokumentieren
  • Vorschlag erstellen: Wie Althaus Chat in die Gesamtarchitektur integrieren?
  • Integration-Pattern identifizieren
• Tag 5: Graphische Workflow-Modellierung vertiefen
  • Bestehende Workflow-Modellierung analysieren
  • Graphische Darstellung verstehen
  • Vertiefung in das Thema der graphischen Workflow-Modellierung
  • Möglichkeiten und Anforderungen identifizieren

Woche 2: Nyla UI & Customer Journeys

• Tag 1-2: Nyla UI analysieren und Customer Journeys verstehen
  • Bestehende UI-Struktur analysieren (frontend_agents/)
  • Bekannte Customer Journeys identifizieren und dokumentieren
  • UI-Komponenten für Customer Journeys analysieren
• Tag 3-4: Nyla UI-Gestaltungskonzept entwickeln
  • Vorschlag erstellen: Wie Nyla UI gestalten, damit bekannte Customer Journeys flexibel gefahren werden können?
  • UI-Architektur für flexible Customer Journeys konzipieren
  • Komponenten-Struktur für Customer Journeys planen
• Tag 5: Dokumentationen finalisieren
  • Alle aktualisierten Dokumentationen reviewen
  • Integration-Vorschläge dokumentieren
  • Nyla UI-Konzept dokumentieren

Aufgaben für Stephan

Woche 1: Dokumentationsstruktur klären

• Tag 1-2: Bestehende Dokumentationsstruktur analysieren
  • Alle wiki/ Unterordner durchgehen
  • Notion-Struktur analysieren (falls vorhanden)
  • Dokumentations-Typen identifizieren
  • Aktuelle Verteilung Wiki vs. Notion verstehen
• Tag 3-4: Klare Regeln und Strukturen definieren
  • Klären: Was gehört ins Wiki? Was gehört ins Notion?
  • Klare Regeln für Dokumentations-Orte definieren
  • Struktur für beide Systeme festlegen
  • Naming Convention etablieren (handover_naming_convention.md durcharbeiten)
• Tag 5: Dokumentations-Index erstellen
  • Übersicht aller Dokumente (Wiki + Notion)
  • Kategorisierung nach Typ und Ort
  • Verlinkungen zwischen Dokumenten
  • Klare Zuordnung: Was gehört wohin?

Woche 2: Sprint-Planung & Dokumentations-Integration

• Tag 1-2: Sprint-Planung strukturieren
  • Sprint-Länge festlegen (z.B. 2 Wochen)
  • Backlog-Struktur definieren
  • Sprint-Planung in Notion strukturieren
• Tag 3-4: Integration sicherstellen
  • Sicherstellen: Sprint-Planung, Notion-Doku und Wiki sind integral aufeinander abgestimmt
  • Workflow definieren: Wie fließen Informationen zwischen den Systemen?
  • Klare Zuordnungen: Was gehört in Sprint-Planung, was in Notion, was ins Wiki?
  • Intuitive Struktur schaffen: Auf einfache Weise klar, was wohin gehört
• Tag 5: Dokumentations-Struktur finalisieren
  • Regeln dokumentieren
  • Struktur visualisieren
  • Team informieren und Feedback einholen

Checkpoint 1 (Ende Woche 2)

Prüfung durch Patrick:

Kriterium	Name	Status
Dokumentationen aktualisiert und nachgeführt	Ida	(offen)
Vorschlag für Althaus Chat-Integration erstellt	Ida	(offen)
Selbstständig in graphische Workflow-Modellierung vertieft	Ida	(offen)
Vorschlag für Nyla UI-Gestaltung erstellt	Ida	(offen)
Klare Regeln für Wiki vs. Notion definiert	Stephan	(offen)
Dokumentationsstruktur etabliert	Stephan	(offen)
Sprint-Planung, Notion-Doku und Wiki abgestimmt	Stephan	(offen)
Intuitiv klar, was wohin gehört	Ida & Stephan	(offen)

---

Phase 2: Praktische Einarbeitung (Woche 3-4)

Ziel

Erste Bug-Fixes implementieren, Dokumentation aktualisieren, Feature-Integrations-Anleitung erstellen

Aufgaben für Ida

Woche 3: Bug-Fixes & Code-Verbesserungen

• Tag 1-2: Task-Nummerierung Fix (kritisch)
  • Problem verstehen (siehe WORKFLOW_IMPLEMENTATION_GAPS.md)
  • workflowManager._executeTasks() analysieren
  • Fix implementieren
  • Testen
• Tag 3-4: Code-Qualität verbessern
  • Unused Functions identifizieren (tool_stats_showUnusedFunctions.py)
  • Code-Formatierung vereinheitlichen
  • Linter-Fehler beheben
• Tag 5: Code-Review für eigene Änderungen
  • Pull Requests erstellen
  • Review-Prozess durchlaufen
  • Feedback einarbeiten

Woche 4: Feature-Integrations-Anleitung + React UI Objektbaum

• Tag 1-2: Bestehende Features analysieren
  • Wie wurden Features bisher integriert?
  • Patterns identifizieren
  • Beispiele sammeln
• Tag 3-4: Feature-Integrations-Anleitung erstellen + React UI Objektbaum
  • Schritt-für-Schritt-Anleitung
  • Beispiele für verschiedene Feature-Typen
  • Checkliste für neue Features
  • React UI Objektbaum erstellen
    • Alle React-Komponenten analysieren
    • Komponenten-Hierarchie dokumentieren
    • Objektbaum visualisieren
• Tag 5: Anleitung testen
  • Kleines Feature als Beispiel integrieren
  • Anleitung dabei verwenden
  • Verbesserungen identifizieren

Aufgaben für Stephan

Woche 3: Dokumentations-Pflege

• Tag 1-2: Dokumentations-Lücken schließen
  • Fehlende Dokumentation identifizieren
  • Prioritäten setzen
  • Erste Dokumente erstellen/aktualisieren
• Tag 3-4: Dokumentations-Struktur verbessern
  • Verlinkungen zwischen Dokumenten
  • Index aktualisieren
  • Kategorisierung vervollständigen
• Tag 5: Review-Prozess für Dokumentation
  • Review-Checkliste erstellen
  • Qualitätskriterien definieren
  • Erste Dokumente reviewen

Woche 4: Komponentenmodell + Mehrsprachigkeits-Konzept

• Tag 1-2: Bestehendes Komponentenmodell analysieren
  • doc_diagram_components.md durcharbeiten
  • Lücken identifizieren
  • Aktualitätsprüfung
• Tag 3-4: Komponentenmodell vervollständigen + Mehrsprachigkeits-Konzept starten
  • Alle Komponenten dokumentieren
  • Beziehungen zwischen Komponenten
  • Diagramme aktualisieren/erstellen
  • Mehrsprachigkeits-Konzept entwickeln (mit Ida)
    • Backend-Analyse: Pydantic-Models mit Sprachen
    • Frontend-Analyse: React UI-Komponenten
    • Trennung: Backend/Logik vs. Frontend/Rendering
• Tag 5: Komponentenmodell validieren + Mehrsprachigkeits-Konzept
  • Mit Codebase abgleichen
  • Feedback von Ida einholen
  • Verbesserungen einarbeiten
  • Mehrsprachigkeits-Konzept dokumentieren

Checkpoint 2 (Ende Woche 4)

Prüfung durch Patrick:

Kriterium	Name	Status
Task-Nummerierung Fix implementiert	Ida	(offen)
Code-Qualität verbessert	Ida	(offen)
Feature-Integrations-Anleitung erstellt	Ida	(offen)
React UI Objektbaum erstellt	Ida	(offen)
Dokumentations-Lücken geschlossen	Stephan	(offen)
Dokumentations-Struktur verbessert	Stephan	(offen)
Komponentenmodell vervollständigt	Stephan	(offen)
Mehrsprachigkeits-Konzept gestartet (mit Ida)	Ida & Stephan	(offen)

---

Phase 3: Selbstständige Entwicklung (Woche 5-6)

Ziel

Kritische Gaps beheben, neue Features entwickeln, Best Practices etablieren

Aufgaben für Ida

Woche 5: Kritische Gaps beheben

• Tag 1-2: Fast Path Implementation
  • detectComplexity() Funktion implementieren
  • fastPathExecute() Funktion implementieren
  • Routing-Logik in workflowManager.py einbauen
  • Tests schreiben
• Tag 3-4: User-Language Messages
  • AI-generierte benutzerfreundliche Nachrichten
  • messageCreator.py anpassen
  • Mehrsprachigkeit testen
• Tag 5: Code-Review & Testing
  • Alle Änderungen testen
  • Integrationstests schreiben
  • Code-Review durchführen

Woche 6: Neue Features & Architektur-Verbesserungen

• Tag 1-2: Workflow-Level Models (optional)
  • RequestContext Model erstellen
  • UnderstandingResult Model erstellen
  • Migration planen (falls gewünscht)
• Tag 3-4: Architektur-Verbesserungen
  • Code-Duplikation reduzieren
  • Performance-Optimierungen
  • Refactoring wo nötig
• Tag 5: Feature-Entwicklung
  • Neues Feature nach Anleitung integrieren
  • Dokumentation parallel erstellen
  • Tests schreiben

Aufgaben für Stephan

Woche 5: Dokumentations-Konsolidierung + Mehrsprachigkeits-Konzept finalisieren

• Tag 1-2: Alle Dokumentationen durchgehen
  • Aktualitätsprüfung
  • Konsistenz prüfen
  • Verbesserungen identifizieren
• Tag 3-4: Dokumentations-Workflow etablieren + Mehrsprachigkeits-Konzept
  • Prozess für Dokumentations-Updates
  • Review-Prozess für Dokumentation
  • Qualitätskriterien durchsetzen
  • Mehrsprachigkeits-Konzept finalisieren (mit Ida)
    • Konzept für einfache UI-Mehrsprachigkeit
    • Abdeckung: Statische Texte, Log-Texte, Navigationstexte, Seitentexte
    • Backend: Pydantic-Models automatisiert erweiterbar
    • Frontend: Rendering-Themen
    • Klare Trennung Backend/Logik vs. Frontend
• Tag 5: Dokumentations-Templates erstellen
  • Template für neue Features
  • Template für Architektur-Dokumente
  • Template für Implementierungs-Dokumente

Woche 6: Sprint-Planung & Strukturierung

• Tag 1-2: Backlog strukturieren
  • Features priorisieren
  • Bugs kategorisieren
  • Technische Schulden dokumentieren
• Tag 3-4: Sprint-Planung für nächste Sprints
  • Sprint-Ziele definieren
  • Aufgaben verteilen
  • Zeitplanung
• Tag 5: Metriken & Reporting
  • Fortschritts-Tracking einrichten
  • Metriken definieren
  • Reporting-Struktur etablieren

Checkpoint 3 (Ende Woche 6)

Prüfung durch Patrick:

Kriterium	Name	Status
Fast Path implementiert	Ida	(offen)
User-Language Messages implementiert	Ida	(offen)
Neue Features erfolgreich integriert	Ida	(offen)
Architektur-Verbesserungen umgesetzt	Ida	(offen)
Dokumentations-Konsolidierung abgeschlossen	Stephan	(offen)
Mehrsprachigkeits-Konzept finalisiert (mit Ida)	Ida & Stephan	(offen)
Dokumentations-Templates erstellt	Stephan	(offen)
Sprint-Planung strukturiert	Stephan	(offen)
Code-Qualität ist hoch	Ida & Stephan	(offen)

---

Phase 4: Konsolidierung (bis Weihnachten)

Ziel

Verstehen & Starten: Alle kritischen Gaps geschlossen, Dokumentation vollständig strukturiert, Feature-Integrations-Anleitung fertig, Komponentenmodell komplett, Mehrsprachigkeits-Konzept fertig, React UI Objektbaum dokumentiert

Aufgaben für Ida

Woche 7-8: Finalisierung kritischer Features

• Alle kritischen Gaps aus WORKFLOW_IMPLEMENTATION_GAPS.md beheben
• Code-Qualität auf hohem Niveau halten
• Performance-Optimierungen
• Umfassende Tests schreiben

Woche 9-10: Feature-Entwicklung

• Neue Features nach Anleitung entwickeln
• Best Practices etablieren
• Code-Reviews durchführen
• Wissen dokumentieren

Aufgaben für Stephan

Woche 7-8: Dokumentations-Finalisierung

• Alle Dokumentationen aktualisieren
• Komponentenmodell finalisieren
• Feature-Integrations-Anleitung finalisieren
• Dokumentations-Index vollständig

Woche 9-10: Prozess-Optimierung

• Sprint-Prozess optimieren
• Metriken & Reporting etablieren
• Wissenstransfer dokumentieren
• Handover-Dokumentation vervollständigen

Final Checkpoint (Weihnachten)

Prüfung durch Patrick:

Kriterium	Name	Status
Alle kritischen Gaps geschlossen	Ida	(offen)
Code-Qualität auf hohem Niveau gehalten	Ida	(offen)
Performance-Optimierungen umgesetzt	Ida	(offen)
Umfassende Tests geschrieben	Ida	(offen)
Neue Features erfolgreich entwickelt	Ida	(offen)
Best Practices etabliert	Ida	(offen)
Alle Dokumentationen aktualisiert	Stephan	(offen)
Komponentenmodell finalisiert	Stephan	(offen)
Feature-Integrations-Anleitung finalisiert	Stephan	(offen)
Dokumentations-Index vollständig	Stephan	(offen)
Sprint-Prozess optimiert	Stephan	(offen)
Metriken & Reporting etabliert	Stephan	(offen)
Selbstständig entwickeln	Ida & Stephan	(offen)
Qualität ist hoch und konsistent	Ida & Stephan	(offen)
Verstehen & Starten abgeschlossen	Ida & Stephan	(offen)

---

Wöchentliche Checkpoints

Format

• Dauer: 30-60 Minuten
• Teilnehmer: Patrick, Ida, Stephan
• Agenda:
  1. Fortschritt der letzten Woche
  2. Herausforderungen & Blockaden
  3. Nächste Schritte
  4. Feedback & Anpassungen

Checkpoint-Termine

• Checkpoint 1: Ende Woche 2
• Checkpoint 2: Ende Woche 4
• Checkpoint 3: Ende Woche 6
• Final Checkpoint: Weihnachten

---

Ressourcen & Links

Dokumentation

• Architektur: wiki/appdoc/doc_gateway_architecture_overview.md
• Development Framework: wiki/appdoc/doc_gateway_development_framework.md
• Workflow System: wiki/appdoc/doc_dev_workflow.md
• Implementation Gaps: gateway/WORKFLOW_IMPLEMENTATION_GAPS.md

Viel Erfolg bei der Einarbeitung! 🚀