# Vendoo 1.41.0 – GitHub Push, Pull Request, Merge und Release

## Grundregel

Der Produktionsbranch ist `main`. Direkt auf `main` wird nicht entwickelt. Jeder neue Vendoo-Stand wird zuerst auf einen Release- oder Hotfix-Branch übertragen, durch GitHub Actions geprüft und anschließend per Pull Request gemergt.

## Teil A – vollständigen Quellstand hochladen

Auf dem Windows-Rechner nach erfolgreichem lokalen Start von 1.41.0:

1. `W:\ChatGPT\Vendoo\GitHub-Deploy-Assistent.bat` starten.
2. Der Assistent bereitet ein sauberes Git-Staging vor.
3. Den vollständigen Sicherheitsbericht lesen.
4. Prüfen, dass keine dieser Dateien im Git-Status erscheint:
   - `.env`
   - Datenbanken
   - Uploads
   - Backups
   - Logs
   - `master.key`
   - `secrets.enc.json`
   - `modules/`
   - `updates/`
5. Prüfen, dass der Zielbranch lautet:

```text
release/1.41.0-coolify-production
```

6. Erst danach exakt eingeben:

```text
PUSH
```

7. Den Assistenten vollständig abschließen lassen.

## Teil B – Pull Request #16 prüfen

1. GitHub öffnen.
2. Repository `Masterluke77/vendoo` öffnen.
3. `Pull requests` öffnen.
4. PR `Vendoo 1.41.0 – Coolify Production Deployment & Controlled Web Updates` öffnen.
5. Prüfen:

```text
Base: main
Compare: release/1.41.0-coolify-production
```

6. Unter `Files changed` kontrollieren, dass der vollständige Quellstand enthalten ist.
7. Besonders prüfen:
   - `Dockerfile`
   - `deploy/coolify.env.example`
   - `.github/workflows/ci.yml`
   - `.github/workflows/release.yml`
   - `app/modules/deployments/`
   - `app/kernel/platform-kernel.mjs`
   - `public/index.html`
   - `public/app.js`
   - `docs/COOLIFY_PRODUCTION_1_41_0.md`
8. Unter `Checks` beziehungsweise unten im PR warten, bis alle GitHub-Actions-Prüfungen grün sind.
9. Bei einem roten Check nicht mergen. Den fehlgeschlagenen Job öffnen und den vollständigen Fehler korrigieren.

## Teil C – Draft beenden

Der vorbereitete PR ist zunächst ein Draft.

1. Im PR `Ready for review` anklicken.
2. Erneut prüfen, dass alle Checks grün sind.
3. Keine offenen Review-Kommentare stehen lassen.

## Teil D – Merge

Empfohlen:

```text
Squash and merge
```

Vorgehen:

1. Pfeil neben dem Merge-Button öffnen.
2. `Squash and merge` auswählen.
3. Commit-Titel verwenden:

```text
Vendoo 1.41.0 – Coolify Production Deployment & Controlled Web Updates
```

4. Merge bestätigen.
5. Prüfen, dass der PR den Status `Merged` hat.
6. Den Release-Branch anschließend über `Delete branch` löschen.

Nicht den lokalen Vendoo-Ordner löschen. Nur der GitHub-Release-Branch darf nach dem Merge entfernt werden.

## Teil E – main prüfen

1. Repository-Startseite öffnen.
2. Branch `main` auswählen.
3. Prüfen, dass `package.json` Version `1.41.0` enthält.
4. `Actions` öffnen.
5. Den letzten Workflow auf `main` prüfen.
6. Erst fortfahren, wenn `Vendoo CI` erfolgreich ist.

## Teil F – GitHub Release veröffentlichen

1. Rechts im Repository `Releases` öffnen.
2. `Draft a new release` anklicken.
3. `Choose a tag` wählen.
4. Neuen Tag erstellen:

```text
v1.41.0
```

5. Target Branch `main` wählen.
6. Release title:

```text
Vendoo 1.41.0 – Coolify Production Deployment & Controlled Web Updates
```

7. Release Notes aus `CHANGELOG.md` übernehmen.
8. `Set as the latest release` aktivieren.
9. Nicht als Pre-Release markieren.
10. `Publish release` anklicken.

Danach startet der Workflow `Vendoo Release`.

## Teil G – Release-Workflow kontrollieren

Unter `Actions → Vendoo Release` müssen beide Jobs erfolgreich sein:

1. `Release-Paket und Prüfsummen`
2. `GHCR-Container veröffentlichen`

Der Workflow erzeugt:

- Release-ZIP
- SHA-256-Datei
- `ghcr.io/masterluke77/vendoo:1.41.0`
- `ghcr.io/masterluke77/vendoo:1.41`
- `ghcr.io/masterluke77/vendoo:stable`
- `ghcr.io/masterluke77/vendoo:latest`
- SBOM und Provenienz/Attestation

## Teil H – erstes Coolify-Deployment

Für die erste Installation:

1. Coolify-Anwendung mit GitHub-Repository und Branch `main` verbinden.
2. Auto Deploy zunächst deaktivieren.
3. `Deploy` manuell anklicken.
4. Build-Logs und Healthcheck prüfen.
5. `https://vendoo.flatlined.de/readyz` öffnen.
6. Ersteinrichtung durchführen.
7. Coolify-Webhook im Vendoo Update Center speichern.

## Teil I – zukünftiger Updateablauf

Für spätere Releases immer in dieser Reihenfolge:

1. neue Version lokal entwickeln und testen
2. Release-Branch pushen
3. Pull Request öffnen
4. GitHub Actions grün
5. PR nach `main` mergen
6. GitHub Release veröffentlichen
7. laufendes Vendoo öffnen
8. Update Center öffnen
9. Coolify-Deployment mit `DEPLOY` bestätigen
10. `/readyz` und Anwendung prüfen

Mit deaktiviertem Coolify Auto Deploy bleibt der Produktionsstand aktiv, bis der Administrator den Deployment-Auftrag bewusst aus Vendoo oder Coolify auslöst.
