# Vendoo 1.41.0 – Coolify Production Deployment & Controlled Web Updates

## Ziel

Vendoo 1.41.0 bereitet den reproduzierbaren Produktionsbetrieb unter `https://vendoo.flatlined.de` vor. GitHub ist die Quell- und Releasequelle, Coolify baut oder zieht den Container und Vendoo fordert spätere Deployments ausschließlich über eine kontrollierte, verschlüsselte Schnittstelle an.

## Architektur

```text
Release-Branch → Pull Request → GitHub Actions → main → GitHub Release/GHCR
                                                        │
                                                        ▼
                                               Coolify Deployment
                                                        │
                                                        ▼
                                          https://vendoo.flatlined.de
                                                        │
                                                        ▼
                                             Volume /app/data
```

## Neu

- geschütztes natives Modul `vendoo.deployments`
- 17 Module, 15 nativ und 2 Legacy Bridges
- 38 aufgelöste Capabilities
- Coolify Webhook- und API-Modus
- verschlüsselte Coolify-Zugangsdaten
- Vorab-Backup und Bestätigung `DEPLOY`
- Dockerfile-Produktion ohne eigenen Caddy-Container
- ein persistenter Datenbereich `/app/data`
- FLUX Studio beim ersten Start deaktiviert
- GHCR-Images mit Semver-, `stable`- und `latest`-Tags
- vollständige GitHub-, Merge-, Release- und Coolify-Anleitungen

## Unveränderlicher Container

Vendoo führt im Container kein `git pull`, kein `npm install`, kein `docker compose` und keine Docker-Socket-Kommandos aus. Ein Updateauftrag wird nach erfolgreichem Backup an Coolify delegiert. Coolify erzeugt einen neuen Container aus dem freigegebenen GitHub-Stand beziehungsweise dem veröffentlichten Image.

## Persistente Daten

Das Coolify-Volume `/app/data` enthält Datenbank, Uploads, Backups, Operations-Daten, Konfiguration, Secret Store, Master-Key, installierte Module, Modulzustand und Logs. Das Volume darf bei Updates nicht gelöscht oder neu angelegt werden.

## FLUX Studio

Beim ersten Produktionsstart gelten:

```env
VENDOO_INITIAL_DISABLED_MODULES=vendoo.flux-studio
LOCAL_IMAGE_ENABLED=false
```

Der Initialwert gilt nur, solange noch keine persistente Modulentscheidung existiert. Eine spätere Aktivierung im Modulmanager bleibt erhalten.

## Updateablauf

1. vollständigen Quellstand auf Release-Branch übertragen
2. GitHub Actions prüfen
3. Pull Request nach `main` mergen
4. GitHub Release veröffentlichen
5. optional GHCR-Image kontrollieren
6. im Vendoo Update Center Version prüfen
7. Coolify-Deployment mit `DEPLOY` bestätigen
8. Backup und Deploymentstatus kontrollieren
9. `/readyz`, Login und Kernfunktionen prüfen

## Ausführliche Dokumente

- `docs/GITHUB_MERGE_RELEASE_1_41_0.md`
- `docs/COOLIFY_PRODUCTION_1_41_0.md`
- `docs/WEB_UPDATE_CENTER_1_41_0.md`
- `docs/ABNAHMEBERICHT_1_41_0.md`
