scoreodonto.com/CRM_Ortodontia_Tutoria_Master.md

CRM ORTODONTIA + TUTORIA ORTODÔNTICA

---

LISTA DE TAREFAS

FASE 1 — Documentação Fotográfica (armazenamento local)

Backend

• Tabelas orto_photo_session, orto_photo, orto_photo_annotation no PostgreSQL
• multer configurado — upload local em /app/media/orto-fotos/
• express.static servindo /app/media em /media
• POST /api/orto/:tratamentoId/sessoes — criar/buscar sessão por tipo
• GET /api/orto/:tratamentoId/sessoes — listar sessões com fotos
• POST /api/orto/sessoes/:sessaoId/fotos — upload de foto para slot
• DELETE /api/orto/fotos/:fotoId — excluir foto
• GET /api/orto/:tratamentoId/completude — % de documentação preenchida

Frontend

• OrthoPhotoWorkspace — substitui PhotoCompare placeholder
• Tabs de sessão (Inicial / 3m / 6m / 12m / Finalização / Pós-contenção)
• Grid de 15 slots (5 extraoral + 5 intraoral + 5 complementar)
• Upload por clique no slot (file input)
• Visualizador de foto (modal fullscreen)
• Exclusão de foto com confirmação
• Indicador de completude (%)
• Comparador lado a lado (selecionar 2 slots e comparar)
• backend.ts — métodos getOrtoSessoes, uploadOrtoFoto, deleteOrtoFoto, getOrtoCompletude

FASE 2 — Tutoria Integrada

• Tabelas ortho_tutor_profile, ortho_tutoring_request, ortho_tutoring_message, ortho_tutoring_photo_package
• Botão "Solicitar Tutoria" no painel do paciente (TutoriaSection.tsx)
• Lista de tutores disponíveis com SLA e preço
• Formulário de solicitação (escolha tutor, tipo, descrição)
• Pacote automático gerado (todas as fotos do tratamento incluídas)
• Chat inline por caso (CLINICA ↔ TUTOR)
• Painel do tutor — receber, responder, fechar (TutorPainelView.tsx)
• Status tracking: AGUARDANDO → EM_ANALISE → RESPONDIDO → FECHADO
• Menu "PAINEL TUTOR" no Sidebar
• Rota /tutoria-painel no App.tsx

FASE 3 — Planejamento Visual e PDFs

• Marcações clínicas nas fotos — PhotoAnnotator.tsx (SVG overlay)
  • Ferramentas: Seta, Linha, Círculo, Retângulo, Texto, Caneta livre
  • Cores (6) + espessura (P/M/G) + desfazer + limpar
  • Anotações persistidas no banco (orto_photo_annotation)
  • Botão ANOTAR no viewer de fotos
• PDF — Documentação fotográfica (grade 15 slots + fotos base64)
• PDF — Evolução ortodôntica (timeline cronológico)
• PDF — Caso clínico para tutoria (triagem + diagnóstico + fotos)
• jsPDF instalado (client-side, sem servidor)
• OrthoReports.tsx integrado no OrthoDetailPanel
• Planejamento visual (vetores de movimentação) — Fase 4
• Tutor anota diretamente no painel de tutoria — próximo passo

MARKETPLACE DE TUTORES (GLOBAL)

• Fluxo de candidatura self-service para dentistas (TutorCandidaturaView)
• Formulário acadêmico em 3 passos (dados pessoais / formação / perfil público)
• Status tracking: PENDENTE → AGUARDANDO_PAGAMENTO → ATIVO / REJEITADO
• Painel admin de gestão (AdminGestaoTutoresView) — 3 abas: Candidaturas / Ativos / Configurações
• Aprovação/rejeição com campo de observação
• Configuração de taxa de inscrição + chave PIX fallback
• Integração MercadoPago — pagamento único (PIX / cartão / boleto)
• Webhook automático — ativa perfil ao detectar pagamento aprovado
• Confirmação manual de pagamento pelo admin (fallback)
• Tutor global — disponível para TODAS as clínicas do sistema
• Criação automática de ortho_tutor_profile após ativação
• Tabelas: tutor_candidatura, tutor_config, tutor_pagamento
• Sidebar: "SER TUTOR ORTO" (dentistas) + "GESTÃO TUTORES" (admin)

FASE 4 — Marketplace e IA

• Marketplace público de tutores
• Sistema de pagamento
• IA clínica (sugestão de diagnóstico, sequência de fios)
• Rede colaborativa entre clínicas
• App mobile para registro fotográfico

MIGRAÇÃO STORAGE

• Substituir multer local por Wasabi S3
• Manter URLs compatíveis (alterar apenas o driver de storage)
• Migração das fotos existentes para o Wasabi

---

Visão Estratégica

Projeto de CRM Ortodôntico integrado com Marketplace de Tutoria Ortodôntica, Documentação Fotográfica, Planejamento Clínico e Colaboração entre Profissionais.

---

MÓDULO CRM ORTODONTIA

Componentes Principais

• PatientHeader
• ClinicalTriage
• Diagnosis
• TreatmentPlan
• Timeline
• NewEvolution
• PhotoCompare
• ContencaoTermo
• ClinicalRequests
• MaintenanceReport
• Finalization

Fluxo do Tratamento

Triagem → Diagnóstico → Planejamento → Evoluções → Controle Fotográfico → Relatórios → Finalização → Contenção

---

MÓDULO DE TUTORIA ORTODÔNTICA

