Pular para o conteúdo

No ar · release v1.0.1

Torre Logística

Operação logística em tempo real

.NET 10 ASP.NET Core PostgreSQL 17 PostGIS EF Core 10 SignalR React 19 TypeScript Docker GitHub Actions
Passeio de 33 s pela demo pública: console, PWA do motorista e rastreamento.
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.Domain Regras e invariantes, sem infraestrutura.
  • TorreLogistica.Application Casos de uso; usa o EF Core direto, sem repositório (ADR 0008).
  • TorreLogistica.Infrastructure PostgreSQL/PostGIS, relógio e gerador de identificador.
  • TorreLogistica.Api Borda HTTP e SignalR.
  • TorreLogistica.Workers Carga assíncrona: SLA, webhooks e limpeza de rastro vencido.
  • TorreLogistica.Simulator Cliente 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

  1. A entrega é criada, planejada e atribuída a um motorista.
  2. 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.
  3. 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.
  4. 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.
  5. Ocorrências entram como registros somente-inserção, com motivo tipado; falha de entrega vira tentativa frustrada e reagendamento.
  6. 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.