Pacientes

O módulo de Pacientes centraliza todo o cadastro e histórico dos pacientes da clínica.

Lista de Pacientes

A tela principal exibe a lista paginada de pacientes com:

• Foto (se cadastrada) ou avatar gerado por inicial do nome
• Nome completo e CPF
• Último atendimento
• Tags de segmentação
• Indicador de alertas (alergias, plano de saúde)

Busca em Tempo Real

A caixa de pesquisa filtra instantaneamente por:

• Nome completo (busca parcial)
• CPF (exato ou parcial)
• Telefone
• E-mail

A busca tem debounce de 300ms para não sobrecarregar a API durante a digitação.

Filtros Avançados

• Por tags personalizadas
• Por plano de saúde vinculado
• Por período sem atendimento (ex: sem consulta há mais de 90 dias)
• Por status (ativo / inativo)

Cadastrar Novo Paciente

Campos Obrigatórios

Campo	Validação
Nome completo	Mínimo 3 caracteres
CPF	Válido e único por organização
Data de nascimento	Data válida no passado
Telefone principal	Formato com DDD

Campos Opcionais

• E-mail
• Telefone secundário
• Endereço completo (CEP, logradouro, número, cidade, estado)
• Foto de perfil
• Tipo sanguíneo
• Alergias (campo multiplo, exibido em destaque no prontuário)
• Observações clínicas (criptografadas)
• Tags de segmentação
• Fonte de indicação (ex: indicação de amigo, Google, Instagram)
• Plano de saúde vinculado
• Responsável legal (obrigatório para menores de 18 anos)

Detecção de Duplicata por CPF

Ao informar o CPF, o sistema verifica em tempo real se já existe um paciente com o mesmo CPF na organização. Se existir:

1. Um alerta é exibido com o nome do paciente existente
2. O botão "Visualizar paciente existente" é apresentado
3. A opção "Mesclar cadastros" é oferecida

Não é possível salvar dois pacientes com o mesmo CPF na mesma organização.

Detalhe do Paciente

A página de detalhes de um paciente é dividida em abas:

Aba Dados

Informações cadastrais completas com botão de edição para usuários autorizados.

Alertas em destaque:

• Alergias documentadas (exibidas em vermelho)
• Condições relevantes informadas
• Observações do responsável legal (se menor de idade)

Aba Histórico

Linha do tempo de todos os atendimentos realizados, incluindo:

• Data e horário
• Profissional responsável
• Procedimento realizado
• Status final (Concluído, Cancelado, No-show)

Permite filtrar por período e status.

Aba Prontuário

Acesso ao prontuário clínico completo:

• Anamneses registradas
• Evoluções por atendimento
• Prescrições emitidas
• Solicitações de exame
• Resultados e laudos

Acesso restrito a Admin, Owner e Professional (apenas seus próprios pacientes).

Aba Financeiro

Histórico financeiro do paciente:

• Faturas em aberto
• Faturas pagas
• Histórico de pagamentos
• Saldo de crédito (se existir)

Acesso restrito a Admin, Owner e Receptionist.

Aba Documentos

Arquivos vinculados ao paciente:

• Documentos pessoais (RG, CPF)
• Termos de consentimento assinados
• Exames e laudos
• Fotos before/after (quando disponível)

Upload suportado: PDF, JPG, PNG, HEIC. Tamanho máximo: 20 MB por arquivo.

Merge de Pacientes Duplicados

Quando dois cadastros identificados como duplicatas precisam ser unificados:

1. Acesse o paciente principal
2. Clique em "Mesclar com outro cadastro"
3. Busque o cadastro duplicado
4. Confirme qual cadastro será mantido como principal
5. O sistema consolida automaticamente: agendamentos, prontuários e faturas do cadastro secundário no principal
6. O cadastro secundário é desativado (não excluído)

O CPF do cadastro principal é mantido. Dados em conflito são preservados com flag de origem.

Exportação de Dados (LGPD)

Para atender ao direito de acesso e portabilidade previsto na LGPD:

1. Acesse o paciente
2. Menu de ações → "Exportar dados LGPD"
3. Um arquivo JSON é gerado com todos os dados do paciente
4. O arquivo inclui: cadastro, histórico de agendamentos, prontuários, faturas e logs de acesso aos seus dados

Disponível apenas para Owner e Admin. O processo é registrado no audit log.

Inativar Paciente

Pacientes não podem ser excluídos permanentemente (conformidade com regulação clínica). A inativação:

• Remove o paciente da busca padrão
• Mantém todo o histórico acessível via filtro "inativos"
• Bloqueia a criação de novos agendamentos para o paciente

Permissões

Ação	Owner	Admin	Receptionist	Professional	Viewer
Listar pacientes	✅	✅	✅	✅	✅
Cadastrar paciente	✅	✅	✅	❌	❌
Editar dados cadastrais	✅	✅	✅	❌	❌
Ver prontuário	✅	✅	❌	Próprios	❌
Ver financeiro	✅	✅	✅	❌	❌
Mesclar cadastros	✅	✅	❌	❌	❌
Exportar dados LGPD	✅	✅	❌	❌	❌
Inativar paciente	✅	✅	❌	❌	❌

Acesso

• URL lista: /app/patients
• URL detalhe: /app/patients/:id
• Guard: Requer autenticação