DiaBem — Acompanhamento Pessoal de Diabetes

Diário pessoal inteligente de diabetes. Registre, acompanhe e entenda sua rotina de saúde — offline, privado e no seu bolso.

DiaBem é uma Progressive Web App (PWA) de acompanhamento pessoal de diabetes, construída com foco em experiência mobile-first, armazenamento local criptografado e funcionamento offline. A aplicação permite registrar glicemia, refeições, atividades físicas, medicamentos e observações, visualizando evolução, padrões e estatísticas ao longo do tempo.

Aviso importante: DiaBem é uma ferramenta de acompanhamento e organização de dados pessoais. Não realiza diagnóstico médico e não substitui orientação de profissionais de saúde.

Funcionalidades

Fluxo da Aplicação

Landing Page
     ↓
Login / Criar conta
     ↓
Onboarding (opcional)
     ↓
Dashboard
     ↓
┌───────────────┬────────────────┐
│               │                │
Timeline    Registro rápido   Estatísticas
│               │                │
├── Glicemia    ├── Refeição     │
├── Refeição    ├── Atividade    │
├── Atividade   ├── Medicamento  │
├── Medicamento └── Observação   │
└───────────────┴────────────────┘
     ↓
Relatórios
     ↓
Exportação / Compartilhamento
     ↓
Configurações

Stack Tecnológica

Estrutura do Projeto

diabem/
├── app/                          # Next.js App Router
│   ├── layout.tsx                # Root layout (fontes, providers, toaster)
│   ├── page.tsx                  # Landing page
│   ├── globals.css               # Tema global (Tailwind v4 + design tokens)
│   ├── manifest.webmanifest      # Manifest PWA
│   │
│   ├── (app)/                    # Área autenticada (protegida por AuthGuard)
│   │   ├── layout.tsx            # AuthGuard > AppShell > PageTransition
│   │   ├── dashboard/
│   │   ├── glucose/
│   │   ├── meals/
│   │   ├── activity/
│   │   ├── medications/
│   │   ├── notes/
│   │   ├── reports/
│   │   ├── settings/
│   │   ├── statistics/
│   │   └── timeline/
│   │
│   └── (public)/                 # Rotas públicas
│       ├── login/
│       └── signup/
│
├── components/
│   ├── ui/                       # Primitivas UI (shadcn/ui)
│   ├── layout/                   # Shell, sidebar, bottom-nav, headers
│   ├── shared/                   # Componentes reutilizáveis (auth-guard, skeleton, etc.)
│   ├── features/                 # Módulos de feature (widget/ui/hooks)
│   │   ├── activity/
│   │   ├── camera/
│   │   ├── dashboard/
│   │   ├── data-ownership/
│   │   ├── devices/
│   │   ├── glucose/
│   │   ├── meals/
│   │   ├── notes/
│   │   ├── notifications/
│   │   ├── progressive-enhancement/
│   │   ├── reports/
│   │   ├── statistics/
│   │   ├── timeline/
│   │   └── voice-input/
│   ├── landing/                  # Seções da landing page
│   ├── motion/                   # Componentes de animação
│   └── providers/                # PWA provider
│
├── lib/
│   ├── auth/                     # Autenticação e sessão
│   ├── analytics/                # Estatísticas e gráficos
│   ├── browser/                  # Capacidades e serviços do navegador
│   ├── crypto/                   # Criptografia (AES-GCM, PBKDF2)
│   ├── data-ownership/           # Exportação, importação, compartilhamento
│   ├── db/                       # Dexie (IndexedDB) — schema, repositórios, criptografia
│   ├── devices/                  # Integração com medidores (Bluetooth/Serial)
│   ├── health/                   # Serviços de domínio (glicemia, refeições, etc.)
│   ├── intelligence/             # Motor de insights (regras, analytics, Web Worker)
│   ├── offline/                  # Status de rede e armazenamento
│   ├── pwa/                      # Registro SW, instalação, atualização
│   └── reports/                  # Construção de relatórios PDF
│
├── e2e/                          # Testes E2E (Playwright)
├── docs/
│   ├── architecture/             # Documentação de arquitetura
│   └── design/                   # Design system e especificação de UI
├── public/                       # Assets estáticos, sw.js, ícones PWA
└── scripts/                      # Scripts utilitários

Arquitetura

Feature Module Architecture

O projeto segue uma arquitetura orientada a features, onde cada módulo funcional é autocontido:

components/features/<feature>/
├── widget/       # Composição, estado, comportamento
├── ui/           # Apresentação e renderização
├── hooks/        # Hooks específicos da feature
└── utils/        # Utilitários da feature

Camada de Componentes

Server & Client

• React Server Components por padrão
• "use client" apenas quando necessário: estado interativo, APIs do navegador, hooks client-side, efeitos, IndexedDB, notificações
• Módulos client-only nunca são importados em Server Components

Armazenamento Local

• IndexedDB (Dexie) como mecanismo principal para dados estruturados
• localStorage apenas para preferências simples (tema, configurações)
• Criptografia no nível do campo via Web Crypto API (AES-GCM)
• Chave de criptografia mantida apenas em memória, expurgada no logout

Segurança

• Todos os dados são escopados por userId (isolamento de usuário)
• Senhas hasheadas com PBKDF2 + salt por usuário
• Criptografia AES-GCM para campos sensíveis de saúde
• Headers de segurança: CSP, X-Frame-Options: DENY, Referrer-Policy
• Nenhum dado é compartilhado automaticamente — apenas com ação explícita do usuário

