BDS0.1

Arquitetura e responsabilidades

O que o Tooling mantém, o que copia do Core e quais bases e fluxos o leem.

Revisado 2026-10-28Markdown

Tooling and Access mantém ferramentas, workspaces, contas, identity bindings, planos, assentos, principals, recursos e concessões. O Core mantém pessoas, organizações, memberships, times, departamentos e tags. O CRM decide como uma conta do Cal.com é direcionada a um vendedor; o Tooling só fornece a conta.

Mirrors que entram

Tabela local Origem no Core Uso aqui
Person (mirror) People Pessoa por trás de um vínculo, controladora ou dona de workspace, pagadora de plano
Organization (mirror) Organizations Company por trás de um Tool Workspace
Membership (mirror) Membership Member atendido por um vínculo; origem de Bound Membership ID
Department (mirror) Department Ainda sem vínculo nativo
Grid view Team Ainda sem vínculo nativo; tabela com nome errado
Tags (mirror) Tags Classificação opcional em toda tabela

Registros que saem

Tabela de origem Base consumidora Tabela consumidora Uso no consumidor
Tool Systems Central Tool (mirror) Ferramenta em que um sistema roda
Tool Communication Tool (mirror) Ferramenta usada por um Channel
Tool Workspace Communication Tool Workspace (mirror) Workspace em que um Channel vive
Tool Account CRM Tool Account Roteamento do Cal.com pela Automation: Lead Source

O Airtable não expõe a configuração de sync pela API. As views de origem foram deduzidas pelos conjuntos de campos iguais: bds:Tool, Grid view de Tool Workspace e ops:ToolAccount Sync. Esta última inclui Access Token, e a cópia do CRM tem uma coluna Access Token; veja Segredos. Um mirror de Tool Account na Communication e o vínculo Channel → Tool Account foram decididos mas não construídos (Work Item “Mirror Tool Account into Communication and link it from Channel”).

Siga os dados

  • Destinatário no Slack: nome de uma membership em KPIs & OKRs → Person (mirror) → Identity Binding aberto → Tool Account humana → id do workspace → bot desse workspace no cache de tokens.
  • Vendedor do Cal.com: Tool Account → Tool Account do CRM → regra da Lead Source → empresa e membership responsáveis.
  • Caixa de e-mail (fluxo inativo): caixa do Gmail → Tool Account pelo Login Alias → Bound Membership ID → membership no CRM.

Esses leitores usam a API do Airtable, não syncs. Automações lista cada um.

Resolva conflitos na origem

Corrija pessoas, organizações e memberships no Core. Corrija ids de conta, logins, tipos e vínculos aqui; as cópias nos consumidores são somente leitura. Corrija o roteamento de vendedores na Lead Source do CRM, não renomeando contas. A identidade vem dos vínculos, nunca da comparação de endereços de e-mail.

Separe acesso de registro

Assento é direito comercial, vínculo não verificado não autoriza nada e tag não concede nada. Só a Access Grant registra uma permissão, e ela estava vazia em 2026-10-28. Ninguém auditou quem pode abrir esta base ou seus consumidores; os valores dos campos não descrevem o compartilhamento no Airtable.