Rotas

Secao 2

Entidade e Propriedades

Arquivo: cargo_fleet.Domain/Rotas/Rota.cs

Propriedade	Tipo	Descricao
`TenantId`	`Guid?`	Multitenancy
`Tipo`	`TipoRotaEnum`	Spot ou Contrato
`Operacao`	`TipoOperacaoEnum`	Tipo de operacao
`Carga`	`TipoCargaEnum`	Tipo de carga
`Veiculo`	`TipoVeiculoEnum`	Tipo de veiculo
`Origem`	`CidadesEnum?`	Enum de cidade de origem
`Destino`	`CidadesEnum?`	Enum de cidade de destino
`QuantidadeCarros`	`int`	Veiculos disponiveis para carga normal (decrementado a cada aceite)
`PeriodoInicial`	`DateTime`	Inicio da janela de validade
`PeriodoFinal`	`DateTime`	Fim da janela de validade
`Preco`	`decimal?`	Preco padrao
`PontoTNF`	`CidadesEnum?`	Cidade de troca de NF
`PrecoPerna1`	`decimal?`	Preco perna 1 (TNF)
`PrecoPerna2`	`decimal?`	Preco perna 2 (TNF)
`Status`	`StatusRotaEnum`	`Ativado` ou `Desativado`
`AceitaCargaAdicional`	`bool?`	Habilita aceite de carga adicional
`CargaAdicionalPeriodoInicio`	`DateTime?`	Inicio do periodo para carga adicional
`CargaAdicionalPeriodoFinal`	`DateTime?`	Fim do periodo para carga adicional
`CargaAdicionalQuantidadeVeiculos`	`int?`	Veiculos disponiveis para carga adicional
`AceitaTnf`	`bool?`	Aceita operacao TNF
`OrigemCidadeId`	`int?`	FK para tabela `Cidades`
`DestinoCidadeId`	`int?`	FK para tabela `Cidades`
`AbrangenciaOrigem`	`TipoAbrangenciaGeograficaEnum?`	Suporte futuro a regioes
`AbrangenciaDestino`	`TipoAbrangenciaGeograficaEnum?`	Suporte futuro a regioes

Verificacao de Rotas Expirando (VerificarRotasWorker)

Arquivo: cargo_fleet.HttpApi.Host/BackgroundJobs/VerificarRotasWorker.cs

Timer.Period = 1 dia (TimeSpan.FromDays(1).TotalMilliseconds).
Para cada tenant: busca rotas com PeriodoFinal entre hoje e amanha.
Para cada rota expirada: cria notificacao de alerta e faz dispatch via Firebase.
Fluxo por rota: 1 query de DeviceToken + 1 chamada Firebase por rota, sem rate limiting.

Contadores de Veiculos

Os contadores QuantidadeCarros e CargaAdicionalQuantidadeVeiculos sao gerenciados da seguinte forma:

Decremento: Ocorre em OfertasAceiteResultApplier.AplicarEfeitosAceite apos aceite bem-sucedido na API Galileu.

Restauracao: NAO existe logica de restauracao. Se uma oferta aceita for cancelada ou recusada pela Galileu (RECUSADO_APOS_ACEITE, CANCELADO), o contador permanece decrementado.

Risco de race condition: O decremento e feito em memoria (rota.QuantidadeCarros--) antes de persistir. Dois ciclos concorrentes podem ler o mesmo valor e ambos decrementar para o mesmo resultado, resultando em over-accept.

Incoerencias Identificadas

ID	Descricao
P-08	`QuantidadeCarros` e `CargaAdicionalQuantidadeVeiculos` nao restaurados em cancelamento
(escalabilidade)	Decremento nao atomico — race condition com over-accept

Secao 1Ofertas — Ciclo de Vida Completo Secao 3Integracao Galileu