341 lines
13 KiB
Markdown
341 lines
13 KiB
Markdown
# 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! 🚀**
|
|
|