Jurisdiktionsmatrix

Levy Cover ist nicht uberall verfugbar. Die Jurisdiktionsmatrix definiert, welche Regionen abgedeckt sind, welche Stufen in jeder verfugbar sind und welcher Versicherer sie absichert. Die Matrix wird beim Entsperren durchgesetzt - wenn der Standort des Fahrers zu einer nicht unterstutzten Region auflost, erscheint die Opt-in-Karte nie.

Wo die Matrix lebt

Es gibt zwei Schichten:

1. Code-Standards. src/lib/insurance/jurisdiction-matrix.ts wird mit den kanonisch unterstutzten Regionen fur den aktuellen Release ausgeliefert.
2. Laufzeit-Overrides. Die insurance_offerings Tabelle in Supabase kann Standards pro Unterkonto oder global uberschreiben. Super-Admin-Bearbeitungen laufen uber /api/admin/insurance/jurisdiction-matrix.

Die Auflosungskette zur Angebotszeit:

1. Unterkonto-spezifische insurance_offerings Zeile.
2. Globale insurance_offerings Zeile (subaccount_id IS NULL).
3. Code-internes DEFAULT_JURISDICTION_MATRIX.
4. Land-Wildcard.
5. available: false.

Schritte 1-2 sind die Laufzeit-Overrides. Schritt 3 ist die Quelle der Wahrheit fur das Hinzufugen eines neuen Bundesstaates in einer Code-Veroffentlichung.

Phase-1-unterstutzte Regionen

Die anfangliche Startmatrix ist absichtlich konservativ - zuerst freundliche DOI-Staaten.

US (Phase 1)

EU (Phase 1)

Phase-2-Erweiterung

Phase 2 fugt funf US-Bundesstaaten hinzu und schaltet das Drei-Stufen-Menu (Minimal, Standard, Premium) in allen Live-Regionen frei. Sie fuhrt auch Slice als Fallback-Versicherer ein, wo Cover Genius nicht verfugbar ist.

US (Phase 2)

Ausgeschlossene Regionen

Die folgenden sind ausserhalb des Geltungsbereichs fur v1 und v2:

Wenn ein Unterkonto in einer ausgeschlossenen Region operiert, wird der Levy Cover Toggle unter /dashboard/insurance/settings deaktiviert und die Opt-in-Karte erscheint beim Entsperren nie.

Wie eine Fahrt zu einer Jurisdiktion auflost

Beim Entsperren:

1. Der Entsperrort (lat/lng) wird geokodiert zu ISO-Landercode + Region.
2. Die Matrix wird mit der Auflosungskette oben konsultiert.
3. Wenn die Matrix available: true zuruckgibt, wird ein Angebot vom passenden Versicherer angefordert.
4. Die Angebotsantwort enthalt die verfugbaren Stufen, Preise und Policentext-Version.
5. Die Opt-in-Karte wird mit den Stufen gerendert, denen sowohl Matrix als auch Versicherer zustimmen.

Cross-Jurisdiktions-Fahrten binden basierend auf Entsperrort. Wenn ein Fahrer in einer abgedeckten Jurisdiktion entsperrt und die Fahrt in einer nicht abgedeckten beendet, gilt die Police trotzdem fur die Fahrt - der Policentext des Versicherers definiert den geografischen Umfang.

Eine neue Region hinzufugen

Um eine neue Region in einem Release hinzuzufugen:

1. Bearbeiten Sie src/lib/insurance/jurisdiction-matrix.ts und fugen Sie ISO-Land + Region hinzu.
2. Bestatigen Sie, dass der gewahlte Versicherer lizenziert und bereit ist, die Region zu versichern (das ist eine versichererseitige Entscheidung, keine Levy-Entscheidung).
3. Fugen Sie eine globale insurance_offerings Zeile fur die Region ein, damit bestehende Unterkonten den Standard automatisch erben.
4. Fuhren Sie die Test-Suite in src/lib/insurance/__tests__/jurisdiction-matrix.test.ts aus.
5. Ausliefern.

Um eine Region nur fur ein einzelnes Unterkonto zu aktivieren - z.B. ein Pilotstart in einem neuen Bundesstaat - fugen Sie eine unterkontospezifische insurance_offerings Zeile ein, anstatt die Standardmatrix zu bearbeiten.

Eine Region deaktivieren

Wenn ein Versicherer mitten im Quartal aus einer Region ausscheidet oder ein DOI Einspruch erhebt:

1. Setzen Sie enabled = false auf der passenden insurance_offerings Zeile.
2. Bestehende gebundene Policen bleiben aktiv, bis die Fahrten enden - der Versicherer ehrt sie.
3. Neue Entsperren in der Region horen auf, Levy Cover anzubieten.
4. Benachrichtigen Sie betroffene Betreiber.

Der Versicherer-Abstimmungs-Cron markiert alle Policen, die der Versicherer spater fur ungultig erklart, und die Fahrten werden fur Pramienruckerstattung uber den Fahrt-Ruckerstattungspfad markiert (siehe Pramienruckerstattungen uber die Fahrt).

Die Matrix abfragen

Betreiber konnen die Matrix unter /dashboard/insurance/settings inspizieren. Die Seite listet jede Region auf, in der das Unterkonto operiert, die angebotenen Stufen, den verwendeten Versicherer und etwaige Overrides.

Super-Admin-Mitarbeiter konnen die Matrix uber /api/admin/insurance/jurisdiction-matrix bearbeiten. Betreiberseitige Anfragen fur neue Regionen werden uber den Support geleitet.

---