Projeto de Validação de Senha

Esse projeto foi desenvolvimento na tecnologia .NET 5 para a validação de senha. Este projeto segue as seguintes regras para validação:

• Nove ou mais caracteres.
• Ao menos 1 dígito.
• Ao menos 1 letra minúscula.
• Ao menos 1 letra maiúscula.
• Ao menos 1 caractere especial.
• Considere como especial os seguintes caracteres: !@#$%^&*()-+.
• Não possuir caracteres repetidos dentro do conjunto.

As regras estão desacopladas e são validadas separadamente através do FluentValidation.

Segue abaixo o detalhamento das tecnologias, padrões de projetos e metodologias utilizadas:

Tecnologias Utilizadas:

• .NET 5.
• MongoDB.
• Swagger.
• JWT.
• MediatR.
• NUnit.
• Newtonsoft.Json.
• Docker (DockerFile e Docker-Compose).
• FluentValidation.
• Regex.
• Microsoft.AspNetCore.Mvc.Testing

Padrões de Projetos Utilizados:

• Generic Repository Pattern.
• Unit of Work Paterrn.
• Notification Pattern.
• Middleware Pattern.
• Singleton Pattern.
• Inversion of Control Pattern.
• Command Pattern.
• Dependency Injection Pattern.

Metodologias Utilizadas

• Clean Code.
• SOLID.
• TDD.
• Documentação de Classes.
• Principio do DDD (Insolamento do Dominio da Aplicação);

Arquitetura Utilizada: Clean Architecture:

• Independência de Framework.
• Independência de identidade.
• Independência de banco de dados.
• Independência de qualquer elemento externo.
• Ter uma maior estabilidade.

Outros Motivos de Decisão de Implementação:

• Alteração no retorno da API para ao invés de retornar apenas um verdadeiro/falso, a aplicação retornará as inconsistências das validações de senha e se a validação foi verdadeiro ou falso.
• Implementação de uma criptografia básica para ter uma maior segurança na transferência das senhas entre as camandas e a persistência ao banco.
• Decisão de utilizar o Mediatr para abstrair o projeto da API com o projeto da Application, tendo a abstração através da interface do MediatR.
• Utilização do Regex separadamente. Para ter uma maior entendimento e retornar as validações separadamente para os usuários.
• Implementação do repositório MongoDB. Mesmo que o escopo inicial não pedisse, tive a proatividade de mostrar mais da minha implementação.
• Implementação de alguns padrões de projetos normalmente utilizados e outros para demostrar o meu nivel de conhecimento.
• Utilização do Clean Code.
• Utilização da autenticação JWT básica para ter uma segurança maior na API.
• Utilização do CodeMaid para ordenar e adequar o código.
• Utilização do Insomnia e Postman para testar fora do swagger.
• Criação de pastas para facilitar o entendimento e separar cada responsabilidade com Helpers, Extensions, Interfaces, Context, Command, Query, Handler, Constantes, Enums, Validations, Exceptions, Middleware, filters, etc.
• Padronização das nomeclaturas de classes através de suas responsabilidades.
• Padronização de nome de metódos no verbo infinitivo.
• Responsabilidade unica de cada classe.
• Utilização do FluentValidation para as validações.
• Foi feito a gravação da senha descriptografada no banco mongodb apenas para validar se a senha está correta no mongodb.
• Utilização do SOLID.
• Criação do Docker-compose e o DockerFile do projeto (mesmo que o escopo inicial não estava incluído).
• Utilização de 53 testes unitários e integrados.
• Documentação de responsabilidades de classes.

Nota: Para cada classe existe uma documentação em cabeçalho explicando a sua responsabilidade. O intuito é para facilitar o entendimento das responsabilidades.

Diagrama Arquitetural do Projeto:

Execuções de testes:

Estrutura do Projeto:

