From c8981758557fed3245e36380add89e8d28628aeb Mon Sep 17 00:00:00 2001 From: ValueOn AG Date: Wed, 19 Nov 2025 14:02:28 +0100 Subject: [PATCH] =?UTF-8?q?Handover=20Plan=20gem=C3=A4ss=20Meeting=20aktua?= =?UTF-8?q?lisiert?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- training/handover_einarbeitungsplan.md | 267 +++++++++++-------------- 1 file changed, 112 insertions(+), 155 deletions(-) diff --git a/training/handover_einarbeitungsplan.md b/training/handover_einarbeitungsplan.md index e95c50e..6637e71 100644 --- a/training/handover_einarbeitungsplan.md +++ b/training/handover_einarbeitungsplan.md @@ -6,16 +6,14 @@ --- -## Übersicht: 4 Phasen +## Übersicht: 3 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) +Phase 3: Selbstständige Entwicklung & Konsolidierung (Woche 5) ``` **Info - Parallele Refactors:** @@ -51,20 +49,6 @@ Dokumentationen geradeziehen und nachführen, Struktur der Dokumentation klären - 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 @@ -84,9 +68,36 @@ Dokumentationen geradeziehen und nachführen, Struktur der Dokumentation klären - 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 (z.B. 2 Wochen) + - 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 @@ -99,17 +110,16 @@ Dokumentationen geradeziehen und nachführen, Struktur der Dokumentation klären - Struktur visualisieren - Team informieren und Feedback einholen -### Checkpoint 1 (Ende Woche 2) +### 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) | -| 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 strukturiert (wöchentlich) | Stephan | (offen) | | Sprint-Planung, Notion-Doku und Wiki abgestimmt | Stephan | (offen) | | Intuitiv klar, was wohin gehört | Ida & Stephan | (offen) | @@ -123,11 +133,11 @@ Erste Bug-Fixes implementieren, Dokumentation aktualisieren, Feature-Integration ### 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 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 @@ -137,6 +147,32 @@ Erste Bug-Fixes implementieren, Dokumentation aktualisieren, Feature-Integration - 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? @@ -157,20 +193,6 @@ Erste Bug-Fixes implementieren, Dokumentation aktualisieren, Feature-Integration ### 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 @@ -190,160 +212,91 @@ Erste Bug-Fixes implementieren, Dokumentation aktualisieren, Feature-Integration - Verbesserungen einarbeiten - **Mehrsprachigkeits-Konzept dokumentieren** -### Checkpoint 2 (Ende Woche 4) +### Checkpoint 4 (Woche 4) - Montag, 15.12.2025, 09:30-10:00 **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) +## Phase 3: Selbstständige Entwicklung & Konsolidierung (Woche 5) ### Ziel -Kritische Gaps beheben, neue Features entwickeln, Best Practices etablieren +Kritische Gaps beheben, Immobilien Analyse implementieren, neue Features entwickeln, Best Practices etablieren, Dokumentation finalisieren ### Aufgaben für Ida -#### Woche 5: Kritische Gaps beheben -- [ ] **Tag 1-2**: Fast Path Implementation +#### 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 - - 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 + - **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 - -#### 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 + - Dokumentation aktualisieren ### 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 +#### 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 5**: Dokumentations-Templates erstellen - - Template für neue Features - - Template für Architektur-Dokumente - - Template für Implementierungs-Dokumente +- [ ] **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 -#### 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) +### Final Checkpoint (Woche 5) - Freitag, 19.12.2025, 13:30-14:00 **Prüfung durch Patrick:** | Kriterium | Name | Status | | ---------- | ---- | ------ | | Fast Path implementiert | Ida | (offen) | -| User-Language Messages implementiert | Ida | (offen) | -| Neue Features erfolgreich integriert | 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) | -| 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) | +| 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) | @@ -355,7 +308,7 @@ Kritische Gaps beheben, neue Features entwickeln, Best Practices etablieren ## Wöchentliche Checkpoints ### Format -- **Dauer**: 30-60 Minuten +- **Dauer**: 30 Minuten - **Teilnehmer**: Patrick, Ida, Stephan - **Agenda**: 1. Fortschritt der letzten Woche @@ -364,10 +317,14 @@ Kritische Gaps beheben, neue Features entwickeln, Best Practices etablieren 4. Feedback & Anpassungen ### Checkpoint-Termine -- **Checkpoint 1**: Ende Woche 2 -- **Checkpoint 2**: Ende Woche 4 -- **Checkpoint 3**: Ende Woche 6 -- **Final Checkpoint**: Weihnachten +- **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 ---