From 8a31bb74733b41d2a8a3c298ea6fb46868f241c4 Mon Sep 17 00:00:00 2001 From: torbinus Date: Mon, 12 Oct 2026 14:46:29 +0200 Subject: [PATCH] =?UTF-8?q?Ablaufplan=20f=C3=BCr=20den=20Livegang?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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) --- LIVEGANG.md | 117 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 117 insertions(+) create mode 100644 LIVEGANG.md diff --git a/LIVEGANG.md b/LIVEGANG.md new file mode 100644 index 0000000..a338b44 --- /dev/null +++ b/LIVEGANG.md @@ -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= +DATA_DIR=/srv/place4bees +POSTGRES_PASSWORD= +JWT_SECRET= +COOKIE_SECRET= +MEDUSA_BACKEND_URL=https://place4bees.com +PUBLISHABLE_KEY= +STORE_CORS=https://place4bees.com +ADMIN_CORS=https://place4bees.com +AUTH_CORS=https://place4bees.com +GA_ID= +``` + +**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 "" --nach "" --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)