Banco de Sangue
- Flutter
- Dart
- TypeScript
- Node.js
- Fastify
- Zod
- SQLite
- Drizzle
- Venice AI
- Docker
- GitHub Actions
App para quem doa sangue: guia educativo, histórico de doações, cálculo da próxima data apta para doar e questionários e assistente de dúvidas com IA. Nasceu em 2023 como Projeto de Iniciação Científica na FEMA e foi modernizado em 2026 como um monorepo com app Flutter e API própria em TypeScript.
- Período
- 2023 → 2026
- Origem
- Iniciação Científica · CEPEIN FEMA
- Plataformas
- Android · iOS · Web
- Autores
- Matheus Saleh e Gabriel Eduardo de Souza

O problema
A doação de sangue é voluntária e depende de que o doador saiba se pode doar e quando pode voltar. As regras de intervalo (60 dias para homens e 90 para mulheres) e o limite anual (4 e 3 doações) são pouco conhecidas, e informação errada afasta doadores.
O app reúne em um só lugar informação confiável, conferida com o Ministério da Saúde, e acompanhamento pessoal: cada doação registrada atualiza a estimativa da próxima data. O cálculo é uma estimativa educativa, e o app deixa claro que quem decide é a triagem do hemocentro.
A versão de 2023 fez parte da pesquisa “O uso de Dart e Flutter para desenvolvimento de jogos em aplicativos móveis”, publicada nos anais do Fórum Científico da FEMA.
Capturas de tela
Telas do build Web real em modo API, com um doador fictício e respostas reais do Venice AI.
Inteligência artificial(6)
Questionário gerado pelo Venice AI Explicação após cada resposta Resultado do questionário Assistente com perguntas sugeridas Conversa que mantém o contexto Cota diária de IA esgotada
Acompanhamento do doador(7)
Início: dias até a próxima doação e navegação inferior Histórico de doações Registro de doação Compatibilidade de hemácias ABO/Rh Guia antes, durante e depois Quiz local, disponível sem IA Login com conta da API própria
Tema escuro e telas largas(2)
Tema escuro Layout responsivo em tela larga
Dados de demonstração: o doador Lucas Andrade é fictício e foi criado num banco separado. A cota do ambiente de captura foi reduzida a 3 solicitações para mostrar o bloqueio; no app o padrão é 20 por dia.
Funcionalidades
O que veio da versão de 2023 e o que foi construído na modernização de 2026.
- 2026
Próxima data apta para doar
Calculada pelo intervalo mínimo e pelo limite de doações em 12 meses, de acordo com o sexo informado no perfil.
- 2026
Questionários com IA
Cinco perguntas por rodada, com temas e alternativas embaralhados e explicação após cada resposta. Sem IA, o quiz local continua disponível.
- 2026
Assistente de dúvidas
Chat sobre doação e bancos de sangue que mantém o contexto e sugere as próximas perguntas. Perfil e histórico não são enviados ao provedor.
- 2026
Cota diária de IA por conta
20 solicitações por dia, compartilhadas entre quiz e chat, reservadas de forma atômica no SQLite e renovadas à meia-noite de Brasília.
- 2023 · 2026
Registro e histórico de doações
Criado em 2023; em 2026 ganhou edição, exclusão com “Desfazer” e validação de datas.
- 2023 · 2026
Guia e quiz educativo
Orientações antes, durante e depois da doação, revisadas com a fonte oficial, e quiz com explicações e barra de progresso.
- 2026
Compatibilidade ABO/Rh
Tabela completa de compatibilidade de concentrado de hemácias, coberta por testes.
- 2023 · 2026
Contas e perfil
Login criado em 2023; cadastro, recuperação de senha e perfil do doador (nome, sexo e tipo sanguíneo) em 2026.
- 2023 · 2026
Notícias
Publicadas por administradores, com estados de erro e carregamento tolerante a campos ausentes.
- 2026
Modo demonstração
Roda sem servidor: sessão, perfil e doações ficam no armazenamento local do dispositivo.
Arquitetura
Monorepo com o app e a API. O app fala com a API por HTTPS com token Bearer; a chave da IA fica só no servidor.
- Telas e view models com ChangeNotifier e provider
- Domínio em Dart puro: elegibilidade e compatibilidade
- Repositórios com duas implementações: local (demonstração) e API
- Token no armazenamento seguro (Keychain / Keystore)
- go_router com um único guard e StatefulShellRoute para preservar as quatro abas
- Módulos auth, donor, news e ai
- Zod valida entrada e saída e gera a documentação OpenAPI
- Drizzle ORM com SQLite e migrações SQL versionadas
- Rate limit, Helmet, senhas com scrypt e tokens opacos com hash
- Integração com o Venice AI e cota diária persistida
Decisões técnicas
| Decisão | Por quê | Custo |
|---|---|---|
| API própria no lugar do Firebase | Controle das regras, sem depender de um projeto na nuvem e testável localmente | Manter servidor, banco e e-mail |
| Tokens opacos com hash (não JWT) | Revogação imediata no logout e na troca de senha; um token vazado do banco é inútil | Uma consulta ao banco por requisição |
| Venice somente no backend | A chave não entra no APK nem no build Web; validação e limites ficam no servidor | Exige conexão, saldo no provedor e tratamento de respostas incorretas |
| Cota diária com reserva atômica | Impede ultrapassar o limite com várias sessões, dispositivos ou processos ao mesmo tempo | Todas as instâncias precisam usar o mesmo banco |
| Datas AAAA-MM-DD | As regras de doação contam dias, não instantes; evita erros de fuso horário | Tolerância de 1 dia no servidor para fusos à frente |
De 2023 para 2026
Versão original · 2023
- Login com Firebase Authentication
- Notícias e doações direto no Firestore
- Guia, quiz de 5 perguntas e tela Sobre
- Firebase acessado dentro dos widgets
- Contas criadas só pelo console do Firebase
- Apenas o teste padrão do Flutter, que falhava
Modernização · 2026
- Flutter 3.50 com arquitetura MVVM e go_router
- API própria em Fastify + SQLite no lugar do Firebase
- Cadastro, recuperação de senha e sessões revogáveis
- Quiz e assistente com IA, com cota diária por conta
- Conteúdo revisado com o Ministério da Saúde
- 145 testes e CI no GitHub Actions
Qualidade
- testes na API
- 71
- testes no app
- 74
- versões do Node na CI (22 e 24)
- 2
Os testes cobrem isolamento entre usuários, expiração e revogação de sessões, rate limit, redefinição de senha, regras de elegibilidade com anos bissextos, a tabela ABO/Rh completa, a integração com o Venice simulada e a cota diária com concorrência entre processos. A CI roda lint, typecheck, testes, build e auditoria da API, constrói a imagem Docker e gera o build Web e o APK do app.
Limitações e próximos passos
- A redefinição de senha ainda precisa de um provedor de e-mail; hoje o código aparece no log da API.
- Os dados de 2023 ficaram no Firestore do projeto original e não foram migrados.
- O build iOS não foi gerado, porque exige macOS.
- Próximos passos: lembrete quando a data de doar chegar, PostgreSQL em produção e mapa de hemocentros com dados oficiais.
Quer ver o código?
O repositório tem o app, a API, os testes e o script que gera estas capturas. Desenvolvido por Matheus Saleh e Gabriel Eduardo de Souza.