frontend_nyla/docs/MONETARISIERUNG_KURZ_PRAESENTATION.md
ValueOn AG 9b99020686 feat(billing): Nutzerhinweise bei leerem Budget + Mandats-Mail (402/SSE)
Gateway
- InsufficientBalanceException: billingModel, userAction (TOP_UP_SELF /
  CONTACT_MANDATE_ADMIN), DE/EN-Texte, toClientDict(), fromBalanceCheck()
- HTTP 402 + JSON detail für globale API-Fehlerbehandlung
- AI/Chatbot: vor Raise ggf. E-Mail an BillingSettings.notifyEmails
  (PREPAY_MANDATE, Throttle 1h/Mandat) via billingExhaustedNotify
- Agent-Loop & Workspace-Route: SSE-ERROR mit strukturiertem Billing-Payload
- datamodelBilling: notifyEmails-Doku für Pool-Alerts
frontend_nyla
- useWorkspace: SSE onError für INSUFFICIENT_BALANCE mit messageDe/En
  und Hinweis auf Billing-Pfad bei TOP_UP_SELF
2026-03-21 01:34:47 +01:00

68 lines
2.5 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Monetarisierung — Kurzfassung (Präsentation)
*Technische Einordnung: Plattform `frontend_nyla` — Mandat → Feature → **Instanz** → **Views** (Rechte). Billing-Typen aus `billingApi.ts`.*
---
## Folie 1 · Kernthese
**Wir verkaufen Module (`featureCode`) und deren Ausprägung: wie viele Instanzen, welche Views, wie viel Verbrauch.**
Preislogik: **Was** × **Wie viel** × **Abrechnungsmodell** (Pauschale, Credits, Nachzahlung, Flat).
---
## Folie 2 · Drei Hebel für das Angebot
| Hebel | Bedeutung |
|--------|-----------|
| **Modul** | z.B. `chatbot`, `workspace`, `trustee`, `automation`, … |
| **Instanz** | Skalierung pro Mandat (Bots, Organisationen, Teams, …) |
| **View / Rolle** | „Light vs Pro“, Add-ons (fein granular über Berechtigungen) |
**Self-Service:** Feature Store (`automation`, `teamsbot`, …) → Trial, Freemium, Upsell.
---
## Folie 3 · Abrechnung (Systemkonzept)
| Modell | Kunde versteht es so |
|--------|----------------------|
| **PREPAY_MANDATE** | Ein Guthaben-Topf für die ganze Organisation |
| **PREPAY_USER** | Kontingent pro Nutzer |
| **UNLIMITED** | Paket / Enterprise-Flat |
Transparenz: Verbrauch lässt sich nach **Feature**, **Instanz**, **Provider/Modell** auswerten (technische Basis im Billing).
---
## Folie 4 · Produktportfolio (Überblick)
| Modul | Fokus |
|--------|--------|
| Treuhand (`trustee`) | Dokumente, Positionen, Import/Scan, Buchhaltung |
| Immobilien (`realestate`) | Karte / Mandantenfähigkeit |
| Chatbot (`chatbot`) | Konversationen, Konfiguration |
| Workflow (`chatworkflow`) | Überblicke, Runs, Dateien |
| Automatisierung (`automation`) | Definitionen, Vorlagen, Logs |
| Teams Bot (`teamsbot`) | Dashboard, Sessions, Settings |
| Neutralisierung (`neutralization`) | Playground, Config, Attribute |
| CommCoach (`commcoach`) | Dashboard, Coaching, Dossier |
| AI Workspace (`workspace`) | Dashboard, Editor, Settings |
*Details & Workshop-Checklisten: siehe `MONETARISIERUNG_FEATURES_INTERAKTIV.md`.*
---
## Folie 5 · Entscheidungen (noch zu füllen)
1. **Segment:** SMB-Paket vs. Enterprise — Standard-Billingmodell?
2. **Messgröße:** Seats, Instanzen, CHF-Verbrauch, hybride Limits?
3. **Transparenz:** getrennte Kosten pro Feature oder ein Gesamtpool?
4. **Store:** welche Module dürfen selbst aktiviert werden — mit welchem Trial?
---
## Folie 6 · Nächster Schritt
Paketraster **Starter / Business / Enterprise** mit festen Inklusiv-Features + klaren **Überlaufregeln** (Warnung, Sperre, Nachkauf).