update

AzA march 2026 - Kopie (18)/deploy/WORDPRESS_GOLIVE.md

@@ -0,0 +1,263 @@
+# AZA Verkaufsstart — WordPress/Hostpoint Go-Live
+
+Stand: 30. Maerz 2026 (aktualisiert)
+
+> **HINWEIS:** Verbindliche Kaufpfad-Referenz ist `deploy/SELL_READY_KAUFPFAD.md`.
+> Dieses Dokument enthaelt die WordPress-Admin-Schritte und bleibt als Nachschlagewerk erhalten.
+
+---
+
+## Architektur-Entscheidung (FEST)
+
+| Zweck | Plattform | Wann |
+|---|---|---|
+| Website, Verkauf, Checkout, Download | **Hostpoint / WordPress** | **JETZT** |
+| Browser-AZA, KI-Backend, eigener Stripe-Flow | Hetzner | SPÄTER |
+
+Eigener Stripe-Code (`stripe_routes.py`, `license_server.py`) bleibt unangetastet.
+Keine DNS-/Domain-Änderungen. Kein Hetzner-Deploy für den Verkaufsstart.
+
+---
+
+## Live-Befund (aktualisiert 2026-03-30)
+
+### Was bereits laeuft
+- ✅ WordPress auf Hostpoint, HTTPS aktiv
+- ✅ Kadence Theme aktiv
+- ✅ WooCommerce aktiv
+- ✅ `/shop/` Seite existiert (HTTP 200)
+- ✅ Stripe Live-Konto mit 4 Preisen eingerichtet
+- ✅ Stripe Payment Links erstellt
+- ✅ Stripe Webhook auf api.aza-medwork.ch funktional
+- ✅ Lizenz-Backend auf Hetzner live
+- ✅ Admin Control Panel v2 live
+
+### Was noch fehlt / manuell in WordPress zu tun
+- ⬜ **Waehrung auf CHF aendern** (falls noch auf USD)
+- ⬜ **Land auf Schweiz setzen** (falls noch auf US)
+- ⬜ **9 Demo-Produkte loeschen** (Berge-Thema)
+- ⬜ **Produktseite anlegen** mit AZA Office Info + Payment-Link-Buttons
+- ⬜ **Danke-Seite anlegen** mit Download-Link
+
+### NICHT noetig
+- ~~WooCommerce Stripe Gateway Plugin~~ → Stripe Payment Links umgehen WooCommerce-Checkout
+- ~~WooCommerce Subscriptions Plugin~~ → Stripe Billing handhabt Subscriptions direkt
+- ~~Checkout-Seite~~ → Stripe Hosted Checkout statt WooCommerce-Checkout
+- ~~Mein-Konto-Seite~~ → Stripe Billing Portal fuer Abo-Verwaltung
+
+---
+
+## Benoetigte Plugins
+
+Seit dem Architektur-Entscheid (Stripe Payment Links direkt, kein WooCommerce-Checkout)
+werden **keine zusaetzlichen Plugins** fuer den Kaufpfad benoetigt.
+
+| Plugin | Status | Anmerkung |
+|---|---|---|
+| ~~Flexible Subscriptions for WooCommerce~~ | NICHT noetig | Stripe Billing handhabt Subscriptions |
+| ~~WooCommerce Stripe Gateway~~ | NICHT noetig | Payment Links umgehen WooCommerce-Checkout |
+| Code Snippets (optional) | Optional | Nur fuer deutsche Button-Texte, falls WooCommerce-Buttons angezeigt werden |
+
+---
+
+## WooCommerce-Konfiguration (exakt)
+
+### Schritt 1: Grundeinstellungen korrigieren
+
+**WooCommerce → Einstellungen → Allgemein:**
+- Land / Adresse: **Schweiz**
+- Währung: **Schweizer Franken (CHF)**
+- Währungsposition: Links
+- Tausendertrennzeichen: `'`
+- Dezimaltrennzeichen: `.`
+
+### Schritt 2: WooCommerce-Seiten anlegen
+
+**WooCommerce → Einstellungen → Erweitert → Seiteneinrichtung:**
+
+WooCommerce erstellt diese Seiten normalerweise automatisch bei der Ersteinrichtung.
+Falls sie fehlen (wie jetzt), manuell anlegen:
+
+1. **Seiten → Neu hinzufügen**: Titel „Checkout", Inhalt leer lassen → Veröffentlichen
+2. **Seiten → Neu hinzufügen**: Titel „Mein Konto", Inhalt leer lassen → Veröffentlichen
+3. In **WooCommerce → Einstellungen → Erweitert → Seiteneinrichtung**:
+   - Checkout-Seite → „Checkout" wählen
+   - Mein-Konto-Seite → „Mein Konto" wählen
+
+### Schritt 3: ENTFAELLT (Stripe Gateway nicht noetig)
+
+Stripe Payment Links umgehen den WooCommerce-Checkout.
+Kein WooCommerce Stripe Gateway Plugin noetig.
+Stripe-Konfiguration laeuft direkt ueber Stripe Dashboard + Hetzner-Backend.
+
+### Schritt 4: Demo-Produkte loeschen
+
+**WooCommerce → Produkte → Alle Produkte:**
+
+Diese 9 Demo-Produkte löschen (alle auswählen → Massenaktion → In Papierkorb):
+- Everest Series
+- Rockies Line
+- Kilimanjaro Set
+- Andes Collection
+- Alps Edition
+- Himalaya Range
+- Sierra Series
+- Fuji Line
+- Pyrenees Pack
+
+### Schritt 5: Produktseite anlegen
+
+**Seiten → Neu hinzufuegen** (NICHT WooCommerce-Produkt, sondern normale WordPress-Seite):
+
+| Feld | Wert |
+|---|---|
+| Seitentitel | **AZA Office – Medizinische KI fuer Ihre Praxis** |
+| Slug | `aza-office` |
+
+Inhalt der Seite: Produktbeschreibung + Pricing-Tabelle + Stripe Payment Link Buttons.
+
+**Kurzbeschreibung** (in die Seite kopieren):
+```
+AZA Office ist der intelligente KI-Arbeitsplatz fuer Schweizer Aerzte.
+
+Diktieren Sie Krankengeschichten, stellen Sie medizinische Fragen an die KI,
+uebersetzen Sie Fachtexte und organisieren Sie Ihren Praxisalltag –
+alles in einer sicheren Desktop-Anwendung.
+
+✓ Sofortiger Download nach Abschluss
+✓ Alle Updates inklusive
+✓ Kein eigener OpenAI-Key noetig – KI laeuft ueber unser Backend
+✓ Monatlich kuendbar oder 17 % sparen mit Jahreslizenz
+✓ Fuer Windows 10/11
+```
+
+**Pricing-Bereich** (als Tabelle oder Kadence-Blocks):
+```
+Basic (1 Benutzer): CHF 59/Monat oder CHF 590/Jahr
+Team (2 Benutzer):  CHF 89/Monat oder CHF 890/Jahr
+
+[Jetzt abonnieren] → Stripe Payment Link URL
+```
+
+**Ausfuehrliche Beschreibung** (in die Seite kopieren):
+```
+Ihr KI-Arbeitsplatz fuer den Praxisalltag
+
+AZA Office wurde von Aerzten fuer Aerzte entwickelt.
+
+6 Module:
+• KI-Assistent – Medizinische Fragen stellen, Befunde besprechen
+• Krankengeschichte – Diktat aufnehmen, transkribieren, KG erstellen
+• Audio-Notizen – Sprachnotizen fuer den Praxisalltag
+• Uebersetzer – Medizinische Texte uebersetzen
+• Projekt-Notizen – Tabs, Bilder, Diktat, Auto-Save
+• Aerzte-Netzwerk – Kollegialer Austausch (Vorschau)
+
+Was Sie erhalten:
+• Sofortiger Download nach Zahlung (ca. 40 MB)
+• Professioneller Windows-Installer
+• Gefuehrte Einrichtung in unter 5 Minuten
+• Alle Updates inklusive
+• Kein eigener API-Key noetig
+
+Systemvoraussetzungen:
+• Windows 10 oder 11 (64-Bit)
+• Internetverbindung
+```
+
+### Schritt 6: E-Mail-Einstellungen
+
+**WooCommerce → Einstellungen → E-Mails:**
+- Absendername: **AZA MedWork**
+- Absender-E-Mail: **info@aza-medwork.ch**
+- „Bestellung abgeschlossen" → aktiviert (enthält Download-Link automatisch)
+
+### Schritt 7: ENTFAELLT (deutsche Button-Texte nicht noetig)
+
+Da der Kaufpfad ueber Stripe Payment Link Buttons laeuft (die als normale WordPress-Buttons
+auf der Produktseite eingebunden werden), gibt es keine WooCommerce-Subscription-Buttons
+die uebersetzt werden muessen. Die Button-Texte werden direkt im Seiteneditor gesetzt.
+
+### Schritt 8: Danke-Seite anlegen
+
+Seiten → Neu hinzufuegen:
+- Titel: **Vielen Dank fuer Ihren Kauf**
+- Slug: `danke`
+- Inhalt:
+  ```
+  Ihr AZA Office Download ist bereit.
+
+  [AZA Office herunterladen](https://api.aza-medwork.ch/download/aza_desktop_setup.exe)
+
+  Installationsanleitung:
+  1. Datei herunterladen und ausfuehren
+  2. Installation abschliessen (ca. 2 Minuten)
+  3. App starten und Fachgebiet waehlen
+  4. Fertig – alle KI-Funktionen sind sofort verfuegbar
+
+  Abo verwalten: In der App unter "Abonnement".
+  Fragen? info@aza-medwork.ch
+  ```
+- Veroeffentlichen
+
+### Schritt 9: Stripe Payment Links → Danke-Seite
+
+In Stripe Dashboard → Payment Links → jeweils bearbeiten:
+- After completion: Redirect
+- URL: `https://aza-medwork.ch/danke/`
+
+### Schritt 10: Testkauf und Live
+
+1. Produktseite im Frontend aufrufen
+2. Payment-Link-Button klicken → Stripe Checkout
+3. Mit eigener Kreditkarte kaufen (Live-Modus, danach sofort stornieren)
+4. Pruefen:
+   - ✅ Danke-Seite zeigt Download-Link
+   - ✅ Stripe-Receipt kommt per E-Mail
+   - ✅ Subscription im Stripe Dashboard sichtbar
+   - ✅ Lizenz in Admin-Panel sichtbar (`GET /admin/license_customer_map`)
+   - ✅ App laeuft im Vollmodus
+5. Produktseite auf Startseite verlinken
+
+---
+
+## Checkout-Flow (wie der Kunde es erlebt)
+
+```
+aza-medwork.ch/aza-office/
+     │
+     ▼
+Produktseite: AZA Office
+(Basic CHF 59/Monat oder CHF 590/Jahr | Team CHF 89/Monat oder CHF 890/Jahr)
+     │
+     ▼
+[Jetzt abonnieren] → Stripe Payment Link
+     │
+     ▼
+Stripe Checkout (gehostet von Stripe)
+(E-Mail, Kreditkarte)
+     │
+     ▼
+Webhook an api.aza-medwork.ch → Lizenz in DB
+     │
+     ▼
+Redirect zu aza-medwork.ch/danke/
+(Download-Link: aza_desktop_setup.exe)
+     │
+     ▼
+Stripe Billing Portal
+(Abo verwalten, kuendigen, Rechnungen)
+```
+
+---
+
+## Späterer Hetzner-Pfad (NICHT JETZT)
+
+| Datei | Zweck | Wann |
+|---|---|---|
+| `stripe_routes.py` | Eigener Checkout/Webhook | Browser-AZA |
+| `license_server.py` | Plan-Mapping, Lizenz-DB | Browser-AZA |
+| `web/index.html` | Eigene Landing-Page | Browser-AZA |
+| `deploy/.env` | Stripe-Secrets für Hetzner | Browser-AZA |
+
+Alles bleibt im Repo, wird nicht angefasst, kommt erst mit Browser-AZA auf `app.aza-medwork.ch`.