Dicionário de Tabelas e Tipos do Schema Connect

O schema connect centraliza o plano de dados relacional de conectores, isolamento multi-tenant, instâncias de mensageria e o motor reativo de notificações operacionais.

1. Domínio Multi-Tenant & Hierarquia Organizacional

Tabela Chave Primária RLS Responsabilidade

connect.partner_brandings

id (UUID)

Sim

Mapeamento de domínios customizados (custom_domain), identidades visuais, logos e identificador do parceiro (partner_id).

connect.organizations

id (UUID)

Sim

Organizações soberanas de clientes sob autoridade de um parceiro.

connect.store_groups

id (UUID)

Sim

Agrupamentos e clusters lógicos de unidades operacionais dentro de uma organização.

connect.locations

id (UUID)

Sim (Force)

Unidades físicas e filiais vinculadas a grupos de lojas com resolução de slug semântico.

connect.tags

id (UUID)

Sim

Catálogo analítico de etiquetas corporativas para segmentação de unidades.

connect.location_tags

(location_id, tag_id)

Sim

Tabela associativa de relacionamento N:N entre unidades físicas e tags.

2. Controle de Acesso, Membros & Onboarding

Tabela Chave Primária RLS Responsabilidade

connect.organization_members

(organization_id, user_id)

Sim

Relação de membros vinculados à organização com controle de papel hierárquico.

connect.user_roles

id (UUID)

Sim

Atribuição de permissões operacionais (partner_admin, org_admin, store_manager, operator).

connect.user_location_access

(user_id, location_id)

Sim

Escopo de permissão refinado para operadores delimitados a unidades específicas.

connect.invitations

id (UUID)

Sim

Motor de convites e onboarding com tokens criptográficos CSPRNG, controle de expiração e outbox de e-mails.

3. Mensageria, Provedores & Conectores

Tabela Chave Primária RLS Responsabilidade

connect.whatsapp_instances

id (UUID)

Sim (Force)

Instâncias de mensageria WhatsApp com associação à unidade física, segregação de provedor (evolution ou zapster) e estado de pareamento.

connect.instances

id (UUID)

Sim

Tabela canônica de instâncias de comunicação integradas aos gateways externos.

connect.instance_status_ledger

id (BIGINT)

Sim

Ledger sequencial imutável de transições de status, eventos de conexão e métricas de uptime.

connect.email_integrations

id (UUID)

Sim

Configurações seguras de envio transacional de e-mail por organização (SMTP autenticado ou OAuth delegado).

connect.email_outbox

id (UUID)

Sim

Fila transacional de e-mails pendentes de despacho para garantia de entrega assíncrona desacoplada.

connect.oauth_states

state (TEXT)

Sim

Armazenamento de tokens transitórios de handoff OAuth 2.0 protegidos com prazo estrito de expiração.

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

Tabela Chave Primária RLS Responsabilidade

connect.resource_alert_states

id (UUID)

Sim

Fonte Única da Verdade (SSOT) dos incidentes físicos ativos (ACTIVE) ou resolvidos (RESOLVED) por recurso rastreado.

connect.system_notifications

id (UUID)

Sim

Projeção Agregada de Leitura (Read Model) deduplicada por bucket_key, otimizada para o feed da Home e registrada no Supabase Realtime CDC (REPLICA IDENTITY FULL).

connect.system_notification_resources

(notification_id, resource_alert_state_id)

Sim

Ponte relacional N:N que associa notificações agregadas a incidentes físicos concretos.

connect.user_notification_dismissals

(notification_id, user_id)

Sim

Registro de dispensas individuais realizadas pelos usuários, com invalidação reativa em tempo real.