PWA para organizar estoque e lista de compras da casa, compartilhado em família. Evolução do TCC da Etec Parque Belém.
O CARI v2 ajuda uma casa a controlar o que tem na despensa e o que precisa comprar, com a lista de compras compartilhada entre os membros da família. É um PWA (Next.js + Supabase) que funciona também sem conexão.
- Node 24
- Docker (para o Supabase local)
npm i
npm run db:start # sobe o Supabase local (a primeira vez baixa as imagens Docker)
cp .env.example .env.local # preencha NEXT_PUBLIC_SUPABASE_ANON_KEY com a saída de `npx supabase status`
npm run devnpm test # testes unitários (Vitest)
npm run db:test # testes do banco (pgTAP)
npm run test:e2e # testes E2E (Playwright)Tudo roda em free tiers: Supabase Cloud (banco, auth e realtime), Vercel (front) e GitHub Actions (CI, migrations, keepalive e backup). O repositório é público, então nenhum segredo vai para o código: tudo entra pelos secrets do GitHub ou pelas envs da Vercel.
-
Supabase Cloud. Crie o projeto em supabase.com e anote o
Project ref, a senha do banco, a URL do projeto e a chaveanon. -
Google OAuth. No Google Cloud, crie um OAuth Client ID (aplicação web) e, em Authentication > Providers > Google do Supabase, cadastre o Client ID e o Client Secret. No Google Cloud, autorize o redirect
https://<ref>.supabase.co/auth/v1/callback. -
URLs de redirecionamento. Em Authentication > URL Configuration, defina o Site URL como
https://<domínio-vercel>e adicionehttps://<domínio-vercel>/auth/callbackaos Redirect URLs. -
Vercel. Importe o repositório e cadastre só as 2 envs públicas:
NEXT_PUBLIC_SUPABASE_URLeNEXT_PUBLIC_SUPABASE_ANON_KEY. Aservice_rolenunca entra no front nem na Vercel. -
Secrets do GitHub (Settings > Secrets and variables > Actions):
Secret Usado por O que é SUPABASE_ACCESS_TOKENmigrations token pessoal do Supabase (Account > Access Tokens) SUPABASE_PROJECT_REFmigrations ref do projeto SUPABASE_DB_PASSWORDmigrations senha do banco do projeto SUPABASE_URLkeepalive URL do projeto ( https://<ref>.supabase.co)SUPABASE_ANON_KEYkeepalive chave anon(pública)SUPABASE_DB_URLbackup string de conexão do Postgres (Settings > Database > Connection string > Session pooler, porta 5432; os runners do GitHub não têm IPv6, então a conexão direta falha, e o transaction pooler não serve para o pg_dump)BACKUP_AGE_PUBLIC_KEYbackup chave pública age(age1...) -
Chave do backup. Gere o par com
age-keygen -o chave.txt. Guardechave.txt(privada) fora do repositório, por exemplo em um gerenciador de senhas, e cadastre só a chave pública (linhaPublic key: age1...) emBACKUP_AGE_PUBLIC_KEY. Sem a chave privada o backup não pode ser restaurado.
ci.yml: lint, tipos, testes unitários, pgTAP e E2E contra um Supabase local, em todo PR e push paramain.migrate.yml: aplicasupabase/migrations/**no projeto na nuvem a cada push paramainque mude migrations (ou manualmente).keepalive.yml: uma consulta por semana à API para o projeto free não ser pausado por inatividade.backup.yml: todo domingo gera o dump dos dados (incluiauth.users, sem sessões nem refresh tokens), criptografa comagee envia só odump.sql.agecomo artefato (90 dias). O dump em texto puro nunca é enviado nem impresso nos logs.
Baixe o artefato backup-criptografado da execução desejada e, em um banco com as migrations já aplicadas (rode o workflow Migrations, ou npx supabase link --project-ref <ref> + npx supabase db push --remote --yes) e sem dados, rode:
age -d -i chave.txt dump.sql.age | psql -v ON_ERROR_STOP=1 --single-transaction "$SUPABASE_DB_URL"O dump já traz auth.users, então perfis e membros não ficam órfãos. Sessões não são salvas: quem estava logado precisa entrar de novo. Restaure em um banco vazio: em um banco com dados, os INSERTs de linhas existentes falham por chave duplicada.
O CARI nasceu em 2023 como TCC da Etec Parque Belém, um CRUD em PHP para organizar os alimentos de casa e incentivar o consumo sustentável. O código original está preservado na tag tcc-2023.
Integrantes do TCC:
- Lucas Rodrigues Grecco
- Lucas Garcia
- Luiz Felipe
- Murilo Cardoso