A gravação de uma chamada na Colômbia, sua transcrição no Brasil e o registro de um agente nos Estados Unidos têm regras legais distintas. As três coisas vivem no Qomni. A pergunta de design foi onde guardá-las, e a resposta define quase tudo o mais: uma célula por país.
O problema
Um único banco de dados para o mundo todo é a opção mais simples de operar. Obriga a escolher um país para os dados de todos os clientes e a explicar essa escolha a cada um deles. Com gravações de voz e conversas com clientes, essa explicação nem sempre convence.
A alternativa habitual é uma região por cliente, escolhida no cadastro. Põe a decisão nas mãos de quem tem menos contexto. E a faz aparecer em todo lugar: na URL da API, na configuração do cliente, em cada SDK.
O que fizemos
Cada workspace nasce em uma célula (us1, co1 ou br1): uma cópia completa
da plataforma em uma região. Na frente de todas as células há um único ponto
de entrada, o edge, um Worker da Cloudflare que recebe cada requisição e
a leva à célula correta.
A célula nunca aparece em uma URL. Vai dentro da chave de API
(sk_agents_live_co1_…), e o edge a lê dali sem consultar nada. Para o
app web, sai do workspace com o qual você entrou. Seu código é o mesmo para
um cliente em Bogotá e para um em São Paulo.
O que custou
- Uma origem não pode confiar em ninguém além do edge. Por isso o edge assina cada requisição com um token Ed25519. Vale 10 segundos, serve para uma única requisição e fica ligado ao host, à célula e ao IP do cliente. Uma origem rejeita tudo o que não traga esse token, então ninguém consegue pular o edge chamando uma célula diretamente.
- Uma chave só vale na sua célula. Usá-la em outra responde
421 wrong_cell. Na prática não acontece, porque a célula da chave é a do workspace que a criou, mas a regra existe para que um erro de configuração nunca cruze dados entre países. - Os dados não se movem. Um workspace fica na sua célula. Mover um seria mover gravações de clientes de um país para outro, e preferimos não ter essa ferramenta a tê-la e usá-la mal.
O que ganhamos
Cumprir as regras de cada país é uma propriedade da arquitetura, não um processo. Uma requisição viaja menos. E um cliente nunca precisa escolher uma região nem lembrar dela.
Se você quer ver o percurso completo de uma requisição, está em O edge e as células.
Receba um aviso a cada artigo novo
Uma nota de engenharia a cada publicação; nada mais.