Análise de Corridas

Sistema online para analisar corridas de aplicativo: quanto rendeu no dia, na semana e no mês, sempre comparado com o mesmo ponto do período anterior, com os horários de pico, o KM rodado, as despesas e o lucro real por km.

Como o lucro é calculado

lucro real = bruto − (km rodado × custo por km) − despesas

• Custo por km: configurável na tela (padrão R$ 0,81). Representa combustível, manutenção, pneu e desgaste. É ele que transforma bruto em lucro de verdade.
• Combustível lançado como despesa não entra no lucro: o custo por km já cobre o abastecimento, e contar os dois seria custo em dobro. Ele continua descontando da carteira.
• KM da corrida vem do odômetro quando o MacroDroid envia, e do campo manual quando o lançamento é feito à mão. Os dois somam no total.

API usada pelo MacroDroid

Todas exigem o header x-app-pin: <PIN> (ou ?pin=<PIN> na query).

Método	Rota	Uso
POST	/api/radar/analisar	Analisa uma oferta em JSON (fare, pickup_km, trip_km, pickup_min, trip_min) e classifica em Boa / No limite / Ruim
POST	/api/radar/analisar-texto	Mesma análise a partir do texto bruto da notificação (raw_text)
POST	/api/radar/:id/aceitar	Marca a oferta como aceita e lança a corrida como ganho
POST	/api/radar/:id/recusar	Marca a oferta como recusada
GET	/api/radar/hoje	Eventos do radar do dia
POST	/api/sessions/:id/entries	Lançamento direto de corrida (rota original, mantida)
POST	/api/rides	Lançamento de corrida sem precisar de id: o dia é resolvido sozinho

O dia de trabalho é criado automaticamente no primeiro lançamento — não existe mais passe para abrir antes de rodar.

Outras rotas

Método	Rota	Uso
GET	/api/analytics?scope=day|week|month	Análise completa do período, já comparada com o anterior
GET	/api/rides?from=&to=	Corridas e despesas do intervalo
GET	/api/reports?period=daily|weekly|monthly	Resumo agrupado por dia, semana ou mês
GET	/api/export.csv?from=&to=&pin=	CSV com uma linha por corrida
GET POST	/api/settings	Lê e grava o custo por km
GET POST	/api/wallet	Carteira: conferência e projeção
GET	/api/pulse	Sinal barato usado pelo tempo real

Variáveis de ambiente

Variável	Padrão	Para que serve
DATABASE_URL	—	Conexão Postgres (obrigatória)
APP_PIN	vazio	PIN de acesso; vazio libera o app
APP_TZ_OFFSET_MIN	-180	Fuso de operação em minutos. É o que define o corte do dia, da semana e do mês
COST_PER_KM	0.81	Custo por km inicial, antes de ser alterado na tela
PORT	3000	Porta HTTP

Rodando local

npm install
DATABASE_URL=postgres://... APP_PIN=1234 npm start