Trilho

Plataforma de desenvolvimento pessoal (PWA) que mede, mostra padrões e lembra. O módulo 1, Hábitos, transforma métodos de mudança de hábito em exercícios na tela e indicadores de adesão, com check-in diário.

A especificação do MVP está em docs/HANDOFF-sistema-habitos.md; nome, cores e ícones em docs/HANDOFF-marca-trilho.md (vale este onde houver conflito); a direção da plataforma em docs/ROADMAP-trilho.md. O conteúdo das lições está em docs/conteudo-modulo1-habitos.md e os arquivos de marca em brand-kit/ (os do app ficam copiados em public/brand/).

Stack: Next.js (App Router) + TypeScript + Tailwind CSS + Supabase, deploy na Vercel.

Rodar localmente

cp .env.example .env.local   # preencha as chaves do Supabase
npm install
npm run dev

Abra http://localhost:3000.

Banco de dados

As migrações ficam em supabase/migrations/, em ordem. Para aplicar no projeto da nuvem, abra o SQL Editor do Supabase e rode cada arquivo novo, na ordem do nome.

Configuração de Auth no painel (Authentication):

• Sign In / Providers: Email ligado e cadastro de novos usuários permitido.
• URL Configuration: Site URL = endereço do app; em Redirect URLs, http://localhost:3000/** e o domínio de produção.

Carregar as lições

Depois de aplicar as migrações (e sempre que docs/conteudo-modulo1-habitos.md mudar):

npm run seed-licoes

Lê o arquivo de conteúdo e grava as 8 lições na tabela licoes. Pode rodar de novo sem duplicar.

Liberar acesso manualmente (testadores)

Precisa de SUPABASE_SERVICE_ROLE_KEY no .env.local.

npm run liberar-acesso -- [email protected]

Vale na hora, mesmo para quem já está logado. Para revogar, no SQL Editor: update acessos set status = 'revogado' where email = '[email protected]';

Lembrete diário (Web Push)

1. Gere as chaves uma vez: npx web-push generate-vapid-keys e coloque VAPID_PUBLIC_KEY, VAPID_PRIVATE_KEY e VAPID_SUBJECT (mailto:seu-email) no .env.local e na Vercel. Não troque as chaves depois: as inscrições existentes param de funcionar.
2. Defina CRON_SECRET (qualquer texto longo e aleatório).
3. Algo precisa chamar GET /api/cron/lembretes a cada 15 minutos com o cabeçalho Authorization: Bearer <CRON_SECRET>. A rota decide quem recebe (janela de 15 min do horário do usuário, no máximo 1 por dia, só se houver hábito pendente).

O service worker (public/sw.js) só é registrado no build de produção (npm run build && npm start); em npm run dev ele fica desligado para não servir páginas antigas do cache.

Supabase local (opcional, precisa de Docker)

npx supabase start   # sobe o banco e aplica as migrações

Os e-mails de link mágico chegam no Mailpit (http://127.0.0.1:54324). Para usar o local, troque URL e chave no .env.local pelos valores que o comando mostra.

Scripts

• npm run dev: servidor de desenvolvimento
• npm run build: build de produção
• npm run lint: ESLint
• npm run typecheck: TypeScript sem emitir arquivos
• npm test: testes unitários (Vitest)