Feature-Flags und Stufen
AI Ops wird durch vier Spalten auf der subaccounts-Tabelle gesteuert. Sie wirken sofort — kein Redeploy nötig — und jeder Cron-Job liest sie zur Laufzeit.
Die vier Einstellungen
| Spalte | Typ | Standard | Was sie tut |
|---|---|---|---|
ai_ops_enabled | boolean | false | Hauptschalter. Aus = AI-Ops-Crons überspringen diesen Subaccount komplett. |
ai_ops_tier | text | null | Einer von starter, pro, enterprise. Bestimmt, welche Fähigkeiten laufen. |
tech_cost_per_mile_usd | numeric | 0.50 | Wird im Empfehlungssystem vom erwarteten Mehrertrag abgezogen. |
rebalance_battery_floor | integer | 30 | Minimaler Ladezustand (Prozent), den ein Fahrzeug als Rebalance-Kandidat braucht. |
Stufenmatrix
| Fähigkeit | Starter | Pro | Enterprise |
|---|---|---|---|
Nachfragekarte (/dashboard/analytics/heat-maps) | ja | ja | ja |
| Unmet-Demand-Heatmap | ja | ja | ja |
Rebalance-Empfehlungen (/dashboard/operations/rebalance) | nein | ja | ja |
| Top-3-Widget im Operations-Dashboard | nein | ja | ja |
| Kombinierte Swap+Rebalance-Routen | nein | nein | ja |
| Route-Tab in der operator-app | nein | nein | ja |
| Auto-Maintenance-Regel | nein | nein | ja |
| OR-Tools-VRP-Solver | n/a | n/a | ja |
| Routific-Solver (wenn Token konfiguriert) | n/a | n/a | ja |
tech_cost_per_mile_usd justieren
Diese Einstellung repräsentiert die Grenzkosten, ein Fahrzeug eine Meile zu bewegen. Für einen Operator, der Auftragnehmer pauschal pro Stunde bezahlt, ist eine sinnvolle Schätzung der Stundenlohn geteilt durch die durchschnittliche Stundengeschwindigkeit im Gebiet.
- Niedrigere Werte machen das Empfehlungssystem aggressiver — mehr Bewegungen bei geringerem individuellen Mehrertrag.
- Höhere Werte machen es konservativer — nur die ertragreichsten Bewegungen passieren die Schwelle.
Der Standardwert 0.50 ist ein guter Startpunkt für urbane Scooter-Operatoren. Vorort- und Tour-Operatoren mit längeren Fahrtdistanzen heben ihn oft auf 0.75 oder 1.00.
Die Kosten werden direkt vom erwarteten Mehrertrag abgezogen:
projected_lift_usd = (dest_gain - src_loss) * avg_fare - distance_miles * tech_cost_per_mile_usd
Wird das Ergebnis negativ, wird die Empfehlung nie geschrieben.
rebalance_battery_floor justieren
Ein Fahrzeug wird nicht für eine Rebalance-Bewegung eingeladen, wenn sein Akku unter dieser Untergrenze ist. Der Standardwert 30 (Prozent) ist eine sichere Schwelle für die meisten Scooter-Flotten — genug Reichweite, damit der Techniker laden und abladen kann, ohne unterwegs einen Ausfall zu riskieren.
- Für E-Bikes oder Fahrzeuge mit größerer Reichweite können Sie die Schwelle auf
15-20senken. - Für ultrakonservative Operatoren (z. B. Winterbetrieb) auf
40-50anheben.
Fahrzeuge unter der Schwelle werden nicht rebalanciert. Sie sind stattdessen Kandidaten für swap-Stopps in Techniker-Routen, die sie hochziehen, bevor sie bewegt werden.
Wie Stufenwechsel sich auswirken
| Aktion | Effekt |
|---|---|
ai_ops_enabled = false setzen | Alle AI-Ops-Crons überspringen diesen Subaccount beim nächsten Lauf. Bestehende Prognosen und Empfehlungen bleiben in der DB, aber keine neuen werden erzeugt. |
ai_ops_tier von enterprise auf pro zurückstufen | Der Routen-Solver-Cron überspringt diesen Subaccount. Bestehende laufende Routen werden bis zur Fertigstellung oder zum Abbruch fortgeführt. |
Upgrade starter → pro | Der Empfehlungs-Cron beginnt beim nächsten Lauf mit der Erzeugung von Empfehlungen. |
Upgrade pro → enterprise | Der Routen-Solver startet beim nächsten 30-Minuten-Tick (während der Betriebszeiten). |
Stufenwechsel werden beim nächsten Cron-Lauf wirksam. Sie machen die Arbeit früherer Läufe nicht rückgängig.
Wo Sie die Flags setzen
Heute werden die Flags direkt auf der subaccounts-Zeile über die Admin-API (PATCH /api/admin/super-subaccounts/[id]) oder per Supabase-SQL gesetzt. Eine erstklassige UI im Admin-Dashboard ist in der Roadmap.
Für den Pilot-Rollout ist das empfohlene SQL:
UPDATE subaccounts
SET ai_ops_enabled = TRUE,
ai_ops_tier = 'starter',
tech_cost_per_mile_usd = 0.50,
rebalance_battery_floor = 30
WHERE id IN ('<pilot_uuid_1>', '<pilot_uuid_2>');
Verwandt
- Erste Schritte — vollständige Einrichtungsanleitung.
- Rebalance-Empfehlungen — wo
tech_cost_per_mile_usdangewendet wird. - Techniker-Routen — erfordert die Enterprise-Stufe.