# 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`