Especificação Técnica - Sistema de Gestão para Dispatchers
1. Visão Geral
O sistema é uma plataforma de gestão para Dispatchers, utilizando o template AdminLTE como base para a interface. O sistema visa automatizar e otimizar o processo de gestão de cargas entre Dispatchers e Carriers (caminhoneiros).
O que é car hauler dispatcher:
https://en.truckdispatchertraining.us/how-to-dispatch-a-car-hauler/
O sistema sera construído com dados de empresas e clientes que vivem nos estados unidos, então os dados e validações tem de seguir as regras do pais e não do br. Eu irei informar as especificações.
2. Arquitetura e Tecnologias
• Frontend: AdminLTE Premium (
https://adminlte.io/premium/)
• Frontend: Nextjs com typescript e com testes unitários ( Tudo que for criado depois será validado por testes)
• Ambiente local deve ser com docker-compose
• Vamos utilizar VERCEL
• Banco de Dados: postgresql ou outro de preferencia.
3. Entidades Principais
3.1 Dispatcher
• Pode ser pessoa física (informal) ou jurídica (empresa)
• Empresas podem ter múltiplos usuários
• É o pagador do sistema
3.2 Carrier (Cliente)
• Caminhoneiro/proprietário de frota
• Pode ter múltiplos drivers e caminhões
• Possui comissão específica com cada dispatcher
• Vinculado a uma única conta de dispatcher (exceto em casos especiais)
• É o carrier que paga o Dispatcher. Esse sistema inicialmente irá controlar esse pagamento.
3.3 Usuário do Sistema
• Pode ser dispatcher individual ou funcionário de empresa dispatcher
• Acessa o sistema com permissões específicas
4. Funcionalidades Principais
4.1 Gestão de Cargas (Loads)
• Importação automática via Excel (formato Super Dispatch) Essa planilha, sempre é exportada com as mesmas colunas. As informações alteram.
• Validações na importação:
• Verificação de Load id e vin number (essa verificação permite que não terá cargas repetidas)
• validação de carrier (email)
• cálculo automático de comissões
• controle de status de pagamento ( se o carrier já pagou ao dispatcher sob alguma carga)
• campos obrigatórios:
• identificação interna
• nome do cliente
• data de importação
• due date de pagamento ( data de vencimento que o carrier tem de pagar o dispatcher)
• status de pagamento (unpaid, invoiced, due payment)
4.2 Gestão de Faturas (Invoices)
• Geração de PDF
• Parâmetros configuráveis:
• Data de criação
• Data de pickup
• Data de entrega
• Data de pagamento
• Atualização automática de status
• Controle de pagamentos
4.3 Dashboard – Para o Usuario
• Métricas principais:
• Total de cargas
• Total de clientes
• Cargas por cliente
• Cargas por dispatcher
• Valores financeiros (período selecionável)
4.4 Planos: Controle de planos e features.
Free: 1 usuario ou 1 empresa até 50 cargas por mês. Passou disso $15,00 dolares por mês.
Usuário adicional: $15 dolares por Mês.
4.4 Painel administrativo do sistema
Usuários/empresas cadastrados, para dar manutenção e suporte
Cobrança recorrente via STRIPE ( Vamos conectar com o sistema de pagamento Stripe para gerar as cobranças automáticas e recorrentes da assinatura.)
5. Estrutura do Banco de Dados
5.1 Tabelas Principais
1. Tb_company
• Dados da empresa dispatcher
• Campos: id, nome, endereço, telefone, email, ein/tax id, etc.
2. Tb_user
• Usuários do sistema
• Campos: ID, company_id, dados pessoais, dispatch_fee
3. Tb_customer
• Dados dos carriers
• Campos: id, dados da empresa, mc, dot, ein, etc.
4. Tb_driver
• Motoristas vinculados aos carriers
• Campos: id, customer_id, dados pessoais, ssn/tax id
5. Tb_loads
• Registro de cargas
• Campos: ID interno, dados da carga, status, comissões, etc.
6. Tb_invoice
• Faturas geradas
• Campos: ID, cargas vinculadas, valores, status, datas
6. Requisitos Não-Funcionais
• Interface responsiva
• Sistema multi-tenant
• Controle de acesso baseado em permissões
• Backup automático
• Logs de atividades
• Exportação de relatórios
7. Considerações de Segurança
• Autenticação em dois fatores
• Controle de sessão
• Backup regular
8. Entregáveis
1. Sistema completo com interface AdminLTE
2. Documentação técnica
3. Manual do usuário
4. Código fonte comentado
5. Ambiente de testes
6. Ao final do projeto e tudo entregue, sera considerado entregue, após uma vídeo conferencia comigo e publicar o projeto no Vercel.
Prazo de Entrega: 31 de Maio de 2025