wiki/training/handover_agenda_sync.md

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