Recompensas de Zonas de Estacionamento

As recompensas de zonas de estacionamento incentivam os clientes a estacionar veículos em áreas designadas, concedendo pontos de fidelidade. Isso ajuda a melhorar a distribuição da frota, reduzir custos de rebalanceamento e criar uma experiência melhor para o próximo usuário.

Visão Geral

Quando os clientes encerram sua viagem em uma zona de estacionamento preferencial, eles automaticamente recebem pontos de fidelidade como recompensa. O sistema verifica a localização GPS do veículo no término da viagem e concede pontos se ele estiver dentro de uma zona de estacionamento configurada.

Principais Recursos

• Concessão automática de pontos - Pontos dados automaticamente no término da viagem
• Pontos base configuráveis - Defina quantos pontos cada zona concede
• Multiplicador de rebalanceamento - Aumente recompensas durante horários de alta demanda
• Mensagens personalizadas - Exiba mensagens específicas da zona para clientes
• Suporte a múltiplas zonas - Crie muitas zonas de recompensa por local
• Verificação GPS em tempo real - Verificação precisa de localização no término da viagem

Como Funciona

Viagem Termina
    ↓
Sistema verifica localização GPS
    ↓
Veículo está em zona de estacionamento preferencial?
    ├── Sim → Conceder pontos (base × multiplicador)
    │         Atualizar registro da viagem
    │         Cliente vê recompensa no app
    └── Não → Sem recompensa de estacionamento
             Conclusão normal da viagem

Criando uma Zona de Recompensa

Configuração da Zona

Alternância de Estacionamento Preferencial

Marca a zona como uma zona de recompensa.

Pontos de Recompensa

O número base de pontos de fidelidade a conceder.

Dicas:

• Considere seus limites de nível de fidelidade ao definir pontos
• Mais pontos = incentivo mais forte
• Equilibre com pontos de tempo/distância ganhos durante viagens

Multiplicador de Rebalanceamento

Aumente dinamicamente as recompensas para zonas específicas.

O multiplicador permite ajuste em tempo real dos incentivos com base nas necessidades de distribuição da frota.

Mensagem de Recompensa

Mensagem opcional exibida aos clientes quando eles estacionam na zona.

Exemplos:

• "Obrigado por estacionar na Estação Central!"
• "Você ganhou pontos bônus por estacionar em uma área de alta demanda!"
• "Ótima escolha! Esta localização ajuda outros usuários."

Se não definido, uma mensagem padrão com o nome da zona é exibida.

Tipos de Zona para Recompensas

Recompensas de estacionamento funcionam com estes tipos de zona:

Como os Pontos São Calculados

Pontos Concedidos = Pontos Base × Multiplicador de Rebalanceamento

Exemplo:
- Pontos Base: 50
- Multiplicador: 2.0
- Pontos Concedidos: 50 × 2.0 = 100 pontos

O cálculo acontece automaticamente quando:

1. O status da viagem muda para "concluída"
2. O GPS do veículo está dentro do limite de uma zona de recompensa
3. A zona tem is_preferred_parking = true
4. A zona tem parking_reward_points > 0

Esquema do Banco de Dados

Tabela de Zonas (Campos de Recompensa)

Tabela de Viagens (Rastreamento)

Exibição no Aplicativo Móvel

Durante a Viagem

Os clientes veem zonas de recompensa no mapa:

• Indicador visual para zonas de estacionamento
• Pontos disponíveis mostrados na zona
• Multiplicador atual se > 1.0

No Término da Viagem

Ao terminar em uma zona de recompensa:

• Mensagem de confirmação exibida
• Pontos concedidos mostrados
• Mensagem específica da zona (se configurada)
• Saldo de pontos de fidelidade atualizado

Na Seção de Fidelidade

• Histórico de transações mostra recompensas de estacionamento
• Descrição "Estacionou em [Nome da Zona]"
• Quantidade de pontos concedidos

Melhores Práticas

Posicionamento da Zona

1. Destinos de alto tráfego - Terminais de transporte, centros comerciais
2. Estações de carregamento - Incentive estacionamento próximo aos carregadores
3. Locais seguros - Áreas bem iluminadas e acessíveis
4. Conveniência operacional - Fácil para a equipe fazer manutenção

Valores de Pontos

1. Comece conservador - Inicie com valores moderados de pontos
2. Monitore eficácia - Acompanhe se os clientes estão respondendo
3. Ajuste sazonalmente - Mais pontos em períodos lentos
4. Equilibre o orçamento - Considere custos do programa de fidelidade

Estratégia de Multiplicador

1. Ajuste em tempo real - Atualize multiplicadores com base em dados da frota
2. Aumento em horário de pico - Multiplicadores maiores durante hora do rush
3. Incentivos de fim de semana - Aumente para zonas subatendidas no fim de semana
4. Baseado em eventos - Multiplicadores especiais para eventos locais

Solução de Problemas

Pontos Não Sendo Concedidos

1. Verifique configuração da zona:

   • is_preferred_parking deve ser true
   • parking_reward_points deve ser > 0
   • Tipo de zona deve ser parking ou bonus

2. Verifique dados da viagem:

   • Verifique coordenadas GPS no término da viagem
   • Confirme que a viagem foi concluída com sucesso
   • Verifique zonas sobrepostas

3. Verifique limites da zona:

   • Certifique-se de que o polígono é GeoJSON válido
   • Verifique se a zona cobre a área pretendida
   • Verifique lacunas na cobertura

Pontos Errados Concedidos

1. Verifique configuração do multiplicador - Verifique o rebalancing_multiplier atual
2. Verifique sobreposição de zonas - Múltiplas zonas no mesmo local
3. Revise o cálculo - Pontos = base × multiplicador

Cliente Não Vendo Recompensas

1. Verifique histórico de viagens - Verifique se ended_in_preferred_zone é true
2. Verifique transações de fidelidade - Procure entradas do tipo "estacionamento"
3. Verifique conta do cliente - Pontos de fidelidade devem estar atualizados

Referência da API

Obter Zonas de Estacionamento (Móvel)

GET /api/mobile/referrals
# Resposta inclui array parking_zones com informações de recompensa

Conceder Recompensa de Estacionamento (Interno)

import { awardParkingReward } from '@/lib/referrals'

const result = await awardParkingReward(admin, {
  customerId: 'uuid',
  rideId: 'uuid',
  zoneId: 'uuid',
  zoneName: 'Estação Central',
  basePoints: 50,
  multiplier: 2.0
})
// Retorna: { success: boolean, pointsAwarded: number }

Estrutura de Dados da Zona

{
  "id": "uuid",
  "name": "Estacionamento Estação Central",
  "type": "parking",
  "is_preferred_parking": true,
  "parking_reward_points": 50,
  "rebalancing_multiplier": 1.5,
  "parking_reward_message": "Obrigado por estacionar na Estação Central!",
  "geojson": { /* coordenadas do polígono */ }
}