2026-07-10 17:54:37 +00:00
1 changed files with 82 additions and 0 deletions
@@ -0,0 +1,82 @@
+# Abnahmebericht – Vendoo Production Updater 3.4
+
+**Status:** in technischer Abnahme  
+**Branch:** `feature/updater-3.4-lifecycle`  
+**Pull Request:** `#28`  
+**Zielversion:** Vendoo `1.43.0`  
+**Updater-Version:** `3.4.0`
+
+## Verbindliche Ausgangslage
+
+- `main` basiert auf dem gültigen Release aus PR #26.
+- PR #27 ist geschlossen, nicht gemergt und kein zulässiger Quellstand.
+- Der alte Worker 3.3 ist aus dem aktiven Release-Payload entfernt.
+- Persistente Produktionsdaten unter `/app/data` sind nicht Bestandteil des Payloads.
+- PR #28 bleibt bis zum vollständigen Linux-/Windows-Nachweis ein Draft.
+
+## Ist-/Lückenanalyse Updater 3.3
+
+| Bereich | Reale 3.3-Lücke | Umsetzung 3.4 | Nachweis |
+|---|---|---|---|
+| Check-Registrierung | `gh pr checks --watch` konnte bei noch nicht registrierten Checks sofort mit `no checks reported` abbrechen | eigener Check-Classifier mit 90 Sekunden Grace Period | Regressionstest und GitHub-CI ausstehend |
+| Manifest-Sync | Head-SHA konnte sich nach Start der Checkphase ändern | aktuelle `headRefOid` wird in jeder Runde gelesen; Wechsel startet Grace Period und Auswertung neu | Regressionstest und Integrationstest ausstehend |
+| Wiederholung nach Merge | 3.3 suchte nur offene PRs und konnte nach einem Merge erneut Sourcearbeit beginnen | gemergter passender PR führt direkt in Deployment/Verifikation | Regressionstest vorhanden, CI ausstehend |
+| `main` bereits Zielversion | 3.3 erzeugte weiterhin Arbeitskopie und Releasebranch | Sourcephase wird vollständig übersprungen | Regressionstest vorhanden, CI ausstehend |
+| Produktion bereits Zielversion | kein sofortiger erfolgreicher Zielzustand | sofortiger Erfolg ohne Branch, PR oder Deployment | Regressionstest vorhanden, reale Produktionsprobe ausstehend |
+| veralteter Payload | Overlay plus Force-Push konnte neuere `main`-Änderungen zurücksetzen | Provenienz v2, Base-Ancestor-Prüfung und Pfadkonflikt-Guard vor dem Overlay | realer temporärer Git-Regressionstest vorhanden, CI ausstehend |
+| Branch/PR-Idempotenz | Branch wurde stets neu erzeugt und unbedingt mit `--force` gepusht | deterministischer Branch, PR-Reconciliation und `--force-with-lease` | statischer Vertrag vorhanden, Windows-Lauf ausstehend |
+| Check-Lifecycle | keine konkrete Workflow-Run-Auswertung am finalen Head | Rollup plus Actions-Runs nach `head_sha`, neuester Run entscheidet | Regressionstests vorhanden, GitHub-Lauf ausstehend |
+| Merge-Sicherheit | kein atomarer Nachweis, dass der gemergte Head geprüft wurde | `--match-head-commit` mit unmittelbar zuvor bestätigtem finalen SHA | statischer Vertrag vorhanden, Integration ausstehend |
+
+## Zustandsautomat
+
+Der verbindliche Automat ist in `docs/PRODUCTION_UPDATER_3_4.md` dokumentiert. Die terminalen Zustände sind:
+
+- `COMPLETED`: GitHub- und Produktionsziel nachgewiesen,
+- `FAILED`: terminaler Pflichtcheck, Payloadkonflikt, Timeout oder technischer Fehler,
+- `CANCELLED`: expliziter Benutzerabbruch mit erhaltenem Sitzungsstand.
+
+Ein fehlender oder noch laufender Check ist kein terminaler Fehler.
+
+## Regressionstest-Matrix
+
+| Szenario | Erwartung | Automatisierter Test | Linux | Windows |
+|---|---|---:|---:|---:|
+| verspätet registrierte Checks | innerhalb Grace Period weiter warten | vorhanden | ausstehend | ausstehend |
+| `queued` / `pending` / `in_progress` | nicht fehlschlagen | vorhanden | ausstehend | ausstehend |
+| Manifest-Sync erzeugt neuen Head | alten Head verwerfen, neuen Head vollständig prüfen | Worker-/Lifecycle-Vertrag vorhanden | ausstehend | ausstehend |
+| bereits gemergter PR | keinen zweiten PR erzeugen | vorhanden | ausstehend | ausstehend |
+| bereits deployte Zielversion | sofort erfolgreich ohne Änderungen | vorhanden | ausstehend | ausstehend |
+| doppelter Start | vorhandenen Zustand übernehmen | Entscheidungs- und Sessionvertrag vorhanden | ausstehend | ausstehend |
+| parallele Workflow-Runs | zeitlich neuesten Run bewerten | vorhanden | ausstehend | ausstehend |
+| veralteter Payload gegen neueren `main` | vor Overlay blockieren | realer temporärer Git-Test vorhanden | ausstehend | ausstehend |
+| blockierter Rückschritt | Konfliktpfade ausgeben, keine Sourceänderung | vorhanden | ausstehend | ausstehend |
+| älterer Erfolg, neuerer Fehler | neuer Fehler ist terminal | vorhanden | ausstehend | ausstehend |
+| älterer Fehler, neuer Lauf | neuer Lauf bleibt pending | vorhanden | ausstehend | ausstehend |
+| älterer Abbruch, neuer Erfolg | neuer Erfolg gilt | vorhanden | ausstehend | ausstehend |
+
+## Releasevertrag
+
+Vor einer Freigabe müssen nachweislich erfolgreich sein:
+
+1. Syntax- und Sicherheitsgates unter Linux,
+2. vollständiges `npm run verify:all` unter Windows,
+3. PowerShell-Parserprüfung von UI, Host und Worker34,
+4. Manifest-Reproduzierbarkeit,
+5. Release-Staging mit `vendoo-release-package-v2`,
+6. SHA-256-Prüfung aller Paketdateien,
+7. Nachweis, dass der alte Worker 3.3 nicht ausgeliefert wird,
+8. keine Änderung an Datenbank- oder `/app/data`-Inhalten,
+9. Review des finalen PR-Head-SHA.
+
+## Noch offene Abnahmepunkte
+
+- GitHub-CI für den finalen PR-Head muss vollständig grün sein.
+- Der Windows-Vertrag muss den echten PowerShell-Parser und alle bestehenden Tests erfolgreich durchlaufen.
+- Das auslieferbare Paket darf erst danach erzeugt und als Workflow-Artefakt übernommen werden.
+- Die öffentliche Produktionsantwort konnte in dieser Arbeitsumgebung noch nicht unabhängig verifiziert werden; sie ist daher kein bereits erbrachter Nachweis.
+
+## Freigabeentscheidung
+
+**Noch nicht freigegeben.**  
+Es existiert noch kein als produktionsreif deklarierter Download. Der Bericht wird erst nach finaler CI-, Paket- und Produktionsabnahme auf „bestanden“ gesetzt.