Pular para o conteúdo principal

MetaValorArrecadado

atenção

Gerado por Inteligência Artificial.

Visão Geral​

Este método gera os dados de valor arrecadado por colaborador para exibição em gráfico de barras, filtrando pelo arrecadadorId e opcionalmente por mês e ano, retornando um RelatorioGraficoBarraModel com os valores agregados.

BOX3_ERP_API\BOX3_ERP_API.Core\BLL\Relatorio\ArrecadacaoMensalColaboradorBLL.cs
public RelatorioGraficoBarraModel MetaValorArrecadado(int arrecadadorId, int? mes = null, int? ano = null) { ... }

Dependências Diretas​

MétodoLocalizaçãoLinha
List<int>.AddRange(IEnumerable<int>)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\Relatorio\ArrecadacaoMensalColaboradorBLL.cs42
List<int>.Contains(int)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\Relatorio\ArrecadacaoMensalColaboradorBLL.cs48
ConfiguracaoBLL.GetItem(bool)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\Relatorio\ArrecadacaoMensalColaboradorBLL.cs63

Referências​

Método / EndpointLocalizaçãoLinha
API_ArrecadacaoMes(int)BOX3_ERP_API\BOX3_ERP_API\Controllers\Mobile\CobrancasController.cs354
API_RelatorioArrecadaçãoMensalGrafico(FiltroRelatorioArrecadacaoMensalModel)BOX3_ERP_API\BOX3_ERP_API\Controllers\ColaboradorController.cs1517

Detalhamento das Referências​

API_ArrecadacaoMes​

Método do controller CobrancasController decorado com [HttpGet("arrecadacaoMes/{arrecadadorId}")].
Recebe o arrecadadorId como parâmetro de rota, invoca MetaValorArrecadado no BLL e retorna os dados de gráfico de barras.

API_RelatorioArrecadaçãoMensalGrafico​

Método do controller ColaboradorController decorado com [HttpPost("relatorioArrecadacaoMensalGrafico")].
Recebe um FiltroRelatorioArrecadacaoMensalModel no corpo da requisição, chama MetaValorArrecadado no BLL e retorna um ItemGraficoArrecadadoresModel com os valores prontos para exibição.

Impacto de Alterações​

  • Modificações em AddRange ou Contains podem alterar os meses considerados no gráfico.
  • Mudanças em ConfiguracaoBLL.GetItem afetam valores padrão de mês/ano quando não informados.
  • Alterações na assinatura ou comportamento de MetaValorArrecadado impactam diretamente os endpoints acima.

Propagação de Mudanças​

  1. Atualizar testes unitários que cobrem combinações de arrecadadorId, mês e ano.
  2. Verificar o comportamento de API_ArrecadacaoMes e API_RelatorioArrecadaçãoMensalGrafico após alterações.
  3. Sincronizar mudanças com front-end móvel e web que consomem esses endpoints.
  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 cenários com e sem filtro de mês/ano, e para casos extremos (mês ou ano nulos).
  • Validação de parâmetros de entrada em controller e BLL.
  • Verificação de performance ao agregar grandes volumes de dados.
  • Tratamento de exceções e fallback se não houver registros para o período solicitado.