Prévia do material em texto
UNIVERSIDADE ESTADUAL DO MARANHÃO NÚCLEO DE TECNOLOGIAS PARA EDUCAÇÃO CURSO SUPERIOR DE TECNOLOGIA EM ANÁLISE E DESENVOLVIMENTO DE SISTEMAS ANDERSON SILVA DA CUNHA IGOR EDUARDO DA SILVA SOUZA DYNAVOICE: ANÁLISE DA QUALIDADE DA PROPOSTA TECNOLÓGICA PARAREGISTRO DE AFERIÇÕES DE FORÇA POR VOZ Axixá2026 ANDERSON SILVA DA CUNHA IGOR EDUARDO DA SILVA SOUZA DYNAVOICE: ANÁLISE DA QUALIDADE DA PROPOSTA TECNOLÓGICA PARAREGISTRO DE AFERIÇÕES DE FORÇA POR VOZ Relatório técnico apresentado ao CursoSuperior de Tecnologia em Análise eDesenvolvimento de Sistemas, daUniversidade Estadual do Maranhão,Núcleo de Tecnologias para Educação,como requisito parcial de avaliação dadisciplina Gestão da Qualidade e Teste deSoftware. Docente: Prof. Dr. Cristie Luis Kugelmeier. Axixá2026 SUMÁRIO 1 INTRODUÇÃO..........................................................................................................4 2 DESCRIÇÃO DA PROPOSTA TECNOLÓGICA.......................................................5 3 REQUISITOS DA SOLUÇÃO....................................................................................6 3.1 Requisitos funcionais .............................................................................................6 3.2 Requisitos não funcionais ......................................................................................7 4 CRITÉRIOS DE QUALIDADE...................................................................................7 4.1 Funcionalidade.......................................................................................................8 4.2 Usabilidade.............................................................................................................8 4.3 Confiabilidade.........................................................................................................8 4.4 Segurança..............................................................................................................8 4.5 Desempenho..........................................................................................................9 4.6 Manutenibilidade....................................................................................................9 5 RISCOS E CUIDADOS COM SEGURANÇA............................................................9 5.1 Matriz de riscos......................................................................................................9 5.2 Cuidados com segurança.....................................................................................10 6 MODELAGEM INICIAL...........................................................................................11 6.1 Entidades e atributos............................................................................................11 6.2 Relacionamentos..................................................................................................11 6.3 Diagrama entidade-relacionamento.....................................................................12 7 CONCLUSÃO..........................................................................................................12 4 1 INTRODUÇÃO A fisioterapia baseada em evidências exige a quantificação precisa da evolução clínica do paciente e, nesse contexto, a dinamometria manual consolidou-se como ferramenta clínica indispensável para a avaliação objetiva da força de contração isométrica. Equipamentos modernos, como o dinamômetro SP Tech da Medeor Medtech, fornecem dados digitais em tempo real sobre a força máxima e as assimetrias musculares. Contudo, a rotina de uso desses equipamentos impõe um gargalo operacional na camada de software, pois o fisioterapeuta precisa optar entre um fluxo burocrático de pré-cadastro a cada medição no software oficial ou adotar o modo livre, mais ágil, porém volátil, uma vez que os dados não são salvos sistemicamente e são perdidos ao término do uso. Esse processo manual gera um efeito cascata no atendimento, causando dupla digitação, perda de foco na técnica de estabilização articular do paciente e aumento do risco de falhas humanas, chegando, em avaliações de alto volume, a exigir o deslocamento de um segundo profissional de saúde apenas para atuar como digitador. Foi a partir dessa necessidade que surgiu o DynaVoice, uma proposta tecnológica desenvolvida na primeira etapa da Prática Profissional Supervisionada, cujo objetivo é permitir o registro das aferições de força com as mãos livres, por meio de comandos de voz, liberando o fisioterapeuta da transcrição manual. Do ponto de vista técnico, o DynaVoice consiste em um aplicativo móvel desenvolvido em Flutter que atua como um assistente flutuante integrado ao sistema operacional por meio da biblioteca flutter_overlay_window. Por meio de um processador de linguagem natural baseado em expressões regulares (ParserService), o sistema interpreta comandos de voz do tipo "cento e quarenta e cinco, joelho direito, flexão" e os converte em registros estruturados de força (em kgf), articulação e movimento, exibindo-os em tempo real em uma sobreposição transparente sobre o software do dinamômetro. Toda a inferência ocorre localmente no dispositivo, sem dependência de serviços em nuvem, o que reforça o compromisso da proposta com a privacidade dos dados clínicos. Contudo, desenvolver uma solução computacional voltada à área da saúde não se restringe a programar funcionalidades. Para que o DynaVoice seja realmente útil, confiável e seguro, é necessário planejar sua construção com base nos princípios da qualidade de software, revisando de forma crítica seus requisitos, riscos e cuidados 5 com segurança antes de avançar o desenvolvimento do Protótipo/MVP. O presente relatório tem, portanto, o objetivo de analisar a qualidade da proposta tecnológica, retomando o problema original e examinando seus requisitos funcionais e não funcionais, os critérios de qualidade esperados para a solução, os riscos envolvidos no desenvolvimento e os cuidados necessários com a proteção de dados clínicos, em especial os relacionados à adequação à Lei Geral de Proteção de Dados (LGPD). Dessa forma, busca-se garantir que o desenvolvimento posterior do DynaVoice ocorra de maneira organizada, coerente e alinhado às necessidades reais do ambiente fisioterapêutico. 2 DESCRIÇÃO DA PROPOSTA TECNOLÓGICA A avaliação da força de contração isométrica por dinamometria manual é uma prática consolidada na fisioterapia baseada em evidências, pois permite quantificar de forma objetiva a evolução clínica do paciente. Equipamentos modernos, como o dinamômetro SP Tech da Medeor Medtech, fornecem dados digitais em tempo real sobre a força máxima e as assimetrias musculares. Apesar desse avanço, a rotina de coleta desses dados impõe um gargalo operacional na camada de software. O software proprietário do equipamento exige um fluxo burocrático de pré-cadastro antes de cada medição, no qual o fisioterapeuta precisa definir paciente, articulação, movimento e membro. A alternativa é o modo de medida livre, mais ágil, porém volátil, pois os dados não são salvos de forma estruturada e se perdem ao término do uso. Diante disso, o profissional se vê obrigado a interromper a manipulação do paciente para anotar os valores manualmente ou a deslocar um segundo profissional de saúde apenas para atuar como digitador, o que gera dupla digitação, perda de foco na técnica de estabilização articular e aumento do risco de falhas humanas. A partir dessa necessidade, o DynaVoice foi concebido como um aplicativo móvel de registro assistido por voz, que opera de forma paralela ao dinamômetro. O objetivo geral do projeto é projetar o protótipo de um aplicativo capaz de capturar, transcrever de forma local e estruturar os dados de força de contração isométrica aferidos por dinamometria manual, utilizando comandos de voz em linguagem natural. Para alcançá-lo, foram definidos quatro objetivos específicos: mapear o fluxo de registro e definir a estrutura do banco de dados para os parâmetros clínicos de paciente, membro, articulação, movimento e carga;integrar um motor de transcrição 6 acústica de código aberto para execução estritamente local; elaborar um algoritmo de extração de entidades semânticas por meio de expressões regulares e processamento de linguagem natural para a categorização automática dos dados; e projetar uma interface gráfica de validação para a revisão e edição dos dados antes da persistência no prontuário. O público-alvo da solução é composto por fisioterapeutas que realizam avaliações de força de contração isométrica em consultórios, clínicas e clubes esportivos. A justificativa da proposta reside na otimização do fluxo de atendimento por meio de uma interface com as mãos livres, que permite ao avaliador manter o foco na estabilização articular do paciente durante a execução dos testes. Do ponto de vista tecnológico, a solução se apoia no processamento local dos dados, de modo que as informações sensíveis não trafegam pela rede, o que favorece a conformidade com a Lei Geral de Proteção de Dados e elimina a dependência de um segundo profissional para a transcrição. As funcionalidades previstas para o DynaVoice compreendem a conversão de áudio em texto de forma local, a extração de entidades semânticas como paciente, membro, lado, movimento e valor numérico por meio de processamento de linguagem natural e expressões regulares, a interface gráfica de validação para conferência e edição de inconsistências, e a persistência e exportação dos dados estruturados em formato JSON. 3 REQUISITOS DA SOLUÇÃO Os requisitos da solução descrevem o que o DynaVoice deve fazer e sob quais condições de qualidade deve operar. Eles foram organizados em requisitos funcionais, que definem as funcionalidades do sistema, e requisitos não funcionais, que estabelecem as restrições e os atributos de qualidade esperados. 3.1 Requisitos funcionais Código Requisito DescriçãoRF01 Captura de áudio O sistema deve capturar a fala do fisioterapeuta pormeio do microfone do dispositivo, mantendo a escutaativa durante a avaliação.RF02 Transcrição local O sistema deve converter o áudio capturado em texto deforma local, sem depender de serviços em nuvem.RF03 Extração de O sistema deve extrair do texto as entidades semânticas 7 entidades de paciente, membro, lado, movimento e valor numérico,por meio de expressões regulares e processamento delinguagem natural.RF04 Estruturação dosdados O sistema deve estruturar os dados reconhecidos emregistros de força em quilograma-força, articulação emovimento.RF05 Exibição emsobreposição O sistema deve exibir os dados reconhecidos em temporeal em uma sobreposição transparente sobre o softwaredo dinamômetro, sem interromper o uso doequipamento.RF06 Validação e edição O sistema deve oferecer uma interface gráfica para queo fisioterapeuta confira e edite os dados antes dapersistência, corrigindo eventuais inconsistências.RF07 Persistência dosdados O sistema deve armazenar os registros estruturados deforma organizada por paciente e por sessão deavaliação.RF08 Exportação dosdados O sistema deve permitir a exportação dos dadosestruturados em formato JSON. 3.2 Requisitos não funcionais Código Requisito DescriçãoRNF01 Desempenho A transcrição e a extração de entidades devem ocorrerem tempo hábil para acompanhar o ritmo da avaliação,sem atrasos perceptíveis ao usuário.RNF02 Usabilidade A interação deve ser possível com as mãos livres,permitindo que o fisioterapeuta mantenha o foco naestabilização articular do paciente.RNF03 Privacidade Todo o processamento deve ocorrer localmente nodispositivo, de modo que os dados clínicos nãotrafeguem pela rede, em conformidade com a Lei Geralde Proteção de Dados.RNF04 Confiabilidade O sistema deve reconhecer e estruturar corretamente oscomandos de voz, minimizando erros de transcrição e decategorização das entidades.RNF05 Manutenibilidade O código deve ser organizado em módulos bemdefinidos, facilitando a correção de defeitos e a evoluçãodas funcionalidades.RNF06 Portabilidade O aplicativo deve ser desenvolvido em Flutter,permitindo a execução em dispositivos móveis comsistema Android. 4 CRITÉRIOS DE QUALIDADE Os critérios de qualidade definem os atributos que o DynaVoice deve apresentar para ser considerado uma solução útil, confiável e segura. Eles foram organizados a partir das seis dimensões: funcionalidade, usabilidade, confiabilidade, segurança, desempenho e manutenibilidade. 8 4.1 Funcionalidade O critério de funcionalidade refere-se à capacidade do sistema de executar corretamente as funções para as quais foi projetado. No DynaVoice, isso implica que a captura de áudio, a transcrição local, a extração de entidades semânticas e a estruturação dos dados ocorram de forma integrada e sem falhas, produzindo registros de força, articulação e movimento corretos a partir dos comandos de voz. A adequação funcional será verificada por meio de testes que comparem o resultado estruturado pelo sistema com o valor esperado para cada comando. 4.2 Usabilidade A usabilidade é o critério central da proposta, pois a solução foi concebida justamente para eliminar a interação tátil com a interface gráfica. O DynaVoice deve permitir que o fisioterapeuta realize todo o registro com as mãos livres, mantendo o foco na estabilização articular do paciente. Isso exige que os comandos de voz sejam interpretados de forma natural, que a sobreposição exibida sobre o software do dinamômetro seja discreta e legível, e que a interface de validação seja simples o suficiente para permitir a correção de inconsistências sem interromper o fluxo de atendimento. 4.3 Confiabilidade A confiabilidade diz respeito à capacidade do sistema de manter um desempenho consistente ao longo do tempo e de produzir resultados corretos de forma repetida. No contexto do DynaVoice, o principal risco à confiabilidade está na precisão da transcrição e da extração de entidades, uma vez que erros de reconhecimento podem gerar registros incorretos de força ou de articulação. Para atender a esse critério, o sistema deve minimizar falhas de categorização e oferecer a interface de validação como mecanismo de recuperação, permitindo que o usuário corrija eventuais inconsistências antes da persistência. 4.4 Segurança A segurança é um critério especialmente relevante por se tratar de dados clínicos, classificados como sensíveis pela Lei Geral de Proteção de Dados. O DynaVoice deve garantir a confidencialidade e a integridade das informações, o que 9 é favorecido pela arquitetura de processamento local, na qual os dados não trafegam pela rede. Além disso, o armazenamento dos registros deve prever mecanismos de proteção, como a restrição de acesso ao aplicativo e, em uma evolução futura, a criptografia dos dados persistidos no dispositivo. 4.5 Desempenho O critério de desempenho refere-se ao tempo de resposta do sistema e à sua capacidade de operar sem degradação durante o uso. No DynaVoice, a transcrição e a extração de entidades devem ocorrer em tempo hábil para acompanhar o ritmo da avaliação, sem atrasos perceptíveis que comprometam a fluidez do atendimento. Como o processamento é realizado localmente no dispositivo móvel, é necessário observar o consumo de recursos, como memória e processamento, para que a execução do motor de transcrição não comprometa o desempenho geral do aplicativo. 4.6 Manutenibilidade A manutenibilidade refere-se à facilidade com que o sistema pode ser corrigido, atualizado e evoluído. O DynaVoice deve ser desenvolvido com uma arquitetura modular, na qual a captura de áudio, a transcrição, a extração de entidades e a persistência estejam separadas em componentes bem definidos. Essa organização facilita a identificação e a correção de defeitos, a substituição de componentes, como o motor de transcrição, e a adição de novas funcionalidades sem comprometer as já existentes. 5 RISCOS E CUIDADOS COM SEGURANÇA A análise de riscos tem por objetivo antecipar os problemas que podem gerar erros, defeitos, falhas ou retrabalho durante o desenvolvimento e o uso do DynaVoice, bem como definir os cuidados necessários paratornar a solução mais segura e confiável. Os riscos foram organizados em uma matriz que relaciona cada risco ao seu impacto e à ação de mitigação correspondente. 5.1 Matriz de riscos Código Risco Impacto MitigaçãoR01 Erros de transcrição de voz,gerando registros incorretos Alto Implementar a interface de validaçãopara revisão e edição dos dados antes 10 de força ou articulação da persistência, além de testes comamostras reais de fala.R02 Falha na extração deentidades semânticas porexpressões regulares,especialmente em variaçõesde fala Médio Ampliar o conjunto de padrões doanalisador e realizar testes comdiferentes formas de expressar omesmo comando. R03 Vazamento de dados clínicossensíveis, em desacordocom a Lei Geral de Proteçãode Dados Alto Manter o processamento estritamentelocal e prever criptografia dos dadospersistidos no dispositivo. R04 Perda de dados por ausênciade persistência,comprometendo o históricode avaliações Alto Implementar a persistência estruturadados registros por paciente e porsessão, com armazenamento local. R05 Consumo excessivo derecursos do dispositivo pelomotor de transcrição,degradando o desempenho Médio Otimizar o processamento e monitoraro uso de memória e processamentodurante a execução. R06 Dependência de um motor detranscrição ainda nãointegrado, gerando retrabalhona integração Médio Priorizar a integração do motor detranscrição local e validar suaexecução em dispositivos reais. R07 Incompatibilidade comdiferentes versões dosistema Android, limitando aportabilidade Médio Definir uma versão mínima suportada erealizar testes em múltiplosdispositivos. 5.2 Cuidados com segurança Por se tratar de dados clínicos, classificados como sensíveis pela Lei Geral de Proteção de Dados, o DynaVoice exige cuidados específicos de segurança. O principal deles é a manutenção do processamento estritamente local, de modo que as informações de saúde não trafeguem pela rede e permaneçam sob controle do profissional responsável. Esse princípio, já previsto na arquitetura da proposta, deve ser preservado em todas as etapas do desenvolvimento. Além disso, o armazenamento dos registros deve prever mecanismos de proteção contra acesso não autorizado. Em uma primeira versão, recomenda-se a restrição de acesso ao aplicativo e a separação dos dados por paciente e por sessão. Em uma evolução futura, deve-se incorporar a criptografia dos dados persistidos no dispositivo, de modo que, mesmo em caso de perda ou roubo do aparelho, as informações permaneçam inacessíveis a terceiros. Por fim, é necessário observar o princípio da minimização de dados, coletando apenas as informações estritamente necessárias à avaliação de força, e garantir a 11 possibilidade de exclusão dos registros quando solicitada pelo titular, em conformidade com os direitos previstos na legislação. 6 MODELAGEM INICIAL A solução proposta envolve o armazenamento e o gerenciamento de informações clínicas, o que torna necessária a definição de uma organização inicial dos dados. A modelagem apresentada a seguir descreve as entidades centrais do DynaVoice e os relacionamentos entre elas, servindo como base para a implementação da persistência no Protótipo/MVP. 6.1 Entidades e atributos A estrutura de dados do DynaVoice é organizada em torno de quatro entidades principais: Paciente, Sessão, Avaliação e Medição. A entidade Paciente representa o indivíduo submetido à avaliação de força e contém os atributos de identificação, como nome e demais dados cadastrais mínimos necessários ao atendimento. A entidade Sessão representa uma avaliação realizada em uma data específica, vinculada a um paciente, e permite agrupar as medições de um mesmo atendimento. A entidade Avaliação representa o conjunto de testes realizados em uma articulação ou movimento específico dentro de uma sessão. Por fim, a entidade Medição representa o registro individual de força, contendo o valor aferido em quilograma-força, o membro, o lado, a articulação, o movimento e a carga. 6.2 Relacionamentos Os relacionamentos entre as entidades seguem uma hierarquia de composição. Um Paciente pode possuir várias Sessões, e cada Sessão pertence a um único paciente. Uma Sessão pode conter várias Avaliações, e cada Avaliação pertence a uma única sessão. Uma Avaliação pode conter várias Medições, e cada Medição pertence a uma única avaliação. Essa estrutura hierárquica reflete diretamente o fluxo de trabalho do fisioterapeuta, que atende um paciente, realiza uma sessão de avaliação e, dentro dela, registra as medições de força de diferentes articulações e movimentos. 12 6.3 Diagrama entidade-relacionamento Figura 1— Diagrama entidade-relacionamento da modelagem inicial do DynaVoice.Fonte: elaborado pelos autores (2026). 7 CONCLUSÃO O presente relatório analisou a qualidade da proposta tecnológica do DynaVoice, um aplicativo móvel de registro assistido por voz destinado a otimizar a coleta de dados de força de contração isométrica na prática fisioterapêutica. A análise partiu do problema original, caracterizado pelo gargalo operacional imposto pelo software proprietário dos dinamômetros digitais, que obriga o fisioterapeuta a interromper a manipulação do paciente para registrar os dados ou a deslocar um segundo profissional para atuar como digitador. 13 A revisão da proposta permitiu confirmar a coerência entre o problema identificado e a solução concebida. Os requisitos funcionais e não funcionais foram definidos de forma alinhada aos objetivos geral e específicos do projeto, abrangendo desde a captura e transcrição local da fala até a extração de entidades semânticas, a validação dos dados e a persistência estruturada por paciente e por sessão. Os critérios de qualidade foram organizados nas dimensões de funcionalidade, usabilidade, confiabilidade, segurança, desempenho e manutenibilidade, com destaque para a usabilidade, que constitui o diferencial central da proposta, e para a segurança, dada a natureza sensível dos dados clínicos envolvidos. A análise de riscos evidenciou os principais pontos de atenção para o desenvolvimento do Protótipo/MVP, entre os quais se destacam os erros de transcrição e de extração de entidades, a ausência de persistência dos dados e a necessidade de proteção das informações em conformidade com a Lei Geral de Proteção de Dados. Para cada risco, foram indicadas ações de mitigação, com ênfase na implementação da interface de validação, na persistência estruturada e na manutenção do processamento estritamente local. A modelagem inicial dos dados, organizada na hierarquia Paciente, Sessão, Avaliação e Medição, forneceu a base conceitual para a futura implementação do armazenamento. Como melhorias para o desenvolvimento ou aperfeiçoamento do Protótipo/MVP, recomenda-se priorizar a integração efetiva do motor de transcrição local, a implementação da persistência estruturada dos registros, a incorporação da interface de validação e edição dos dados e a adoção de mecanismos de criptografia para o armazenamento das informações clínicas. Com essas ações, o DynaVoice estará apto a cumprir seu propósito de liberar as mãos do fisioterapeuta, reduzir erros de transcrição e assegurar a confiabilidade e a segurança dos dados, consolidando- se como uma solução alinhada aos princípios da qualidade de software. 1 INTRODUÇÃO 2 DESCRIÇÃO DA PROPOSTA TECNOLÓGICA 3 REQUISITOS DA SOLUÇÃO 3.1 Requisitos funcionais 3.2 Requisitos não funcionais 4 CRITÉRIOS DE QUALIDADE 4.1 Funcionalidade 4.2 Usabilidade 4.3 Confiabilidade 4.4 Segurança 4.5 Desempenho 4.6 Manutenibilidade 5 RISCOS E CUIDADOS COM SEGURANÇA 5.1 Matriz de riscos 5.2 Cuidados com segurança 6 MODELAGEM INICIAL 6.1 Entidades e atributos 6.2 Relacionamentos 6.3 Diagrama entidade-relacionamento 7 CONCLUSÃO