📊 Cap 06: Sequência e Estados em Mermaid

Docs-as-Code • Comunicação Temporal e Ciclos de Vida

🗺️ O Poder de Expressar Sequência Temporal em Texto

sequenceDiagram
    autonumber
    actor Dev as Desenvolvedor
    participant Git as Repositório Git
    participant CI as Pipeline GitHub Actions
    participant Prod as Servidor Produção

    Dev->>Git: git push origin main
    Git->>CI: Webhook disparado
    CI->>CI: Roda testes automatizados
    CI->>Prod: Deploy automático com zero-downtime ⚡

🎯 Slide 1: Elementos-Chave de Diagramas de Sequência

• actor vs participant: Representação de humanos vs serviços.

• Tipos de Setas:
  • ->>: Mensagem síncrona com ponta cheia.
  • -->>: Resposta síncrona pontilhada.
  • -): Mensagem assíncrona (fire-and-forget).

🎯 Slide 2: Blocos de Controle: Loop, Alt e Par

• loop: Repetições condicionais (“A cada 5 segundos…“).

• alt / else: Bifurcações de sucesso ou falha (“Se saldo >= valor… Senão…“).

• par / and: Operações simultâneas em paralelo (“Busca cotação do dólar e euro ao mesmo tempo”).

🎯 Slide 3: Máquinas de Estados com stateDiagram-v2

• Modela transições finitas de estado de entidades de negócio:
  • [*] indica estado inicial e final.
  • Suporta estados compostos e aninhados.
  • Transições rotuladas com eventos: EstadoA --> EstadoB: EventoDisparador.