Objetivo

Permitir que ortodontistas experientes ofereçam:

• Segunda opinião
• Planejamento ortodôntico
• Mentoria clínica
• Discussão de casos
• Encaminhamento de pacientes

Perfis

Tutor Ortodôntico

• Publicar portfólio
• Receber solicitações
• Definir preços
• Definir SLA
• Receber pagamentos

Solicitante

• Enviar casos
• Escolher tutor
• Acompanhar status
• Receber pareceres

---

INTEGRAÇÃO DA TUTORIA AO CRM

A tutoria não será um sistema isolado.

Será incorporada ao painel do paciente:

Paciente ├── Triagem ├── Diagnóstico ├── Plano ├── Evoluções ├── Fotografias ├── Tutoria Ortodôntica ├── Relatórios └── Finalização

Solicitar Tutoria

Botão:

[ Solicitar Tutoria ]

Tipos

• Segunda opinião
• Planejamento completo
• Discussão de caso
• Alinhadores
• Orto-cirúrgico
• Encaminhamento

---

PACOTE AUTOMÁTICO PARA O TUTOR

Ao solicitar uma tutoria o sistema gera automaticamente:

Dados Clínicos

• Triagem
• Diagnóstico
• Planejamento
• Evoluções

Dados Ortodônticos

• Classe de Angle
• Fio atual
• Cooperação
• Status do tratamento

Arquivos

• Fotografias
• Radiografias
• Tomografias
• STL
• PDFs

---

MÓDULO DE DOCUMENTAÇÃO FOTOGRÁFICA

Objetivo

Transformar as fotografias em uma documentação ortodôntica completa.

---

WORKSPACE FOTOGRÁFICO

Novo módulo:

OrthoPhotoWorkspace

Recursos:

• Upload
• Organização
• Comparação
• Anotações
• Compartilhamento
• Exportação

---

SESSÕES FOTOGRÁFICAS

Cada paciente pode possuir:

• Inicial
• Controle 3 meses
• Controle 6 meses
• Controle 12 meses
• Finalização
• Pós contenção

---

TEMPLATE ORTODÔNTICO PADRÃO

Extraoral

• Frontal sorrindo
• Frontal repouso
• Perfil direito
• Perfil esquerdo
• Perfil sorrindo

Intraoral

• Frontal oclusão
• Lateral direita
• Lateral esquerda
• Oclusal superior
• Oclusal inferior

Complementares

• Linha média
• Overjet
• Overbite
• Mordida cruzada
• Mordida aberta

---

SISTEMA DE SLOTS

Cada fotografia ocupa posição específica.

Garantindo padronização clínica.

---

EDITOR DE IMAGENS

Ferramentas:

• Zoom
• Crop
• Rotação
• Contraste
• Brilho
• Espelhamento

---

MARCAÇÕES CLÍNICAS

Permitir desenhar diretamente nas imagens.

Tipos:

• Seta
• Linha
• Texto
• Círculo
• Área destacada

Exemplos:

• Linha média desviada
• Apinhamento
• Torque inadequado
• Mordida cruzada

---

COMPARADOR FOTOGRÁFICO

Modos:

• Inicial × Atual
• Inicial × Final
• 6 meses × 12 meses

Visualizações:

• Slider
• Lado a lado
• Sobreposição

---

CHECKLIST DE DOCUMENTAÇÃO

Validação automática:

• Frontal
• Perfil direito
• Perfil esquerdo
• Oclusal superior
• Oclusal inferior
• Oclusão frontal

Indicador:

Documentação Completa (%)

---

TUTORIA SOBRE FOTOGRAFIAS

Enviar para Tutor

O sistema envia:

• Fotos
• Diagnóstico
• Planejamento
• Timeline
• Evoluções

---

RESPOSTA DO TUTOR

Tutor pode:

• Escrever parecer
• Marcar fotografias
• Desenhar vetores
• Apontar correções
• Criar planejamento visual

---

PLANEJAMENTO VISUAL

Ferramenta Premium.

Permite:

• Vetores de movimentação
• Correção de linha média
• Planejamento de fechamento de espaços
• Estratégia de extrações
• Planejamento de alinhadores

---

RELATÓRIOS

PDF Documentação

Documentação completa organizada.

PDF Evolução

Comparação cronológica.

PDF Tutoria

• Caso clínico
• Fotografias
• Comentários
• Marcações
• Planejamento

---

BANCO DE DADOS

ortho_tutor_profile

Cadastro do tutor.

ortho_tutoring_request

Solicitações de tutoria.

ortho_tutoring_message

Chat do caso.

ortho_tutoring_financial

Controle financeiro.

ortho_photo_session

Sessões fotográficas.

ortho_photo

Fotografias.

ortho_photo_annotation

Marcações sobre imagens.

ortho_photo_compare

Comparações.

ortho_tutoring_photo_package

Pacotes enviados para tutores.

---

ROADMAP

Fase 1

• Persistência das fotos
• Sessões fotográficas
• Upload real
• Comparação

Fase 2

• Tutoria integrada
• Chat
• Envio de documentação

Fase 3

• Planejamento visual
• Marcações do tutor
• PDFs avançados

Fase 4

• Marketplace público
• IA clínica
• Rede colaborativa de ortodontistas

---

DIFERENCIAL

CRM Ortodontia

Documentação Fotográfica Profissional

Tutoria Ortodôntica

Planejamento Visual

Marketplace de Especialistas

Colaboração Entre Clínicas