Ablaufplan für den Livegang

TODO.md sagt, was offen ist. Hier steht die Reihenfolge, in der es beim
Umschalten abzuarbeiten ist — samt der Punkte, die ein Datenabzug
mitbringt und die danach von Hand weg müssen: Testbestellungen,
Testkonten, Rechnungsnummern.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
torbinus
2026-10-12 14:46:29 +02:00
parent ed7838af68
commit 8a31bb7473
+117
View File
@@ -0,0 +1,117 @@
# Livegang — Ablaufplan
Stand: 12. Oktober 2026. Was offen ist, steht in `TODO.md`; hier steht die
**Reihenfolge**, in der es beim Umschalten abzuarbeiten ist.
Zwei Dinge wandern auf getrennten Wegen in die Produktion:
| | Weg | Stand |
| --- | --- | --- |
| **Code** | `./deploy.sh` baut Images, Portainer zieht sie | erprobt |
| **Daten** | `./uebergabe.sh` einmalig in die leere Umgebung | erprobt |
Danach gilt: **Die Produktion ist die Wahrheit.** Produkte werden dort im
Admin gepflegt. `uebergabe.sh` zeigt nie wieder auf sie — es bricht
ohnehin ab, sobald dort Bestellungen liegen.
---
## 0. Was vorher entschieden sein muss
- [ ] **Wo läuft die Produktion?** Der Orange Pi im Heimnetz taugt dafür
nicht: Bei Stromausfall oder Störung ist der Shop offline, und niemand
ist nachts da. Ein kleiner Server bei einem Anbieter mit Sicherungen
kostet im Monat ungefähr so viel wie zwei Gläser Honig. Diese
Entscheidung blockiert alles Weitere.
- [ ] **Wer betreibt ihn?** Also: Wer bekommt den Anruf, wenn samstags um
acht nichts mehr geht.
- [ ] **Was passiert mit shop.hhonig.de?** Abschalten, weiterleiten oder als
Archiv für die alten Rechnungen stehen lassen. Die Aufbewahrungspflicht
für Rechnungen beträgt zehn Jahre.
- [ ] **Was passiert mit den Kundenkonten des alten Shops?** Passwörter
lassen sich nicht übernehmen. Und: Verkäufer war die Imkerei Björn
Schumann, künftig ist es die PLACE4BEES GmbH — ein anderer
Verantwortlicher im Sinne der DSGVO. Vor dem Kopieren von Kundendaten
anwaltlich klären.
## 1. Umgebung aufsetzen
- [ ] Docker und Portainer auf dem Zielserver
- [ ] Ordner anlegen: `sudo mkdir -p /srv/place4bees/{postgres,redis,uploads}`
- [ ] Registry in Portainer hinterlegen (`git.place4bees.com`, Zugangstoken)
- [ ] Stack aus `compose.prod.yml` anlegen
- [ ] Reverse Proxy: `place4bees.com` auf das Frontend, die Pfade `/store`,
`/auth`, `/admin`, `/app`, `/static`, `/health` auf das Backend
- [ ] Zertifikat über Let's Encrypt
- [ ] **Port 5433 (Postgres) nicht nach außen weiterleiten**
## 2. Variablen setzen
```
IMAGE_TAG=<Commit-Nummer, nicht "latest">
DATA_DIR=/srv/place4bees
POSTGRES_PASSWORD=<neu erzeugen, nicht vom Testsystem übernehmen>
JWT_SECRET=<neu>
COOKIE_SECRET=<neu>
MEDUSA_BACKEND_URL=https://place4bees.com
PUBLISHABLE_KEY=<aus der Produktionsdatenbank, siehe Schritt 3>
STORE_CORS=https://place4bees.com
ADMIN_CORS=https://place4bees.com
AUTH_CORS=https://place4bees.com
GA_ID=<Messkennung, erst nach Einwilligungsbanner-Prüfung>
```
**DHL umstellen** — beide Schalter, in dieser Reihenfolge:
1. `DHL_SANDBOX=false`, `DHL_VALIDATE_ONLY=true` → eine echte Adresse prüfen
2. Erst wenn die sauber durchläuft: `DHL_VALIDATE_ONLY=false`
Dazu gehören die **echte Abrechnungsnummer** statt der Testnummer
`33333333330102` und die Freigabe der App bei DHL für die Produktion.
## 3. Daten übertragen
Einmalig, solange die Zielumgebung leer ist:
```
./uebergabe.sh --von "<Testsystem>" --nach "<Produktion>" --schreiben
```
Danach von Hand nacharbeiten, weil der Abzug alles mitbringt:
- [ ] **Testbestellungen löschen** (Nummern 1 bis ~33 sind Tests)
- [ ] **Testkundenkonten löschen** (`testkunde+…@example.com`,
`screenshot+…`, `aside+…`)
- [ ] **Rechnungsnummern zurücksetzen**, sonst beginnt die erste echte
Rechnung bei RE-34
- [ ] **Admin-Konten prüfen**: Wer soll Zugang haben, wer nicht mehr
- [ ] **Publishable Key** der Produktion ins Stack eintragen
## 4. Vor dem Umschalten der Domain
- [ ] Testbestellung über jede Zahlart, mit echtem Geld und Rückerstattung
- [ ] Ein echtes DHL-Label erzeugen und wieder stornieren
- [ ] Bestell-, Versand- und Kündigungsbestätigung kommen an
- [ ] Rechnungs-PDF stimmt: Steuersätze, Adresse, Nummernkreis
- [ ] Impressum, AGB, Widerruf und Datenschutz gegengelesen — die
Datenschutzerklärung hat zwei markierte Lücken (Google Analytics)
- [ ] Alle Produkte haben Bild, Preis und **Versandgewicht**
- [ ] Entwürfe durchgehen: Nichts Halbfertiges veröffentlichen
- [ ] Sitemap in der Search Console einreichen
- [ ] Produktdatenfeed im Merchant Center hinterlegen
## 5. Umschalten
- [ ] DNS von WordPress auf den neuen Server
- [ ] WordPress-Seite als Archiv sichern, bevor sie verschwindet
- [ ] Den Hinweisblock „Shop-Umzug" aus der alten Seite entfernen
- [ ] Erste echte Bestellung begleiten und von Hand nachprüfen
## 6. Danach
- [ ] Sicherung einrichten: Datenbank **und** der Ordner `uploads`.
Ohne Sicherung ist alles darüber wertlos.
- [ ] Eine Sicherung einmal zurückspielen — eine ungetestete Sicherung ist
keine.
- [ ] Festlegen, wer Produkte pflegt und wo (Antwort: im Admin der
Produktion)