Skip to main content

​
Schema

CampoTipoDescrição
leadOrganizationIdUUIDv7Identificador único
organizationIdUUIDv7FK para Organization (domínio IAM)
leadIdUUIDv7FK para Lead
metadataJSONDados específicos da organização (tags, segmento, notas, etc.)
createdAtdatetimeTimestamp de criação
updatedAtdatetimeTimestamp da última atualização
Banco de dados: Aurora PostgreSQL (via RDS Proxy). Esta é a entidade pivô do domínio — conecta o Lead global à organização e serve como chave de partição para todos os dados comportamentais no DynamoDB.
Privacidade cross-org: A Organização A nunca pode saber que um lead também pertence à Organização B. Classificações como “é cliente?”, “nível de engajamento”, “risco de churn” são derivadas de Features e LeadMemories, nunca armazenadas como campos nesta entidade.

​
Relacionamentos

​
Regras de Negócio

  • Unique constraint em (organizationId, leadId) — um lead tem no máximo um relacionamento por organização
  • Todos os dados comportamentais (events, memories, features) são escopados ao LeadOrganization, não ao Lead diretamente
  • Organização A não pode ver que um lead também pertence à Organização B
  • Classificações como “é cliente?”, “nível de engajamento”, “risco de churn” são derivadas de Features e LeadMemories, não armazenadas como campos nesta entidade

​
Exemplo

{
  "id": "lo_01HX...",
  "leadId": "lead_01HX...",
  "organizationId": "org_01HX...",
  "metadata": { "tags": ["vip", "enterprise"], "segment": "B2B", "notes": "Decisora técnica" },
  "classification": "HOT",
  "churnRisk": 0.12,
  "createdAt": "2026-01-15T10:30:00Z"
}