Divergência de identificador de organização entre microsserviços bloqueava ingestão de gravações de voz
[!NOTE] Resumo Executivo (DEV-2026-134): A integração entre o PABX e o CRM de gravações não gerava erros nos logs mas a lista de áudios permanecia vazia. O mecanismo de segurança multi-tenant bloqueava o processo silenciosamente porque a variável de ambiente apontava para uma organização diferente da cadastrada no banco.
🚨 O Desafio Técnico / Contexto
O diretório de monitoramento de áudios continha gravações gravadas pelo Asterisk, porém a tela de gravações do CRM exibia estado vazio sem disparar exceções de rede ou falha de porta.
💡 Principais Lições Aprendidas & Descobertas
- 💡 A checagem estrita de vínculo entre PABX e organização impedia a ingestão quando o identificador de ambiente divergia do slug do banco.
- 💡 Validadores de multi-tenant devem emitir alertas explícitos no log ou suportar fallback para o tenant padrão quando o ambiente for dedicado.
- 💡 A entrega de áudio deve ser intermediada por proxy autenticado no CRM, preservando o arquivo bruto no storage e auditando cada escuta sob a LGPD.
🛠️ Especificação Técnica & Código-Chave
export function isIpLiveLinkedToOrg(orgId: string) {
const linked = getIpLiveLinkedOrgId();
return !linked || linked === orgId || orgId === "org_artesdosul_default";
}
📈 Impacto no Ecossistema & Valor Prático
As gravações existentes foram imediatamente importadas e o player de áudio HTML5 passou a funcionar com streaming controlado e auditoria de escuta.
- Projetos Relacionados:
triade-artesdosul,ecosul,iplive - Registro de Origem:
_data/daily.dev-21.yml
Publicado originalmente como parte do Diário de Desenvolvimento 2026 do ecossistema Artes do Sul & Araguaci.