118 lines
3.5 KiB
HTML
118 lines
3.5 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="pt-BR">
|
|
<head>
|
|
<meta charset="UTF-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
<title>Documentação - Fluxo de Login com Microserviço</title>
|
|
<style>
|
|
body {
|
|
font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
|
|
background-color: #f9f9f9;
|
|
color: #333;
|
|
line-height: 1.6;
|
|
padding: 2rem;
|
|
}
|
|
h1, h2, h3 {
|
|
color: #007acc;
|
|
}
|
|
code, pre {
|
|
background-color: #eee;
|
|
padding: 1rem;
|
|
border-radius: 4px;
|
|
display: block;
|
|
white-space: pre-wrap;
|
|
margin-bottom: 1rem;
|
|
}
|
|
table {
|
|
width: 100%;
|
|
border-collapse: collapse;
|
|
margin: 1rem 0;
|
|
}
|
|
th, td {
|
|
border: 1px solid #ddd;
|
|
padding: 0.75rem;
|
|
}
|
|
th {
|
|
background-color: #007acc;
|
|
color: white;
|
|
}
|
|
.tag {
|
|
display: inline-block;
|
|
background: #007acc;
|
|
color: white;
|
|
padding: 0.2rem 0.6rem;
|
|
border-radius: 4px;
|
|
font-size: 0.85rem;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<h1>🔐 Fluxo de Login com Microserviço - Portal Juru API</h1>
|
|
|
|
<h2>📌 Rota de Login</h2>
|
|
<p><strong>URL:</strong> <code>POST /api/v1/auth/login</code></p>
|
|
<p><strong>Descrição:</strong> Autentica o usuário via microserviço e retorna um token JWT.</p>
|
|
|
|
<h3>📤 Body (JSON)</h3>
|
|
<pre>{
|
|
"username": "joelson.r",
|
|
"password": "1010"
|
|
}</pre>
|
|
|
|
<h3>✅ Resposta (200 OK)</h3>
|
|
<pre>{
|
|
"id": 1498,
|
|
"sellerId": 2013,
|
|
"name": "JOELSON DE BRITO RIBEIRO",
|
|
"username": "JOELSON DE BRITO RIBEIRO",
|
|
"storeId": "4",
|
|
"email": "JOELSON.R@JURUNENSE.COM.BR",
|
|
"token": "eyJhbGciOiJIUzI1NiIsInR5..."
|
|
}</pre>
|
|
|
|
<h3>❌ Resposta (401 Unauthorized)</h3>
|
|
<pre>{
|
|
"success": false,
|
|
"message": "Usuário ou senha inválidos.",
|
|
"data": null,
|
|
"error": "Usuário ou senha inválidos."
|
|
}</pre>
|
|
|
|
<h2>🧱 Camadas e Responsabilidades (CQRS + Microservice)</h2>
|
|
<table>
|
|
<tr><th>Componente</th><th>Responsabilidade</th></tr>
|
|
<tr><td>AuthController</td><td>Recebe requisição HTTP e envia AuthenticateUserCommand ao CommandBus</td></tr>
|
|
<tr><td>AuthenticateUserCommand</td><td>Representa a intenção de autenticar um usuário</td></tr>
|
|
<tr><td>AuthenticateUserHandler</td><td>Executa regras de autenticação com base no comando</td></tr>
|
|
<tr><td>UserRepository</td><td>Consulta o banco para obter dados do usuário</td></tr>
|
|
<tr><td>Result<T></td><td>Encapsula sucesso ou falha com mensagens claras</td></tr>
|
|
<tr><td>AuthService</td><td>Gera token JWT e/ou Refresh Token</td></tr>
|
|
<tr><td>Auth Microservice</td><td>Escuta o evento 'auth.login' e executa a autenticação</td></tr>
|
|
<tr><td>ClientProxy</td><td>Faz chamada ao microserviço de autenticação</td></tr>
|
|
</table>
|
|
|
|
<h2>🔗 Comunicação via Microserviço</h2>
|
|
<ul>
|
|
<li><strong>Protocolo:</strong> TCP</li>
|
|
<li><strong>Evento:</strong> <code>auth.login</code></li>
|
|
<li><strong>Porta:</strong> 3001</li>
|
|
<li><strong>Formato:</strong> <code>{ username, password }</code></li>
|
|
<li><strong>Resposta:</strong> <code>Result<User></code></li>
|
|
</ul>
|
|
|
|
<h2>🛡️ Proteção com JWT</h2>
|
|
<p>Após o login, o token JWT é retornado e deve ser enviado em todas as requisições protegidas.</p>
|
|
<code>Authorization: Bearer <token></code>
|
|
|
|
<h2>🚀 Melhorias Futuras</h2>
|
|
<ul>
|
|
<li>[ ] Blacklist de tokens</li>
|
|
<li>[ ] Refresh Token</li>
|
|
<li>[ ] Log de auditoria</li>
|
|
<li>[ ] Controle de permissões e roles</li>
|
|
</ul>
|
|
|
|
<p><strong>Última atualização:</strong> 31/03/2025</p>
|
|
</body>
|
|
</html>
|