proteje rotas com JwtAuthGuard e documenta endpoints com Swagger

src/auth/doc/doc.txt

@@ -0,0 +1,46 @@
+Controller
+  ↓ recebe LoginDto
+UsersService
+  ↓ monta o AuthenticateUserCommand
+AuthenticateUserService
+  ↓ executa regras de negócio
+UserRepository
+  ↓ executa query no banco
+Result<User>
+  ← resposta encapsulada
+
+
+1. LoginController
+Entrada da requisição HTTP (POST /auth/login)
+
+Recebe LoginDto com email e password
+
+Encaminha para o UsersService
+
+2. UsersService
+Cria e valida o comando AuthenticateUserCommand
+
+Chama o serviço de autenticação de domínio (AuthenticateUserService)
+
+3. AuthenticateUserService
+Lógica de negócio da autenticação:
+
+Busca usuário pelo e-mail
+
+Verifica se o usuário está ativo
+
+Valida a senha com hash
+
+Retorna Result<User>
+
+4. UserRepository
+Camada de persistência (interface com o banco de dados)
+
+Executa a query findByEmail(email: string)
+
+5. Result<T>
+Objeto genérico de retorno que encapsula:
+
+Sucesso (success = true, com data: User)
+
+Falha (success = false, com error: string)