🔄 Atividade 12: Diagrama de Transição de Estados (UML)

🎯 Objetivo da Aula

Ao final desta atividade, você será capaz de:

• Identificar entidades de negócio com ciclos de vida complexos.
• Modelar os Estados estáveis de um objeto no sistema.
• Mapear Eventos Gatilho (Triggers) que provocam a transição entre estados.
• Aplicar Condições de Guarda (Guards) para proteção lógica contra transições inválidas.

🏢 O Cenário Prático (Seu Desafio)

Na TecProExpress, tivemos um incidente grave de banco de dados: um cliente de suporte ligou reclamando que a sua entrega apareceu no sistema como "Entregue com Sucesso", mas o motorista ainda nem havia saído com o caminhão do centro de distribuição!

Ao analisar o código, a equipe técnica descobriu que não havia validação de regras de negócios. Um motorista distraído clicou no botão "Confirmar Entrega" na tela errada de um pacote que ainda estava no estado de triagem físico!

"Seu desafio como Arquiteto de Software é desenhar o Diagrama de Máquina de Estados para a entidade Entrega. Você deve blindar o sistema, definindo as regras exatas de como um pacote muda de estado (ex: de Pendente para Em Rota) e quais validações (guardas) impedem que um pacote seja marcado como Entregue antes de ser despachado."

🧠 Fundamentos: A Teoria Traduzida

Enquanto o Diagrama de Atividades mostra o fluxo das ações de um processo, o Diagrama de Máquina de Estados foca em um único objeto do início ao fim da sua existência.

Elementos Chave:

1. Estado Inicial (Círculo Preto): O ponto de criação do objeto.
2. Estado (Retângulo Arredondado): Uma condição estável na vida do objeto onde ele aguarda um evento (Ex: PENDENTE, EM_ROTA, ENTREGUE).
3. Transição (Seta Direcionada): A mudança de um estado para o outro.
4. Evento Gatilho (Trigger): A ação que dispara a transição (Ex: despacharPacote()).
5. Condição de Guarda (Guard - entre colchetes [...]): Uma regra que precisa ser verdadeira para a transição acontecer. (Ex: [motorista_no_local == true]).

📊 Visualizando a Lógica

📖 Exemplo Guiado

Abaixo, veja o mapeamento de transição para o ciclo de vida do pacote da TecProExpress.

🛠️ Regra UML em Sintaxe Padrão:

A sintaxe formal gravada na seta da transição segue o padrão: Evento [Guarda] / Ação executada

• Exemplo: confirmarEntrega [comprovanteAnexado] / notificarCliente()

🔍 Detalhamento do Processo:

• Note a guarda [gps_ok == true]. Se o aplicativo do motorista não coletar a coordenada geográfica a menos de 100 metros da casa do cliente, o sistema bloqueia a mudança para o estado Entregue, evitando fraudes ou cliques acidentais!

🛠️ Prática Obrigatória 1: A Máquina de Estados

Cenário: O projeto semestral da sua equipe.

1. Selecione a entidade mais crítica do seu sistema que possui vários status (Ex: Pedido em um e-commerce, Agendamento em uma clínica, Vaga em um estacionamento).
2. Mapeie pelo menos 4 estados distintos para essa entidade.
3. Defina claramente os Eventos Gatilho em cada seta de transição.
4. Adicione pelo menos 2 Condições de Guarda entre colchetes [...] para blindar transições perigosas.

🏁 Resultado Esperado (Para sua Referência)

Uma imagem (PNG/JPG) do diagrama de máquina de estados UML modelado de forma organizada, exibindo a trajetória completa da entidade do estado inicial ao final.

🛠️ Prática Obrigatória 2: Tabela de Transições Lógicas

Cenário: Detalhamento da lógica de negócios.

1. Crie uma tabela com 4 colunas: Estado Origem, Evento Gatilho, Condição de Guarda e Estado Destino.
2. Preencha as linhas detalhando as regras lógicas que você desenhou no diagrama da Prática 1.

📤 Instruções de Entrega (Microsoft Teams)

Após validar suas documentações técnicas de estados:

1. Salve o arquivo de tabela com o nome Atividade_12.md e a imagem do seu diagrama com o nome Atividade_12.png na pasta es-atv-12-estados/ do seu repositório GitHub.
2. Certifique-se de fazer o commit e push para o repositório público.
3. Submeta o link do seu repositório no Microsoft Teams para avaliação do professor.

💡 Checkpoint de Lógica

📊 Rubrica Formativa de Avaliação