Codebase Brain

Sua arquitetura, como um grafo vivo.

Repositórios, módulos, dependências, quem é responsável por quê — tirado direto do código, não de um diagrama que alguém desenhou em 2023. Ele se reconstrói a cada push, e os clusters com atividade real brilham — para que o mapa nunca seja aquela imagem parada de um wiki. E tudo isso fica na mesma base que seus clientes e sua receita, então "o que esse recurso realmente afeta?" finalmente tem uma resposta.

Mostrado aqui: o código real da AIOProductOS — a gente roda nossa empresa nisso.

O codebase brain

Ele conhece o seu produto — inclusive o código

Sua arquitetura como um grafo vivo, na mesma base que clientes e receita. Clique para ver o que ele oferece.

Mapa vivo

Sua arquitetura como um grafo

  • Módulos agrupados por recurso, dependências como cordas
  • Se reconstrói a cada push — nunca um diagrama de wiki parado

Docs automáticas

Documentação que se escreve sozinha

  • Gerada a partir do grafo de código e sempre sincronizada
  • Ninguém precisa manter um wiki

Atividade

Ele mostra o que está vivo

  • Clusters com atividade real brilham
  • Veja onde o trabalho realmente está acontecendo

De ponta a ponta

Código no registro do cliente

  • Rastreie um recurso até o código que o entrega
  • …e até a receita que depende dele

Mostrado aqui: o código real da AIOProductOS — a gente roda nisso.

O mapa

Cada módulo, conectado como ele realmente é.

Um grafo interativo de toda a base de código: módulos agrupados em clusters de recursos, dependências trançadas como cordas, dimensionados pela importância de cada peça. Clique num módulo para abrir suas conexões — e o mapa se reconstrói sozinho conforme seu código muda.

    Construído a partir do código

    Nós, arestas e limites de módulo vêm do que o código de fato importa — rotas, funções, componentes, tabelas — não de um diagrama desenhado à mão que ficou desatualizado.

    Responsável no nó

    Cada módulo mostra quem é responsável por ele e quantos arquivos tem. Novos engenheiros ganham um mapa em vez de um tour pelo conhecimento tribal.

    Dependências com peso

    As conexões entre módulos mostram o quanto uma coisa depende da outra — veja o que vai quebrar antes de tocar nele.

Ele se mantém atualizado por conta própria: o mapa se reconstrói a cada push e duas vezes por dia, direto do conector do GitHub — sem CI para configurar, sem diagrama para manter. Precisa agora? Atualize sob demanda a qualquer momento.

Docs vivas

Documentação que se escreve sozinha.

Docs por módulo, geradas direto do grafo: para que o módulo serve, do que ele é feito, suas peças mais conectadas, as tabelas e RPCs que ele possui, e do que ele depende. READMEs extraídos dos seus repositórios ficam ao lado.

  • Determinístico — calculado a partir do grafo, sem chamada de modelo, sem conta de tokens.
  • Sempre atualizado: toda vez que o grafo é republicado, as docs já correspondem.
  • "Depende de / usado por" por módulo — as conexões em texto, não só em pixels.
codebase / docs / connectors

connectors — 546 peças

routes 38 · functions 412 · mappings 51 · tables 9

Peças principais

  • · stripe/route.ts — preenche retroativamente clientes + MRR
  • · github/mapping.ts — repositórios, linguagens, atividade
  • · sentry/mapping.ts — erros → tarefas

Depende de

db · webhooks

Usado por

pm · analytics · modules

Gerado a partir do grafo de código · Dados de exemplo

codebase / inventory
  • route api/connectors/stripe connectors 64
  • table analytics_event db 58
  • function stitchIdentity db 41
  • component BoardView pm 37
  • route api/codebase/brain/refresh codebase 22

Linguagens · todos os repositórios sincronizados

TypeScript 68% · SQL 22% · outras 10%

Ordenado por conexões — mais importantes primeiro · Dados de exemplo

O inventário

Cada ativo de código. Um catálogo pesquisável.

Cada nó do grafo como uma lista plana e filtrável: tipo, nome, módulo, arquivo, e quantas coisas se conectam a ele — ordenado pelos mais importantes primeiro. O gêmeo tabular do mapa, vindo da mesma fonte, então nunca fica fora de sincronia.

  • Pesquise e filtre por tipo, módulo ou nome — encontre a peça, depois o arquivo dela.
  • Distribuição de linguagens agregada em todos os repositórios sincronizados.
  • Lista de repositórios com atividade, visibilidade, estrelas e issues abertas por host de código.

