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: 3 Phasen

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

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

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?

Checkpoint 1 (Woche 1) - Montag, 24.11.2025, 09:30-10:00

Prüfung durch Patrick:

Kriterium	Name	Status
Dokumentationen analysiert und Aktualisierungsbedarf identifiziert	Ida	(offen)
Althaus Chat Integration analysiert	Ida	(offen)
Graphische Workflow-Modellierung vertieft	Ida	(offen)
Dokumentationsstruktur analysiert	Stephan	(offen)
Regeln für Wiki vs. Notion definiert	Stephan	(offen)

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 2: Sprint-Planung & Dokumentations-Integration

• Tag 1-2: Sprint-Planung strukturieren
  • Sprint-Länge festlegen: Wöchentliche Sprints (Montags 09:30-10:00, startend ab 24.11.2025)
  • 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 2 (Woche 2) - Montag, 01.12.2025, 09:30-10:00

Prüfung durch Patrick:

Kriterium	Name	Status
Dokumentationen aktualisiert und nachgeführt	Ida	(offen)
Vorschlag für Althaus Chat-Integration erstellt	Ida	(offen)
Vorschlag für Nyla UI-Gestaltung erstellt	Ida	(offen)
Dokumentationsstruktur etabliert	Stephan	(offen)
Sprint-Planung strukturiert (wöchentlich)	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: Code Analyse mit AI für kritische Themen
  • Kritische Code-Bereiche identifizieren
  • AI-Tools für Code-Analyse nutzen
  • Potenzielle Probleme und Verbesserungen dokumentieren
  • Prioritäten setzen
• 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

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

Checkpoint 3 (Woche 3) - Montag, 08.12.2025, 09:30-10:00

Prüfung durch Patrick:

Kriterium	Name	Status
Code Analyse mit AI für kritische Themen durchgeführt	Ida	(offen)
Code-Qualität verbessert	Ida	(offen)
Dokumentations-Lücken geschlossen	Stephan	(offen)
Dokumentations-Struktur verbessert	Stephan	(offen)

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 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 4 (Woche 4) - Montag, 15.12.2025, 09:30-10:00

Prüfung durch Patrick:

Kriterium	Name	Status
Feature-Integrations-Anleitung erstellt	Ida	(offen)
React UI Objektbaum erstellt	Ida	(offen)
Komponentenmodell vervollständigt	Stephan	(offen)
Mehrsprachigkeits-Konzept gestartet (mit Ida)	Ida & Stephan	(offen)

---

Phase 3: Selbstständige Entwicklung & Konsolidierung (Woche 5)

Ziel

Kritische Gaps beheben, Immobilien Analyse implementieren, neue Features entwickeln, Best Practices etablieren, Dokumentation finalisieren

Aufgaben für Ida

Woche 5: Kritische Gaps beheben & Immobilien Analyse

• Tag 1-2: Fast Path Implementation & Immobilien Analyse - Konzept
  • detectComplexity() Funktion implementieren
  • fastPathExecute() Funktion implementieren
  • Routing-Logik in workflowManager.py einbauen
  • Konzept erstellen: Feature "PEK Kunde" mit Route "immoAnalyse"
  • interfaceImmo definieren
  • datamodelImmo erstellen
• Tag 3-4: Immobilien Analyse - Implementierung & UI
  • Feature "PEK Kunde" vollständig implementieren
  • Route "immoAnalyse" finalisieren
  • interfaceImmo und datamodelImmo integrieren
  • Backend-Integration planen und umsetzen
  • Erstes UI für Monitoring der Workflow-Daten entwickeln
  • Datenvisualisierung konzipieren und implementieren
• Tag 5: Testing, Code-Review & Architektur-Verbesserungen
  • Immobilien Analyse Feature testen
  • Integrationstests schreiben
  • Code-Review durchführen
  • Code-Duplikation reduzieren
  • Performance-Optimierungen
  • Dokumentation aktualisieren

Aufgaben für Stephan

Woche 5: Dokumentations-Konsolidierung & Sprint-Planung

• Tag 1-2: Dokumentations-Konsolidierung + Mehrsprachigkeits-Konzept finalisieren
  • Alle Dokumentationen durchgehen
  • Aktualitätsprüfung und Konsistenz prüfen
  • 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 3-4: Dokumentations-Finalisierung
  • Alle Dokumentationen aktualisieren
  • Komponentenmodell finalisieren
  • Feature-Integrations-Anleitung finalisieren
  • Dokumentations-Index vollständig
  • Dokumentations-Templates erstellen
• Tag 5: Sprint-Planung & Prozess-Optimierung
  • Backlog strukturieren
  • Sprint-Planung für nächste Sprints
  • Metriken & Reporting etablieren
  • Wissenstransfer dokumentieren
  • Handover-Dokumentation vervollständigen

Final Checkpoint (Woche 5) - Freitag, 19.12.2025, 13:30-14:00

Prüfung durch Patrick:

Kriterium	Name	Status
Fast Path implementiert	Ida	(offen)
Immobilien Analyse (PEK Kunde) konzipiert und implementiert	Ida	(offen)
UI für Monitoring der Workflow-Daten erstellt	Ida	(offen)
Architektur-Verbesserungen umgesetzt	Ida	(offen)
Code-Qualität auf hohem Niveau gehalten	Ida	(offen)
Umfassende Tests geschrieben	Ida	(offen)
Alle Dokumentationen aktualisiert	Stephan	(offen)
Komponentenmodell finalisiert	Stephan	(offen)
Feature-Integrations-Anleitung finalisiert	Stephan	(offen)
Dokumentations-Index vollständig	Stephan	(offen)
Mehrsprachigkeits-Konzept finalisiert (mit Ida)	Ida & Stephan	(offen)
Dokumentations-Templates erstellt	Stephan	(offen)
Sprint-Planung strukturiert	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 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: Montag, 24.11.2025, 09:30-10:00 (Woche 1)
• Checkpoint 2: Montag, 01.12.2025, 09:30-10:00 (Woche 2)
• Checkpoint 3: Montag, 08.12.2025, 09:30-10:00 (Woche 3)
• Checkpoint 4: Montag, 15.12.2025, 09:30-10:00 (Woche 4)
• Final Checkpoint: Freitag, 19.12.2025, 13:30-14:00 (Woche 5)

Sprint-Termine

• Wöchentliche Sprints: Montags 09:30-10:00, startend ab 24.11.2025

---

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! 🚀