BikerWay

01 / Problema

Mapas genéricos não respondem às perguntas de quem anda de moto.

02 / Produto

Um mapa para motociclistas, um radar de comboios e uma plataforma de motoclubes.

• Comboios ao vivo

  Rolês em grupo em um mapa ao vivo. Uma tarefa nativa de localização em segundo plano mantém o comboio visível com o celular no bolso.

• Rotas e lugares confiáveis

  Rotas recomendadas, lugares relevantes para motociclistas (postos, oficinas, mirantes), avaliações e um consenso da comunidade sobre o preço do combustível.

• Motoclubes

  Motoclubes com rankings, territórios, recrutamento e check-ins.

• Eventos e convites

  Eventos e encontros de motoclubes, com links de convite que abrem o app ou levam a uma página de download.

• Garagem

  Uma garagem virtual com consumo de combustível, gastos e histórico de manutenção por moto.

• Diário de bordo

  Um registro de rolês anteriores com distância, duração, número de motos e fotos.

• Alertas de SOS com localização ao vivo existem na web app; no app nativo estão planejados para depois do beta.

03 / Arquitetura

Cinco repositórios, um banco de dados, contratos explícitos.

04 / Decisões de engenharia

As decisões que moldaram o sistema.

1. 01

   Vários repositórios, um dono do schema

   Cinco repositórios com alvos de deploy diferentes compartilham um projeto Supabase. Quando divergências de schema entre repositórios causaram bugs em produção, criei um repositório de contexto com a arquitetura, um checklist de mudanças entre projetos e o roadmap, além de tipos gerados e sincronizados em todos os consumidores.

2. 02

   Comboios que sobrevivem à tela bloqueada

   Só a presença em primeiro plano perde quem está com o celular no bolso. Uma tarefa nativa de localização em segundo plano grava em uma tabela protegida por RLS com atualização em tempo real, e a funcionalidade só foi dada como pronta depois de um teste de campo com dois aparelhos.

3. 03

   As regras moram no banco

   Row-level security como padrão, limites de taxa por usuário para conteúdo gerado aplicados por triggers e notificações disparadas por triggers. Todo cliente, inclusive código escrito por agentes, recebe as mesmas garantias.

4. 04

   A IA propõe, a regra decide, o humano cura

   Os pipelines nunca gravam direto nas tabelas de conteúdo. Uma única camada de ingestão valida, normaliza, deduplica, calcula a confiança a partir de evidências e decide se o registro é publicado ou vai para revisão.

5. 05

   Dados que respeitam licenças

   Os termos dos provedores de mapas limitam o que pode ser guardado e por quanto tempo. Os pipelines guardam só o que os termos permitem, renovam ou substituem coordenadas antes de expirarem e usam o OpenStreetMap, com atribuição, como fonte de longo prazo.

6. 06

   Orçamento é restrição de arquitetura

   Gastos novos têm um teto mensal fixo até o produto gerar receita. Isso moldou o stack: planos gratuitos primeiro, orçamentos de IA que falham fechados e busca na web limitada às cotas gratuitas, sem cair para opção paga.

05 / Arquitetura de IA

Onde a IA roda hoje e para onde está indo.

• Pipelines de descoberta de rotas e lugares

  Produção

  Um LLM propõe candidatos, dados reais de mapas os enriquecem, e um portão de confiança junto com a camada de ingestão decide o que é publicado.

• Camada única de ingestão

  Produção

  Deduplicação por place ID, proximidade e similaridade de nome; evidência guardada por registro; status de publicação decidido por regras, não pelo modelo.

• Time de agentes de desenvolvimento

  Em uso

  14 agentes Claude Code com protocolo de consenso e portões de risco exclusivos de humanos.

• Motor de marketing com IA

  Experimental

  Descoberta de tendências e geração de texto e imagem com aprovação pelo Telegram. A publicação ainda é manual.

• Runtime de IA com controle de custo

  Experimental

  Provedores de LLM plugáveis (incluindo DeepSeek), custo de tokens registrado por chamada e orçamentos mensais que falham fechados.

• Time de agentes de conteúdo (AG-0…AG-7)

  Planejado

  Editor-chefe, lugares, eventos, rotas famosas, rotas compostas, desafios e insígnias, peças e manuais, ofertas e um verificador, por trás de um servidor MCP e de uma fila de curadoria.

O time de agentes e seu protocolo estão descritos em Força de trabalho de IA.

06 / Por que importa

O que este projeto mostra sobre como eu trabalho.

Visão de produto

Um problema claro, uma visão ao estilo PlugShare e um roadmap ordenado por custo e tração.

Arquitetura

Cinco repositórios, um dono do schema e contratos sincronizados por um repositório de contexto compartilhado.

Sistemas de IA

LLMs dentro de um pipeline com schemas, nota de confiança, evidências e aprovações.

Automação

Um time de agentes que refina e constrói histórias, com humanos no controle das etapas irreversíveis.

Cloud e backend

Postgres com RLS, Edge Functions, segredos no Vault, triggers e canais em tempo real.

Mobile

Um app nativo com localização em segundo plano e push, testado em aparelhos físicos.

Dados

Procedência, deduplicação e armazenamento de dados de mapas que respeita licenças.

Experimentação

PostHog na web e no mobile, e ondas do roadmap ordenadas para validar tração antes de gastar mais.