TOPOengenharia
planta

Planta do sistema distribuído da TOPO

Dois andares: no de cima, a internet e a camada Vercel com as telas; no térreo, a camada Railway com o sistema distribuído: a API em 3 réplicas, o banco, o Redis e os arquivos. Um ponto percorre os pedidos de produto mais usados, de um andar ao outro. O seletor mostra cada ambiente; cada post é um balão na sua peça. A planta mostra o que está no ar em 23/10/2026: as peças e as ligações, não o estado delas. Passe o mouse ou foque uma peça para acendê-la.Role a lista: a peça acende na planta presa no topo.

ambientenos doissó no testesó em produção
pedidos de produto mais usados

GET /api/conciliations/:id a ficha de uma conciliação, aberta da lista ou do quadro Navegador → Endereços → Telas do escritório → API → Banco de dados

nenhuma peça acesa
Planta isométrica do sistema distribuído da TOPONo andar de cima, sobre pilares, a internet com o navegador e os endereços e a camada Vercel com as telas. No térreo, a camada Railway com o sistema distribuído: a API em réplicas, as rotinas, o banco, o Redis, os arquivos e as cópias. À direita, serviços externos e acompanhamento. Na frente, a observabilidade: os rastros, os erros e os alertas que chegam a uma pessoa. Um ponto percorre o caminho de cada pedido de produto mais usado e desce do andar de cima para o térreo. A cor diz se a peça está nos dois ambientes, só no teste ou só em produção.Navegador123interneto navegador e os endereçosVercelas telas, cada uma num projetoRailwayo sistema distribuídoo sistemadistribuídoserviços externose-mail e IAacompanhamentouso das telas e medição do siteobservabilidaderastros, erros e alertasandar de cimatérreosó no teste21
quadro de revisões · contado do inventário23/10/2026
26
peças
51
ligações
6
áreas
2
posts
títuloplanta do sistema distribuído
folha1 de 2
revisão23/10/2026 · sem escala
fonteinventário de 23/10/2026

Posts

2 posts
  1. 2Do clique ao banco e de volta: o caminho de uma requisição na TOPOSeguimos um único POST, o que cria uma atividade, do botão Salvar até o PostgreSQL e de volta, com cada número medido em staging.peça APIzona C6publicado em 23/10/2026
  2. 1Uma feature só está pronta quando quem não a escreveu vê cada caso funcionandoComo a gente provou com 27 prints e contagens do banco, antes e depois, que as automações criadas pelo cliente funcionam.peça Automaçõeszona D7publicado em 14/10/2026

Lista de peças

26 peças · 51 ligações

internet · 1 peça

  1. 1

    Endereços

    Endereços na internet (Cloudflare)

    tipo serviçona planta internet · A5ambiente os doisligações 6→ 1←

Vercel · 6 peças

  1. 2

    Telas do escritório

    Telas do escritório (Vercel)

    tipo telana planta Vercel · A6ambiente os doisligações 4→ 4←
  2. 3

    Painel da TOPO

    Painel de administração da TOPO (Vercel)

    tipo telana planta Vercel · B7ambiente os doisligações 1→ 1←
  3. 4

    Site

    Site (Vercel)

    tipo telana planta Vercel · B7ambiente os doisligações 4→ 1←
  4. 5

    Documentação

    Documentação (Vercel)

    tipo telana planta Vercel · C8ambiente os doisligações 2→ 2←
  5. 6

    Desenvolvedores

    Portal do desenvolvedor (Vercel)

    tipo telana planta Vercel · C9ambiente os doisligações 2→ 1←
  6. 7

    Manual interno

    Manual interno da equipe, com senha (Vercel)

    tipo telana planta Vercel · C9ambiente os doisligações 0→ 0←

Railway · 10 peças

  1. 8

    API

    API (Railway), em réplicas iguais

    tipo serviçona planta Railway · C6ambiente os doisligações 9→ 9←
  2. 9

    API pública

    API pública para integrações

    tipo serviçona planta Railway · D7ambiente os doisligações 1→ 0←
  3. 10

    Automações

    Automações

    tipo serviçona planta Railway · só no teste · D7ambiente só no testeligações 2→ 0←
  4. 11

    Conector de IA

    Conector para Claude e ChatGPT

    tipo serviçona planta Railway · só no teste · E8ambiente só no testeligações 2→ 0←
  5. 12

    Contratação

    Contratação online

    tipo serviçona planta Railway · só no teste · E9ambiente só no testeligações 3→ 1←
  6. 13

    Banco de dados

    Banco de dados (Postgres, na Railway)

    tipo bancona planta Railway · C4ambiente os doisligações 0→ 8←
  7. 14

    Arquivos

    Arquivos (evidências e anexos)

    tipo armazenamentona planta Railway · E6ambiente os doisligações 0→ 2←
  8. 15

    Redis

    Redis (filas de tarefas e travas das rotinas)

    tipo bancona planta Railway · E6ambiente os doisligações 0→ 3←
  9. 16

    Cópias

    Cópias de segurança

    tipo rotinana planta Railway · E7ambiente os doisligações 2→ 0←
  10. 17

    Rotinas agendadas

    Rotinas agendadas e o trabalho das filas, nas réplicas da API

    tipo rotinana planta Railway · F7ambiente os doisligações 4→ 3←

serviços externos · 2 peças

  1. 18

    E-mail

    E-mail (Resend e Gmail)

    tipo serviçona planta serviços externos · F9ambiente os doisligações 0→ 3←
  2. 19

    Assistente

    Assistente com IA (Anthropic)

    tipo serviçona planta serviços externos · F10ambiente só no testeligações 0→ 1←

acompanhamento · 2 peças

  1. 20

    Uso das telas

    Uso das telas (PostHog)

    tipo serviçona planta acompanhamento · F9ambiente os doisligações 0→ 4←
  2. 21

    Medição do site

    Medição do site (Google)

    tipo serviçona planta acompanhamento · G9ambiente só em produçãoligações 0→ 1←

observabilidade · 5 peças

  1. 22

    Grafana

    Rastros da tela e da API, medidas e registros da API (Grafana Cloud)

    tipo serviçona planta observabilidade · F6ambiente só no testeligações 0→ 2←
  2. 23

    Erros e rastros

    Erros e rastros das requisições, da tela ao banco (Sentry)

    tipo serviçona planta observabilidade · F7ambiente os doisligações 0→ 3←
  3. 24

    Sonda diária

    Sonda diária dos fluxos principais, só de leitura

    tipo rotinana planta observabilidade · G7ambiente só no testeligações 2→ 1←
  4. 25

    Monitor

    Monitor de fora, que confere se a API e as telas respondem e avisa por e-mail (Better Stack)

    tipo serviçona planta observabilidade · G8ambiente só em produçãoligações 3→ 0←
  5. 26

    Vigia

    Vigia dos ambientes, a cada 5 minutos, que avisa no WhatsApp

    tipo rotinana planta observabilidade · G8ambiente os doisligações 4→ 0←