13 KiB
AZA Office – Sell-Ready Kaufpfad (konsolidiert)
Stand: 2026-03-30
Dieses Dokument ist die fuehrende Referenz fuer den produktiven Kauf-/Auslieferungspfad. Es ersetzt und konsolidiert die aelteren Einzel-Dokumente (WORDPRESS_GOLIVE.md, WOOCOMMERCE_PRODUCT.md, STRIPE_LIVE_SETUP.md, GO_LIVE_CHECKLIST_SHORT.md) in einen konsistenten Stand.
Architektur-Entscheidung (FEST)
| Zweck | Plattform | Domain |
|---|---|---|
| Website, Produktseite, Marketing | Hostpoint / WordPress | aza-medwork.ch |
| Stripe Checkout + Lizenz-Backend | Hetzner / Docker | api.aza-medwork.ch |
WordPress/WooCommerce zeigt das Produkt. Der Kauf laeuft ueber Stripe Payment Links direkt. Das Hetzner-Backend empfaengt den Webhook und erstellt die Lizenz. Kein WooCommerce-Subscriptions-Plugin noetig.
A. PRODUKTKLARHEIT
Verbindlicher Produktname
| Feld | Wert |
|---|---|
| Produktname | AZA Office |
| Langform | AZA Office – Ihr medizinischer KI-Arbeitsplatz fuer die Praxis |
| Version | 1.0.0 |
| Typ | Download-Produkt (Windows-Installer .exe, ca. 40 MB) |
| Plattform | Windows 10/11 (64-Bit) |
Verbindliche Preise
| Plan | Monatlich | Jaehrlich (17 % guenstiger) |
|---|---|---|
| Basic (1 Benutzer, 2 Geraete) | CHF 59 / Monat | CHF 590 / Jahr |
| Team (2 Benutzer, 2 Geraete/Benutzer) | CHF 89 / Monat | CHF 890 / Jahr |
- Kein Einmalkauf
- Subscription mit automatischer Verlaengerung
- Kuendigung jederzeit moeglich (Zugang bis Ende der bezahlten Periode)
- Alle Updates inklusive solange Subscription aktiv
Stripe Lookup-Keys und Price-IDs (LIVE)
| Lookup-Key | Price-ID | Betrag |
|---|---|---|
aza_basic_monthly |
price_1T53xHL5lREAW68VbuK43lmz |
CHF 59/Monat |
aza_basic_yearly |
price_1T542BL5lREAW68VNLQGCKWZ |
CHF 590/Jahr |
aza_team_monthly |
price_1T544tL5lREAW68VkmnmZ21Q |
CHF 89/Monat |
aza_team_yearly |
price_1T545RL5lREAW68VLbIh73AN |
CHF 890/Jahr |
WICHTIG: Kein OpenAI-Key fuer Kunden
Seit Variante B (2026-03-25) liegt der OpenAI-Key ausschliesslich serverseitig. Der Kunde braucht KEINEN eigenen OpenAI-Key. Alle KI-Funktionen laufen ueber das AZA-Backend auf Hetzner. In keinem Produkttext, keiner E-Mail und keiner Anleitung darf ein OpenAI-Key als Kundenanforderung erwaehnt werden.
Enthaltene Module
- KI-Assistent – Medizinische Fragen stellen, Befunde besprechen
- Krankengeschichte – Diktat aufnehmen, transkribieren, KG erstellen
- Audio-Notizen – Sprachnotizen fuer den Praxisalltag
- Uebersetzer – Medizinische Fachtexte uebersetzen
- Projekt-Notizen – Tabs, Bilder, Diktat, Auto-Save
- Aerzte-Netzwerk – Kollegialer Austausch (Vorschau)
Systemvoraussetzungen (fuer Produktseite)
- Windows 10 oder 11 (64-Bit)
- Mindestens 4 GB RAM
- Internetverbindung
- Ca. 150 MB Festplattenplatz
B. CHECKOUT-/KAUFPFAD
Soll-Ablauf aus Kundensicht
aza-medwork.ch (WordPress-Produktseite)
│
▼
Kunde waehlt Plan (Basic/Team, Monatlich/Jaehrlich)
│
▼
Klick auf "Jetzt abonnieren"
│
▼
Stripe Checkout (gehostet von Stripe)
- E-Mail-Adresse eingeben
- Kreditkarte eingeben
- Bezahlen
│
▼
Stripe verarbeitet Zahlung
│ │
▼ ▼
Webhook an Hetzner Redirect zu Success-Seite
(api.aza-medwork.ch (Download-Link + Anleitung)
/stripe/webhook)
│
▼
Lizenz in DB angelegt
(status=active)
Checkout-Methode: Stripe Payment Links
Stripe Payment Links sind bereits angelegt. Fuer die WordPress-Produktseite werden die Payment-Link-URLs als Buttons eingebunden. Kein WooCommerce-Checkout noetig.
Alternativ koennen die Payment Links auch ueber stripe_routes.py (POST /stripe/create_checkout_session)
erzeugt werden – das ist der Pfad den die Hetzner-Landing-Page (web/index.html) nutzt.
Success-URL nach Zahlung
| Variante | URL | Anmerkung |
|---|---|---|
| Hetzner-Success | https://api.aza-medwork.ch/billing/success?session_id={CHECKOUT_SESSION_ID} |
Existiert und funktioniert |
| WordPress-Danke | https://aza-medwork.ch/danke/ |
Einfache WordPress-Seite (manuell anlegen) |
Empfehlung: Stripe Payment Links koennen auf eine WordPress-Danke-Seite weiterleiten. Die Hetzner-Success-Seite bleibt als Fallback fuer den Hetzner-Landing-Page-Pfad.
Cancel-URL
Zurueck zur Produktseite: https://aza-medwork.ch/
Abo-Verwaltung / Kuendigung
Der Kunde verwaltet sein Abo ueber das Stripe Billing Portal.
Der Desktop hat einen Button "Abonnement verwalten", der /stripe/billing_portal_url aufruft
und zum Stripe-Portal weiterleitet. Dort kann der Kunde:
- Zahlungsmethode aendern
- Abo kuendigen
- Rechnungen einsehen
C. DOWNLOAD-/AUSLIEFERUNGSPFAD
Was der Kunde nach Kauf erhaelt
- Sofort nach Zahlung: Weiterleitung zur Success-/Danke-Seite mit Download-Link
- Per E-Mail: Stripe-Kaufbestaetigung (automatisch) + optionale manuelle E-Mail mit Download-Link
- Spaeter erneut: Download ueber Stripe Billing Portal oder direkt via URL
Download-URL
| Pfad | URL |
|---|---|
| Installer (Hetzner) | https://api.aza-medwork.ch/download/aza_desktop_setup.exe |
| Version-Info | https://api.aza-medwork.ch/release/version.json |
Der Installer wird ueber den Hetzner-Server ausgeliefert (Caddy Static Files). Alternativ kann die EXE auch als WooCommerce-Download-Produkt in WordPress hochgeladen werden.
Installer-Ablauf fuer den Kunden
aza_desktop_setup.exeherunterladen (ca. 40 MB)- Installer starten (ggf. SmartScreen-Warnung bestaetigen – bis Code-Signing aktiv)
- Installation in ca. 2 Minuten
- App startet, Fachgebiet waehlen, KI-Einwilligung bestaetigen
- App prueft Lizenzstatus automatisch gegen Backend
- Bei aktiver Subscription: Vollmodus. Bei keiner/gekuendigter: Testmodus
Mein-Konto / Kundenbereich
Fuer den produktiven Start gibt es keinen WordPress-Kundenbereich. Stattdessen:
| Funktion | Loesung |
|---|---|
| Abo verwalten / kuendigen | Stripe Billing Portal (aus Desktop-App erreichbar) |
| Rechnung / Beleg | Stripe sendet automatische Receipts |
| Erneuter Download | Direktlink per E-Mail oder Success-Seite-Lesezeichen |
| Lizenzstatus pruefen | Desktop-App zeigt Status, Admin-Panel zeigt Betreibersicht |
Spaeter kann ein WordPress-"Mein Konto"-Bereich ergaenzt werden, aber fuer den produktiven Start ist das NICHT noetig.
D. E-MAILS
Automatische E-Mails (Stripe)
Stripe sendet automatisch:
- Kaufbestaetigung / Receipt nach jeder erfolgreichen Zahlung
- Zahlungserinnerung bei fehlgeschlagener Zahlung
- Kuendigungsbestaetigung bei Abo-Ende
Diese E-Mails koennen im Stripe Dashboard unter Settings → Emails konfiguriert werden.
Empfohlene manuelle E-Mail nach Erstkauf
Wird vom Betreiber manuell oder spaeter automatisiert verschickt:
| Feld | Wert |
|---|---|
| Absender | info@aza-medwork.ch |
| Absendername | AZA MedWork |
| Betreff | Ihr AZA Office Download ist bereit |
Inhalt (Vorlage):
Guten Tag
Vielen Dank fuer Ihren Kauf von AZA Office.
Ihr Download:
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" koennen Sie Ihr Abo jederzeit
verwalten oder kuendigen.
Bei Fragen: info@aza-medwork.ch
Freundliche Gruesse
AZA MedWork
Keine Marketing-E-Mails
Fuer den produktiven Start keine Newsletter oder Werbe-E-Mails. Nur transaktionale E-Mails (Kauf, Download, Kuendigung).
E. TESTKAUF-CHECKLISTE
Vor dem ersten Testkauf pruefen
- WordPress-Produktseite ist online und zeigt korrekte Preise
- Payment-Link-Buttons fuehren zu Stripe Checkout
- Stripe ist im Live-Modus (oder bewusst im Testmodus fuer Testkauf)
Testkauf-Ablauf (10 Schritte)
| # | Schritt | Erwartetes Ergebnis |
|---|---|---|
| 1 | Produktseite auf aza-medwork.ch oeffnen | Seite laedt, AZA Office mit korrekten Preisen sichtbar |
| 2 | "Jetzt abonnieren" (Basic Monatlich) klicken | Stripe Checkout oeffnet sich |
| 3 | E-Mail + Kreditkarte eingeben, bezahlen | Zahlung erfolgreich |
| 4 | Success-/Danke-Seite wird angezeigt | Download-Link sichtbar, Bestaetigung angezeigt |
| 5 | Stripe Dashboard pruefen | Neue Subscription sichtbar, Status: active |
| 6 | Admin-Panel pruefen: GET /admin/license_customer_map |
Neue Lizenz mit korrekter E-Mail und status=active |
| 7 | Download-Link klicken | aza_desktop_setup.exe wird heruntergeladen |
| 8 | Installer ausfuehren, App starten | App laeuft im Vollmodus (nicht Testmodus) |
| 9 | In Stripe: Subscription kuendigen | Webhook liefert 200 OK, Lizenz auf canceled |
| 10 | App neu starten | App faellt auf Testmodus zurueck |
Testkauf mit Stripe-Testkarte (optional vorab)
Stripe auf Testmodus stellen, dann mit Testkarte 4242 4242 4242 4242 (beliebiges Datum, CVC 123) testen.
Nach erfolgreichem Testkauf
- Stripe auf Live-Modus stellen (falls noch im Testmodus)
- Produktseite auf Startseite verlinken
- E-Mail-Vorlage bereithalten
F. ADMIN-SETUP-STAND – WordPress/WooCommerce
Was bereits erledigt ist
- WordPress auf Hostpoint laeuft mit HTTPS
- Kadence Theme aktiv
- WooCommerce Plugin aktiv
- Stripe Live-Konto eingerichtet mit 4 Preisen
- Stripe Payment Links erstellt
- Stripe Webhook auf api.aza-medwork.ch funktional (200 OK)
- Hetzner-Backend live mit Lizenz-DB
- Admin Control Panel v2 live
7 Admin-Schritte in WordPress (manuell auszufuehren)
Schritt 1: WooCommerce-Grundeinstellungen korrigieren
WooCommerce → Einstellungen → Allgemein:
- Land: Schweiz
- Waehrung: Schweizer Franken (CHF)
- Waehrungsposition: Links
- Tausendertrennzeichen:
' - Dezimaltrennzeichen:
.
Schritt 2: Demo-Produkte loeschen
WooCommerce → Produkte → Alle Produkte: 9 Demo-Produkte auswaehlen → Massenaktion → In Papierkorb: Everest Series, Rockies Line, Kilimanjaro Set, Andes Collection, Alps Edition, Himalaya Range, Sierra Series, Fuji Line, Pyrenees Pack
Schritt 3: Produktseite erstellen
Seiten → Neu hinzufuegen:
- Titel: AZA Office – Medizinische KI fuer Ihre Praxis
- Inhalt: Produktbeschreibung + Pricing-Tabelle + Payment-Link-Buttons (Texte aus Abschnitt A dieses Dokuments verwenden)
- Fuer jeden Plan einen Button mit der Stripe Payment Link URL
- Veroeffentlichen
Schritt 4: Danke-Seite erstellen
Seiten → Neu hinzufuegen:
- Titel: Vielen Dank fuer Ihren Kauf
- Inhalt:
Ihr 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". - Slug:
danke - Veroeffentlichen
Schritt 5: Stripe Payment Links aktualisieren
In Stripe Dashboard → Payment Links → jeweils After-Completion auf Redirect setzen:
- URL:
https://aza-medwork.ch/danke/
Schritt 6: Produktseite auf Startseite verlinken
Design → Menues (oder Kadence Header Builder):
- Neuen Menuepunkt hinzufuegen: "AZA Office kaufen" → Link zur Produktseite
- Oder: Button im Header mit Link zur Produktseite
Schritt 7: Rechtliches pruefen
Im Footer oder auf eigenen Seiten verlinken:
- Impressum (Pflicht in der Schweiz)
- Datenschutzerklaerung (Hinweis auf KI-Nutzung, Stripe-Zahlungsverarbeitung)
- AGB (Subscription-Hinweis, automatische Verlaengerung, Kuendigung, digitales Produkt)
Wichtige Dateien / Referenzen
Backend / Hetzner
| Datei | Zweck |
|---|---|
/root/aza-app/stripe_routes.py |
Webhook-Handler, Checkout-Session, Lizenz-DB |
/root/aza-app/admin_routes.py |
Admin Control Panel (8 Endpunkte) |
/root/aza-app/backend_main.py |
FastAPI-App, Success/Cancel-Seiten |
/root/aza-app/deploy/.env |
Stripe-Keys, Domain, Secrets |
/root/aza-app/data/stripe_webhook.sqlite |
Lizenz-Datenbank |
Stripe Dashboard
| Element | Status |
|---|---|
| Produkt: AzA Office | Angelegt mit 4 Preisen |
| Payment Links | Erstellt fuer alle 4 Preise |
| Webhook | https://api.aza-medwork.ch/stripe/webhook → 200 OK |
| Billing Portal | Aktiviert |
Installer / Desktop
| Datei | Zweck |
|---|---|
aza_desktop_setup.exe |
Windows-Installer (ca. 40 MB) |
release/version.json |
Versions-Info fuer Update-Check |
Nicht-Ziele dieses Blocks
- Kein WooCommerce-Subscriptions-Plugin (Stripe handhabt Billing direkt)
- Kein WooCommerce-Stripe-Gateway (Payment Links umgehen WooCommerce-Checkout)
- Kein WordPress-Kundenbereich "Mein Konto" (Stripe Billing Portal genuegt)
- Kein automatisiertes E-Mail-System (manuelle E-Mail-Vorlage genuegt fuer Start)
- Kein Code-Signing (kommt spaeter, SmartScreen-Warnung ist akzeptabel fuer Start)
- Keine Browser-AZA-Integration (separater Block)
Superseded Documents
Dieses Dokument konsolidiert und ersetzt fuer den Kaufpfad:
deploy/WORDPRESS_GOLIVE.md(Stand 14.03.2026, teilweise veraltet)deploy/WOOCOMMERCE_PRODUCT.md(AZA Desktop → AZA Office, OpenAI-Key entfernt)deploy/STRIPE_LIVE_SETUP.md(Stripe-Setup ist erledigt, hier zusammengefasst)deploy/GO_LIVE_CHECKLIST_SHORT.md(URLs korrigiert, Testkauf-Checkliste hier)billing/BILLING_FLOW.md(generischer Platzhalter, durch realen Flow ersetzt)