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:
@@ -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
|
||||
|
||||
In neuem Issue referenzieren
Einen Benutzer sperren