Ir para o conteúdo

Modelo de dados

Catálogo das tabelas do banco (schema public), agrupadas por domínio. Toda tabela é escopada por clinic_id (unidade) e/ou organization_id (rede). O detalhe de colunas pode ser introspectado com \d <tabela> ou pg_get_functiondef — este documento é o mapa de alto nível.

Snapshot gerado a partir do banco de produção. Ao criar/alterar tabelas, atualize este catálogo.

Identidade, acesso & plataforma

Tabela Papel
organizations Redes/grupos (type: franqueadora | independente)
clinics Unidades (clínicas)
users Usuários internos (equipe) + papel
access_groups Grupos de acesso
invite_tokens, signup_verifications, password_recovery_codes Fluxos de convite/cadastro/recuperação
audit_logs Trilha de auditoria
system_config Configurações/segredos de sistema (key/value)
schema_migrations Registro de migrations
plans, subscriptions, cliwefy_subscriptions, cliwefy_expenses Billing da plataforma SaaS
addons, addon_requests, org_addons Addons por plano
usage_events, usage_meters Medição de uso (storage/WhatsApp/IA)
integration_health, changelog_entries, feedback_items, feedback_votes Observabilidade, changelog e Central de Ideias

Pacientes & prontuário

Tabela Papel
patients Cadastro do paciente
anamneses Anamnese assinada (snapshot imutável)
patient_attachments Anexos/imagens (foto, radiografia, exame, PDF)
patient_odontogram, odontogram_snapshots Odontograma atual + histórico
clinical_notes, clinical_sessions Evoluções e sessões clínicas
treatment_plans, treatment_plan_items, treatment_stages Plano de tratamento versionado
avaliacao_guiada Roteiro guiado da avaliação
memed_prescriptions Receitas emitidas (Memed)
patient_biometrics Biometria (futuro check-in facial)
procedures_catalog, procedure_categories, procedure_materials, procedure_consumables Catálogo de procedimentos + ficha técnica

Agenda & recepção

Tabela Papel
appointments Agenda (consultas/avaliações)
queue_entries Fila do corredor / pré-agendamento / pool de avaliação
clinic_chairs, dentist_schedules Cadeiras e horários dos profissionais
clinic_checkin_config, clinic_reminder_config Config de check-in e lembrete
welcome_calls Ligações de boas-vindas

Comercial, leads & vendas

Tabela Papel
leads, lead_events, lead_interactions, landing_leads Leads + Lead Score (eventos de engajamento)
budgets, budget_items, budget_option_groups Orçamentos (funil) + opções A×B
budget_followups, budget_objections Follow-up e objeções
commercial_plans, nurture_sequences Planejamento comercial e nutrição
referrals, referral_codes, referral_opens, roleta_config Indicação (roleta)

Financeiro

Tabela Papel
patient_charges Cobranças do paciente (Asaas/local)
cash_sessions, cash_movements, cash_entries Caixa diário
clinic_payables, clinic_expense_categories Contas a pagar da unidade (Painel do Dono)
payables, receivables Contas a pagar/receber (franqueadora)
dentist_payables, dentist_payment_terms, dentist_procedure_rates Repasse dos dentistas
contracts Contratos/planos contratados
patient_unblocks Bloqueio/desbloqueio por inadimplência
asaas_events, efi_cob_map, evaluation_fee_config Webhooks Asaas, mapa Efí, taxa de avaliação

Fiscal

Tabela Papel
nfse_notes, nfse_records, nf_imports, clinic_nfse_config NFS-e (emissão, registros, config por clínica)

Estoque & fornecedores

Tabela Papel
inventory_items, inventory_categories, inventory_movements Estoque (itens, categorias, movimentos)
inventory_suppliers, suppliers Fornecedores

Fidelidade

Tabela Papel
loyalty_programs, loyalty_config, loyalty_ledger, loyalty_transactions, loyalty_wallet, patient_loyalty Programa de fidelidade

Ocorrências

Tabela Papel
occurrences, occurrence_messages, occurrence_approvals Ocorrências + escalonamento
occurrence_term_templates, occurrence_term_signatures Termos (cancelamento) + assinatura

Comunicação (WhatsApp / IA / voz)

Tabela Papel
wa_conversations, wa_messages, wa_conversation_notes, wa_quick_replies, wa_webhook_log WhatsApp (inbox)
whatsapp_instances, whatsapp_send_log Instâncias e log de envio
notification_queue, notification_triggers Fila e gatilhos de notificação
ai_agents, ai_conversations, ai_messages, ai_usage_log, clinic_ai_config, conversation_insights IA (agentes, conversas, insights)
voz_config, wvoip_connections Voz (VoIP)

Franqueadora & rede

Tabela Papel
org_packages, org_consent_terms, org_integrations, org_regions, org_consultant_portfolios, org_expenses, org_addons Recursos da rede (pacotes, termos, regionais, portfólios)
royalty_agreements, royalty_entries Royalties/FPP
premiacao_rules, premiacao_entries, clinic_goals Metas & premiação
bi_daily_snapshots Snapshots diários de BI

Config & templates

Tabela Papel
clinic_tv_config, clinic_media_items TV da clínica / mídia
treatment_message_templates Templates de mensagem
cep_geocode Geocodificação (geomarketing)