Matriz de Jurisdicao

O Levy Cover nao esta disponivel em todos os lugares. A matriz de jurisdicao define quais regioes sao cobertas, quais niveis estao disponiveis em cada uma e qual seguradora as subscreve. A matriz e aplicada no desbloqueio - se a localizacao do ciclista resolver para uma regiao nao suportada, o cartao opt-in nunca aparece.

Onde a matriz vive

Existem duas camadas:

1. Padroes no codigo. src/lib/insurance/jurisdiction-matrix.ts e entregue com as regioes canonicamente suportadas para o release atual.
2. Substituicoes em tempo de execucao. A tabela insurance_offerings no Supabase pode substituir padroes por subconta ou globalmente. Edicoes de super-admin fluem atraves de /api/admin/insurance/jurisdiction-matrix.

A cadeia de resolucao no momento da cotacao:

1. Linha insurance_offerings especifica da subconta.
2. Linha insurance_offerings global (subaccount_id IS NULL).
3. DEFAULT_JURISDICTION_MATRIX no codigo.
4. Curinga do pais.
5. available: false.

Os passos 1-2 sao as substituicoes em tempo de execucao. O passo 3 e a fonte da verdade para adicionar um novo estado em um release de codigo.

Regioes suportadas na Fase 1

A matriz inicial de lancamento e intencionalmente conservadora - estados DOI amigaveis primeiro.

EUA (Fase 1)

UE (Fase 1)

Expansao Fase 2

A Fase 2 adiciona cinco estados dos EUA e desbloqueia o menu de tres niveis (Minimal, Standard, Premium) em todas as regioes ao vivo. Tambem introduz Slice como seguradora de fallback onde a Cover Genius nao esta disponivel.

EUA (Fase 2)

Regioes excluidas

As seguintes estao fora do escopo para v1 e v2:

Se uma subconta opera em uma regiao excluida, o toggle Levy Cover em /dashboard/insurance/settings sera desativado e o cartao opt-in nunca aparecera no desbloqueio.

Como uma viagem resolve para uma jurisdicao

No desbloqueio:

1. O local de desbloqueio (lat/lng) e geocodificado para codigo de pais ISO + regiao.
2. A matriz e consultada com a cadeia de resolucao acima.
3. Se a matriz retornar available: true, uma cotacao e solicitada da seguradora correspondente.
4. A resposta da cotacao inclui os niveis disponiveis, precos e versao do texto da apolice.
5. O cartao opt-in renderiza com quaisquer niveis com os quais a matriz e a seguradora concordem.

Viagens cross-jurisdicao vinculam com base no local de desbloqueio. Se um ciclista desbloqueia em uma jurisdicao coberta e termina a viagem em uma nao coberta, a apolice ainda se aplica para a viagem - o texto da apolice da seguradora define o escopo geografico da cobertura.

Adicionando uma nova regiao

Para adicionar uma nova regiao em um release:

1. Edite src/lib/insurance/jurisdiction-matrix.ts e adicione o pais ISO + regiao.
2. Confirme que a seguradora escolhida e licenciada e disposta a subscrever a regiao (esta e uma decisao do lado da seguradora, nao uma decisao da Levy).
3. Insira uma linha insurance_offerings global para a regiao para que as subcontas existentes herdem o padrao automaticamente.
4. Execute o conjunto de testes em src/lib/insurance/__tests__/jurisdiction-matrix.test.ts.
5. Entregue.

Para ativar uma regiao apenas para uma unica subconta - por exemplo, um lancamento piloto em um novo estado - insira uma linha insurance_offerings especifica da subconta em vez de editar a matriz padrao.

Desativando uma regiao

Se uma seguradora sair de uma regiao no meio do trimestre, ou um DOI levantar uma objecao:

1. Defina enabled = false na linha insurance_offerings correspondente.
2. Apolices vinculadas existentes permanecem ativas ate o fim das viagens - a seguradora as honra.
3. Novos desbloqueios na regiao param de oferecer Levy Cover.
4. Notifique os operadores afetados.

O cron de reconciliacao da seguradora sinaliza quaisquer apolices que a seguradora depois invalida, e as viagens sao sinalizadas para reembolso de premio atraves do caminho de reembolso de viagem (veja Reembolsos de Premio via Viagem).

Consultando a matriz

Os operadores podem inspecionar a matriz em /dashboard/insurance/settings. A pagina lista cada regiao em que a subconta opera, os niveis oferecidos, a seguradora em uso e quaisquer substituicoes.

Funcionarios super-admin podem editar a matriz via /api/admin/insurance/jurisdiction-matrix. Solicitacoes do lado do operador para novas regioes sao roteadas atraves do suporte.

---