VITALREGISTRO

Depois de algumas semanas sentindo dores frequentes na nuca, comprei um aparelho de pressão arterial em uma farmácia. A dor foi o motivo para começar a medir; não houve diagnóstico relacionando o sintoma à pressão alta.

Onde eu guardo essas medições?

Eu queria registrar sistólica, diastólica, pulso, peso, data, horário e observações. Uma planilha ou um bloco de notas resolveriam a necessidade imediata. Em vez disso, decidi transformar uma pergunta pequena em um projeto de software.

Os registros ficam no próprio aparelho, em um banco SQLite armazenado na área privada do aplicativo. Não existe login, cadastro, sincronização obrigatória ou servidor necessário para usar o VitalRegistro.

Essa escolha não é perfeita. Perda ou dano do telefone, limpeza dos dados, desinstalação ou restauração do aparelho podem remover o histórico que não tenha sido exportado. Nesta versão não há sincronização, importação nem backup automático em nuvem.

Data e horário pertencem à medição, não ao instante em que o formulário foi salvo. Isso permite registrar depois uma leitura feita anteriormente. O histórico consulta o banco pelo momento medido, do mais recente para o mais antigo; se dois registros compartilham o mesmo minuto, o identificador desempata a ordem.

As mesmas linhas alimentam detalhes, edição, gráficos e exportação. Uma falha de leitura não provoca recriação destrutiva do banco.

A interface foi mantida simples de propósito. As capturas abaixo foram feitas no primeiro APK instalado no Samsung Galaxy M55 e usam dados fictícios. Elas antecedem ajustes posteriores de transparência do ícone, áreas seguras e seletores, portanto documentam uma etapa real — não necessariamente a aparência final do artefato publicado.

A exportação reúne todos os registros em ordem cronológica, em CSV UTF-8, com data, hora, sistólica, diastólica, pulso, peso e observação. Aspas e quebras de linha são tratadas pelo gerador.

No Android, o aplicativo abre o seletor de documentos do sistema. O usuário escolhe nome e destino sem conceder ao aplicativo permissões amplas de armazenamento. Serviços de nuvem podem aparecer se já estiverem instalados, mas só são usados por escolha explícita.

A geração do CSV possui testes automatizados. O adaptador Android foi testado com componentes simulados; salvar, cancelar e repetir pelo seletor em um aparelho físico ainda aguardam validação.

Transformar o projeto Python/Kivy em um APK exigiu Google Colab, Buildozer, python-for-android, Android SDK e Android NDK. O fluxo anterior esperava Python entre 3.10 e 3.12, enquanto o Colab já executava Python 3.13.15.

Remover a verificação de versão não resolveria recipes, compilador nativo ou dependências. A cadeia foi revista para separar o Python que coordena o notebook, o Python que executa as ferramentas de build e o Python preparado pelo p4a para o aplicativo.

O ambiente final fixou commits específicos do Buildozer e do python-for-android, API 36, NDK 29 e o commit do próprio projeto. O arquivo build-info.json preserva o ambiente efetivo e associa esses dados ao APK produzido.

No fechamento da versão existiam dois arquivos chamados vitalregistro-0.1.0-arm64-v8a-debug.apk. Um era um build anterior; o outro, o artefato final. A conferência do SHA-256 evitou que o arquivo antigo fosse usado na publicação.

Uma informação que parecia formalidade mostrou imediatamente sua utilidade: identificar exatamente qual binário correspondia ao ambiente documentado.

O APK debug ARM64 foi instalado em um Samsung Galaxy M55 com Android 16. A documentação separa implementação, teste automatizado, smoke desktop e validação no aparelho.

A suíte registrada cobre CRUD, persistência, edição de todos os campos, ordenação histórica, datas inválidas e bissextas, peso decimal, rollback, CSV UTF-8, áreas seguras e estados simulados da exportação Android.

Um smoke desktop exercitou detalhes, edição, gráficos vazios e preenchidos, pressão, pulso, peso, períodos, exportações repetidas e exclusão usando somente dados temporários fictícios. Esses testes ampliam a confiança no código, mas não substituem a lista curta do que foi confirmado no Galaxy M55.

A v0.1.0 reúne um aplicativo funcional, persistência local, histórico, gráficos, exportação implementada, documentação de build e uma primeira validação em hardware. O artefato publicado é DEBUG + ARM64-V8A; não é uma versão pronta para Google Play.

Ferramentas de IA participaram de discussões, implementação, revisão e documentação. A necessidade, as decisões, os testes e a conferência em hardware continuaram sendo parte de um processo conduzido e verificado por uma pessoa.