SistemaWebBasicoDeGestaoDeClientes

Sobre o Projeto

Este projeto foi desenvolvido como resolução de um desafio técnico focado em arquitetura e boas práticas. O objetivo é um sistema web de gestão de clientes (CRUD completo) com uma restrição arquitetural estrita: o front-end não pode acessar o banco de dados diretamente.

Toda a comunicação flui através de uma API intermediária, e o acesso aos dados ocorre exclusivamente via Stored Procedures, garantindo segurança e performance.

Arquitetura e Tecnologias

A aplicação foi dividida em três camadas:

1. Aplicação (Front-end): Desenvolvida em C# ASP.NET Core (Razor Pages) com Bootstrap 5. Responsável apenas pela interface e por consumir os endpoints via HttpClient.
2. API (Back-end): Desenvolvida em ASP.NET Core Web API. Centraliza as regras de negócio (como cálculo de validação matemática de CPF) e o tratamento de exceções.
3. Banco de Dados: SQL Server. Estruturado com tabelas relacionais (Integridade Referencial via Foreign Keys, Constraints e Unique) e manipulação de dados feita 100% via Stored Procedures.

Decisão Técnica: Por que o Dapper?

Para fazer a ponte entre a API e o SQL Server, optei pelo Dapper (Micro-ORM). Como o escopo do projeto exigia o uso exclusivo de Stored Procedures, o Dapper se mostrou a ferramenta mais limpa e performática para mapear os retornos do banco diretamente para os objetos em C#, evitando a sobrecarga de frameworks mais pesados (como o Entity Framework).

Funcionalidades e Regras de Negócio

• CRUD Completo: Inclusão, listagem, edição e exclusão de clientes.
• Camadas de Segurança (Trava Dupla): O CPF é validado matematicamente na camada de Service da API e possui restrição UNIQUE e IF EXISTS diretamente no Banco de Dados.
• Tratamento de Exceções: Retornos HTTP adequados (400 Bad Request, 404 Not Found, 201 Created) garantindo que falhas de regras de negócio não exponham a infraestrutura do servidor (Erro 500).

Como Executar o Projeto

Pré-requisitos

• SQL Server 2022 (Developer ou Express) instalado e rodando
• Visual Studio 2022 com "ASP.NET e desenvolvimento web"
• .NET 10.0 SDK

1. Banco de Dados

1. Abra o SQL Server Management Studio (SSMS) e conecte na sua instância local.
2. Execute o script script_completo.sql (pasta BancoDB do repositório). Ele cria o banco FacilAssistDB, as tabelas e cria as 6 Procedures.
3. Confirme que funcionou executando o seguinte comando no SSMS:

   USE FacilAssistDB;
   SELECT * FROM SituacaoCliente;

Deve retornar 3 registros (Ativo, Inativo, Bloqueado).

2. Configurar a Connection String da API

Abra FacilAssistTestAPI/appsettings.json. Você precisa ajustar a DefaultConnection de acordo com o nome da sua instância do SQL Server, que pode variar entre computadores.

Como descobrir o nome da sua instância: abra o SSMS — o nome que você usa pra conectar (campo "Nome do servidor") é exatamente o que vai no Server=.

3. Configurar a comunicação Site → API

Descubra a porta real da API

Abra FacilAssistTestAPI/Properties/launchSettings.json e localize o campo applicationUrl dentro do perfil https. Algo como:

"applicationUrl": "https://localhost:7149;http://localhost:5080"

A porta que interessa é a https (no exemplo, 7149). Ela pode ser diferente na sua máquina.

Aponte o Site para essa porta

Abra FacilAssistTestAPI.Site/appsettings.json e ajuste:

"ApiSettings": {
  "BaseUrl": "https://localhost:7149/"
}

Substitua 7149 pela porta que você encontrou Sem essa barra / no final da URL, as chamadas do HttpClient falham silenciosamente.

Confirme que não há conflito de porta

Se ao rodar a solução aparecer erro de "endereço já em uso", outro processo já está usando aquela porta. Feche outras instâncias do Visual Studio/IIS Express rodando em segundo plano, ou altere a porta manualmente no launchSettings.json da API (e repita o processo)

4. Rodando a Solução

1. Abra o arquivo .sln no Visual Studio 2022.
2. Botão direito na Solução (não no projeto) → Configurar Projetos de Inicialização → Vários projetos de inicialização → marque Iniciar para FacilAssistTestAPI e FacilAssistTestAPI.Site.
3. Pressione F5.
4. Devem abrir duas abas do navegador: uma com o Swagger da API (https://localhost:XXXX/swagger) e outra com a tela de listagem de clientes do Site.

5. Se a listagem de clientes aparecer vazia ou der erro de conexão

Nessa ordem, verifique:

1. A API está rodando e o Swagger responde GET /api/clientes corretamente? (teste a API isolada primeiro, antes do Site)
2. A porta no appsettings.json do Site é exatamente a mesma do launchSettings.json da API (passo 3)?
3. O SQL Server está rodando (verifique no "Serviços" do Windows: SQL Server (MSSQLSERVER) ou SQL Server (SQLEXPRESS))?
4. A connection string do passo 2 bate com o cenário real da sua instância?