GetList

atenção

Gerado por Inteligência Artificial.

---

Visão Geral

Este método processa os filtros fornecidos em AnaliseVendaPlanoFiltroDto, executa consultas de venda de plano e retorna um objeto AnaliseVendaPlanoResultDto contendo os resultados formatados e truncados.

BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnaliseVendaPlanoBLL.cs

public async Task<AnaliseVendaPlanoResultDto> GetList(AnaliseVendaPlanoFiltroDto item) { ... }

Dependências Diretas

Método	Localização	Linha
DateTime.Equals(DateTime)	BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnaliseVendaPlanoBLL.cs	31
DateTime.Equals(DateTime)	BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnaliseVendaPlanoBLL.cs	34
DateTime.AddDays(double)	BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnaliseVendaPlanoBLL.cs	99
IDbConnection.QueryAsync<AnaliseVendaPlanoDto> (string, object, IDbTransaction, int?, CommandType?)	BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnaliseVendaPlanoBLL.cs	107
Calculadora.Truncar(decimal)	BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnaliseVendaPlanoBLL.cs (chama método definido em Util\Calculadora.cs)	127
Calculadora.Truncar(decimal)	BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnaliseVendaPlanoBLL.cs (chama método definido em Util\Calculadora.cs)	128
Calculadora.Truncar(decimal)	BOX3_ERP_API\BOX3_ERP_API.Core\BLL\AnaliseVendaPlanoBLL.cs (chama método definido em Util\Calculadora.cs)	129

---

Referências

Método / Endpoint	Localização	Linha
API_GetList([FromBody] AnaliseVendaPlanoFiltroDto)	BOX3_ERP_API\BOX3_ERP_API\Controllers\AnaliseVendaPlanoController.cs	34

---

Detalhamento das Referências

API_GetList

Este é o método do controller AnaliseVendaPlanoController decorado com [HttpPost("Listar")].
Ele expõe o endpoint REST que recebe o AnaliseVendaPlanoFiltroDto do cliente, invoca o BLL GetList para executar a lógica de consulta de vendas de plano e retorna um ActionResult<AnaliseVendaPlanoResultDto> ao consumidor da API.

---

Impacto de Alterações

• Mudanças na comparação e adição de datas (Equals, AddDays) podem alterar o intervalo de filtragem de vendas.
• Alterações na consulta Dapper (QueryAsync) afetam diretamente os dados retornados.
• Ajustes no método Calculadora.Truncar modificam como valores decimais são arredondados/truncados nos resultados.
• Qualquer alteração na assinatura ou no comportamento de GetList impacta o contrato do endpoint Listar.

---

Propagação de Mudanças

1. Atualizar testes unitários que cobrem cenários de filtro de datas e valores truncados.
2. Verificar o comportamento do endpoint API_GetList no controller após alterações no BLL.
3. Sincronizar mudanças com front-end ou serviços que consomem AnaliseVendaPlanoResultDto.
4. Atualizar documentação Swagger/OpenAPI para refletir alterações na assinatura ou no formato de retorno.

---

Requisitos para Alteração Segura

• Cobertura de testes para filtros de data no limite (datas iguais, nulas, intervalos longos).
• Validação de valores de entrada em AnaliseVendaPlanoFiltroDto.
• Verificação de performance da consulta SQL em cenários de alto volume de dados.
• Garantir tratamento de exceções e rollback em caso de falha na consulta ao banco.

---