← Voltar ao índice
🚛 TruckRightWay
Plataforma de gestão logística e frota. Controle de veículos, motoristas, viagens, manutenção e combustível com geolocalização PostGIS.
Node.js
Express
PostgreSQL
PostGIS
Neon DB
JWT
Docker
Especificação do Produto
Plataforma de gestão de frota e logística para transportadoras — controla veículos, motoristas, rotas e manutenções.
Gestores de frota, motoristas, transportadoras
🚧 Em desenvolvimento — truckrightway.blackcatcorp.com.br
- Cadastro e gestão de frota de veículos
- Controle de motoristas e documentação
- Rastreamento de viagens e entregas
- Gestão de manutenções preventivas
- Controle de abastecimento
- Otimização de rotas
- Dashboard de KPIs de frota
- GPS tracking em tempo real
- App do motorista (mobile)
- Integração com sistemas de pedágio
- BI e relatórios avançados
Autenticação
POST
/api/auth/login
🌐 Público
Login com email/senha. Retorna JWT.
POST
/api/auth/register
🌐 Público
Registrar novo usuário/empresa. Body: { name, email, password, company }
Veículos
GET
/api/vehicles
🔒 JWT
Listar frota. Query: ?status=active&type=truck
POST
/api/vehicles
🔒 JWT
Cadastrar veículo. Body: { plate, model, year, type, capacity_kg }
GET
/api/vehicles/:id
🔒 JWT
Detalhe do veículo com histórico de viagens e manutenções
PUT
/api/vehicles/:id
🔒 JWT
Atualizar dados do veículo
Motoristas
GET
/api/drivers
🔒 JWT
Listar motoristas cadastrados
POST
/api/drivers
🔒 JWT
Cadastrar motorista. Body: { name, cnh, cnh_category, cnh_expiry, phone }
GET
/api/drivers/:id
🔒 JWT
Perfil do motorista com histórico de viagens
PUT
/api/drivers/:id
🔒 JWT
Atualizar dados do motorista
Viagens
GET
/api/trips
🔒 JWT
Listar viagens. Query: ?status=in_progress&driver_id&vehicle_id&from&to
POST
/api/trips
🔒 JWT
Criar viagem. Body: { vehicle_id, driver_id, origin, destination, cargo, scheduled_at }
GET
/api/trips/:id
🔒 JWT
Detalhe da viagem com rota e registros de posição
PUT
/api/trips/:id/status
🔒 JWT
Atualizar status da viagem. Body: { status: "started"|"in_progress"|"completed"|"cancelled" }
Manutenção
GET
/api/maintenance
🔒 JWT
Listar registros de manutenção. Query: ?vehicle_id&status=pending
POST
/api/maintenance
🔒 JWT
Registrar manutenção. Body: { vehicle_id, type, description, cost, date, km }
Abastecimento
GET
/api/fuel-logs
🔒 JWT
Histórico de abastecimentos. Query: ?vehicle_id&from&to
POST
/api/fuel-logs
🔒 JWT
Registrar abastecimento. Body: { vehicle_id, liters, cost_per_liter, km, station }
Rotas
GET
/api/routes
🔒 JWT
Listar rotas salvas
POST
/api/routes
🔒 JWT
Salvar rota com waypoints PostGIS. Body: { name, waypoints[], distance_km, estimated_hours }
Dashboard
GET
/api/dashboard/metrics
🔒 JWT
Métricas da frota: viagens ativas, km rodados, custo combustível, veículos em manutenção
Alertas
POST
/api/alerts
🔒 JWT
Criar alerta (vencimento CNH, revisão, etc). Body: { type, vehicle_id, driver_id, due_date, message }
GET
/api/alerts
🔒 JWT
Listar alertas ativos e pendentes
BlackCat Corp © 2026 — Voltar ao índice