Movio Entregasprojeto paralelo
Um app de entregador construído a partir de specs, com agentes de IA
O app do entregador da Movio em React Native e o fluxo spec-driven em que agentes de IA implementam e pessoas revisam. Projeto paralelo.
- Papel
- Desenvolvedor fullstack, projeto paralelo
- Período
- mai. de 2026 – Atual
- entregas
- 55 mil+
- para aceitar um pedido
- ~4s
- checagens antes de cada merge
- 5
Experimente
À esquerda, uma funcionalidade vai da spec ao plano, tarefas, PR e atualização OTA. À direita, o app do entregador antes e depois dela. Faça uma entrega primeiro, depois entregue a funcionalidade e tente de novo. Os dados são fictícios.
# Prova de entrega com foto e código ## Cenários de aceite1. Dado um pedido a caminho, quando o entregador chega ao cliente, então o app pede uma foto e o código.2. Dado um código errado, quando o entregador envia, então a entrega continua aberta.3. Dado um pedido de marketplace que já exige o código do parceiro (iFood, 99Food), então prevalece esse código.4. Dado que o entregador está longe do ponto, quando tenta finalizar, então a API recusa com 409.
Aguardando ofertas…
Eventos
O problema
A Movio liga restaurantes do iFood, 99Food, Takeat e Open Delivery a entregadores. O pedido precisa chegar a um entregador e ser aceito rápido, e o entregador está em movimento, com rede instável e o app muitas vezes em segundo plano.
A maior parte do código é escrita por agentes de IA no Cursor e no Claude Code. Sem uma spec clara eles chutam, e a revisão vira retrabalho.
O que construí
- No app do entregador: a fila de ofertas de corrida em tempo real via WebSocket, prova de entrega com foto e código, localização em segundo plano, push, atualizações OTA e Sentry.
- Introduzi o Spec Kit no projeto: cada funcionalidade relevante começa com uma spec de negócio, que vira plano e tarefas antes da implementação pelos agentes.
- As regras de cada repositório ficam em AGENTS.md e CLAUDE.md, e toda entrega passa por lint, typecheck, build, testes E2E e revisão humana no PR.
- A spec do domínio de entregas da API reúne cenários, contratos e modelo de dados que guiam os agentes.
Decisões
- A spec é a fonte da verdade
- Os cenários de aceite vêm primeiro, em Dado/Quando/Então; plano, tarefas e testes saem deles.
- Empurrar ofertas, não consultar
- As ofertas chegam ao entregador via WebSocket no momento em que existem.
- Entregar sem passar pela loja
- Com o PR aprovado, uma atualização OTA leva a mudança ao celular dos entregadores.
Stack
- React Native
- TypeScript
- WebSocket
- OTA
- Sentry
- Node.js
- PostgreSQL
- Spec Kit
- Claude Code
- Cursor
- Playwright