Dieser Task ist die Konkretisierung der SOLL-Konzeption und beinhaltet die detaillierte Ausarbeitung des zukünftigen Code-Review-Workflows auf der neu gewählten Zielplattform (Pull/Merge Request-Modell). Das Ziel ist ein verbindliches, vollständiges Dokument sowie eine leicht verständliche Visualisierung für alle Entwicklerteams.
Die Ergebnisse dieses Tasks bilden die Grundlage für die Entwicklerschulung und die technische Konfiguration der neuen Plattform.
Erforderliche Ergebnisse und Detaillierungspunkte
Die Ausarbeitung des Ziel-Workflows muss folgende Elemente umfassen:
1. Detaillierte Beschreibung aller einzelnen Schritte
Es muss eine Schritt-für-Schritt-Anleitung erstellt werden, die den gesamten End-to-End-Prozess beschreibt:
- Lokale Entwicklung: Vom Start des Features bis zum ersten Push.
- PR/MR-Erstellung: Genaue Anweisungen zur Erstellung des Requests in der Zielplattform (inkl. Benennungskonventionen und Vorlagen).
- Automatisierte Checks: Beschreibung der Prüfungen, die durch die CI/CD-Pipeline automatisch ausgelöst werden (Linting, Tests).
- Review-Schleife: Wie erfolgt die Zuweisung, wie die Kommentierung und die iterative Überarbeitung des Codes (Ablösung des arc diff-Prozesses).
- Merge-Prozess: Genaue Definition der Merge-Strategie (z.B. Squash Merge, Rebase) und der Merge-Gating-Regeln (wer darf mergen, wann).
- Abschluss: Wie werden Branches und verknüpfte Tasks im System bereinigt und abgeschlossen.
2. Grafische Übersicht (Diagramm)
- Erstellung einer einfachen, klaren grafischen Darstellung des Ablaufs (z.B. Sequenz- oder Flussdiagramm).
- Das Diagramm muss die Interaktion zwischen den Hauptkomponenten (Entwickler, Git-Plattform, CI/CD, Reviewer) visualisieren.
- Das Diagramm muss im finalen Dokument als Bild oder über die Mermaid-Syntax im Wiki/Ticket eingebunden werden.
3. Verantwortlichkeiten
- Zuweisung der Verantwortlichkeiten für jeden Workflow-Schritt (z.B. *Entwickler* vs. *Reviewer* vs. *Automatisierung*).
Nächste Schritte
- Zuständige Person/Team: Zuweisung der Ausarbeitung an das zuständige Team (z.B. DevOps/Entwicklungsprozesse).
- Abstimmung: Review des ausgearbeiteten Workflows durch das Kernteam der Migration.
- Freigabe: Offizielle Freigabe des Ziel-Workflows als *Standard Operating Procedure*.