Pular para o conteúdo principal

Adicionar

atenção

Gerado por Inteligência Artificial.

Visão Geral​

Este método adiciona de forma assíncrona uma nova entidade Banco ao sistema. Antes de inserir, valida se já não existe repetição e, em seguida, persiste o registro usando o contexto de dados.

BOX3_ERP_API\BOX3_ERP_API.Core\BLL\BancoBLL.cs
public async Task<Banco> Adicionar(Banco item, DadosToken dadosToken) { ... }

Dependências Diretas​

MétodoLocalizaçãoLinha
GetItem(int)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\BancoBLL.cs86
ValidaRepeticao(Banco)BOX3_ERP_API\BOX3_ERP_API.Core\BLL\BancoBLL.cs97

Referências​

Método / EndpointLocalizaçãoLinha
API_Adicionar(Banco)BOX3_ERP_API\BOX3_ERP_API\Controllers\BancoController.cs77

Detalhamento das Referências​

API_Adicionar​

Este método do controller BancoController expõe o endpoint para criação de banco:

[HttpPost]
public async Task<ActionResult<Banco>> API_Adicionar(Banco banco) { ... }

Ele recebe no corpo da requisição um objeto Banco, invoca o BLL Adicionar, e retorna o registro criado ou erro em caso de falha.

Impacto de Alterações​

  • Mudanças na assinatura (tipo de retorno ou parâmetros) exigem atualização do endpoint e de clientes que consomem a API.
  • Alterações na lógica de validação podem permitir duplicações ou rejeitar inserções válidas.

Propagação de Mudanças​

  1. Atualizar testes unitários para cenários de inserção bem-sucedida e tentativa de duplicação.
  2. Verificar o comportamento do endpoint API_Adicionar em todas as integrações.
  3. Sincronizar alterações com documentação Swagger/OpenAPI e comunicá-las aos consumidores da API.
  4. Revisar scripts de migração ou seed data que dependam deste fluxo de inserção.

Requisitos para Alteração Segura​

  • Cobertura de testes para:
    • Inserção de registro único.
    • Tentativa de inserir registro existente (retornar erro apropriado).
  • Validação de dados de entrada no controller (campos obrigatórios, formatos válidos).
  • Tratamento de exceções e retorno de status HTTP adequados (400 para dados inválidos, 409 para conflito, 500 para erros internos).