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