Chapter
Um app de leitura social serverless para iOS, Android e web. Um engenheiro, um mês, e o escopo que um time pequeno colocaria no roadmap de um semestre.
// O ponto de partida
O Chapter estava parado: sem infraestrutura, sem modelagem de banco, sem caminho para deploy e sem orçamento para um time. Para tirar do papel, era preciso escolher uma stack que fizesse muito com pouco e ser rigoroso nas poucas partes que carregam risco de verdade.
// O que foi entregue
// Como foi construído
- Serverless
- Expo
- React Native
- Supabase
- Postgres
- Edge Functions
- pgTAP
- Vite + React
- Sentry
- CI
- Serverless. O Supabase gerencia o Postgres, a autenticação, o Realtime e as Edge Functions. Não há servidor para manter.
- Um único código Expo para iOS, Android e web.
- O app fala direto com o Postgres via supabase-js e Realtime. O Row Level Security é a fronteira de segurança: toda tabela tem RLS ativo e coberto por testes pgTAP.
- As Edge Functions ficam ao lado: busca e importação de livros no Open Library e no Google Books, com limite por usuário e cache, além das notificações push. O cliente não consegue escrever no catálogo; só o service role escreve.
- O backoffice é um app separado, em Vite + React. Os admins usam a própria sessão e funções auditadas no banco, nunca o service role.
- A configuração remota chega ao app por uma única função pública,
app_config(), com os valores do código como fallback. - Sentry com dados pessoais removidos e uma telemetria anônima própria no lugar de rastreamento de terceiros.
app_config(). São as políticas de RLS, não o código do app, que decidem quem lê o quê. Só as Edge Functions escrevem no catálogo; o backoffice usa a sessão do próprio admin e funções auditadas.## Decision Use Supabase: Postgres + Row Level Security + Realtime + Auth + Edge Functions. The client uses `supabase-js` directly; RLS is the security boundary (the equivalent of Firestore rules); Realtime pushes changes without hand-written websockets. ## Consequences - Joins, aggregates, full-text/trigram search and triggers are plain SQL; schema lives in versioned migrations; TS types are generated from the schema. - Nothing is protected by hiding endpoints: **every table must have RLS enabled and tested** (`supabase/tests`). …
Trecho original do ADR, em inglês.
// Como eu trabalhei
Toda escolha relevante virou um dos 21 registros de decisão, toda mudança passou por revisão, e uma rodada de QA num aparelho de verdade corrigiu mais de 35 problemas antes do beta. Ferramentas de IA aceleraram a implementação; as decisões e a revisão ficaram comigo.
// Onde está
Chegando ao beta no Android. O link da Play Store entra aqui quando abrir.