⏳ Fluxo Temporal (Diagrama de Sequência)
O Diagrama de Sequência foca na ordem temporal das mensagens trocadas entre objetos para realizar um processo específico do negócio ou uma requisição de API.
🏗️ Elementos da Linha de Tempo
| Elemento | Papel na Explicação Técnica |
|---|---|
| 🎭 Ator e Objetos | Representam os participantes da interação (Usuário, Controller, Service, Database). |
| ⏳ Linhas de Vida | Linhas pontilhadas verticais que indicam o tempo de existência do elemento no fluxo. |
| ➡️ Mensagens | Setas (Calls/Returns) que indicam a chamada de métodos ou retornos de dados (JSON). |
| ⚖️ Foco de Controle | Retângulos sobre a linha de vida que indicam que o objeto está executando uma lógica naquele instante. |
🏗️ Exemplo Prático: Fluxo de Autenticação
Representação do fluxo de requisição entre o Front-end e o Back-end para validar um acesso.
sequenceDiagram
actor U as Usuário App
participant API as Gateway/Controller
participant S as AuthService
U->>+API: 1: POST /login (payload)
API->>+S: 1.1: validateCredentials()
Note right of S: Consultando Hash no Banco...
S-->>-API: 1.2: Token JWT Gerado
API-->>-U: 2: 200 OK (JWT)
[!TIP] 💡 A Importância do detalhe: Cada caso de uso (Unidade III) é detalhado por diagramas de sequência. Isso permite que o Arquiteto preveja gargalos de performance antes mesmo de escrever a primeira Rota.