diagrama de m\u00e1quina de estados UML<\/strong> <\/a>(tamb\u00e9m chamado de diagrama de estado). O diagrama captura o ciclo de vida do sistema, pontos de decis\u00e3o e respostas a eventos como leituras de umidade, tempos esgotados e interven\u00e7\u00f5es do usu\u00e1rio.<\/p>\nO projeto utiliza a sintaxe PlantUML<\/strong> sintaxe, semelhante ao exemplo da cafeteria fornecido, que modela elegantemente estados compostos, guardas, a\u00e7\u00f5es e caminhos de erro\/recupera\u00e7\u00e3o.<\/p>\n2. Declara\u00e7\u00e3o do Problema e Requisitos<\/h2>\n
Um controlador de irriga\u00e7\u00e3o automatizado para um jardim dom\u00e9stico ou pequeno estufa deve:<\/p>\n
![\"\"](\"https:\/\/www.go2posts.com\/wp-content\/uploads\/2026\/02\/img_69804ee2a3cd2.png\")
<\/p>\n
\n- Iniciar em um modo de baixo consumo de energia Standby<\/strong> a maioria do tempo.<\/li>\n
- Acordar periodicamente de acordo com um cronograma<\/strong> (disparador de temporizador) para verificar as condi\u00e7\u00f5es.<\/li>\n
- Entrar em um estado de Sensing<\/strong> para ler o n\u00edvel de umidade do solo (por meio de um sensor capacitivo ou resistivo).<\/li>\n
- Se a umidade < 30%<\/strong> (limiar seco configur\u00e1vel), iniciar Irrigando<\/strong> abrindo uma v\u00e1lvula solen\u00f3ide ou ativando uma bomba.<\/li>\n
- Se a umidade \u2265 30%<\/strong>, retornar para Aguardando<\/strong> (n\u00e3o \u00e9 necess\u00e1rio regar).<\/li>\n
- Enquanto Regando<\/strong>, monitore continuamente (ou periodicamente) a umidade.<\/li>\n
- Pare de regar e feche a v\u00e1lvula quando:\n
\n- A umidade atinge 80%<\/strong> (limiar de umidade ajust\u00e1vel) \u2192 meta alcan\u00e7ada.<\/li>\n
- Um Tempo limite de seguran\u00e7a<\/strong> expira (por exemplo, 30 minutos) \u2192 evita inunda\u00e7\u00e3o, estouro de tubos ou problemas el\u00e9tricos se o sensor falhar.<\/li>\n<\/ul>\n<\/li>\n
- Ap\u00f3s parar a irriga\u00e7\u00e3o, v\u00e1 para o estado Desligamento<\/strong>.<\/li>\n
- Em Desligamento<\/strong>, aguarde confirma\u00e7\u00e3o manual<\/strong> (press\u00e3o de bot\u00e3o ou comando do aplicativo) antes de retornar ao Aguardando<\/strong> \u2014 isso permite que o usu\u00e1rio inspecione o sistema ou anule a a\u00e7\u00e3o, se necess\u00e1rio.<\/li>\n
- Trate falhas com eleg\u00e2ncia (por exemplo, falha no sensor, v\u00e1lvula travada) passando para um estado Erro<\/strong> com op\u00e7\u00f5es de recupera\u00e7\u00e3o.<\/li>\n<\/ul>\n
Comportamentos desej\u00e1veis adicionais (mantidos simples aqui):<\/p>\n
\n- Nenhuma irriga\u00e7\u00e3o durante certas horas (gerenciada por cronograma\/temporizador).<\/li>\n
- Registro ou notifica\u00e7\u00f5es est\u00e3o fora do escopo desta m\u00e1quina de estados principal.<\/li>\n<\/ul>\n
3. Conceitos principais da m\u00e1quina de estados utilizados<\/h2>\n\n- Estados<\/strong>: Ocioso\/Standby, Sensando, Irrigando, Desligando, Erro.<\/li>\n
- Estado composto<\/strong>: Irrigando inclui l\u00f3gica de monitoramento interna (embora mantida plana aqui para simplifica\u00e7\u00e3o).<\/li>\n
- Transi\u00e7\u00f5es<\/strong>:\n
\n- Disparado por eventos (temporizador, leitura de umidade, tempo limite).<\/li>\n
- Protegido por condi\u00e7\u00f5es [umidade < 30%], [umidade >= 80%].<\/li>\n<\/ul>\n<\/li>\n
- A\u00e7\u00f5es<\/strong>: \/abrir_valvula(), \/fechar_valvula(), \/notificar_usuario(), etc.<\/li>\n
- Pseudostados iniciais\/finais<\/strong>: [*] para in\u00edcio\/fim.<\/li>\n
- Transi\u00e7\u00f5es auto<\/strong> e loops de recupera\u00e7\u00e3o.<\/li>\n<\/ul>\n
4. Diagrama de Estados em PlantUML<\/h2>\n
Abaixo est\u00e1 o c\u00f3digo completo em PlantUML que implementa o comportamento descrito. Ele segue as conven\u00e7\u00f5es do exemplo da cafeteria (estilo skinparam, estados compostos quando apropriado, guardas em [], a\u00e7\u00f5es com \/).<\/p>\n