Mapa 4 — Diagrama de banco e persistência

Este mapa resume como o módulo se ancora no banco e nos diretórios de imagem. Ele é útil para manutenção de integridade, criação de relatórios e correção de fluxos que gravam dados em mais de um ponto.

Tabelas reais do dump SQL Relacionamentos de uso Campos críticos para manutenção

Diagrama relacional simplificado do módulo

clientes id, nome, telefone, usuario... Entidade central do vínculo proteses id, cliente, modelo, cor, densidade tamanho, observacoes, usuario, fornecedor Representa a ficha da prótese escolhida analise_capilar id, cliente, foto, cor_detectada densidade_detectada, grau_falha sugestao_protese, observacoes fornecedores id, nome, telefone, endereco tipo_chave, chave_pix Opcional na ficha da prótese simulacoes_protese id, cliente, id_protese, foto_original imagem_simulada, observacoes Une contexto do cliente + prótese + imagens manutencoes_protese id, id_protese, cliente, data_manutencao tipo, produtos_utilizados, observacoes proxima_manutencao, alerta_manutencao_enviado tipo_pele, nivel_sudorese, clima, tipo_adesivo config
No dump atual, nem todos esses relacionamentos aparecem como foreign key explícita. Em manutenção, trate-os como relacionamentos de uso definidos pela aplicação.

Matriz de persistência por fluxo

FluxoTabela principalTabelas de apoioArquivos / diretórios afetados
Cadastrar próteseprotesesclientes, fornecedoresSem arquivo binário; gravação relacional direta.
Salvar análiseanalise_capilarclientessistema/painel/images/analises/
Processar análise IAanalise_capilarconfigLê a imagem salva e atualiza campos interpretados pela IA.
Salvar simulaçãosimulacoes_proteseclientes, protesessistema/painel/images/simulacoes/
Gerar simulação IAsimulacoes_proteseproteses, configSubstitui/gera imagem_simulada no diretório de simulações.
Registrar manutençãomanutencoes_proteseclientes, protesesSem binário; prepara dados para alerta futuro.

Campos que merecem atenção especial

CampoTabelaPor que é crítico
clientequase todasÉ o elo central do módulo. Erro aqui gera cruzamento de dados entre ficha, análise, simulação e manutenção.
id_protesesimulacoes_protese, manutencoes_protesePrecisa apontar para a prótese correta do cliente para evitar inconsistência visual e técnica.
foto / foto_original / imagem_simuladaanálises e simulaçõesSão somente nomes/refs de arquivo. Se o arquivo físico sumir, o banco continua apontando para algo inexistente.
alerta_manutencao_enviadomanutencoes_proteseControla idempotência do cron. Se manipulado errado, gera mensagens duplicadas ou nenhum envio.
openai_keyconfigDependência central para IA. Quando ausente ou inválida, análise e simulador param.