A Topo é uma plataforma modular que roda a operação contábil de grupos com várias empresas em cima do ERP deles: conciliação de contas com revisão, aprovação e prazos em dias úteis, gestão do fechamento, obrigações acessórias e certidões, demonstrações financeiras, auditoria externa e consolidação. A ideia é dar padronização, controle, visibilidade e rastreabilidade a essa operação.
Cofundei a Topo em outubro de 2025 com um contador. Construí a arquitetura de produto, a engenharia e a segurança. Hoje são 8 módulos de produto construídos, incluindo um assistente sobre Claude.
Os dados são de finanças corporativas, então o isolamento entre clientes fica no banco, e a trilha de auditoria só aceita inclusão. A Topo chegou a ARR de cinco dígitos no primeiro ano, com clientes B2B pagantes e sem gasto com distribuição.
Vercel: seis apps Next.js 16 (app, painel admin, site, docs, portal do desenvolvedor e wiki), cada um construído só quando o deploy hook dele é chamado.
Railway (produção): API NestJS 12 num container Docker construído pelo Dockerfile, três réplicas com health check, servindo a API pública v1 (REST e GraphQL só leitura) e o conector MCP em HTTP. PostgreSQL acessado via Prisma 7, com RLS habilitada e forçada nas 120 tabelas de cliente. Redis com filas Bull 4 (importação de balancete, operações em lote, sincronização de períodos, e-mail) e travas das tarefas agendadas. Workers e crons rodam dentro do processo da API. MinIO como armazenamento compatível com S3 para as evidências, guardadas sob o cliente dono.
Staging: ambiente separado, com uma réplica e dados próprios.
Cloudflare: DNS do domínio e proxy HTTPS na frente da API.
GitHub: repositório do código e CI no GitHub Actions (checks de cada PR, cópia cifrada mensal do banco e dos anexos).
Serviços externos: Anthropic (Claude, modelo do assistente), Sentry (rastreio de erros), Resend (e-mail transacional por SMTP), PostHog (uso de tela).
Clientes: equipe contábil no navegador, ERP e BI do cliente com chave de API com escopo, agentes de IA como clientes MCP.
Navegador → Vercel: HTTPS, carrega as telas Next.js.
Navegador → Cloudflare → API: HTTPS com o login num cookie que o código da tela não lê; nenhuma tela fala com o banco.
ERP e BI → Cloudflare → API: API pública v1, REST e GraphQL só leitura, autenticada com chave de API com escopo.
Agentes de IA → Cloudflare → API: MCP em HTTP com OAuth, servido pelo mesmo processo da API.
Cloudflare → API: proxy HTTPS. Em cada requisição a API confere login, cliente, papel e módulo.
API → PostgreSQL: SQL via Prisma 7, com o cliente marcado em cada transação; a política de RLS forçada esconde as linhas dos outros clientes.
API → MinIO: API S3; arquivos guardados sob o cliente dono e entregues só pela API depois da checagem de permissão.
API → Redis: enfileira jobs Bull; as tarefas agendadas pegam uma trava no Redis para não rodar duas vezes.
Redis → workers: jobs Bull consumidos pelo próprio processo da API.
Workers → Resend: SMTP para e-mail transacional.
API → Anthropic: SDK da Anthropic em HTTPS para o Claude; as ferramentas do assistente leem pelos repositórios sujeitos à RLS, com teto de custo mensal por cliente.
API → Sentry: erros.
Navegador → Sentry, PostHog: erros das telas para o Sentry, uso de tela para o PostHog.
GitHub → Railway: o script de publicação grava a versão num arquivo do repositório e faz o push; a Railway só constrói a imagem Docker quando esse arquivo muda. Antes de a API nova ligar, um passo único sincroniza o schema e reaplica a RLS; se sobrar tabela de cliente sem a política, a publicação para e a API nova não liga.
GitHub → Vercel: depois que a API responde com o commit novo, o script de publicação chama os deploy hooks das telas na Vercel.
Isolar os tenants no banco, com row-level security ligada e forçada em toda tabela que tem tenant.
Alternativa descartada: Confiar só no filtro por tenant escrito em cada consulta da aplicação.
Por quê: Um WHERE esquecido numa consulta mostraria a contabilidade de uma empresa para outra. A política do banco vale para toda consulta, inclusive as que ninguém lembrou de revisar. Sem o FORCE, o dono da tabela passaria por cima das próprias políticas.
Um teste que falha se qualquer modelo com tenant não tiver RLS ligada, forçada e com política, sem lista de exceções.
Alternativa descartada: Uma lista de tabelas liberadas da regra, cada uma justificada na hora.
Por quê: Uma lista de exceções cresce com itens que parecem defensáveis um a um e nunca são revistos. Tabela que precisa de outra regra recebe uma política própria em vez de ficar sem nenhuma.
Result<T, E> e ValidationResult com severidade no domínio e na aplicação.
Alternativa descartada: Exceções com try/catch para as falhas de negócio.
Por quê: Separa falha esperada de erro do sistema, deixa o tratamento explícito em cada chamada e permite que a tela explique o motivo de uma recusa, como a mesma pessoa preparar e aprovar uma conciliação. O custo é código mais verboso e o controller precisa desembrulhar o resultado.
Clean Architecture com domínio sem dependência externa e fronteiras checadas no CI.
Alternativa descartada: Regras de negócio escritas direto nos serviços do framework e nas chamadas do ORM.
Por quê: As regras contábeis são testadas sem banco e sem framework. O preço é cerimônia: uma feature simples pede vários arquivos e uma camada de mappers entre domínio, banco e DTO.
Módulo novo nasce desligado: entra no catálogo e no contrato, mas sem rota nem tela até ser ligado, e o acesso é negado por padrão.
Alternativa descartada: Publicar o módulo visível assim que o código chega em produção.
Por quê: A parte comercial (pacotes, preço, concessão por empresa) anda sem depender de a engenharia ter terminado, e nenhum cliente vê um módulo pela metade.