Motor de Inteligência

• Engine de regras local executada em Web Worker
• Regras: tendência, mudança de média, variabilidade, concentração por período, relação refeição/glicemia, frequência de atividade, dias com mais registros
• Insights gerados em português (pt-BR), apresentados como observações

Design System

O design é centrado no conceito de “Companheiro Pessoal de Saúde” — acolhedor, acessível e encorajador.

Para mais detalhes, consulte:

• docs/design/DESIGN.md — sistema de design completo
• docs/design/INTERFACE.md — especificação de UI/UX

Pré-requisitos

• Node.js 18+ ou Bun 1.3+
• Git

Instalação

# Clone o repositório
git clone https://github.com/ruanvalente/diabem.git
cd diabem

# Instale as dependências (recomendado: Bun)
bun install

# Ou com npm
npm install

Comandos Disponíveis

Desenvolvimento

Servidor de Desenvolvimento

bun dev

Acesse http://localhost:3000.

Estrutura de Rotas

Banco de Dados Local (IndexedDB)

Todas as tabelas são escopadas por userId. Campos sensíveis são criptografados com AES-GCM.

Testes

Testes Unitários

bun test

Cobertura: repositórios DB, criptografia, serviços de autenticação, domínio de saúde, analytics, intelligence, dispositivos, data-ownership, capabilities do navegador, reports, offline e componentes.

Testes E2E

bun test:e2e

Projetos Playwright:

• Pixel 7 (mobile-chromium)
• Desktop Chrome

Specs:

• core-health.spec.ts — fluxos CRUD (glicemia, refeições, atividade, notas)
• experience.spec.ts — comportamentos de UX
• offline.spec.ts — comportamento offline-first
• pwa.spec.ts — shell PWA, precache, manifest
• reports.spec.ts — geração de relatórios

CI

Pipeline em .github/workflows/ci.yml com dois jobs:

• ci: lint → testes unitários → build
• e2e: Playwright chromium com relatório de falhas

PWA

Instalação

O DiaBem é instalável como PWA em:

• Android — via prompt de instalação do Chrome
• iOS — via “Adicionar à Tela de Início” no Safari
• Desktop — via prompt de instalação no Chrome/Edge

Service Worker

• Precache de assets estáticos
• Network-first para navegações (fallback offline para /)
• Cache-first para assets estáticos
• Sem dados de saúde no cache — dados ficam apenas no IndexedDB criptografado

Manifest

• Nome: “DiaBem - Acompanhamento Pessoal de Diabetes”
• Idioma: pt-BR
• Display: standalone
• Atalhos: /glucose, /timeline, /settings

Contribuindo

Guia de Contribuição

1. Fork o repositório
2. Crie uma branch para sua feature (git checkout -b feature/nova-funcionalidade)
3. Faça suas alterações seguindo as convenções do projeto
4. Execute os testes (bun test && bun lint)
5. Crie um commit descritivo
6. Abra um Pull Request

Antes de abrir um PR, consulte SECURITY.md e o SECURITY-CHECKLIST.md para garantir que sua contribuição segue a postura de segurança do projeto. Para reportar uma vulnerabilidade, não abra issue pública — use o reporte privado descrito em SECURITY.md.

Convenções

Nomenclatura

Todos os identificadores devem estar em inglês.

Arquitetura

Antes de implementar uma nova feature:

1. Identifique o domínio de negócio e o módulo de feature correspondente
2. Consulte docs/architecture/APPLICATION-ARCHITETURE.md e docs/architecture/COMPONENT-ARCHITETURE.md
3. Defina responsabilidades e limites
4. Determine requisitos de Server/Client
5. Determine requisitos de persistência
6. Defina estados de loading, erro, vazio e offline onde aplicável
7. Implemente seguindo a arquitetura documentada
8. Valide a implementação final contra a arquitetura

Código

• TypeScript com strict mode
• ESLint + Prettier
• Sem uso desnecessário de any
• JSDoc para APIs públicas e funções complexas
• Não introduza abstrações sem necessidade concreta

Commits

• Mensagens claras e descritivas
• Formato: <tipo>: <descrição>
• Tipos: feat, fix, refactor, test, docs, chore

Privacidade e Segurança

• Armazenamento local — dados ficam no dispositivo do usuário
• Criptografia — campos sensíveis protegidos com AES-GCM
• Isolamento — dados escopados por usuário
• Controle total — exportar, importar e apagar dados a qualquer momento
• Sem compartilhamento automático — apenas com ação explícita do usuário
• Offline-first — funciona sem conexão com a internet
• Senhas — hasheadas com PBKDF2 + salt

Roadmap

Funcionalidades planejadas ou em desenvolvimento:

• [ ] Integração com APIs de alimentos
• [ ] Sincronização com backend
• [ ] Autenticação biométrica
• [ ] Notificações push
• [ ] Integração com wearables
• [ ] Suporte a múltiplos idiomas
• [ ] Modo de acompanhamento para cuidadores

Documentação

Quer contribuir ?

Toda a documentação se encontra no repositório do projeto.

DiaBem — Seu companheiro pessoal para acompanhar sua rotina de saúde. | Todos os vossos atos sejam feitos com amor. - 1 Coríntios 16:14