📦src
 ┣ 📂Validacao.Senha.Application
 ┃ ┣ 📂Authorization
 ┃ ┃ ┗ 📜TokenAuthorization.cs
 ┃ ┣ 📂Base
 ┃ ┃ ┗ 📜BaseSenhaQueryCommand.cs
 ┃ ┣ 📂Command
 ┃ ┃ ┗ 📜GravarSenhaCommand.cs
 ┃ ┣ 📂Context
 ┃ ┃ ┗ 📜NotificacaoContext.cs
 ┃ ┣ 📂Handler
 ┃ ┃ ┣ 📜GerarTokenHandler.cs
 ┃ ┃ ┣ 📜GravarSenhaHandler.cs
 ┃ ┃ ┗ 📜ValidarSenhaHandler.cs
 ┃ ┣ 📂Interfaces
 ┃ ┃ ┣ 📜INotificacaoContext.cs
 ┃ ┃ ┗ 📜ITokenAuthorization.cs
 ┃ ┣ 📂Query
 ┃ ┃ ┣ 📜GerarTokenSenhaQuery.cs
 ┃ ┃ ┗ 📜ValidarSenhaQuery.cs
 ┃ ┣ 📜DependencyInjection.cs
 ┃ ┗ 📜Validacao.Senha.Application.csproj
 ┣ 📂Validacao.Senha.Domain
 ┃ ┣ 📂Constantes
 ┃ ┃ ┣ 📜MensagensConstantes.cs
 ┃ ┃ ┣ 📜RegexConstantes.cs
 ┃ ┃ ┗ 📜SenhaConstantes.cs
 ┃ ┣ 📂Entities
 ┃ ┃ ┣ 📜BaseAbstractEntity.cs
 ┃ ┃ ┣ 📜BaseEntity.cs
 ┃ ┃ ┣ 📜NotificacaoEntity.cs
 ┃ ┃ ┗ 📜SenhaEntity.cs
 ┃ ┣ 📂Enums
 ┃ ┃ ┣ 📜AcaoEncryptionEnum.cs
 ┃ ┃ ┣ 📜CodigoErrorValidacaoEnum.cs
 ┃ ┃ ┣ 📜CodigoSucessoValidacaoEnum.cs
 ┃ ┃ ┗ 📜RetornoEnum.cs
 ┃ ┣ 📂Exceptions
 ┃ ┃ ┣ 📜EncriptacaoPossuiEspacoException.cs
 ┃ ┃ ┗ 📜EnumDescricaoNuloReferenceException.cs
 ┃ ┣ 📂Extensions
 ┃ ┃ ┣ 📜EnumExtensions.cs
 ┃ ┃ ┣ 📜ObjetoExtensions.cs
 ┃ ┃ ┗ 📜StringExtensions.cs
 ┃ ┣ 📂Helpers
 ┃ ┃ ┣ 📜CriptografarHelper.cs
 ┃ ┃ ┣ 📜DescriptografarHelper.cs
 ┃ ┃ ┗ 📜ValidarSenhaHelper.cs
 ┃ ┣ 📂Validations
 ┃ ┃ ┗ 📜SenhaValidator.cs
 ┃ ┗ 📜Validacao.Senha.Domain.csproj
 ┣ 📂Validacao.Senha.Infrastructure
 ┃ ┣ 📂Context
 ┃ ┃ ┗ 📜MongoContext.cs
 ┃ ┣ 📂Interfaces
 ┃ ┃ ┣ 📜IMongoContext.cs
 ┃ ┃ ┣ 📜IRepository.cs
 ┃ ┃ ┣ 📜ISenhaRepository.cs
 ┃ ┃ ┗ 📜IUnitOfWork.cs
 ┃ ┣ 📂Mappings
 ┃ ┃ ┗ 📜SenhaMap.cs
 ┃ ┣ 📂Persistence
 ┃ ┃ ┗ 📜MongoDbPersistence.cs
 ┃ ┣ 📂Repositories
 ┃ ┃ ┣ 📜BaseRepository.cs
 ┃ ┃ ┗ 📜SenhaRepository.cs
 ┃ ┣ 📂UoW
 ┃ ┃ ┗ 📜UnitOfWork.cs
 ┃ ┣ 📜DependencyInjection.cs
 ┃ ┗ 📜Validacao.Senha.Infrastructure.csproj
 ┣ 📂Validacao.Senha.IntegrationTests
 ┃ ┣ 📂Controllers
 ┃ ┃ ┣ 📜GravarSenhaControllerTest.cs
 ┃ ┃ ┣ 📜TokenControllerTest.cs
 ┃ ┃ ┗ 📜ValidarControllerTest.cs
 ┃ ┣ 📜BaseTest.cs
 ┃ ┗ 📜Validacao.Senha.IntegrationTests.csproj
 ┣ 📂Validacao.Senha.UnitTests
 ┃ ┣ 📂Extensions
 ┃ ┃ ┣ 📜EnumExtensionsTest.cs
 ┃ ┃ ┣ 📜ObjectExtensionsTest.cs
 ┃ ┃ ┗ 📜StringExtensionsTest.cs
 ┃ ┣ 📂Helpers
 ┃ ┃ ┣ 📜CriptografarHelperTest.cs
 ┃ ┃ ┗ 📜DescriptografarHelperTest.cs
 ┃ ┣ 📂Validations
 ┃ ┃ ┗ 📜SenhaValidatorTest.cs
 ┃ ┣ 📜BaseTest.cs
 ┃ ┗ 📜Validacao.Senha.UnitTests.csproj
 ┣ 📂Validacao.Senha.Web
 ┃ ┣ 📂Controllers
 ┃ ┃ ┣ 📜BaseController.cs
 ┃ ┃ ┣ 📜GravarSenhaController.cs
 ┃ ┃ ┣ 📜TokenController.cs
 ┃ ┃ ┗ 📜ValidarController.cs
 ┃ ┣ 📂Filters
 ┃ ┃ ┗ 📜NotificacaoFilter.cs
 ┃ ┣ 📂Middleware
 ┃ ┃ ┗ 📜ErrorHandlerMiddleware.cs
 ┃ ┣ 📂Properties
 ┃ ┃ ┗ 📜launchSettings.json
 ┃ ┣ 📂ViewModel
 ┃ ┃ ┗ 📜RetornoViewModel.cs
 ┃ ┣ 📜appsettings.Development.json
 ┃ ┣ 📜appsettings.json
 ┃ ┣ 📜Dockerfile
 ┃ ┣ 📜Program.cs
 ┃ ┣ 📜Startup.cs
 ┃ ┣ 📜Validacao.Senha.Web.csproj
 ┃ ┣ 📜Validacao.Senha.Web.csproj.user
 ┃ ┗ 📜Validacao.Senha.Web.xml
 ┣ 📜ValidacaoSenha.sln
 ┗ 📜ValidacaoSenha.sln.DotSettings.user

