Banco de Dados

O banco do Vendee é organizado em torno do conceito de workspace (tenant). Toda tabela de dados de negócio carrega um workspace_id para isolamento multi-tenant via RLS.

Tabelas de negócio (core CRM)

Tabela	Descrição
`workspaces`	Tenants — cada cliente é um workspace
`members`	Usuários vinculados a workspaces (role, is_active, display_name)
`deals`	Negócios/oportunidades (valor, status, qualified_override, owner_id)
`contacts`	Contatos/pessoas (owner_id, custom fields)
`companies`	Empresas clientes (segmento, tax_regime)
`activities`	Atividades/tarefas (tipo, status, scheduled_at)
`comments`	Comentários em negócios (kind: note/observation/activity_log)
`pipelines`	Funis de venda (lost_deal_visibility_days)
`stages`	Etapas de um pipeline
`deal_products`	Produtos vinculados a negócios (qty, unit_price, discount)

Tabelas de configuração

Tabela	Descrição
`deal_types`	Tipos de negócio
`lead_sources`	Origens de leads
`loss_reasons`	Motivos de perda
`activity_types`	Tipos de atividade
`products`	Catálogo de produtos/serviços (área, default_frequency, suggestion_metadata)
`custom_field_definitions`	Definição de campos personalizados
`custom_field_values`	Valores dos campos personalizados por entidade

Tabelas de qualificação

Tabela	Descrição
`qualification_forms`	Formulários (com threshold de score)
`qualification_questions`	Perguntas
`qualification_answers`	Opções de resposta com peso
`qualification_responses`	Respostas de um deal a um formulário
`qualification_response_items`	Itens individuais de resposta
`qualification_score_ranges`	Faixas de score (Muito Frio → Muito Quente)

Tabelas de propostas

Tabela	Descrição
`proposals`	Propostas comerciais (template_type, status, token público)
`proposal_events`	Timeline de eventos da proposta (created, viewed, accepted, etc.)
`workspace_proposal_settings`	Config de propostas por workspace (bandas, extras, template padrão)
`workspace_guided_options`	Opções guiadas customizáveis do wizard

Tabelas de metas e workspace

Tabela	Descrição
`workspace_monthly_goals`	Metas mensais por membro e mês (revenue_target, count_target)

Tabelas de base de clientes

Tabela	Descrição
`client_bases`	Bases importadas (nome, data, qtd de entradas)
`client_base_entries`	Linhas da planilha importada
`client_base_snapshots`	Snapshots de análise gerados
`ai_insights`	Insights gerados por IA sobre a base

Tabelas de admin/auditoria

Tabela	Descrição
`super_admins`	Usuários com acesso super admin (user_id)
`admin_audit_log`	Log de ações administrativas (actor_id, action, workspace_id)
`federal_companies`	Base federal de CNPJs para lookup

Relacionamentos chave

deals → contacts, companies, stages, members (owner_id), lead_sources, loss_reasons, deal_types
activities → deals, members, activity_types
stages → pipelines
deal_products → deals, products
proposals → deals, workspaces
Todo campo de dados tem workspace_id para isolamento multi-tenant

Tipos TypeScript

Os tipos são gerados a partir do schema do banco. Para cada tabela existem três variações:

import type { Database } from "@repo/supabase/types";

// Linha lida do banco (todos os campos preenchidos)
type Deal = Database["public"]["Tables"]["deals"]["Row"];

// Payload de INSERT (campos com default são opcionais)
type DealInsert = Database["public"]["Tables"]["deals"]["Insert"];

// Payload de UPDATE (todos os campos opcionais)
type DealUpdate = Database["public"]["Tables"]["deals"]["Update"];

Nunca escreva tipos de tabela à mão. Use sempre os tipos gerados em @repo/supabase/types — eles são a fonte da verdade e ficam sincronizados com migrations. Se um tipo parecer errado, regenere antes de criar um shim local.

Banco de Dados

On this page