TermoCore
Todos os clientes da Termotubos num crate só, o termo_core. Cada serviço é um módulo (termo_core::bucket, termo_core::auth...) e cada rota da API do serviço é uma função de uma linha, gerada a partir do openapi.json dele.
= "=0.1.5" # todos os serviços
= { = "=0.1.5", = ["webhook_postgres"] } # + fila de saída de eventos
Fixe sempre a versão exata (=). O workflow publica cada mudança de contrato do sandbox subindo só o último número, inclusive quando a mudança quebra código. Para atualizar, troque a versão de propósito e confira se compila.
let credencial_de_acesso = token_do_usuario_logado;
let usuario = buscar_pelo_id_usuario.await?;
let pagina = buscar_paginador_usuario
.await?;
O nome da função é a ação seguida do recurso (operationId usuarioBuscarPeloId com a tag usuario vira buscar_pelo_id_usuario). Rotas públicas não pedem credencial. Todo erro vem como ErroAoChamarServico, com o status e o campo erro da resposta.
Configuração: só a variável AMBIENTE
AMBIENTE |
Para onde cada serviço aponta |
|---|---|
LOCALHOST |
o servidor local (http://localhost:51xx1) ou o sandbox, escolhido por serviço |
SANDBOX |
https://sandbox-api-<serviço>.termotubos.com.br |
PRODUCTION |
https://api-<serviço>.termotubos.com.br |
A tabela fica em termo_core/base/servicos.rs. No LOCALHOST, o TermoAI usa o endereço do sandbox (EnderecoNoLocalhost::MesmoEnderecoDoSandbox), então não é preciso levantar a IA na máquina. Sem AMBIENTE ou com um valor inválido, o processo para com uma mensagem clara: nunca cai em PRODUCTION por engano.
Para apontar um serviço para outro endereço só num processo (ex.: teste): termo_core::substituir_endereco_do_servico_neste_processo(&termo_core::servicos::TERMO_AUTH, "http://...").
Serviços
| Módulo | Serviço |
|---|---|
termo_core::ai |
TermoAI |
termo_core::auth |
TermoAuth |
termo_core::bucket |
TermoBucket |
termo_core::intranet |
TermoIntranetAPI |
termo_core::leads |
TermoLeads |
termo_core::mcp |
TermoMCP |
termo_core::portal |
TermoPortal |
termo_core::quality |
TermoQuality |
termo_core::sell |
TermoSell |
termo_core::status |
TermoStatus |
termo_core::studio |
TermoStudio |
termo_core::support |
TermoSupport |
termo_core::tracing |
TermoTracing |
termo_core::webhook |
TermoWebhook |
termo_core::wms |
TermoWMS |
Cada módulo também é uma feature, todas ligadas por padrão (todos_os_servicos). Quem quiser compilar menos usa default-features = false, features = ["auth", "bucket"]. O webhook tem ainda webhook_publicar, webhook_receber e webhook_postgres (veja abaixo).
Eventos do TermoWebhook
Os contratos dos eventos são gerados dos esquemas cadastrados no hub, lidos de GET /esquemas.json do TermoWebhook (o TermoCore não acessa o banco de nenhum serviço). Cada aplicativo dono vira um módulo:
use ColaboradorCriadoV1;
// Ao subir, uma vez (feature webhook_postgres):
iniciar_envio_automatico_dos_eventos_guardados.await?;
// No model, dentro da transação que já grava a mudança:
guardar_evento_para_publicar_na_mesma_transacao.await?;
// Na rota que recebe as entregas (feature webhook_receber):
let evento = .await?;
O endereço do hub vem do AMBIENTE. O app informa só TERMOWEBHOOK_APLICATIVO_ID e, se publica, o segredo TERMOWEBHOOK_SEGREDO_DE_PUBLICACAO.
Como o código é gerado
openapi/fica no git: toda mudança de API aparece no diff.rotas.rs,tipos.rseeventos/contratos.rsnunca são editados à mão. Código feito à mão fica em outros arquivos do módulo (comopublicar.rsereceber.rsdowebhook).- Serviço novo: adicione a constante em
termo_core/base/servicos.rse emTODOS_OS_SERVICOS, a feature e opub modnotermo_core, e rode o gerador. Ele cria omod.rsdo módulo novo.
Publicação
O workflow publicar-termo-core.yml roda a cada push na production, manualmente ou por repository_dispatch (contratos_atualizados). Ele sincroniza, gera, testa, faz commit dos contratos que mudaram e publica o termo_core no crates.io quando o código mudou, subindo o último número da versão. Usa o segredo CARGO_REGISTRY_TOKEN.