Execução da Aplicação - Validação de Senha

1) Primeiramente, execute o docker-compose up -d para iniciar a instancia do MongoDB.

Nota: Essa etapa, é executada apenas caso queira testar a parte de gravação e executar os testes unitários.

2) Executar a aplicação Validacao.Senha.Web, por comando, dotnet run ou pelo visual studio ou code.
3) Após executar com sucesso, acessar a página do swagger, pela seguite url: http://localhost:9001/swagger

4) Após acessar, executar o endpoint Token/Get para a geração do Token JWT. Após fazer a geração do token copie o response, e ai cole no campo Authorize que fica no canto superior direito. Logo após colar, clique no botão Authorize.

5)Após ser autorizado na API de Validação de Senha, agora você pode utilizar o endpoint para validar sua senha. O endpoint é Validar/Post. Segue o contrato do endpoint:

 { 
   "Conteudo":"informar_senha"
 } 

Execução da Aplicação - Gravação de Senha

1) Primeiramente, execute o docker-compose up -d para iniciar a instancia do MongoDB.

Nota: Essa etapa, é executada apenas caso queira testar a parte de gravação e executar os testes unitários.

2) Executar a aplicação Validacao.Senha.Web, por comando, dotnet run ou pelo visual studio ou code.
3) Após executar com sucesso, acessar a página do swagger, pela seguite url: http://localhost:9001/swagger

4) Após acessar, executar o endpoint Token/Get para a geração do Token JWT. Após fazer a geração do token copie o response, e ai cole no campo Authorize que fica no canto superior direito. Logo após colar, clique no botão Authorize.

5)Após ser autorizado na API de Validação de Senha, agora você pode utilizar o endpoint para validar sua senha. O endpoint é GravarSenha/Post. Segue o contrato do endpoint:

 { 
   "Conteudo":"informar_senha"
 }