Pular para o conteúdo principal

Detalhado

atenção

Gerado por Inteligência Artificial.

Visão Geral​

Este método processa e retorna dados detalhados de análise de plano com base nos filtros fornecidos em FiltrosListagemDetalhadoDto, produzindo um AnalisePlanoRetornoDto que contém tanto a lista de itens paginada quanto dados para gráficos.

BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnalisePlanoBLL.cs
public async Task<AnalisePlanoRetornoDto> Detalhado(FiltrosListagemDetalhadoDto filtros) { ... }

Dependências Diretas​

MétodoLocalizaçãoLinha
DTParameters.getSearchString()BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnalisePlanoBLL.cs27
IDbConnection.QueryAsync<BOX3_ERP_API.Core.DTOs.AnalisePlano.AnalisePlanoDto>(string, object, IDbTransaction, int?, CommandType?)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnalisePlanoBLL.cs95
DTParameters.MakeResponseList<BOX3_ERP_API.Core.DTOs.AnalisePlano.AnalisePlanoDto>(List<AnalisePlanoDto>, int?)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnalisePlanoBLL.cs96
IEnumerable<AnalisePlanoDto>.AsList<AnalisePlanoDto>()BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnalisePlanoBLL.cs96
IEnumerable<AnalisePlanoDto>.Max<AnalisePlanoDto>(Func<AnalisePlanoDto, int?>)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnalisePlanoBLL.cs196

Referências​

Método / EndpointLocalizaçãoLinha
Detalhado([FromBody] FiltrosListagemDetalhadoDto)BOX3_ERP_API\BOX3_ERP_API\Controllers\AnalisePlanoController.cs36

Detalhamento das Referências​

Detalhado​

Este é o método do controller AnalisePlanoController decorado com [HttpPost("Detalhado")].
Ele expõe o endpoint que recebe o FiltrosListagemDetalhadoDto no corpo da requisição, invoca o BLL Detalhado e retorna o AnalisePlanoRetornoDto ao consumidor da API.

Impacto de Alterações​

  • Alterações na construção da query ou no processamento de filtros podem afetar a paginação e os resultados retornados.
  • Mudanças na lógica de agrupamento e ordenação alteram os dados exibidos nos gráficos.
  • Modificações na assinatura do DTO de retorno impactam todos os consumidores que usam esta API.

Propagação de Mudanças​

  1. Atualizar testes unitários que verifiquem filtros, paginação e resultados de gráficos.
  2. Verificar o endpoint Detalhado no controller e no Swagger/OpenAPI.
  3. Sincronizar alterações com front-end ou serviços que consomem os dados de análise de plano.
  4. Atualizar documentação de API e exemplos de uso.

Requisitos para Alteração Segura​

  • Cobertura de testes para múltiplos cenários de filtro: vazio, valores extremos e combinação de parâmetros.
  • Validação de parâmetros de entrada no controller e no BLL.
  • Verificação de performance da query e resposta em cenários com grande volume de dados.
  • Tratamento de exceções e fallback para casos de erro no acesso ao banco.