157 lines
4.9 KiB
Markdown
157 lines
4.9 KiB
Markdown
# Handover-Agenda: Sync mit Ida & Stephan
|
|
|
|
**Datum:** 19.11.2025
|
|
|
|
**Teilnehmer:**
|
|
| Name | Rolle |
|
|
|------|------|
|
|
| Ida | Coding Expertin, Architekt |
|
|
| Stephan | Sprintführung, Struktur, Dokumentation |
|
|
| Patrick | Product Owner, Applikations-Architekt |
|
|
| Dominic | Business Owner |
|
|
|
|
**Dauer:** 20 Minuten
|
|
|
|
---
|
|
|
|
## 1. Projektkontext & Zugriff (3 Min)
|
|
|
|
- **PowerOn Gateway**: Backend für intelligente Workflow-Automatisierung
|
|
- **Architektur**: Multi-Layer (Connectors → Interfaces → Services → Workflows)
|
|
- **Zugriff**: GitHub Repository, Dokumentation (`wiki/appdoc/`, `wiki/implementation/`), Code (`gateway/`, `frontend_agents/`)
|
|
- **Ziel**: Weiterentwicklung und Wartung übernehmen
|
|
|
|
---
|
|
|
|
## 2. System-Architektur (5 Min)
|
|
|
|
**Layer-Struktur:**
|
|
```
|
|
Routes → Services → Interfaces → Connectors
|
|
↓
|
|
Workflows (Orchestration)
|
|
↓
|
|
Datamodels & AI Core
|
|
```
|
|
|
|
**Wichtigste Verzeichnisse:**
|
|
- `gateway/modules/routes/` - HTTP Endpoints
|
|
- `gateway/modules/services/` - Business Logic
|
|
- `gateway/modules/interfaces/` - Standardisierte APIs
|
|
- `gateway/modules/connectors/` - Externe System-Integration
|
|
- `gateway/modules/workflows/` - Workflow-Orchestrierung
|
|
|
|
**Dokumentation:** `wiki/appdoc/` (Architektur), `wiki/implementation/` (Details)
|
|
|
|
---
|
|
|
|
## 3. Wichtige Anforderungen & Aufgaben (5 Min)
|
|
|
|
### Basis-Anforderungen:
|
|
1. **Komplettes Komponentenmodell** - Vervollständigen (`doc_diagram_components.md`)
|
|
2. **Klare Dokumentation** - Strukturieren, Naming Convention etablieren
|
|
3. **Feature-Integrations-Anleitung** - Praktische Schritt-für-Schritt-Anleitung erstellen
|
|
|
|
### Zusätzliche Aufgaben:
|
|
|
|
**Mehrsprachigkeits-Konzept** (Ida & Stephan):
|
|
- Konzept für einfache UI-Mehrsprachigkeit entwickeln
|
|
- Anforderungen:
|
|
- Einfaches Ergänzen neuer Sprachen jederzeit möglich
|
|
- Angepasste Elemente nachführbar
|
|
- Abdeckung: Statische Texte, Log-Texte, Navigationstexte, Seitentexte
|
|
- Backend: Bereits über Pydantic-Models mit Sprachen versorgt (automatisiert erweiterbar)
|
|
- Frontend: Rendering-Themen, die Backend nicht interessieren
|
|
- Klare Trennung: Was kommt aus Backend/Logik vs. Frontend
|
|
|
|
**React UI Objektbaum** (Ida):
|
|
- Objektbaum aller React UI-Elemente erstellen
|
|
- Klarheit über UI-Struktur und Komponenten-Hierarchie
|
|
- Dokumentation der React-Komponenten-Struktur
|
|
|
|
**Althaus Chat Integration** (Ida):
|
|
- Bestehende Implementierung analysieren
|
|
- Vorschlag für Integration in Gesamtarchitektur erstellen
|
|
|
|
**Nyla UI-Gestaltung** (Ida):
|
|
- Vorschlag für flexible Customer Journeys entwickeln
|
|
- UI-Architektur für bekannte Customer Journeys konzipieren
|
|
|
|
**Graphische Workflow-Modellierung** (Ida):
|
|
- Vertiefung in graphische Workflow-Modellierung
|
|
- Möglichkeiten und Anforderungen identifizieren
|
|
|
|
**Wiki vs. Notion Struktur** (Stephan):
|
|
- Klare Regeln definieren: Was gehört wohin?
|
|
- Sprint-Planung, Notion-Doku und Wiki abstimmen
|
|
- Intuitive Struktur schaffen
|
|
|
|
### Info - Parallele Refactors:
|
|
**RBAC Refactoring** (Patrick macht parallel):
|
|
- RBAC in DB überführen mit klaren Rollenmodellen
|
|
- Berechtigungen auch für UI-Komponenten definieren
|
|
- Klare Trennung Backend/Frontend Berechtigungen
|
|
|
|
---
|
|
|
|
## 4. Rollenverteilung (3 Min)
|
|
|
|
**Ida:**
|
|
- Code-Entwicklung, Architektur-Entscheidungen, Python/React
|
|
- Feature-Implementierung, Code-Review, Bug-Fixes
|
|
|
|
**Stephan:**
|
|
- Sprint-Planung, Dokumentations-Pflege, Prozess-Optimierung
|
|
|
|
**Zusammenarbeit:** Wöchentliche Syncs, Code-Reviews, Checkpoints mit Ida & Stephan
|
|
|
|
---
|
|
|
|
## 5. Einarbeitungsplan & Trainingsziel (4 Min)
|
|
|
|
**Trainingsziel bis Weihnachten:** Verstehen & Starten
|
|
|
|
**4 Phasen bis Weihnachten:**
|
|
- **Phase 1** (Woche 1-2): Grundlagen - Dokumentationen nachführen, Althaus Chat Integration, Nyla UI-Konzept, Wiki/Notion-Struktur klären
|
|
- **Phase 2** (Woche 3-4): Praktische Einarbeitung - Bug-Fixes, Feature-Integrations-Anleitung, React UI Objektbaum, Mehrsprachigkeits-Konzept
|
|
- **Phase 3** (Woche 5-6): Selbstständige Entwicklung - Kritische Gaps beheben, Features entwickeln, Mehrsprachigkeits-Konzept finalisieren
|
|
- **Phase 4** (bis Weihnachten): Konsolidierung - Verstehen & Starten abgeschlossen
|
|
|
|
**Checkpoints:** Ende Woche 2, 4, 6 und Weihnachten
|
|
|
|
**Details:** Siehe `handover_einarbeitungsplan.md`
|
|
|
|
---
|
|
|
|
## 6. Naming Convention (1 Min)
|
|
|
|
**Präfix-System:**
|
|
- `doc_*` - Architektur- und System-Dokumentation
|
|
- `implementation_*` - Implementierungsdetails
|
|
- `handover_*` - Handover-Dokumente
|
|
- `spec_*` - Spezifikationen
|
|
- `user_*` - User-Dokumentation
|
|
|
|
**Verzeichnisse:** `wiki/appdoc/`, `wiki/implementation/`, `wiki/training/`
|
|
|
|
**Details:** Siehe `handover_naming_convention.md`
|
|
|
|
---
|
|
|
|
## 7. Nächste Schritte & Fragen (3 Min)
|
|
|
|
### Action Items:
|
|
- [ ] (Siehe Einarbeitungsplan)
|
|
- [ ] Nächster Sync-Termin vereinbaren
|
|
|
|
### Offene Fragen:
|
|
- Zum Plan, Vorgehen, andere?
|
|
|
|
---
|
|
|
|
## Anhänge
|
|
|
|
- **Einarbeitungsplan**: `handover_einarbeitungsplan.md`
|
|
- **Naming Convention**: `handover_naming_convention.md`
|
|
- **Architektur**: `../appdoc/doc_architecture_gateway.drawio`
|
|
|