No ar · release v1.0.1
Torre Logística
Operação logística em tempo real
- Arquitetura
- Monólito modular com Workers separados
- Testes
- Unidade, integração com PostGIS real, frontend e arquitetura
- Segurança
- Pentest gray-box em produção, com relatório no repositório
- Infra da demo
- VM Always Free (Oracle Cloud)
Visão geral
Plataforma B2B de operação logística em tempo real: acompanha cada entrega entre a saída para rota e a conclusão, com localização, ETA, SLA, geofencing, alertas, ocorrências, prova de entrega e rastreamento público controlado.
São três experiências sobre o mesmo núcleo: o console para administrador, supervisor e operador; a PWA do motorista, que funciona offline; e a página de rastreamento do destinatário, com token forte e sem dados sensíveis. Não é um SaaS comercial ativo: é um projeto de portfólio arquitetado para virar um sem reescrita.
Arquitetura
Monólito modular em .NET 10 com um processo de Workers separado, três aplicações React e PostgreSQL com PostGIS. O simulador é um cliente externo, sem acesso ao núcleo. Decisões registradas em ADRs, cada uma com a forma de verificá-la.
-
TorreLogistica.DomainRegras e invariantes, sem infraestrutura. -
TorreLogistica.ApplicationCasos de uso; usa o EF Core direto, sem repositório (ADR 0008). -
TorreLogistica.InfrastructurePostgreSQL/PostGIS, relógio e gerador de identificador. -
TorreLogistica.ApiBorda HTTP e SignalR. -
TorreLogistica.WorkersCarga assíncrona: SLA, webhooks e limpeza de rastro vencido. -
TorreLogistica.SimulatorCliente externo que encena seis histórias contra a API real. -
apps/Três aplicações web: console operacional, PWA do motorista e rastreamento público.
Ciclo de uma entrega
- A entrega é criada, planejada e atribuída a um motorista.
- O motorista sai para a rota. Cada ação nasce no aparelho com identificador próprio e fica guardada se não houver conexão.
- A ingestão grava a posição, avalia o geofence do destino no PostGIS (com histerese) e recalcula ETA e SLA fora da requisição.
- O console recebe o aviso em tempo real por SignalR, só depois do commit; o motor de alertas abre, deduplica e reabre alertas por regra tipada.
- Ocorrências entram como registros somente-inserção, com motivo tipado; falha de entrega vira tentativa frustrada e reagendamento.
- Na chegada, a prova de entrega sobe direto ao storage por URL assinada de curta duração; a entrega é concluída e o histórico fica na timeline numerada.
Capturas de tela
Pontos fortes
- Geofence e ETA no PostGIS: chegada detectada na ingestão da posição, com histerese contra oscilação de GPS; ETA e SLA explicáveis, sem IA.
- Tempo real com SignalR: o console recebe o aviso só depois do commit; alertas são regras tipadas que carregam a evidência.
- PWA offline-first: toda ação é aplicada exatamente uma vez ao reconectar, com o registro da operação na mesma transação do efeito.
- Prova de entrega e rastreamento seguros: foto por URL assinada de curta duração; link público com token forte (o banco guarda só o hash) e posição aproximada.
- Multi-tenancy e RBAC: filtro por organização que falha fechado; Transactional Outbox nos webhooks.
- Contrato testado contra a API real: o CI barra descompasso entre frontend e backend.
- Decisão por medição: o particionamento da tabela de posições foi recusado porque a medição em ambiente local não o justificou.
Limites e decisões conscientes
O que este projeto não faz, e por quê. Descrever isso com precisão vale mais do que exagerar o escopo.
- A demo pública roda numa VM Always Free de 1 GB, nó único e sem SLA. A arquitetura de produção no Azure foi aplicada e depois destruída por decisão de custo.
- O ETA é determinístico e explicável, não preditivo: decisão registrada no ADR 0018.
- O dado de demonstração é fictício e determinístico: mesma semente, mesma história.
- Fora do escopo: billing, roteirização ótima (VRP), app nativo, chat e emissão fiscal.
- Há uma única instância da API: tempo real e alertas pressupõem processo único, e várias instâncias exigiriam um backplane.