O que o alimenta

Três hosts de código na entrada. Deploys, erros e schema ao lado.

Conecte o stack de engenharia que você já usa. O grafo de arquitetura se constrói a partir do GitHub — conecte e o mapa aparece, sem CI ou devops do seu lado — enquanto deploys, erros e schema chegam na mesma base ao lado dele.

    Hosts de código

    GitHub · GitLab · Bitbucket

    O grafo de arquitetura se constrói hoje a partir do GitHub — mais completo para TypeScript/JavaScript + Supabase. GitLab e Bitbucket sincronizam metadados de repositório na base, ao lado da receita.

    Deploys

    Vercel · Netlify · Cloudflare

    Uma linha do tempo de deploys com projeto, ambiente, estado, branch e commit. Saiba quando um recurso realmente foi lançado.

    Erros

    Sentry

    Erros de produção chegam como tarefas com stack traces — um feed de erros em tempo real, ligável a contas e recursos.

    Schema de banco de dados

    Supabase · Firebase

    Schema e postura de acesso — tabelas, policies, configuração de auth. Nunca lemos as linhas de dados dos seus clientes.

    Jobs em segundo plano

    Inngest

    Jobs assíncronos, falhas e retentativas se tornam tarefas visíveis — a metade invisível do seu sistema, no registro.

    De volta pra fora

    Zapier · webhooks

    Eventos da base disparam webhooks de saída, para que o resto das suas ferramentas reaja sem precisar consultar em loop.

Cada fonte chega por conector — conecte uma e os dados fluem; conecte mais e o retrato se completa.

Uma base

Código de um lado. Clientes do outro. O mesmo registro.

A maioria das equipes mantém a arquitetura numa ferramenta e a receita em outra, sem nada entre elas. Aqui, repositórios, deploys e erros chegam na base que já guarda suas contas, assinaturas e feedback. Assim, o recurso, o código por trás dele, e os clientes esperando por ele deixam de ser três perguntas separadas.

Veja: o mapa de arquitetura, em tempo real na base · Dados de exemplo

Limite honesto: os dados de código entram na base por conector. Erros do Sentry chegam hoje como tarefas; visões de código por cliente mais completas se ativam conforme cada junção é entregue.

1.734 nós · 4.217 conexões · 36 módulos

O grafo no topo desta página é o nosso próprio. Esses são os números reais do mapa de arquitetura da AIOProductOS — a mesma tela que nosso time abre para integrar engenheiros e decidir o que uma mudança vai afetar. A gente não está fazendo demo de um conceito; estamos mostrando o nosso próprio código.

Comece agora

Veja sua própria arquitetura na base.

Conecte o GitHub em um clique — sem CI, sem YAML, nada para configurar. Repositórios e linguagens sincronizam em minutos, o grafo se constrói a partir daí, e ele se mantém atualizado sozinho.

FAQ

Perguntas, respondidas

O que o Codebase Brain mostra?

Sua arquitetura como um grafo interativo — repositórios, módulos, dependências e responsáveis — além de um inventário completo de ativos de código e docs extraídas automaticamente, para você ver o sistema em vez de ler linha por linha.

Quais ferramentas o alimentam?

O grafo de arquitetura se constrói a partir dos seus repositórios GitHub — conecte o GitHub e ele aparece, sem CI ou devops do seu lado. Ao lado, na mesma base: metadados de repositório do GitLab e Bitbucket, deploys do Vercel, Netlify e Cloudflare, e erros do Sentry — junto dos seus clientes e da sua receita.

De onde vêm as docs?

Elas são extraídas automaticamente da base de código mapeada, então a documentação reflete os módulos reais e suas relações em vez de ficar desatualizada num wiki.

Por que mapear o código dentro de um OS de produto?

Porque ele fica na mesma base que a receita e o trabalho de produto — então um módulo não é só código, ele está ligado aos recursos e clientes que atende. Esse é o "porquê", precificado em receita e código.

Preciso mantê-lo atualizado?

Não. Conecte o GitHub e o mapa se reconstrói sozinho — a cada push e duas vezes por dia — sem configuração de CI ou devops. Os clusters com atividade real brilham, refletindo onde o trabalho está realmente acontecendo. A atualização manual continua disponível se você quiser sob demanda.