O Caso de Uso não responde tudo
Já sabemos que o Atendente usa o sistema para registrar a decisão do orçamento. Mas ainda podemos perguntar: quais passos acontecem por dentro? quem fala com quem? quais informações pertencem à ordem? como a ordem muda de situação?
UML: o nome da família de desenhos
UML vem de Unified Modeling Language, em português Linguagem de Modelagem Unificada.
Pense nela como uma caixa de ferramentas visuais. A gente não usa tudo. Escolhe somente o desenho que ajuda na pergunta daquele momento.
1. Como a funcionalidade acontece? — Diagrama de Atividades
Vamos pegar a decisão do orçamento. Primeiro o atendente localiza a ordem. Depois vê o orçamento. Em seguida registra a decisão. Se houver uma condição, o caminho pode mudar.
Isso já é quase um Diagrama de Atividades. Ele nos ajuda quando a pergunta é: “quais ações acontecem e onde o caminho muda?”
Começo
O círculo preenchido marca onde esse comportamento começa.
Ação
O retângulo arredondado mostra uma atividade.
Ponto de decisão
O losango mostra onde uma resposta pode mudar o caminho.
Perceba que você já conhecia a lógica do fluxograma. O desenho mudou um pouco, mas a pergunta continua sendo sobre o comportamento.
2. Quem troca mensagens com quem e em qual ordem? — Diagrama de Sequência
Agora imagine esta situação: o Atendente registra a aprovação. O sistema precisa verificar se o orçamento está pendente, alterar a situação da ordem e confirmar o registro.
A dúvida deixou de ser apenas “quais ações acontecem?”. Agora queremos ver quem envia cada solicitação e em que ordem.
| Ordem | Quem envia | Quem recebe | O que acontece |
|---|---|---|---|
| 1 | Atendente | Sistema | registrar decisão |
| 2 | Sistema | Orçamento | verificar situação pendente |
| 3 | Sistema | Ordem | alterar situação |
| 4 | Sistema | Atendente | confirmar registro |
Quando desenhamos isso, cada participante fica no topo e o tempo é lido de cima para baixo. A linha vertical abaixo dele é chamada de linha de vida; as setas horizontais representam mensagens ou solicitações.
Leia de cima para baixo
A primeira seta é o primeiro acontecimento. Depois desça. Assim você acompanha quem pediu o quê e quem respondeu.
3. Quais conceitos formam o negócio? — Modelo de Domínio
Agora troque a pergunta. Em vez de pensar em ações, pense nas coisas importantes que existem nesse atendimento: Cliente, Equipamento, Ordem de Serviço, Diagnóstico, Orçamento e Peça.
Esse conjunto de conceitos forma o domínio do problema — aqui, o universo da assistência técnica.
Comece com duas coisas que já conhecemos
Leia assim: cada Ordem pertence a um Cliente; um Cliente pode ter nenhuma, uma ou várias Ordens.
Os números ajudam a mostrar quantidade numa relação. Isso se chama cardinalidade:
- 1 = exatamente um;
- 0..1 = nenhum ou um;
- 0..* = nenhum, um ou muitos.
Quando essa pergunta aparece, o Modelo de Domínio ajuda a enxergar quais conceitos existem e como se relacionam.
| Conceito | Como ele aparece na história |
|---|---|
| Cliente | É a pessoa responsável pelo atendimento e pode ter várias ordens. |
| Equipamento | É o objeto que o cliente entrega para análise e reparo. |
| Ordem de Serviço | É o registro que acompanha aquele atendimento do começo ao fim. |
| Orçamento | Nasce da ordem e recebe a decisão do cliente. |
Com essas relações pequenas compreendidas, agora podemos olhar o modelo completo sem transformar caixas e linhas em símbolos soltos.
4. Como a Ordem muda durante sua vida? — Diagrama de Estados
O notebook de Ana não fica na mesma situação do começo ao fim. A ordem pode estar Aberta, depois Em diagnóstico, depois Aguardando aprovação, e assim por diante.
Essas situações relativamente estáveis são chamadas de estados.
Aberta → diagnóstico registrado → Aguardando aprovação
Leia como uma frase: a Ordem estava Aberta; aconteceu o registro do diagnóstico; por isso passou para Aguardando aprovação.
A mudança de um estado para outro é chamada de transição.
Se o orçamento for recusado ou o teste falhar, outros caminhos aparecem. É justamente por isso que esse desenho é útil.
Então qual diagrama eu uso?
Não escolha pelo nome mais técnico. Comece pela dúvida:
| O que você quer enxergar? | Desenho que pode ajudar |
|---|---|
| Quem usa o sistema e para qual objetivo? | Caso de Uso |
| Quais ações acontecem e onde o caminho muda? | Diagrama de Atividades |
| Quem envia mensagens para quem e em qual ordem? | Diagrama de Sequência |
| Quais conceitos existem e como se relacionam? | Modelo de Domínio |
| Como algo muda de situação ao longo do tempo? | Diagrama de Estados |
| Como setores diferentes colaboram num processo? | BPMN |
Faça agora
- Pegue uma dúvida da Conecta e diga primeiro o que você quer enxergar.
- Escolha um diagrama somente depois dessa pergunta.
- No Diagrama de Atividades, explique o que representa começo, ação e decisão usando o caso da aprovação.
- No Diagrama de Sequência, diga quem envia a primeira mensagem e quem recebe.
- No Modelo de Domínio, explique com suas palavras a relação Cliente — Ordem.
- No Diagrama de Estados, diga o que faz uma Ordem sair de “Aguardando aprovação”.
Um desenho para cada pergunta
Guarde somente os diagramas que realmente ajudaram a entender algo. Se você não consegue dizer qual pergunta um desenho respondeu, provavelmente ele não é necessário.
Checkpoint 5 — Você escolhe pelo problema, não pelo nome?
Diante de uma dúvida concreta da Conecta, você consegue dizer o que precisa enxergar e qual representação pode ajudar?
Os desenhos também podem revelar problemas antigos
Ao montar os estados da Ordem, podemos descobrir uma transição que não apareceu no BPMN. Ao montar o Modelo de Domínio, podemos perceber um conceito sem requisito claro. Quando isso acontecer, volte e corrija o entendimento anterior.