Testes Funcionais Automatizados como Fonte para Geração Automatizada de Manuais de Usuário no Instituto Mineiro de Agropecuária

• Luís Kennedy Turola UFLA
• João Victor de Morais Fundação de Desenvolvimento Científico e Cultural
• Ricardo Terra UFLA

DOI: https://doi.org/10.5753/sast.2026.31073

Resumo

Manuais de usuário tradicionais são difíceis de produzir, manter e sincronizar com o comportamento real dos sistemas, especialmente em contextos institucionais e governamentais. Este trabalho apresenta uma solução que reaproveita testes funcionais automatizados como fonte primária para a geração automatizada de documentação de usuário. A partir da execução de testes que representam cenários reais de uso, o Zettalenium registra mensagens de auditoria e capturas de tela, além de gravar a execução em vídeo. Essas evidências são então processadas para gerar documentação em HTML e PDF, bem como vídeos demonstrativos narrados. A solução encontra-se em uso no Sistema de Apoio Fiscal (SAF), no qual testes selecionados para documentação são executados para produzir materiais aderentes ao comportamento efetivamente validado do sistema. Com isso, a abordagem reduz o esforço manual de manutenção documental e promove maior alinhamento entre testes, sistema e manual de usuário.

Palavras-chave: Testes Funcionais Automatizados, Documentação de Software, Manuais de Usuário

Referências

Emad Aghajani, Sarah Nadi, Sina Shamshiri, and Carlos Pacheco. 2020. Software Documentation: The Practitioners’ Perspective. In 42nd International Conference on Software Engineering (ICSE). 1–12.

João Victor de Morais, Neumar Costa Malheiros, and Ricardo Terra. 2025. Automação de Testes de APIs REST no SisNIR. In X Simpósio Brasileiro de Testes de Software Sistemático e Automatizado (SAST 2025). 138–140.

Jez Humble and David Farley. 2010. Continuous Delivery: Reliable Software Releases through Build, Test, and Deployment Automation. Addison-Wesley.

OBS Project. 2026. OBS Studio. [link]

André Pinho, Lincoln Rocha, and Eduardo Figueiredo. 2024. Challenges and Practices in Software Documentation: Evidence from Brazilian Industry. In 38th Brazilian Symposium on Software Engineering (SBES). 1–10.

Selenium Project. 2026. Selenium. [link]

Marthinus Theunissen, Elmarie Brink, and Machdel Matthee. 2022. Documentation in Continuous Software Development: A Mapping Study. Information and Software Technology 141 (2022), 106710.