Pular para o conteúdo principal

MetaValorArrecadadoMeta

atenção

Gerado por Inteligência Artificial.

Visão Geral​

Este método calcula o valor arrecadado por colaborador para um conjunto de IDs num período definido por dataInicio e dataFim, retornando um RelatorioGraficoBarraModel com os valores agregados.

BOX3_ERP_API\BOX3_ERP_API.Core\BLL\Relatorio\ArrecadacaoMensalColaboradorBLL.cs
public RelatorioGraficoBarraModel MetaValorArrecadadoMeta(List<int> arrecadadorId, DateTime dataInicio, DateTime dataFim) { ... }

Dependências Diretas​

MétodoLocalizaçãoLinha
List<int>.Contains(int)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\Relatorio\ArrecadacaoMensalColaboradorBLL.cs571
List<int>.Contains(int)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\Relatorio\ArrecadacaoMensalColaboradorBLL.cs604
ConfiguracaoBLL.GetItem(bool)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\Relatorio\ArrecadacaoMensalColaboradorBLL.cs623

Referências​

Método / EndpointLocalizaçãoLinha
MetaAcompanhamentoRepository.GetList(FiltroMetaAcompanhamentoDto, DadosToken, IDreExtratoRepository)BOX3_ERP_API\BOX3_ERP_API.Core\Repositories\Implementations\MetaAcompanhamentoRepository.cs421

Detalhamento das Referências​

MetaAcompanhamentoRepository.GetList​

Método do repositório MetaAcompanhamentoRepository que retorna as metas por categoria para os arrecadadores no período especificado.
O resultado é usado por MetaValorArrecadadoMeta para determinar quais valores devem ser agregados no gráfico.

Impacto de Alterações​

  • Alterações na lógica de filtragem (Contains) podem modificar quais IDs de arrecadador são considerados.
  • Mudanças em GetItem podem alterar a configuração padrão usada como fallback de data.
  • Ajustes na construção do RelatorioGraficoBarraModel impactam a apresentação dos dados.

Propagação de Mudanças​

  1. Atualizar testes unitários para cenários com múltiplos IDs e diferentes faixas de data (início/fim).
  2. Verificar compatibilidade com o repositório MetaAcompanhamentoRepository e seu endpoint API_GetList.
  3. Sincronizar mudanças com gráficos no front-end ou relatórios agendados que consumam este método.
  4. Atualizar documentação Swagger/OpenAPI para refletir alterações na assinatura ou no modelo de retorno.

Requisitos para Alteração Segura​

  • Cobertura de testes para listas vazias, listas com múltiplos IDs, e períodos inválidos (dataInicio > dataFim).
  • Validação de parâmetros de entrada na camada de BLL.
  • Tratamento de exceções para períodos sem registros ou dados inconsistentes.
  • Verificação de performance ao agregar grandes volumes de dados.