Pular para o conteúdo principal

HorarioTranslado

atenção

Gerado por Inteligência Artificial.

Visão Geral​

Este método processa e analisa os horários de translado com base nos parâmetros fornecidos em FiltroGeralDto, retornando um objeto ResultGeralDto contendo os resultados agregados de itens gerais e estatísticas de horário de pico de translado.

BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnaliseHorarioPicoBLL.cs
public async Task<ResultGeralDto> HorarioTranslado(FiltroGeralDto model) { ... }

Dependências Diretas​

MétodoLocalizaçãoLinha
DateTime.Equals(DateTime)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnaliseHorarioPicoBLL.cs871
DateTime.Equals(DateTime)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnaliseHorarioPicoBLL.cs874
DateTime.AddMilliseconds(double)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnaliseHorarioPicoBLL.cs897
DateTime.AddDays(double)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnaliseHorarioPicoBLL.cs897
IDbConnection.QueryAsync<BOX3_ERP_API.Core.DTOs.AnaliseHorarioPico.ItemGeralDto>(string, object, IDbTransaction, int?, CommandType?)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnaliseHorarioPicoBLL.cs901

Referências​

Método / EndpointLocalizaçãoLinha
API_HorarioTranslado(FiltroGeralDto)BOX3_ERP_API\BOX3_ERP_API.Controllers\AnaliseHorarioPicoController.cs526

Detalhamento das Referências​

API_HorarioTranslado​

Este é o método do controller AnaliseHorarioPicoController decorado com [HttpPost("Translado")].
Ele expõe o endpoint REST que recebe o FiltroGeralDto do cliente, invoca o método BLL HorarioTranslado para executar a lógica de análise de horário de pico de translado e retorna o ActionResult apropriado ao consumidor da API.

Impacto de Alterações​

  • Modificações na lógica de comparação ou cálculo de datas podem alterar a determinação dos horários de translado.
  • Alterações no mapeamento de ItemGeralDto ou parâmetros da consulta Dapper (QueryAsync) impactam diretamente os resultados retornados.
  • Qualquer mudança na assinatura ou comportamento do método afeta o endpoint Translado na API.

Propagação de Mudanças​

  1. Atualizar testes unitários e de integração que cobrem cenários de translado.
  2. Verificar o comportamento do endpoint API_HorarioTranslado no controller após a alteração.
  3. Sincronizar alterações com front-end ou consumidores externos que utilizem o ResultGeralDto.
  4. Revisar documentação de API (Swagger/OpenAPI) para refletir alterações na assinatura ou no contrato de resposta.

Requisitos para Alteração Segura​

  • Garantir cobertura de testes para cenários de datas iguais, datas nulas e limites de filtro em FiltroGeralDto.
  • Validar corretamente fusos horários e consistência de localidade no tratamento de DateTime.
  • Revisar performance da consulta SQL executada via QueryAsync.
  • Assegurar rollback de transação e tratamento de exceções em caso de falhas de acesso ao banco.