Neste post, vamos explorar a implementação da funcionalidade “Criar Usuário” em um sistema. Abordaremos as sub-histórias envolvidas, a abordagem adotada, a arquitetura e as tecnologias utilizadas. Além disso, apresentaremos estimativas de tempo para cada sub-história, proporcionando uma visão clara e estruturada do processo de desenvolvimento.

Arquitetura e Tecnologias Utilizadas

A arquitetura adotada segue o padrão de camadas, separando a lógica de negócios, a camada de acesso a dados e a camada de apresentação. As tecnologias utilizadas incluem:

• ASP.NET Core para o desenvolvimento da API.
• RazorLight para renderização de templates de email.
• SQL Server para armazenamento de dados.
• Dapper para acesso eficiente ao banco de dados.
• Dependency Injection para gestão de dependências.

Abordagem

A implementação da funcionalidade “Criar Usuário” foi dividida em várias sub-histórias, cada uma abordando uma parte específica do processo. Essa abordagem modular facilita o desenvolvimento, teste e manutenção do código, além de permitir uma distribuição eficiente das tarefas entre a equipe.

Sub-Histórias e Estimativas

1. Criação do Endpoint de API
   • Descrição: Implementar o endpoint de API para criar um novo usuário.
   • Tarefas:
     • Criar o controlador e a rota HTTP POST para criar usuários.
     • Definir o modelo de requisição UserCreateRequest.
     • Implementar validações iniciais no controlador.
   • Estimativa: 1 dia
2. Implementação do Serviço de Criação de Usuário
   • Descrição: Desenvolver o serviço que lida com a lógica de negócios para criar um usuário.
   • Tarefas:
     • Criar o método CreateUserAsync no serviço UserV2Service.
     • Implementar validações de negócio (ex: verificar se o email já existe).
     • Gerar uma senha automática e encriptá-la.
     • Chamar o repositório para inserir o usuário no banco de dados.
     • Enviar um email de boas-vindas ao novo usuário.
   • Estimativa: 2 dias
3. Implementação do Repositório de Usuário
   • Descrição: Desenvolver o repositório que interage com o banco de dados para criar o usuário.
   • Tarefas:
     • Criar o método CreateUserAsync no repositório UserRepository.
     • Implementar a chamada à stored procedure STPR_CoreAPI_Usuario_Insere.
     • Garantir que a stored procedure retorne o ID do novo usuário.
   • Estimativa: 1 dia
4. Criação da Stored Procedure no Banco de Dados
   • Descrição: Implementar a stored procedure que insere o usuário no banco de dados.
   • Tarefas:
     • Criar a stored procedure STPR_CoreAPI_Usuario_Insere.
     • Garantir que a stored procedure insira os dados corretamente e retorne o ID do novo usuário.
   • Estimativa: 0.5 dia
5. Serviço de Encriptação
   • Descrição: Implementar o serviço para encriptar e decriptar dados sensíveis.
   • Tarefas:
     • Criar o serviço de encriptação EncryptionService.
     • Implementar métodos para encriptar e decriptar senhas.
   • Estimativa: 1 dia
6. Serviço de Envio de Emails
   • Descrição: Desenvolver o serviço que envia emails de boas-vindas aos novos usuários.
   • Tarefas:
     • Configurar o serviço de email (EmailService).
     • Implementar o envio de emails com suporte a HTML.
     • Garantir que o serviço utilize templates para os emails.
   • Estimativa: 1.5 dias
7. Templates de Email
   • Descrição: Criar templates HTML para os emails de boas-vindas.
   • Tarefas:
     • Desenvolver templates HTML usando RazorLight.
     • Implementar a lógica de renderização de templates no RazorTemplateService.
     • Garantir que os templates tratem corretamente os caracteres especiais.
   • Estimativa: 1 dia
8. Configuração e Gestão de Dependências
   • Descrição: Configurar corretamente os serviços e as dependências no projeto.
   • Tarefas:
     • Configurar o arquivo appsettings.json para as configurações de email.
     • Registrar serviços e repositórios no Startup ou Program.
     • Garantir que todas as dependências estejam corretamente injetadas e configuradas.
   • Estimativa: 0.5 dia
9. Testes e Validações
   • Descrição: Realizar testes para garantir que todas as partes funcionem corretamente.
   • Tarefas:
     • Testar a criação de usuário via endpoint.
     • Testar o serviço de email para garantir que os emails HTML são enviados corretamente.
     • Verificar a encriptação e decriptação de senhas.
     • Testar a inserção no banco de dados através da stored procedure.
   • Estimativa: 2 dias

Conclusão

Ao dividir a funcionalidade “Criar Usuário” em sub-histórias menores e gerenciáveis, conseguimos abordar cada parte do processo de forma detalhada e organizada. Essa abordagem não só facilita o desenvolvimento e a manutenção do sistema, como também garante uma implementação robusta e eficiente.

O uso de tecnologias como ASP.NET Core, RazorLight, SQL Server e Dapper, combinado com práticas de injeção de dependências e arquitetura de camadas, assegura que o sistema seja escalável, seguro e fácil de gerenciar.

Estimativas realistas e uma boa divisão de tarefas são essenciais para o sucesso de qualquer projeto de software. Esperamos que este post tenha fornecido uma visão clara de como abordar a implementação de funcionalidades complexas de forma estruturada e eficiente.