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