Paulo Lucas Cerqueira
Todos os trabalhos

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.

1engenheiro
3plataformas
27idiomas traduzidos
21registros de decisão

// 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

Clubes do livroClubes fechados, com o livro da vez, um prazo e o progresso de cada membro.
Motor de badgesOs badges são dados. Os novos saem pelo backoffice, sem nova versão do app.
Feed em tempo realFeed de atividades e notificações, ao vivo.
27 idiomas traduzidosInglês, português e espanhol saem primeiro; os outros 24 já estão prontos para publicar como pacotes remotos.
BackofficeUm app web separado; toda ação de admin passa por uma função auditada.
Configuração remotaFeature flags, regras de versão do app e banners, alterados sem publicar nova versão.

// Como foi construído

Arquitetura do Chapter. O app Expo lê e escreve direto no Postgres via supabase-js e Realtime, sob o Row Level Security, e lê a configuração remota por app_config(). As Edge Functions cuidam da busca e importação do catálogo no Open Library e no Google Books, e do push; só elas escrevem no catálogo, com o service role. O backoffice web chama RPCs auditadas com a sessão do próprio admin. Os erros vão para o Sentry. Expo appiOS · Android · Web Postgres + RLSPostgREST · Realtimesecurity boundary reads · writes · realtime supabase-js · app_config() Sentryerrors · PII stripped Edge Functionscatalog search · importrate limit · cachepush · jobs BackofficeVite + React web appadmin's own session Book APIsOpen Library · Google Books catalog search catalog writes (service role) audited RPCs
O app lê e escreve direto no Postgres e recebe a configuração remota por uma função, 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.
ADR 0001. Supabase as the backendaccepted
## 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.