gateway/docs/landing-billing-transparenz-poweron.md
Stephan Schellworth ea566c270f docs: add gateway docs and Cursor plan artifacts
Made-with: Cursor
2026-04-22 07:21:43 +02:00

9.1 KiB
Raw Permalink Blame History

PowerOn Kosten auf einen Blick (Landingpage)

Dieses Dokument fasst die tatsächlich im Gateway implementierte Abrechnungslogik in verständlicher Sprache zusammen für transparente Darstellung auf der Website. Alle Zahlen und Regeln beziehen sich auf den Stand des Codes (siehe Abschnitt Quellen im Repository).


Was kostet PowerOn? (Kurzfassung)

  • Abonnement (Standard): Sie zahlen pro Abrechnungszeitraum für jeden aktiven Benutzer und jede aktive Feature-Instanz wahlweise monatlich oder jährlich (Preise in CHF).
  • Inkludiert im Abo: Ein festes KI-Budget in CHF pro Abrechnungsperiode (z. B. monatlich 10 CHF bzw. jährlich 120 CHF beim Standard-Plan).
  • Darüber hinaus: KI-Nutzung wird verbrauchsbasiert vom Guthaben abgebucht; der Endbetrag ergibt sich aus den Provider-Einstandskosten plus einem definierten Aufschlag im Backend.
  • Speicher: Über dem im Plan enthaltenen Datenvolumen fällt zusätzlicher Speicher an (CHF pro GB und Monat).
  • Aufladen: Zusätzliches Guthaben ist per Stripe Checkout in festen Stufen möglich (10500 CHF).

So setzt sich der Preis zusammen

1) Fixe Abo-Komponente (Benutzer + Instanzen)

Die wählbaren Pläne sind im Backend als fester Katalog hinterlegt. Maßgeblich sind:

Plan (Schlüssel) Zeitraum Preis pro aktivem User Preis pro aktiver Feature-Instanz Inkl. Datenvolumen (Plan) Inkl. KI-Budget (pro Periode)
Standard (Monatlich) STANDARD_MONTHLY Monat 90 CHF 150 CHF 1024 MB (1 GB) 10 CHF
Standard (Jährlich) STANDARD_YEARLY Jahr 1080 CHF 1800 CHF 1024 MB (1 GB) 120 CHF

Hinweis: Die Jahrespreise entsprechen 12 × den Monatsbeträgen (gleiche effektive Monatsrate).

Hinweis zu Limits: Bei den Standard-Plänen sind im Katalog keine maxUsers / maxFeatureInstances gesetzt (None = im Modell keine Plan-Obergrenze; nur das Datenvolumen ist mit 1024 MB pro Mandat als Plan-Limit hinterlegt). Der Trial-Plan hat explizit 1 User und 3 Instanzen max.

Wichtig für das Verständnis: Die Abrechnung erfolgt nutzungsorientiert in dem Sinne, dass sich die Gesamtsumme aus der Anzahl aktiver User und aktiver Feature-Instanzen ergibt. Änderungen (z. B. mehr Instanzen) können über Stripe mit Proration abgebildet werden (technische Umsetzung im Gateway).

2) Testphase (Trial)

Der Plan 7-Tage-Test (TRIAL_7D) ist kein kostenpflichtiges Abo im Katalog-Sinne, sondern eine begrenzte Phase:

  • Dauer: 7 Tage
  • Limits: max. 1 User, max. 3 Feature-Instanzen, 500 MB Datenvolumen
  • Inkl. KI-Budget: 5 CHF
  • Nach Ablauf ist laut Katalog ein Übergang zum Standard (Monatlich) vorgesehen (successorPlanKey).

Variable Kosten (über das Abo hinaus)

KI-Nutzung (Pay-per-Use aus dem Guthaben)

  • Vor KI-Aufrufen prüft das System u. a., ob ein aktives Abonnement (oder Trial / begrenzt überfälliger Status) vorliegt und ob ausreichend Guthaben vorhanden ist.
  • Die bei einem Aufruf verbuchte Summe basiert auf einem Basispreis (vom KI-Provider / AICore geliefert) und wird im Gateway mit einem Aufschlag multipliziert.

Implementierter Aufschlag: Konstante BILLING_MARKUP_PERCENT = 400 → Faktor (1 + 400% = 5{,}0) auf den übergebenen Basisbetrag.

Transparenz-Hinweis: Im Code-Kommentar neben der Konstante steht eine andere Erläuterung („Faktor 2.0“). Maßgeblich für die Verrechnung ist die Implementierung (400 → Faktor 5). Bei Änderungen der Konstante bitte Landingpage-Text anpassen.

Speicher über dem Plan-Inklusivvolumen

  • Preis überschüssigen Speichers: 0,50 CHF pro GB und Monat (STORAGE_PRICE_PER_GB_CHF), soweit das Volumen über dem im Plan enthaltenen Soft-Limit liegt (Standard-Pläne: 1024 MB).

Guthaben aufladen (optional)

Erlaubte Einmal-Beträge für Stripe-Top-up (serverseitig fix): 10, 25, 50, 100, 250, 500 CHF.


