Catálogo de Stored Procedures e RPCs do Schema Connect

As funções de banco no schema connect operam como fronteira transacional atômica para operações que exigem integridade relacional, segurança RLS e processamento assíncrono.

1. Resolução Multi-Tenant & Identidade

Função / Procedure Parâmetros Propósito & Regra de Negócio

public.get_partner_branding_by_domain

p_domain TEXT

Retorna metadados de apresentação pública de parceiro ativo sanitizado por regex RFC 1123 (máx 253 caracteres). EXECUTE aberto para anon e authenticated.

connect.get_partner_id_by_domain

p_domain TEXT

Resolução interna do UUID do parceiro a partir do host de requisição.

connect.get_user_organizations

p_user_id UUID, p_partner_id UUID

Retorna o catálogo de organizações onde o usuário possui vínculo ativo no parceiro.

2. Provisionamento e Ciclo de Vida Organizacional

Função / Procedure Parâmetros Propósito & Regra de Negócio

connect.provision_organization

p_partner_id UUID, p_name TEXT

Criação atômica de organização gerando slug único em base26 e atribuindo o criador como org_admin.

connect.deprovision_organization

p_org_id UUID

Exclusão lógica/física com verificação estrita de papéis administrativos e confirmação textual.

connect.provision_store_group

p_org_id UUID, p_name TEXT

Provisionamento de cluster de lojas dentro de uma organização autorizada.

connect.deprovision_store_group

p_group_id UUID

Remoção de agrupamento de unidades validando ausência de vínculos orfãos.

connect.provision_location

p_group_id UUID, p_name TEXT, p_slug TEXT

Criação de filial física vinculada ao cluster operacional.

connect.deprovision_location

p_location_id UUID

Desprovisionamento de filial física com checagem de instâncias associadas.

connect.provision_location_tag

p_org_id UUID, p_name TEXT, p_color TEXT

Criação de tag analítica no escopo da organização.

connect.sync_location_tags

p_location_id UUID, p_tag_ids UUID[]

Sincronização atômica em lote das tags atribuídas a uma unidade.

3. Gestão de Convites, Membros & RBAC

Função / Procedure Parâmetros Propósito & Regra de Negócio

connect.get_invitation_details

p_token TEXT

Consulta pública protegida dos dados do convite para tela de aceitação.

connect.accept_user_invitation

p_token TEXT, p_user_id UUID

Validação temporal, marcação do convite como aceito e atribuição dos cargos ao usuário.

connect.manage_member_access

p_org_id UUID, p_user_id UUID, p_role TEXT, p_location_ids UUID[]

Atualização transacional de cargo e escopo de acesso às unidades físicas.

connect.remove_member

p_org_id UUID, p_user_id UUID

Revogação imediata de permissões e remoção do membro da organização.

4. Motor de Rastreabilidade e Notificações da Home

Função / Procedure Parâmetros Propósito & Regra de Negócio

connect.get_active_feed_notifications

p_org_id UUID, p_scope_type TEXT, p_location_id UUID

Consulta das notificações ativas respeitando hierarquia de visualização e dispensas individuais do usuário.

connect.reconcile_incident_buckets

p_buckets TEXT[]

Motor convergente que atualiza system_notifications baseado em resource_alert_states com Advisory Locks lexicais ordenados.

connect.reconcile_single_bucket

p_org_id UUID, p_bucket_key TEXT

Reconciliação pontual e transacional de um bucket específico de incidente.

connect.rebuild_all_system_notifications

Nenhum

Rotina de self-healing convergente e idempotente que reavalia toda a base de incidentes ativos.

5. Conectores WhatsApp, Uptime & Outbox

Função / Procedure Parâmetros Propósito & Regra de Negócio

connect.reserve_whatsapp_reconciliation_lease

p_worker_id TEXT, p_ttl_seconds INT

Concede lease concorrente com bloqueio seguro para orquestradores de reconexão.

connect.calculate_whatsapp_uptime

p_instance_id UUID, p_window_days INT

Calcula o percentual de disponibilidade da instância com base nos registros do ledger.

connect.reserve_outbox_event

p_worker_id TEXT, p_batch_size INT

Reserva eventos da fila de e-mails transacionais com lock transacional anti-duplicação.

connect.complete_outbox_event

p_event_id UUID, p_success BOOLEAN, p_error TEXT

Finaliza o ciclo de vida do evento no outbox atualizando timestamps e retentativas.

6. Governança e Restrições de Execução Pública

Rotinas administrativas internas do PostgreSQL, tais como public.rls_auto_enable(), possuem permissão EXECUTE estritamente revogada para PUBLIC, anon e authenticated (conforme migração 20260914210000), sendo restritas aos contextos de migração do CI/CD sob role proprietária.