Driver

Resumo

Plataforma de transporte e entregas no modelo Uber/99 com diferencial cooperativo por cidade: representantes locais gerenciam a frota e as regras comerciais da região. Inclui rastreamento GPS em tempo real, precificação dinâmica com zonas e surge, integração com WhatsApp, checkout pré-pago via BillingPortal, avaliações bidirecionais, relatórios de ganhos e integração last-mile nativa com Marketplace, Dropshipping e e-commerce — pedidos de lojas viram automaticamente solicitações de entrega.

Para quem é

• Operadores locais que querem montar um Uber/99 cooperativo na sua cidade sem depender de gigantes.
• Lojistas de e-commerce e dropshipping que precisam de last-mile confiável integrado ao checkout.
• Franqueados white-label que replicam a operação em múltiplas cidades com marca própria.
• Marketplaces locais que querem oferecer entrega própria aos sellers.

O que você pode fazer

Modelo Cooperativo por Cidade

• Cidades e representantes locais (driver_cities, driver_city_reps): cada cidade tem painel próprio.
• Regras comerciais regionais: tarifas, comissões e disponibilidade definidas pelo representante da cidade.
• White-label por cidade: marca e cores configuráveis.

Corridas e Entregas

• Rides (corridas de passageiros): solicitação, aceite, início, conclusão, cancelamento.
• Deliveries (entregas): pedido com itens (driver_delivery_items), pickup, entrega.
• Timeout de corrida: 120s para aceite, raio de busca padrão 50km.

Rastreamento em Tempo Real

• GPS live com TrackingService e tabela driver_ride_tracking.
• Passageiros e admins veem o motorista no mapa ao vivo.
• Link compartilhável de rastreamento para receptor da entrega.

Precificação Dinâmica

• Zonas de preço (driver_pricing_zones): tarifas diferenciadas por bairro/região.
• Regras de precificação (driver_pricing_rules): base, por km, por minuto, mínimo.
• Surge pricing: aumento automático em horários de alta demanda.
• Comissão configurável: padrão 15% da corrida.

Veículos e Motoristas

• Cadastro de veículos com documentação.
• Perfis de motoristas com fotos, documentos e score.
• Online/offline: eventos driver.online e driver.offline atualizam disponibilidade.

Pagamentos e Avaliações

• Checkout pré-pago via BillingPortal antes da corrida começar.
• Avaliações bidirecionais: passageiro avalia motorista e vice-versa (driver_ratings).
• Payout automático processado por cron (6h) via processAutoPayments.
• Relatório diário de ganhos enviado 22h.

WhatsApp Integration

• Onboarding via WhatsApp: motoristas e passageiros podem interagir sem app.
• Notificações automáticas de corrida, status e confirmação.
• Log de mensagens em driver_whatsapp_logs.

Last-Mile para E-commerce

• Integração com Marketplace e Dropshipping: pedidos virando solicitações de entrega.
• Automação completa: pagamento confirmado → entrega criada → motorista alocado → rastreamento enviado ao cliente.

Como começar

1. Acesse Dashboard → Driver → Settings e configure sua cidade e comissão.
2. Cadastre veículos e motoristas em Vehicles e Profiles.
3. Defina zonas de preço e regras em Pricing.
4. Ative WhatsApp se quiser onboarding sem app.
5. Conecte com Marketplace/Dropshipping para last-mile automático.
6. Acompanhe corridas e entregas em Overview e Tracking.

Tutoriais

Tutorial 1: Cadastrar cidade e representante local

Objetivo: habilitar operação em uma nova cidade. Passos:

1. Admin → Driver → Cities → Nova Cidade.
2. Defina nome, raio de operação e comissão local.
3. Adicione representante(s) com permissões de gestão.
4. O representante passa a ter painel próprio para motoristas, precificação e relatórios da sua cidade.

Tutorial 2: Configurar zonas de preço

Objetivo: tarifar diferente por bairro/região. Passos:

1. Pricing → Zones → Nova Zona.
2. Desenhe a área no mapa ou informe coordenadas.
3. Defina base, por km, por minuto e mínimo da zona.
4. Combine com surge pricing para horários de pico.

Tutorial 3: Integrar last-mile com Dropshipping