Abrechnung & Zahlung (ohne Technik-Jargon)

  1. Abo: Aktivierung läuft über Stripe (wiederkehrende Abrechnung). Mengen (User/Instanzen) werden mit Stripe synchronisiert; Rechnungsstellung erfolgt über Stripe entsprechend der gewählten Periode.
  2. Guthaben: KI-Verbrauch und ggf. Speicher-Overage belasten das Prepaid-Guthaben des Mandats (bzw. die kontextabhängige Kontoführung im Billing-Modul).
  3. Top-up: Mandats-Admins können per Stripe Checkout Guthaben kaufen; die Gutschrift erfolgt über Webhooks / Bestätigung serverseitig nur erlaubte Beträge.
  4. Nachvollziehbarkeit: Transaktionen und Auswertungen (z. B. nach Zeitraum, Provider, Modell, Feature) sind über die Billing-API abrufbar (für eingeloggte Nutzer je nach Rolle).

Währung, Steuern, Laufzeit

  • Währung: Durchgängig CHF (Plan-Katalog, Speicher-Overage, Top-up-Stufen).
  • Intervalle: Monatlich oder jährlich für die Standard-Pläne; Trial ohne Abo-Intervall.
  • MwSt. / Steuerlogik: Im Gateway-Code ist keine automatische Umsatzsteuerberechnung für Stripe-Checkout der Abos erkennbar; die Unternehmens-/MwSt.-Angaben des Betreibers können aus der Konfiguration für Kommunikation genutzt werden finanzrechtliche Texte auf der Landingpage sollten mit Buchhaltung/Legal abgestimmt werden.

FAQ (für die Website)

Ist dies ein Abo?
Ja — die reguläre Nutzung von PowerOn ist ein Abonnement. Sie zahlen in einem festen Rhythmus (monatlich oder jährlich) für Ihre aktiven Benutzer und aktiven Funktionsbereiche (Feature-Instanzen). Die Zahlung verlängert sich automatisch, bis Sie kündigen oder Ihren Tarif anpassen. Im Abo-Preis ist bereits ein KI-Budget enthalten, das Sie jeden Monat bzw. jedes Jahr nutzen können. Für intensive KI-Nutzung oder zusätzlichen Speicher über dem inkludierten Volumen kann separat Guthaben aufgeladen werden — so bleibt das Basis-Abo planbar, während Mehrverbrauch fair nach tatsächlicher Nutzung abgerechnet wird. Die kostenlose Testphase (7 Tage) ist kein bezahltes Abo und endet automatisch; über den Wechsel zu einem Standard-Tarif werden Sie rechtzeitig informiert.

Zahle ich nur das Abo?
Nein. Das Abo deckt Lizenzen (User + Instanzen) und ein inkludiertes KI-Budget pro Periode. Darüber hinaus zählen zusätzliche KI-Kosten (verbrauchsbasiert mit Aufschlag) und ggf. Speicher über dem Planlimit.

Wie transparent sind die KI-Kosten?
Jede belastbare Nutzung wird als Transaktion geführt (u. a. Provider, Modell, Feature-Kontext). Der Endbetrag enthält den im Code konfigurierten Aufschlag auf die Provider-Basis.

Kann ich Guthaben nachladen?
Ja, in festen Paketen (10500 CHF) über Stripe.

Was passiert, wenn das Guthaben nicht reicht?
Die Plattform blockiert entsprechende KI-Aufrufe, sobald die Prüfung (Abo + Guthaben) nicht mehr erfüllt ist Details siehe BillingService.checkBalance im Gateway.

Gibt es eine Testphase?
Ja: 7 Tage mit klaren Grenzen (User, Instanzen, Volumen, 5 CHF KI-Budget).

Wechseln sich die Preise ohne Ankündigung?
Die öffentlich kommunizierten Beträge sollten mit dem Deploy-Stand des Gateways übereinstimmen: Die Standardpreise liegen im Python-Plan-Katalog (BUILTIN_PLANS), nicht in einer Marketing-Datei.


Quellen im Repository

Thema Datei (Gateway)
Plan-Katalog, CHF-Preise, Limits, KI-Budget modules/datamodels/datamodelSubscription.py (BUILTIN_PLANS)
Speicher-Overage CHF/GB/Monat modules/datamodels/datamodelBilling.py (STORAGE_PRICE_PER_GB_CHF)
KI-Aufschlag / Verbrauchsbuchung modules/serviceCenter/services/serviceBilling/mainServiceBilling.py (BILLING_MARKUP_PERCENT, calculatePriceWithMarkup, recordUsage, checkBalance)
Top-up-Beträge, Stripe Checkout modules/serviceCenter/services/serviceBilling/stripeCheckout.py (ALLOWED_AMOUNTS_CHF)
Billing- & Abo-Routen (API) modules/routes/routeBilling.py, modules/routes/routeSubscription.py, modules/routes/routeStore.py (/api/store/subscription-info)

Mini-Übersicht als Fluss (optional für Diagramm auf der Seite)

flowchart LR
  visitor[Besucher] --> plans[Plan_User_und_Instanz_CHF]
  plans --> included[Inkl_KI_Budget_pro_Periode]
  included --> usage[Verbrauch_KI_und_Speicher]
  usage --> topup[Optional_Stripe_TopUp]
  topup --> insight[Transaktionen_und_Statistik_in_App]

Letzte inhaltliche Abstimmung mit dem Gateway-Code: Dokument erzeugt für Landingpage-Transparenz; bei Code-Änderungen bitte Tabelle und FAQ aktualisieren.