feat(abrechnung): Monatskontingent in Credits mit festen Sätzen, Hard-Stop und Warnschwelle

Portierung aus dem Lokal-Fork (AegisSight-Monitor-Local, Commit d2b9168,
per Cherry-Pick übernommen und an den Server-Stand angepasst).

- Feste Sätze je Aktion (BILLING_MODE=flat) statt echter Kosten geteilt
  durch cost_per_credit. Sätze auf die am 23.07.2026 beschlossenen
  Verkaufswerte gesetzt. Live-Lauf 45, Recherche je Durchlauf 40,
  Studio-Bausteine 12, Chat/Beschreibung/Globe 1. Per ENV überschreibbar,
  der alte Modus bleibt als BILLING_MODE=actual erhalten.
- Abrechnungsperiode. licenses.credits_period trennt monthly von total,
  träger Monatsreset bei der nächsten Lizenzprüfung, optionaler Übertrag
  (credits_rollover, gedeckelt auf ein Monatskontingent). Bestandslizenzen
  ohne Periodenmarke behalten ihren Verbrauch.
- Hard-Stop gegen das verfügbare Monatskontingent (Kontingent plus
  Übertrag) statt gegen das Lebenszeit-Total.
- Warnschwelle budget_warning_percent (Default 80 Prozent) wird erstmals
  ausgewertet, einmalige Meldung an alle aktiven Nutzer der Organisation.
- DB-Migration additiv und idempotent (credits_period, credits_period_start,
  credits_rollover, credits_carried, budget_warning_sent, unlimited_budget).
- /api/auth/me liefert credits_available als Bezugsgröße plus
  credits_period, das Credits-Widget zeigt "Credits diesen Monat".
- Wortlaut überall Credits (nicht Guthaben/Einheiten), docs/ABRECHNUNG.md
  auf den Online-Stand gebracht.

Abweichungen zur Fork-Vorlage. Die Takt-Änderungen (Untergrenze 30 Min,
Kostenvorschau im Anlege-Dialog, Fork-Commit 5b0b578) sind bewusst NICHT
enthalten, die Sätze stehen auf 45/40 statt der Fork-Defaults 24/33.

Getestet gegen eine Kopie der Staging-DB, 20 Prüfungen bestanden.
Migration, Flat-Buchung adhoc/research/chat, Warnschwelle einmalig,
Hard-Stop, Monatsreset, Übertrag gedeckelt, Bestandslizenz ohne Marke.
Die vier Live-Lizenzen stehen auf unlimited_budget und sind unbeeinflusst.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Dieser Commit ist enthalten in:
claude-dev
2026-07-25 12:26:54 +00:00
Ursprung ecfc208f22
Commit 1bbbd891ef
13 geänderte Dateien mit 534 neuen und 50 gelöschten Zeilen

Datei anzeigen

@@ -34,6 +34,51 @@ CLAUDE_MODEL_FAST = "claude-haiku-4-5-20251001" # Für einfache Aufgaben (Feed-
CLAUDE_MODEL_MEDIUM = "claude-sonnet-4-6" # Für qualitätskritische Aufgaben (Netzwerkanalyse)
CLAUDE_MODEL_STANDARD = "claude-opus-4-7" # Standard-Opus für Recherche, Analyse, Faktencheck
# --- Verbrauchssaetze (Credits je Aktion) -------------------------------------
# Beschlossen 2026-07-23, der Verbrauchsrechner im Verwaltungsportal nutzt
# dieselben Werte: Live-Lauf 45, Recherche je Durchlauf 40 (das Anlegen faehrt
# drei Durchlaeufe, also 120), 1 Credit = 0,20 USD. Per ENV ueberschreibbar.
# (Die gemessenen Mediane aus refresh_log lagen bei 24 bzw. 33 Credits, die
# Verkaufssaetze sind bewusst hoeher angesetzt.)
CREDITS_PER_ADHOC_REFRESH = float(os.environ.get("CREDITS_PER_ADHOC_REFRESH", "45"))
CREDITS_PER_RESEARCH_PASS = float(os.environ.get("CREDITS_PER_RESEARCH_PASS", "40"))
# --- Abrechnungsmodus ---------------------------------------------------------
# 'flat' = feste Credits je Aktion nach CREDIT_TARIFF. Der Kunde kann seinen
# Verbrauch vorher ausrechnen, und eine spaetere Verbilligung des
# Modell-Backends veraendert sein Kontingent nicht.
# 'actual' = bisheriges Verhalten, echte Kosten geteilt durch cost_per_credit.
# Damit haengt das Kundenerlebnis am Einkaufspreis, ein Refresh einer
# grossen Lage zieht ein Vielfaches eines Refreshs einer frischen.
# Die echten Kosten wandern in beiden Modi unveraendert nach token_usage_monthly,
# die interne Kostenkontrolle bleibt also erhalten.
BILLING_MODE = os.environ.get("BILLING_MODE", "flat").lower()
# Credits je Aktion im Modus 'flat'. Schluessel ist die Abrechnungsquelle,
# beim Refresh zusaetzlich nach Lagentyp getrennt.
#
# monitor_* sind die beschlossenen Verkaufssaetze (siehe oben).
# analysis/factcheck sind Einzelbausteine aus dem Studio und liegen mangels
# eigener Messreihe bei rund einem Viertel eines Live-Laufs. Sobald
# token_usage_monthly dafuer Zahlen hat, hier nachziehen.
# chat/enhance/globe kosten real 0,02 bis 0,03 USD je Aufruf, also unter einem
# halben Credit. Der Satz 1 verhindert Missbrauch, ohne echte Nutzung spuerbar
# zu belasten.
CREDIT_TARIFF = {
"monitor_adhoc": CREDITS_PER_ADHOC_REFRESH,
"monitor_research": CREDITS_PER_RESEARCH_PASS,
"analysis": float(os.environ.get("CREDITS_PER_ANALYSIS", "12")),
"factcheck": float(os.environ.get("CREDITS_PER_FACTCHECK", "12")),
"chat": 1.0,
"enhance": 1.0,
"globe": 1.0,
}
# Voreinstellung fuer neue Lizenzen, wenn die Verwaltung nichts anderes setzt.
# 'monthly' = Kontingent gilt je Kalendermonat und wird zum Monatswechsel neu
# gefuellt. 'total' = Kontingent gilt fuer die gesamte Lizenzlaufzeit.
CREDITS_PERIOD_DEFAULT = os.environ.get("CREDITS_PERIOD_DEFAULT", "monthly")
# Ausgabesprache wird pro Organisation gesteuert -- siehe services/org_settings.py
# (organization_settings-Tabelle, Key 'output_language', Werte 'de' | 'en').
# Default-Fallback in den Agent-Methoden ist 'Deutsch', sodass Calls ohne