Lição: Pacientes e Cadastros
Esta lição prepara você para operar o módulo de Pacientes do Sistema Rabi do zero: cadastrar um paciente completo, buscar registros, vincular convênios, anexar documentos e consultar o histórico. O cadastro de paciente é a base de quase todos os outros módulos, por isso precisa estar sempre correto e atualizado.
1. Objetivo do módulo e onde fica
O módulo de Pacientes é o cadastro central de todos os pacientes da clínica: dados pessoais, contato, endereço, documentos, convênios e histórico. Agendamento, Prontuário, Financeiro e Faturamento usam esse cadastro como base.
- Menu: Pacientes (barra lateral).
- Rota principal:
/portal/pacientes - URL completa (produção):
http://app.rabisistemas.com.br/portal/pacientes
1.1. Telas do módulo
| Tela | Rota | Para que serve |
|---|---|---|
| Lista de pacientes | /portal/pacientes | Listar, buscar e acessar pacientes |
| Novo paciente | /portal/pacientes/criar | Formulário de cadastro |
| Editar paciente | /portal/pacientes/:id/editar | Alterar dados do cadastro |
| Detalhes / histórico | /portal/pacientes/:id | Ver cadastro completo, documentos e histórico |
2. Lista de pacientes
A lista (/portal/pacientes) exibe todos os pacientes cadastrados.
2.1. Busca e filtros
O campo de busca no topo localiza pacientes por Nome (parcial), CPF (com ou sem pontuação) ou Celular (com ou sem formatação). Os resultados são filtrados em tempo real conforme a digitação.
✅ Novo — jul/2026 Busca global (#456): agora é possível encontrar o paciente por parte do nome, telefone, e-mail ou CPF. Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
2.2. Colunas da tabela
| Coluna | Descrição |
|---|---|
| Nome | Nome completo do paciente |
| CPF | CPF formatado; exibe "Estrangeiro" quando aplicável |
| Data Nasc. | Data de nascimento (dd/mm/aaaa) |
| Celular | Número de celular para contato |
| Endereço de e-mail | |
| Status | Status atual do paciente |
2.3. Status do paciente
| Status | Descrição |
|---|---|
| Aguardando | Cadastrado, aguardando primeiro atendimento/confirmação |
| Confirmado | Agendamento confirmado para o paciente |
| Cancelado | Atendimento/agendamento cancelado |
| Atendido | Já foi atendido |
| Em Atendimento | Em atendimento no momento |
| Acolhido | Recebido na recepção (check-in feito) |
| Remarcado | Agendamento remarcado |
| Pendente | Pendência administrativa ou financeira |
| Pago | Situação financeira regularizada |
| Parcialmente Pago | Pagamento parcial registrado |
2.4. Ações por paciente
- Editar — abre o formulário de edição (
/portal/pacientes/:id/editar). - Ver detalhes — abre a visualização completa e o histórico (
/portal/pacientes/:id).
3. Cadastrar novo paciente (passo a passo)
Acesse /portal/pacientes/criar ou clique em "Novo Paciente" na lista.
3.1. Dados pessoais
| Campo | Obrigatório? | Validação / Observação |
|---|---|---|
| Nome | Obrigatório | Nome completo |
| CPF | Obrigatório* | Validação de CPF. *Não exigido se marcado como Estrangeiro. |
| RG | Opcional | Documento de identidade |
| UF Emissor | Opcional | Estado emissor do RG |
| Data de Nascimento | Obrigatório | Formato dd/mm/aaaa |
| Sexo | Opcional | Masculino, Feminino ou outro |
| Estado Civil | Opcional | Solteiro, Casado, Viúvo etc. |
| Estrangeiro | Opcional | Marque quando o paciente não possui CPF brasileiro (dispensa o CPF) |
| Foto | Opcional | Upload de foto de perfil |
3.2. Contato
| Campo | Obrigatório? | Validação / Observação |
|---|---|---|
| Opcional | Endereço para comunicações | |
| Telefone | Opcional | Telefone fixo |
| Celular | Obrigatório | Validação de telefone/celular; principal canal de contato |
3.3. Endereço
| Campo | Obrigatório? | Validação / Observação |
|---|---|---|
| CEP | Opcional | Validação de CEP; ao informar, preenche os campos abaixo automaticamente |
| Logradouro | Opcional | Rua, avenida etc. |
| Número | Opcional | Número do imóvel |
| Complemento | Opcional | Apartamento, bloco, sala etc. |
| Bairro | Opcional | Bairro do endereço |
| Cidade | Opcional | Cidade do endereço |
| Estado | Opcional | UF do estado |
3.4. Informações complementares
| Campo | Obrigatório? | Observação |
|---|---|---|
| Responsável | Opcional | Responsável legal (menores ou dependentes) |
| Pessoa de Contato | Opcional | Lista de pessoas de contato vinculadas ao paciente |
| Observações | Opcional | Anotações administrativas ou clínicas |
3.5. Sequência completa
- Abra o formulário: "Novo Paciente" ou
/portal/pacientes/criar. - Preencha os dados pessoais (Nome, CPF, Data de Nascimento são obrigatórios; marque Estrangeiro se não houver CPF).
- Informe o contato (Celular é obrigatório).
- Preencha o endereço começando pelo CEP (autopreenche o restante).
- Adicione informações complementares (responsável, contatos, observações).
- Se quiser, vincule convênio/plano/carteira e anexe documentos.
- Clique em "Salvar". O paciente fica disponível imediatamente para agendamentos e atendimentos.
4. Convênio do paciente
Você pode vincular um ou mais convênios ao cadastro. Essa informação vira o padrão sugerido ao criar agendamentos.
- No cadastro/edição, localize a seção Convênio / Plano / Carteira.
- Selecione o Convênio (operadora).
- Selecione o Plano (as opções são filtradas pelo convênio escolhido).
- Informe o Número da Carteira do paciente naquele convênio.
- Salve.
| Campo | Obrigatório? | Descrição |
|---|---|---|
| Convênio | Opcional | Operadora de saúde (ex.: Unimed, Bradesco Saúde) |
| Plano | Opcional | Plano contratado dentro da operadora |
| Número da Carteira | Opcional | Identificação do paciente junto à operadora |
Ao agendar, o convênio vinculado é sugerido automaticamente; o operador pode trocá-lo no formulário do agendamento.
5. Documentos do paciente
É possível anexar documentos digitalizados ao cadastro. Tipos suportados: CPF, RG e Outros (laudos, receitas, documentos de convênio etc.). Formatos aceitos: PDF, JPG, PNG.
- No cadastro/edição, localize a seção Anexos (final do formulário).
- Para cada tipo, arraste e solte o arquivo na área indicada ou clique para abrir o seletor.
- Selecione o arquivo e aguarde a conclusão do upload.
- Salve o cadastro.
Na tela de detalhes (/portal/pacientes/:id), os documentos anexados aparecem listados com opções de visualizar e remover.
6. Histórico do paciente
Na tela de detalhes (/portal/pacientes/:id), o histórico completo é registrado automaticamente a cada interação e é de leitura:
| Seção | Conteúdo |
|---|---|
| Agendamentos anteriores | Todos os agendamentos: data, profissional, especialidade e status |
| Atendimentos realizados | Atendimentos concluídos, vinculados ao prontuário |
| Dados financeiros | Cobranças, pagamentos, valores pendentes e situação financeira |
| Documentos | Arquivos e anexos vinculados ao cadastro |
As evoluções clínicas ficam no módulo de Prontuário Eletrônico, acessível a partir dos detalhes do paciente.
7. Integrações do módulo
| Módulo | Como usa o cadastro de paciente |
|---|---|
| Agendamento | O paciente é selecionado ao agendar; convênio e contato são herdados automaticamente. |
| Prontuário | O prontuário é vinculado ao ID do paciente; evoluções, receitas e laudos ficam associados. |
| Financeiro | Cobranças e lançamentos são vinculados ao paciente; o histórico financeiro é acessível pelo cadastro. |
| Faturamento | Guias de convênio referenciam o número de carteira e o plano do cadastro. |
8. Permissões necessárias
Modelo atual: papel (Role) + 4 ações fixas por módulo — VIEW, CREATE, UPDATE, DELETE. Para o módulo Pacientes:
| Ação do usuário | Permissão necessária |
|---|---|
| Ver lista, detalhes e histórico | VIEW |
| Cadastrar novo paciente | CREATE |
| Editar cadastro / anexar documentos | UPDATE |
| Excluir paciente | DELETE |
Níveis: NONE < VIEW < CREATE < UPDATE < DELETE.
9. Erros comuns e como resolver
| Situação | Causa provável | Solução |
|---|---|---|
| Não consigo salvar sem CPF | Paciente estrangeiro sem marcar a opção | Marque "Estrangeiro" — o CPF deixa de ser exigido. |
| Salvar bloqueado por campo faltando | Falta Nome, Data de Nascimento ou Celular | Preencha os obrigatórios: Nome, CPF (ou Estrangeiro), Data de Nascimento e Celular. |
| Endereço não preencheu sozinho | CEP inválido ou incompleto | Confira o CEP; preencha manualmente se necessário. |
| Upload de documento falhou | Arquivo acima de 50 MB ou formato não aceito | Use PDF/JPG/PNG até 50 MB. |
| Paciente não aparece na busca | Nome/CPF/celular digitado diferente do cadastro | Use a busca global (#456) por parte do nome, telefone, e-mail ou CPF; confira a grafia. |
| Plano não lista opções | Convênio ainda não selecionado | Selecione primeiro o convênio; o plano é filtrado por ele. |
Pontos-chave
- O cadastro fica em
/portal/pacientes; criar em/portal/pacientes/criar. - Campos obrigatórios: Nome, CPF (dispensado se Estrangeiro), Data de Nascimento e Celular. O resto é opcional.
- Marcar "Estrangeiro" dispensa o CPF.
- O CEP autopreenche o endereço; a busca global (#456, jul/2026) aceita parte do nome, telefone, e-mail ou CPF.
- Anexos: PDF/JPG/PNG até 50 MB por arquivo.
- O cadastro é a base de Agendamento, Prontuário, Financeiro e Faturamento; convênio vinculado é sugerido no agendamento.
- Dados de saúde são sensíveis (LGPD); acesso restrito a usuários autorizados.
- Permissões: Role + VIEW/CREATE/UPDATE/DELETE.
O que a prova vai cobrar
- Reconhecer os campos obrigatórios do cadastro (Nome, CPF, Data de Nascimento, Celular) e o efeito de marcar "Estrangeiro".
- Saber que o CEP autopreenche o endereço e quais critérios a busca aceita (parte do nome, telefone, e-mail ou CPF — busca global #456).
- Conhecer o limite de anexo de 50 MB e os formatos aceitos.
- Entender que o cadastro alimenta os outros módulos e que o convênio é herdado no agendamento.
- Aplicar cuidados de LGPD para dados sensíveis do paciente.