O que eu construí
Construído com mais um desenvolvedor. Estes são os módulos que são meus, na ordem em que um kartódromo usa:
- Agenda, reservas e check-in. O módulo de reservas nas três frentes (admin, página pública e piloto), um fluxo de reserva em duas etapas, reserva com mais de um piloto por vez, horários recorrentes com geração em lote a partir de templates, datas bloqueadas e check-in por QR code atrás de uma trava biométrica.
- Pilotos. Cadastro e gestão de perfil, o código do piloto que identifica a pessoa no formulário de reserva e nos links de bateria, páginas públicas do piloto com histórico de voltas e a comparação frente a frente entre dois pilotos.
- Campeonatos, de ponta a ponta. Criação e gestão, navegação e filtros, inscrição automática ou com aprovação, campeonatos comunitários criados pelos próprios pilotos, sessões em vez de rodadas, e um módulo de pontuação que é a fonte única da verdade dos pontos.
- Resultados e race control. Lançamento de resultado que pontua e finaliza dentro de uma única transação, o grid formado a partir do quali, lançamento volta a volta, bandeiras de race control, o TV wall, presença por sessão e o bloqueio de um piloto.
- Karts, traçados e categorias. CRUD dos três, histórico de manutenção e status do kart, e intervalos de manutenção controlados em horas com alerta quando um kart passa do próprio intervalo.
- Financeiro. O resumo financeiro com gráficos, ocupação por dia, filtros de período e exportação das reservas em CSV.
- Segurança. MFA por TOTP, rate limiter em memória com janela deslizante, audit log, timeout de sessão nos procedures protegidos, row-level security nas 14 tabelas, validação de tipo e tamanho no upload, e projeções que deixam dado pessoal fora de todo endpoint público.
- Importação de voltas. Ler tempos de volta de um PDF ou de uma imagem com extração por IA, uma etapa de mapeamento para o operador casar as linhas com os pilotos (convidados incluídos), uma ficha de sessão imprimível com QR code e uma página pública de resultados da sessão.
- O app mobile. Expo e React Native: as telas do piloto, as páginas do kartódromo, o fluxo de reserva, tema escuro, notificações push e o workflow do EAS que builda o app de Android.
- O agente no WhatsApp. O agente de reservas no WhatsApp, construído sobre o mesmo procedure de reserva do app, para as regras viverem em um lugar só.
Como está montado
Um monorepo Turborepo, porque web e mobile são o mesmo produto em superfícies diferentes e as
regras precisam ser escritas uma vez. apps/web é a aplicação Next.js 15 com App
Router (painel administrativo, portal do piloto e landing), apps/mobile é o app em
Expo Router para iOS e Android, packages/api guarda os routers tRPC com a lógica de
negócio e packages/db guarda o schema e o client do Prisma.
Decisões técnicas e trade-offs
- tRPC com Zod em vez de um contrato REST escrito à mão. Os dois clientes chamam os mesmos procedures e herdam os tipos deles, então web e mobile não se desencontram. Trade-off: não existe superfície de API pública, então um terceiro precisaria de uma construída para ele.
- Supabase para identidade e Postgres, Prisma para o schema. Um provedor para auth e dados, com o schema como código e as migrations no repositório. Trade-off: a camada de dados fica dependente de um fornecedor, e o Prisma entra entre as queries e o banco.
- Login por biometria no mobile, Google OAuth e e-mail no web. A equipe no balcão abre um navegador; o piloto abre um app com a digital. Mesma identidade, duas entradas.
- Testes de aceitação com Playwright contra um Supabase real em vez de mocks. Trade-off: mais pesado e mais lento que teste unitário, mas exercita os fluxos do jeito que o kartódromo usa.
- Docker Compose para o ambiente local (Supabase e web), para nós dois rodarmos o mesmo ambiente em vez de dois parecidos.
- Tempo ancorado no fuso do kartódromo e calculado no servidor. Janelas de reserva, o que conta como "hoje", intervalos de analytics e prazos de cancelamento saem todos de um mesmo helper, e não do relógio do navegador. Trade-off: toda data viaja com fuso pela API, o que adiciona cerimônia em código que, de outro modo, só leria a hora local.
Onde está
A plataforma está publicada na Vercel com GitHub Actions e soma cerca de 400 commits entre nós dois. Cronometragem e resultados ao vivo são as partes que ainda estão no roadmap; o resto da operação roda no que foi entregue.