Objetivo: pedidos da loja virtual viram entregas automáticas. Passos:

1. Em Driver → Integrations, ative Dropshipping/Marketplace.
2. No Dropshipping, defina raio de entrega própria (ex.: 15km da loja).
3. Ao receber pedido pago, o evento dispara criação de delivery no Driver.
4. Motorista mais próximo recebe a solicitação (timeout 120s).
5. Cliente recebe link de rastreamento via WhatsApp.

Tutorial 4: Onboarding de motorista via WhatsApp

Objetivo: cadastrar motorista sem app dedicado. Passos:

1. Ative WhatsApp em Settings.
2. Compartilhe o número oficial do diretório.
3. O motorista envia "Cadastro" e responde às perguntas (documentos, veículo, zona).
4. Documentos são validados em Profiles antes de ativar.

Tutorial 5: Solicitar corrida de passageiro

Objetivo: fluxo completo do passageiro. Passos:

1. Passageiro acessa a página pública, informa origem e destino.
2. Ve preço estimado com zonas + surge aplicados.
3. Confirma checkout pré-pago em BillingPortal.
4. Motorista mais próximo aceita (ride.accepted).
5. Acompanha o GPS ao vivo até o destino.
6. Ao fim (ride.completed), avalia o motorista.

Integrações com outros plugins

• BillingPortal: checkout pré-pago de corridas e entregas.
• Wallet: saldo do motorista atualizado via payment.completed.
• Dropshipping/Marketplace: eventos de pedido disparam criação de entrega.
• Inbox/WhatsApp: notificações e onboarding via número oficial.
• Eventos emitidos: ride.requested, ride.accepted, ride.started, ride.completed, ride.cancelled, delivery.requested, delivery.picked_up, delivery.delivered, payment.completed, driver.online, driver.offline.
• Listeners: user.created (cria perfil), payment.completed (libera corrida/entrega).

Perguntas frequentes

1. O que é o modelo cooperativo por cidade? Cada cidade opera como uma unidade com representantes locais. A comissão e as regras são definidas localmente, diferente do modelo centralizado de Uber/99.

2. Posso integrar com minha loja virtual? Sim. A integração com Dropshipping e Marketplace é nativa — pedidos pagos viram entregas automaticamente.

3. Como funciona a precificação dinâmica? Combina zonas (por bairro/região), regras (base, km, min, mínimo) e surge (multiplicador em horário de pico).

4. Posso operar 100% via WhatsApp sem app? Onboarding e notificações funcionam via WhatsApp. Para GPS em background, um app companion é recomendado — está no roadmap.

5. Qual o raio padrão de busca de motorista? 50km, configurável. Timeout para aceite: 120s.

6. Como funciona o payout do motorista? Cron processAutoPayments roda a cada 6h e processa o pagamento conforme regras da cidade. O saldo fica no Wallet.

7. Posso ter motoristas em múltiplas cidades? O motorista pode operar em uma cidade primária; operar em outra exige novo cadastro respeitando as regras locais.

8. Há avaliação de ambos os lados? Sim. Passageiro avalia motorista e motorista avalia passageiro (bidirecional).

Glossário

• Ride: corrida de passageiro.
• Delivery: entrega com itens.
• Surge pricing: aumento tarifário em horário de alta demanda.
• Zona: área geográfica com precificação específica.
• Representante de cidade: operador local que gerencia a cidade.
• Last-mile: última milha da entrega, do centro de distribuição ao cliente final.
• Payout: transferência do saldo acumulado ao motorista.

Limitações e avisos

• GPS em background 100% preciso exige app nativo; PWA funciona para casos leves.
• Rotas otimizadas multi-paradas (TSP) para entregas em lote está no roadmap.
• Corridas agendadas (reserva futura) está no roadmap.
• Compliance regulatório (ANTT, licenças municipais) é responsabilidade do operador local.
• Integração com marketplaces globais (Mercado Livre, Shopee, iFood) como transportadora está no roadmap.

Relacionados

• Dropshipping — last-mile de pedidos da loja virtual.
• Marketplace — entregas de sellers.
• BillingPortal — checkout pré-pago.
• Wallet — saldo e payouts.
• Inbox — WhatsApp oficial para onboarding e notificações.