99
Matheus Saleh
Inventário de projetos
Estudo de caso · Iniciação Científica#05

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
Início com a próxima data apta para doar, contadores e atalhos

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.

apps/mobileFlutter · MVVM
  • 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
apps/apiTypeScript · Fastify
  • 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ãoPor quêCusto
API própria no lugar do FirebaseControle das regras, sem depender de um projeto na nuvem e testável localmenteManter 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útilUma consulta ao banco por requisição
Venice somente no backendA chave não entra no APK nem no build Web; validação e limites ficam no servidorExige conexão, saldo no provedor e tratamento de respostas incorretas
Cota diária com reserva atômicaImpede ultrapassar o limite com várias sessões, dispositivos ou processos ao mesmo tempoTodas as instâncias precisam usar o mesmo banco
Datas AAAA-MM-DDAs regras de doação contam dias, não instantes; evita erros de fuso horárioTolerância de 1 dia no servidor para fusos à frente
Ver README completo

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.

Conquista Desbloqueada!