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

# 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`.