Modelos de Dados

Visao geral

O sistema usa dois conjuntos de dados:

• dados operacionais de cobranca no SQL Server
• dados auxiliares e de aplicacao no MySQL

Nem todo schema esta formalizado no repositorio. Parte foi inferida a partir de queries e de criacao dinamica em runtime.

SQL Server: entidades de negocio identificadas

Entidades mais recorrentes nas consultas:

• proposta
• condicao_pagamento_proposta
• parcela
• parcela_condicaopagamentoproposta
• titulo
• receber
• amortizacao
• renegociacao
• cliente
• pessoa
• item_proposta
• unidade_venda
• modulo
• fase
• empreendimento
• usuario

Leitura funcional dessas entidades

• proposta: unidade central de contrato/negocio.
• parcela: vencimentos e composicao financeira.
• titulo + amortizacao: recebimento e pagamento efetivo.
• renegociacao: vinculo com usuario/cobrador em certos fluxos.
• cliente e pessoa: dados cadastrais.
• item_proposta ate empreendimento: hierarquia de produto/residencial.

MySQL: entidades de aplicacao identificadas

Autenticacao e usuarios

usuarios

Campos inferidos:

• id
• nome
• email
• senha_hash
• perfil
• status

Uso:

• login
• autorizacao por perfil
• atribuicao de carteira
• ownership de registros internos

Operacao de cobranca

historico_contato

Tabela central da operacao, usada para:

• registrar contatos
• lembrar proximas cobrancas
• registrar eventos de sistema
• registrar encaminhamento juridico
• registrar automacoes do fluxo 30 dias

Campos inferidos recorrentes:

• id
• cpf_cliente
• numero_parcela
• tipo_contato
• observacao
• usuario_id
• usuario_nome
• data_registro
• data_proxima_cobranca
• motivo_id
• lembrete_status

cobranca_atribuicao_cliente

Uso:

• distribuicao de carteira entre cobradores
• historico de movimentacao
• identificacao do cobrador atual

Campos inferidos:

• id
• cliente_cpfcnpj
• cobrador_usuario_id
• cobrador_anterior_id
• data_ultima_movimentacao
• fonte
• status

cobranca_atendimento

Uso:

• trilha de atendimento por cobrador

Campos inferidos:

• cliente_cpfcnpj
• cobrador_usuario_id
• tipo_acao
• observacoes
• status_apos_acao

cobranca_30dias_registros

Uso:

• controle do fluxo 30 dias

Campos inferidos:

• cobrador_usuario_id
• cpf_cnpj
• proposta
• data_vencimento
• valor
• origem
• advogado
• atualizado_em

cobranca_titulos_cache

Uso inferido:

• fallback local para descobrir flag em_advogado

Status:

• schema nao encontrado; apenas consumido por cobranca30/registrar.php

chronos_sync_credits

Uso:

• base local sincronizada dos contratos da Chronos
• leitura operacional da Travessia sem consulta realtime da API
• apoio a reconciliacao e enriquecimento

Campos principais versionados:

• credit_id
• cpf_cnpj
• debtor_name
• contract_number
• reference_id
• enterprise_name
• unity_name
• status
• payment_status
• next_due_date
• payment_total_amount
• overdue_total_amount
• parcel_quantity
• parcel_paid_quantity
• parcel_overdue_quantity
• parcel_not_paid_quantity
• payload_hash
• payload_json
• source_updated_at
• synced_at

chronos_sync_parcels

Uso:

• base local sincronizada das parcelas da Chronos
• identidade tecnica da linha Travessia por credit_id + parcel_id
• classificacao posterior em quebras, 30 dias, advogado e renegociacoes

Campos principais versionados:

• parcel_id
• credit_id
• parcel_key
• cpf_cnpj
• contract_number
• parcel_number
• number_description
• status
• status_name
• due_date
• payment_date
• payment_total_amount
• current_total_amount
• parcel_frequency_name
• parcel_frequency
• parcel_type_name
• payment_type
• negotiation_id
• negotiation_status_name
• obs
• payload_hash
• payload_json
• source_updated_at
• synced_at

chronos_sync_runs

Uso:

• auditoria dos jobs de sincronizacao Chronos
• rastreio de carga completa, incremental e reprocessamento

Campos principais versionados:

• id
• sync_type
• trigger_source
• requested_by_user_id
• status
• scope_reference
• total_credits_received
• total_parcels_received
• credits_processed
• parcels_processed
• inserted_credits
• updated_credits
• inserted_parcels
• updated_parcels
• started_at
• finished_at
• error_message
• metadata_json

Carteira saudavel e operacao auxiliar

clientes_inativos

Schema formal em clientes_inativos.sql

Campos:

• id
• cpf_cnpj
• nome
• residencial
• cobrador
• total_debito
• status_inativo
• motivo
• data_inclusao
• usuario_inclusao_id
• data_ultima_atualizacao

cliente_atendido

Uso:

• marcacao simples de cliente atendido por cobrador

Documentos

documentos_cliente

Criada em runtime por src/api/documentos/_bootstrap.php

Campos:

• id
• cpf
• categoria
• titulo
• arquivo_original
• arquivo_salvo
• mime_type
• tamanho_bytes
• criado_por
• criado_por_nome
• criado_em

Categorias observadas:

• nota_promissoria
• contrato_compra_venda
• documento_pessoal
• renegociacao

Metas e gratificacoes

metas

Campos inferidos:

• id
• mes
• ano
• valor
• valor_atingido
• premio_meta_atingida
• inadimplencia
• percentual_inadimplencia
• created_at
• updated_at

gratificacao_parametros

Uso:

• parametros do fechamento mensal

gratificacao_fechamento

Uso:

• snapshot/fechamento consolidado

distribuicao_execucoes

Uso:

• log de execucao de distribuicao pendente

Motivos, IA e configuracoes

motivos_contato

Uso:

• cadastro de motivos de contato

ia_config_usuario

Criada em runtime por ia_config_repository.php

Campos:

• usuario_id
• provider
• gemini_api_key
• gemini_model
• openrouter_api_key
• openrouter_model
• openrouter_site_url
• openrouter_app_name

Base de conhecimento

Schemas formais em kb_schema.sql

• kb_categories
• kb_articles
• kb_media

Relacoes importantes

erDiagram
    usuarios ||--o{ cobranca_atribuicao_cliente : atribui
    usuarios ||--o{ historico_contato : registra
    usuarios ||--o{ cobranca_30dias_registros : opera
    usuarios ||--o| ia_config_usuario : configura
    historico_contato }o--|| motivos_contato : usa
    kb_categories ||--o{ kb_articles : classifica
    kb_articles ||--o{ kb_media : anexa

Lacunas conhecidas

• Nao existe dump completo do schema MySQL principal.
• O schema do SQL Server foi inferido apenas por consultas.
• Algumas tabelas aparecem apenas em SQL embutido e podem ter colunas adicionais nao documentadas aqui.