🗺️ Mapa Funcional do Sistema Rabi
Cada tela do sistema, o que ela faz, quem usa no dia a dia e como acompanhar o trabalho — a referência completa, módulo por módulo.
O que é esta página
Este é o mapa funcional profundo do Rabi: uma avaliação de todas as telas do sistema, respondendo a três perguntas para cada uma — o que ela faz (de forma específica, não genérica), quem usa (qual perfil da equipe) e como acompanhar o trabalho feito nela (relatório, dashboard, farol ou notificação). Use-a para:
- Descobrir onde uma tarefa é feita ("onde eu confirmo agenda em massa?");
- Montar a rotina de cada função da clínica (seção Visão por perfil, com links para as Rotinas do Dia a Dia);
- Decidir permissões: saber quais telas cada perfil realmente precisa acessar;
- Saber o que existe: o mapa cobre o sistema em produção e marca claramente o que ainda é roadmap.
💡 Como ler as tabelas
Rota é o endereço da tela dentro do sistema (o que aparece na barra do navegador depois de app.rabisistemas.com.br). Quem usa lista os perfis típicos — a sua clínica pode combinar funções numa mesma pessoa. Itens marcados 🟠 em breve (Sprint X) ainda não estão disponíveis: não conte com eles no dia a dia até chegarem na atualização. Datas das sprints: S7 = 21–28/ago (concluída) · S8 = 28/ago–04/set (concluída) · S9 = 04–11/set (atual) · S10 = 11–18/set/2026.
Perfis usados neste mapa
| Perfil | Quem é na clínica |
|---|---|
| Recepção | Recepcionista / atendimento presencial: agenda, chegada do paciente, cadastro |
| Confirmação | Equipe de confirmação de agenda / contact center (pode ser a própria recepção) |
| Autorizadora | Quem cuida de autorizações e orçamentos junto aos convênios |
| Faturista | Quem monta guias, fecha lotes TISS e trata glosas |
| Médico | Médico(a) e demais profissionais de saúde que atendem |
| Financeiro | Quem lança contas a pagar/receber, faz baixas e controla o caixa |
| Estoquista | Quem controla insumos, materiais e compras (farmácia/almoxarifado) |
| Gestor | Liderança: coordenação, gerência, diretoria — acompanha indicadores e aprova alçadas |
| Implantador/Admin | Quem configura o sistema e administra usuários e permissões |
| Paciente | O próprio paciente, pelo serviço online (agendamento e acompanhamento) |
📅 Agenda
O centro operacional da clínica: é aqui que a recepção passa o dia. O board mostra os agendamentos por status — Aguardando, Pendente, Confirmado, Acolhido, Em Atendimento, Atendido, Cancelado, Remarcado — com colunas de autorizações pendentes e aprovadas e o contador "faltam X de Y" de produtos controlados. Detalhes na página do módulo e na lição completa.
| Tela / Função | Rota | O que faz | Quem usa |
|---|---|---|---|
| Agenda principal (board) | /portal/agenda | Grade por dia/semana com filtros de profissional, especialidade e local. Board por status com avisos visuais, colunas de autorizações pendentes/aprovadas, "faltam X de Y" de produtos controlados e aviso fixo de atendidos com divergência. Setas próximo/anterior navegam sem escolher data. | Recepção, Confirmação, Gestor |
| Novo agendamento | /portal/agenda/criar | Formulário de marcação: data/hora, paciente (busca por nome/CPF), convênio+plano, especialidade, profissional, local, equipamentos, tipo (Normal/Encaixe), anexos. Exige orçamento/autorização conforme parametrização do convênio, aplica bloqueio de prazo de retorno, mostra a previsão de estoque na data e a idade do paciente (anos/meses/dias). | Recepção |
| Editar agendamento | /portal/agenda/:id/editar | Altera data, horário, profissional ou dados do agendamento. Protegido pelo guard de edição (avisa antes de sair com alterações não salvas). Agendamento Atendido não se edita direto — ver "Editar Atendido" abaixo. | Recepção, Confirmação |
| Confirmação em massa | /portal/agenda/confirmacao | Lista os agendamentos "Aguardando" do período; marca vários de uma vez e confirma com um clique — sem abrir cada um. É a tela-base da rotina de confirmação do dia seguinte. | Confirmação, Recepção |
| Acolhimento | /portal/agenda/acolhimento | Lista do dia com nome, horário, profissional, convênio e status. Registra a chegada do paciente e abre o check-in. | Recepção |
| Check-in | /portal/agenda/acolhimento/:id/checkin | Confere os dados do paciente e confirma a chegada: o status vira Acolhido e o paciente entra na fila de atendimento do profissional. | Recepção |
| Bloqueio de agenda | /portal/agenda/bloqueio | Marca períodos indisponíveis (feriado, férias, reunião, manutenção de equipamento) por profissional e local. Impede novos agendamentos, mas não cancela os já existentes no período. | Recepção, Gestor |
| Encaixe | /portal/agenda/criar (Tipo = Encaixe) | Agendamento fora do horário regular, com marcação visual própria na grade. Encaixe adicional em horário cheio pode ser liberado pelo médico via notificação. | Recepção (libera: Médico) |
| Repetir agendamento (série) | botão na agenda | Cria uma série de agendamentos (semanal, quinzenal, mensal) numa só operação — para fisioterapia, infusões e tratamentos longos. | Recepção |
| Editar Atendido (com aprovação) | botão Editar no agendamento Atendido | Agendamento Atendido é bloqueado para edição direta (com trava de troca de paciente). O botão "Editar" exige motivo e abre solicitação de aprovação; aprovada, a mudança reflete automaticamente na Autorização. Divergências ficam sinalizadas no topo da Agenda e na Fila de Atendimento. | Recepção (aprova: Gestor) |
| ✅ Fila de espera — ENTREGUE ✅ Novo — set/2026 | — | Paciente entra na fila quando o horário desejado está cheio (#405, em produção desde 28/08); ao surgir cancelamento, o sistema sugere o encaixe do próximo da fila na grade, e a fila tem botão "Agendar". Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização. | Recepção |
Como acompanhar: Relatório de Agenda e Relatório de Rotina de Recepção (seção Relatórios), aba Dashboard → Agendamentos e o próprio board (colunas de pendências).
💵 Orçamento
Monta o orçamento de procedimentos com serviços + produtos + taxas + equipamentos, envia ao paciente (PDF e notificação com link para aprovar) e, na aprovação, gera o agendamento automaticamente. O farol 🟢🟡🔴🟣 avalia o resultado de cada item: verde segue, amarelo alerta, vermelho bloqueia (liberação por nível de alçada) e roxo indica erro de preço. Ver lição completa.
| Tela / Função | Rota | O que faz | Quem usa |
|---|---|---|---|
| Lista de orçamentos | /portal/agenda/orcamento | Consulta e filtra os orçamentos pelo ciclo de vida: RASCUNHO → AGUARDANDO_APROVACAO → APROVADO_CLIENTE → CONFIRMADO → AGENDADO → REALIZADO (ou rejeitado/cancelado/expirado). Validade padrão de 30 dias; expirados são marcados automaticamente todo dia. | Autorizadora, Recepção, Gestor |
| Novo orçamento | /portal/agenda/orcamento/criar | Cria o orçamento: paciente, local, profissional responsável e serviços — cada serviço com seus produtos consumidos, taxas e equipamentos. Preços vêm da tabela do convênio/interna; o farol calcula o resultado e bloqueia no vermelho; desconto acima da alçada pede aprovação de nível superior. | Autorizadora, Recepção |
| Ver / editar / aprovar | /portal/agenda/orcamento/:id | Detalha o orçamento e executa as ações: Enviar ao paciente (gera PDF + notificação com link), Aprovar (cria o agendamento automaticamente), Rejeitar (com motivo), Agendar, Cancelar. Também dá para vincular o orçamento a partir do agendamento. | Autorizadora |
| Reabrir cancelado | /portal/agenda/orcamento/:id/reabrir | Traz um orçamento cancelado de volta ao fluxo, preservando o histórico — sem redigitar tudo. | Autorizadora |
Como acompanhar: aba Dashboard → Orçamentos (pipeline: abertos, aprovados, expirados, convertidos) e a notificação de orçamentos solicitados com prazos.
🛡️ Autorização
Gerencia o ciclo de autorização junto às operadoras: AGUARDANDO → AUTORIZADA / NEGADA → FATURADA (a passagem para "faturada" é automática quando a guia é faturada). Desde ago/2026 a autorização inclui produtos e taxas (com quantidades e conversão do convênio) e o farol consolidado serviço+produto+taxa. Agendamento cancelado ou não comparecido não consome a sessão autorizada. Ver lição completa.
| Tela / Função | Rota | O que faz | Quem usa |
|---|---|---|---|
| Lista de autorizações | /portal/agenda/autorizacao | Acompanha todas as autorizações por status, com o painel "Original vs Convênio" (valor da clínica lado a lado com o valor pago pelo convênio — mostra onde a diferença é grande) e a timeline de tratativas com a operadora. | Autorizadora, Gestor |
| Nova autorização | /portal/agenda/autorizacao/criar | Cria o pedido: paciente + convênio/carteirinha (valida vínculo ativo), serviços, produtos e taxas com quantidades, caráter do atendimento (Tabela 23) e indicador de acidente (Tabela 87). Só se edita antes do envio. | Autorizadora |
| Tratamento continuado | botão repetir pedido | Repete o pedido de autorização dentro do mesmo prazo, para tratamentos em série — sem recriar do zero. | Autorizadora |
| Agendar direto da autorização | botão Agendar | Abre o novo agendamento já preenchido com os dados da autorização aprovada — elimina a redigitação e o risco de agendar sem autorização. | Autorizadora, Recepção |
| Acompanhamento pelo paciente | serviço online | O próprio paciente acompanha o andamento das suas autorizações pela área online — menos ligações "já saiu?" para a clínica. | Paciente |
| 🟠 Pré-solicitação — em breve | — | Etapa de validação interna antes do envio à operadora (#380). Ainda não disponível. | Autorizadora |
Como acompanhar: Relatório de Rotina de Autorização e Relatório de Autorizações (seção Relatórios), aba Dashboard → Autorizações, colunas de autorizações pendentes/aprovadas no board da Agenda e a notificação de "autorização liberada e não agendada".
🩺 Atendimento / Prontuário
O coração clínico: o profissional chama o paciente da fila, registra a consulta e finaliza — alimentando automaticamente Financeiro (particular) ou Faturamento (convênio) e baixando o estoque consumido. Ver página do módulo e lição completa.
| Tela / Função | Rota | O que faz | Quem usa |
|---|---|---|---|
| Fila de Atendimento | /portal/fila-de-atendimento | Lista quem já fez check-in e aguarda, com hora de chegada e tempo de espera. O profissional vê só os próprios pacientes; recepção/admin veem a fila da unidade. Tem área fixa de divergências (quantidades agendadas × atendidas) com botão Corrigir. | Médico, Recepção |
| Prontuário eletrônico | /portal/pacientes/:id/atendimento/:id | Registro da consulta: anamnese (queixa, histórico, alergias, medicamentos), hipótese diagnóstica com CID-10, procedimentos executados (com quantidade), prescrições e documentos (Receita, Atestado, laudo — por modelo com variáveis automáticas). Mostra só os anexos do agendamento em questão. A saída de estoque fica vinculada ao atendimento. | Médico |
| Finalizar atendimento | botão no prontuário | Bloqueia o prontuário (irreversível), marca o agendamento como Atendido/Realizado e dispara: particular → conta a receber no Financeiro; convênio → guia TISS no pré-faturamento. Cancelar um Atendido depois exige fluxo de autorização. | Médico |
| 🟢 Assinatura digital ICP-Brasil — 1ª fase em produção ✅ Novo — set/2026 | — | Laudos/atestados/receitas assinados digitalmente com QR Code de validação (#394). 1ª fase em produção desde 03/09/2026; finalização na Sprint 9. Os 3 fluxos (custódia própria / WebPKI / nuvem) estão sendo liberados aos poucos — confirme no seu ambiente. | Médico |
Como acompanhar: Relatórios de Produtividade e Ocupação da Agenda, Repasses por Colaborador (Relatórios) e o contador "Em Atendimento" em tempo real no Dashboard.
👤 Pacientes
Cadastro-mestre dos pacientes: tudo o mais (agenda, prontuário, financeiro, faturamento) referencia este cadastro. Ver página do módulo e lição completa.
| Tela / Função | Rota | O que faz | Quem usa |
|---|---|---|---|
| Lista de pacientes | /portal/pacientes | Busca e lista os pacientes cadastrados. Complementa a busca global do topo do sistema (nome parcial, telefone, e-mail ou CPF de qualquer tela). | Recepção, Confirmação |
| Novo paciente | /portal/pacientes/criar | Cadastro completo: dados pessoais (CPF validado), endereço por CEP, contatos, convênio + plano + carteirinha, responsável, pessoas de contato e anexos (PDF/JPG/PNG até 50 MB por arquivo — RG, CPF, carteirinha, exames). | Recepção |
| Ver ficha | /portal/pacientes/:id | Visualiza a ficha com histórico de atendimentos, convênios e anexos — sem risco de alterar nada. | Recepção, Médico |
| Editar paciente | /portal/pacientes/:id/editar | Atualiza dados de contato, convênio e carteirinha. Manter celular e e-mail em dia é o que faz as notificações (SMS/e-mail) chegarem. ✅ Novo — ago/2026 Os dados pessoais (nome, CPF etc.) ficam bloqueados para edição nas telas — proteção do cadastro (#592); carteirinhas excluídas podem ser listadas para recuperação (#308). | Recepção |
| 🟠 Mesclar duplicados — em breve | — | Unificação de cadastros duplicados do mesmo paciente (#546). Ainda não disponível — hoje, prevenir digitando o CPF antes de criar. | Recepção, Admin |
Como acompanhar: filtros por CPF/celular/cidade no Relatório de Agenda; Logs de Auditoria registram quem alterou cada cadastro (LGPD).
💰 Financeiro
Controla contas a pagar e a receber, caixas e a classificação gerencial (categoria + centro de custo). Regra de ouro: todo lançamento exige conta/caixa + categoria + centro de custo + tipo + data + valor + origem — os cadastros-mestre vêm antes. "Contas a Receber" não é tela isolada: são os lançamentos de entrada (com parcelas) vistos na tela de Registros. Ver página do módulo e lição completa.
| Tela / Função | Rota | O que faz | Quem usa |
|---|---|---|---|
| Registros financeiros | /portal/financeiro/registros | Lista todos os lançamentos (a pagar e a receber) com filtros por tipo, status (Pendente/Pago/Parcial), período, beneficiário, conta e categoria. É aqui que se faz a baixa dos recebimentos e pagamentos, inclusive parcial. | Financeiro |
| Novo a pagar | /portal/financeiro/registros/pagar/criar | Lança despesas: fornecedor, colaborador (salário/repasse), empresa, produto ou outra despesa — com parcelamento (UNITARIO/AGRUPADO gera N duplicatas) e recorrência (mensal, anual, dia da semana). | Financeiro |
| Novo a receber | /portal/financeiro/registros/receber/criar | Lança entradas manuais (paciente, convênio, empresa) — inclusive pagamento de sessões. Entradas de atendimento particular e de lote de convênio são geradas automaticamente. | Financeiro |
| Editar lançamento | .../pagar/:id/editar · .../receber/:id/editar | Corrige valor, data ou classificação de um lançamento existente. Estorno de baixa é restrito ao gerente financeiro. | Financeiro |
| Contas e Caixas | /portal/financeiro/contas-caixa | Cadastra contas bancárias, caixas físicos e carteiras digitais, com saldo inicial por unidade. Todo lançamento precisa apontar para uma conta/caixa daqui. | Financeiro, Implantador |
| Histórico de contas | /portal/financeiro/historico-contas | Mostra a evolução do saldo de cada conta/caixa ao longo do tempo — a conferência diária do caixa começa aqui. | Financeiro |
| Tipos de conta | /portal/financeiro/tipos-de-conta | Classifica as contas/caixas por natureza (banco, caixa físico, carteira digital). | Implantador |
| Tipos de pagamento | /portal/financeiro/tipos-de-pagamento | Formas de pagamento aceitas: Dinheiro, PIX, cartões, transferência, cheque — alimenta o dropdown de todo lançamento e baixa. | Implantador |
| Categorias de pagamento | /portal/financeiro/categorias-de-pagamento | Classificação gerencial hierárquica (Receitas × Despesas: consultas, convênios, insumos, pessoal, impostos) — a base do DRE. | Financeiro, Gestor |
| Centro de custo | /portal/financeiro/centro-de-custo | Aloca receitas e despesas por departamento, especialidade ou unidade — permite ver o resultado de cada área separadamente. | Financeiro, Gestor |
| 🟠 Links de pagamento — em breve | — | Envio de link de cobrança ao paciente (#409). Ainda não disponível. | Financeiro |
| 🟠 Integração bancária — em breve (Sprint 10) | — | Conciliação automática com o banco (#343). Ainda não disponível. | Financeiro |
Como acompanhar: relatório Fluxo de Caixa (saldo do dia, acumulado, máximo, mínimo), Repasses por Colaborador, aba Dashboard → Financeiro e a Rotina de Fechamento (Relatórios).
📄 Faturamento (TISS)
Transforma atendimentos de convênio em cobrança no padrão TISS: pré-faturamento (12 validações automáticas ANS) → lote → XML → envio → retorno → contas a receber. Ver lição completa e a rotina do calendário de faturamento.
| Tela / Função | Rota | O que faz | Quem usa |
|---|---|---|---|
| Pré-faturamento | /portal/guia2/list/pre-faturamento | Bateria de conferência das guias antes do envio: 12 validações automáticas (carteirinha, autorização, CBOS, CID, valores × tabela, datas…). Salvamento garantido, anulações de produto/serviço/taxa mantidas e correção de guias em lote por serviço/convênio/período. ✅ Novo — ago/2026 Reconciliação entregue (#568/#569): cruza autorizado × agendado × atendido × faturado, com área fixa de divergências e opção de faturar a diferença preservando o histórico; localizar guia pelo número (mãe e filha, #421) também disponível. Quem conferiu bem aqui não toma glosa depois. | Faturista |
| Buscar / inserir guia | /portal/guia/buscar · /portal/guia/inserir | Localiza uma guia específica e insere guias em lote — a inserção mostra somente lotes abertos. Há telas de código de barras para registrar recebimento e devolução física de guias. | Faturista |
| Fechar lotes | /portal/faturamento/fechar-lotes | Agrupa as guias pré-faturadas por convênio + período (guias da mesma autorização ficam juntas), fecha o lote (guias ficam bloqueadas para edição isolada, com snapshot da quantidade faturada) e gera o XML TISS com hash SHA256, na versão configurada no convênio. | Faturista |
| Administrar lote | /portal/lote/administrar-lote | Acompanha o lote depois de fechado: marca recebido pelo convênio, registra protocolo/NFS-e, reabre o lote (com permissão), re-emite o XML e exporta a lista de guias. Também gera o PDF completo dos documentos por guia para envio às operadoras. | Faturista, Gestor |
| Gerar contas a receber | /portal/lote/gerar-contas-a-receber | Cria automaticamente o lançamento de entrada com parcelas no Financeiro, a partir do lote fechado — é a ponte Faturamento → Financeiro. | Faturista, Financeiro |
| Importar XML de outro sistema | função do faturamento | Importa o XML de faturamento gerado em outro sistema, com casamento automático das guias e área de conciliação; e compara o retorno/XML do convênio para dar baixa. | Faturista |
| 🟠 Emissão de NFS-e — em breve (Sprint 9) | — | O Rabi ainda não emite NFS-e. O núcleo (provedor plugável + configuração fiscal por clínica) e a versão completa chegam na Sprint 9 (04–11/set). Até lá, emita a nota na prefeitura/emissor atual e registre o número no lançamento. | Faturista, Financeiro |
| 🟢 Assinatura digital ICP-Brasil — 1ª fase em produção ✅ Novo — set/2026 | — | Assinatura digital de documentos (#394). 1ª fase em produção desde 03/09/2026; finalização na Sprint 9 — os fluxos são liberados aos poucos, confirme no seu ambiente. | Faturista |
Como acompanhar: aba Dashboard → Faturamento (guias geradas, enviadas, glosadas, pagas), relatório de pendências com status e a Rotina de Fechamento (Relatórios).
⚖️ Glosas
Quando a operadora recusa (glosa) um item, a clínica decide: contestar (abrir recurso, dentro do prazo configurado no convênio) ou aceitar (gera estorno). Ciclo: PENDENTE → EM_RECURSO → RECUPERADA / ACEITA / DEFINITIVA.
| Tela / Função | Rota | O que faz | Quem usa |
|---|---|---|---|
| Glosas | /portal/glosas | Lista os itens glosados no retorno da operadora e registra a tratativa de cada um: recurso (contestação) ou aceite (estorno). Os prazos de recurso vêm do cadastro do convênio — glosa não contestada no prazo vira perda de receita. | Faturista, Gestor |
| ✅ Rework de glosas — ENTREGUE ✅ Novo — ago/2026 | — | Entregue na Sprint 7 (26/08): fluxos de registro unificados + histórico corrigido (#585), baixa/glosa automática a partir do retorno TISS real (#586), relatório agregado por convênio/motivo/período (#587) e status de guia unificados (#588). Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização. | Faturista, Financeiro |
Como acompanhar: aba Dashboard → Faturamento (guias glosadas e em recurso) e os prazos de recurso configurados por convênio.
📦 Estoque
Controle de materiais, insumos e medicamentos: cadastros de apoio → produtos → movimentação. Um produto fica CRÍTICO quando o saldo cai abaixo do Estoque Base (mínimo). A saída em atendimento dá baixa automática, vinculada ao atendimento que consumiu. Ver página do módulo e lição completa.
| Tela / Função | Rota | O que faz | Quem usa |
|---|---|---|---|
| Produtos | /portal/estoque/produtos | Lista os produtos com saldo real (posição), Estoque Base e status Normal/CRÍTICO. O cadastro (/criar) define nome, tipo, fornecedor, fabricante, princípio ativo, custos/margens e o Estoque Base — que aciona o alerta e a previsão de estoque exibida no agendamento. | Estoquista |
| Tipos de produto | /portal/estoque/produtos/tipos-produtos | Categorias (Medicamento, Material de Consumo, Insumo…). Cadastrar antes dos produtos. | Estoquista, Implantador |
| Fornecedores | /portal/estoque/fornecedores | Empresas fornecedoras com CNPJ validado, endereço e contato — usadas no produto e nos pedidos de compra. | Estoquista |
| Fabricantes | /portal/estoque/fabricantes | Fabricantes dos produtos, para rastreabilidade e cotação. | Estoquista |
| Princípios ativos | /portal/estoque/principios-ativos | Substâncias ativas — permitem achar um medicamento pela substância mesmo com nomes comerciais diferentes. | Estoquista |
| Depósitos | /portal/estoque/depositos | Locais físicos de armazenamento (farmácia, almoxarifado, sala de procedimentos). Saída em depósito inativo é bloqueada. | Estoquista |
| Movimentação | dentro do módulo | Entradas, saídas, transferências e ajustes — cada movimento grava data/hora, responsável e motivo. Entrada soma e saída subtrai na posição; consumo em atendimento baixa automático. | Estoquista |
| ✅ Reserva de medicamento — ENTREGUE ✅ Novo — ago/2026 | — | Reserva do medicamento para o agendamento (#363), entregue em 28/08. Entregue no ciclo de agosto/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização. | Estoquista |
Como acompanhar: Mapa de Estoque (itens CRÍTICOS) em Relatórios, aba Dashboard → Produtos e a previsão de estoque na data, direto no agendamento.
🛒 Compras
Módulo novo (1ª versão entregue em ago/2026, com melhorias contínuas): fecha o ciclo do estoque — do item CRÍTICO ao pedido no fornecedor.
| Tela / Função | Rota | O que faz | Quem usa |
|---|---|---|---|
| Pedidos de compra | menu Compras | Cria pedidos de compra a partir da necessidade de reposição, com itens, quantidades e fornecedor, e faz o envio do pedido ao fornecedor. Tem permissão própria — separa quem pede de quem opera o estoque. | Estoquista, Gestor |
| 🟠 Importar NF-e de fornecedor — em breve (Sprint 9) | — | Entrada de estoque automática a partir da NF-e do fornecedor (#391/#147). Ainda não disponível — hoje a entrada é lançada manualmente. | Estoquista |
Como acompanhar: Mapa de Estoque (o que precisa ser comprado) e Dashboard → Produtos.
🔔 Central de Notificações
Comunicação automática com pacientes e equipe pelos canais SMS e e-mail (via MailGrid). Cada envio passa por filtros de seleção de pacientes + tela de confirmação antes de disparar. 🟠 WhatsApp é futuro (ainda não disponível).
| Função | Canal | O que faz | Quem usa |
|---|---|---|---|
| Lembrete e confirmação de agenda | SMS + e-mail | Envia lembrete da consulta com link para o paciente confirmar — reduz falta e alivia a rotina de ligação da confirmação. | Confirmação, Recepção |
| Autorização liberada e não agendada | SMS + e-mail | Avisa o paciente que a autorização saiu e ainda não há agendamento — recupera receita que ficaria parada. | Autorizadora |
| Orçamento com link para aprovar | SMS + e-mail | Envia o orçamento com link de visualização/aprovação e prazos — o paciente aprova sem vir à clínica. | Autorizadora |
| Agenda do dia para médicos | Envia ao profissional a agenda do dia, somente com os confirmados. | Médico | |
| Publicidade programada | SMS + e-mail | Campanhas programadas para grupos de pacientes selecionados por filtro, sempre com confirmação antes do envio. | Gestor |
| Liberação de encaixe | notificação interna | Pedido de encaixe adicional chega ao médico, que autoriza pela própria notificação. | Médico, Recepção |
| ✅ Pendências de alçada — ENTREGUE ✅ Novo — set/2026 | central | Central única das solicitações de aprovação por alçada (descontos, farol vermelho, edição de Atendido, aprovações de compra) na Central de Notificações (#559, entregue em 03/09/2026). Quem tem alçada vê as pendências unificadas. Entregue no ciclo de setembro/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização. | Gestor |
Como acompanhar: status de confirmação no board da Agenda e no Relatório de Rotina de Recepção.
🌐 Serviço Online (área do paciente)
Autoatendimento do paciente pela internet — menos telefone para a recepção. Ativação da conta por SMS; os itens não habilitados pela clínica ficam ocultos para o paciente.
| Função | O que faz | Quem usa |
|---|---|---|
| Agendamento pelo paciente | O paciente marca a própria consulta nos horários que a clínica liberou, com listas filtradas por contexto (só o que se aplica a ele). | Paciente |
| Ativação por SMS | Primeiro acesso validado por código SMS no celular do cadastro — garante que é o próprio paciente. | Paciente |
| Acompanhamento de autorizações | Página onde o paciente vê o andamento das autorizações dele junto ao convênio, sem ligar para a clínica. | Paciente |
| Aprovação de orçamento por link | O link recebido por SMS/e-mail abre o orçamento para o paciente visualizar e aprovar. | Paciente |
Como acompanhar: agendamentos feitos online entram no board da Agenda como os demais; a configuração do que fica habilitado é feita em Configurações (parâmetros do serviço online).
📈 Relatórios
Central de análise em /portal/relatorios (permissão RELATORIOS → VIEW — módulo só de leitura). Regra prática: confira o "Total de registros: N" antes de exportar. Agenda, Ocupação, Produtividade e Repasses exportam CSV; os demais são visões em tela. Ver lição completa.
| Relatório | O que mostra | Filtros | Quem usa | Quando rodar |
|---|---|---|---|---|
| Relatório de Agenda | Todos os agendamentos do período com dados completos do agendamento e do paciente (o mais usado; exporta CSV) | Data inicial/final, especialidade, profissional, status, unidade, procedimento, CPF, celular, cidade, encaixe | Recepção, Confirmação, Gestor | Diário (fechamento) e semanal |
| Rotina de Recepção | Consolidado do trabalho da recepção no dia: agendamentos, confirmações, acolhimentos e pendências | Data, unidade | Recepção, Gestor | Diário (fim do expediente) |
| Rotina de Autorização | Consolidado das autorizações: solicitadas, aprovadas, negadas e pendentes com prazos | Data, convênio | Autorizadora, Gestor | Diário |
| Rotina de Fechamento | Conferência do fechamento do dia: atendimentos × lançamentos financeiros × guias geradas | Data, unidade | Financeiro, Faturista, Gestor | Diário (fechamento) |
| Ocupação da Agenda | Taxa de ocupação da grade por profissional e período (horários vagos × ocupados; CSV) | Data, profissional, unidade | Gestor | Semanal |
| Produtividade da Agenda | Quantidade de atendimentos por colaborador, especialidade e procedimento (base dos repasses; CSV) | Data, profissional, especialidade | Gestor, Financeiro | Semanal e mensal |
| Repasses por Colaborador | Valor de repasse por profissional, calculado automaticamente pelo percentual do cadastro do colaborador (CSV) | Data, colaborador | Financeiro, Gestor | Mensal (folha/repasse) |
| Fluxo de Caixa | Saldo do dia, acumulado, máximo e mínimo por conta/caixa, dia a dia (visão em tela) | Data, conta, tipo de saldo | Financeiro, Gestor | Diário (conferência de caixa) |
| Relatório de Autorizações | Visão dedicada de todas as autorizações e seus status ao longo do período | Data, convênio, status | Autorizadora, Gestor | Semanal |
| Médicos × Convênios (com farol) | Cruzamento de resultado por médico e convênio com as cores do farol 🟢🟡🔴 — versão para impressão | Convênio, profissional | Gestor | Mensal (renegociação) |
| Serviços × Convênio (com farol) | Resultado de cada serviço por convênio com farol — mostra onde a clínica ganha e onde perde dinheiro | Convênio, serviço | Gestor | Mensal (revisão de tabelas) |
| Mapa de Estoque | Saldo atual × Estoque Atual de cada produto (nome anterior: "Estoque Base" — renomeado em set/2026, mesmo cálculo), destacando os itens CRÍTICOS (visão em tela); janela ampliada para 180 dias | Produto, status CRÍTICO, Tipo de Produto ✅ set/2026 | Estoquista, Gestor | Diário/semanal (reposição) |
| Logs de Auditoria | Registro imutável de quem fez o quê e quando (criação, edição, exclusão, login) — rota /portal/relatorios/logs-auditoria; acesso restrito a administradores (LGPD) | Data, usuário, ação, módulo | Admin, Gestor | Sob demanda (apuração) |
| 🟠 Rotina de Acolhimento — em breve (Sprint 10) | Consolidado do acolhimento/check-in do dia (#382) | — | Recepção, Gestor | — |
| 🟠 Produtividade por usuário — em breve (Sprint 10) | Produção individual de cada usuário do sistema (#385) | — | Gestor | — |
📊 Dashboards
O Dashboard abre logo após o login (/dashboard — a exceção às rotas /portal/) e consolida os indicadores em tempo real: contadores como "Em Atendimento" e "Acolhido" mudam sozinhos, sem recarregar. Cada aba só aparece para quem tem permissão VIEW no módulo correspondente; os atalhos rápidos (Agendar, Cadastrar Paciente, Registrar Pagamento…) também respeitam o perfil. Ver lição completa.
| Aba | Rota | O que mostra | Para quem |
|---|---|---|---|
| Principal | /dashboard | Visão geral consolidada do dia — leitura rápida da operação inteira antes de abrir qualquer módulo, mais os atalhos rápidos. | Todos os perfis |
| Agendamentos | /dashboard/agendamentos | Contadores por status da agenda (Aguardando, Confirmado, Acolhido, Em Atendimento, Atendido, Cancelado, Remarcado), com filtros de período, especialidade, profissional e unidade. | Recepção, Confirmação, Gestor |
| Autorizações | /dashboard/autorizacoes | Status das autorizações junto aos convênios: pendentes, aprovadas, negadas e em análise — o termômetro da fila da autorizadora. | Autorizadora, Gestor |
| Orçamentos | /dashboard/orcamentos | Pipeline de orçamentos: abertos, aprovados, expirados e convertidos em agendamento — mede a taxa de conversão comercial. | Autorizadora, Gestor |
| Produtos | /dashboard/produtos | Estoque: itens abaixo do mínimo (CRÍTICOS), entradas/saídas recentes e alertas de reposição. | Estoquista, Gestor |
| Financeiro | /dashboard/financeiro | Resumo do caixa: entradas, saldo do dia, acumulado, máximo e mínimo do período. Acesso restrito (exige FINANCEIRO → VIEW — dado sensível). | Financeiro, Gestor |
| Faturamento | /dashboard/faturamento | Status do faturamento dos convênios: guias geradas, enviadas, glosadas, pagas e em recurso — a saúde da receita de convênio num relance. | Faturista, Gestor |
⚙️ Configurações
A fundação do sistema — todos os módulos dependem destes cadastros. A ordem importa: Empresa → Locais → Operadoras → Convênios → Preços → Serviços → Equipamentos → Colaboradores → Documentos → Permissões → Parâmetros. Acesso restrito ao implantador/administrador. Ver página do módulo, lição completa e os pré-requisitos de implantação.
| Tela / Função | Rota | O que faz | Quem usa |
|---|---|---|---|
| Empresas e Unidades | /portal/configuracoes/empresas-unidades | Estrutura organizacional: empresa (CNPJ validado, endereço por CEP, logo por clínica nos impressos) e suas unidades físicas. É a etapa 1 — sem ela nada mais se cadastra. | Implantador |
| Locais / Salas | /portal/configuracoes/empresas-unidades/locais | Consultórios e salas dentro de cada unidade — alimentam o campo "Local do Agendamento". | Implantador |
| Operadoras | /portal/configuracoes/operadoras | As empresas de plano de saúde (Unimed, Bradesco…). Operadora ≠ convênio: primeiro a operadora, depois os planos dela. | Implantador |
| Convênios | /portal/configuracoes/convenios | O cadastro mais crítico: planos com prazos comerciais (pagamento, retorno, entrega de guias, recurso de glosa), pagamento no ato ou lote, fator K, credenciamento por CBOS (só credenciados aparecem no agendamento), tabela de preços (importar/manual/copiar/exportar Excel), conversão de serviço "de–para" e parâmetros do farol. | Implantador, Gestor |
| Tabela de Preços Internos | /portal/configuracoes/tabela-precos-internos | Valores dos serviços para atendimento particular — aparecem automaticamente no agendamento e no orçamento particular. Tem filtros de busca. | Implantador, Gestor |
| Serviços e Tipos de Serviço | /portal/configuracoes/servicos · /servicos/tipos | Catálogo de tudo que a clínica faz, com código TUSS (obrigatório para faturar convênio). Tipos (Consulta, Exame, Cirurgia…) vêm antes dos serviços. | Implantador |
| Tipos de Atendimento | /portal/configuracoes/tipo-atendimento | Classificação da visita (Primeira Consulta, Retorno — usa o prazo de retorno do convênio —, Urgência, Telemedicina). Herdada pelo prontuário. | Implantador |
| Colaboradores | /portal/configuracoes/colaboradores | Profissionais com e-mail único (login), empresa, especialidades com CBOS (obrigatório para faturar), conselho profissional, percentual de repasse e grade horária que define os horários agendáveis. | Implantador, Gestor |
| Equipamentos | /portal/configuracoes/equipamentos | Aparelhos com grade horária própria, reserváveis no agendamento — evita duas ecografias no mesmo aparelho e horário. | Implantador |
| Tipos de Documento de Atendimento | /portal/configuracoes/tiposDocumentoAtendimento | Modelos dos documentos clínicos (atestado, receita simples/controlada, laudo, encaminhamento) com variáveis automáticas de paciente/profissional/data. | Implantador |
| Tipos de Impressão | /portal/configuracoes/tipo-impressao | Cabeçalho/rodapé dos impressos com logo e dados da clínica/profissional. | Implantador |
| Taxas e Tipos de Taxa | /portal/configuracoes/taxas · /taxas/tipos | Taxas de sala, material e guia cobradas nos serviços — entram no orçamento, na autorização e no farol. | Implantador, Gestor |
| Tipos de Código / Anexos / Identificação | /portal/configuracoes/tipos-de-codigo · /tipos-de-anexos · /tipo-identificacao | Cadastros auxiliares: padrões de codificação do faturamento (TUSS, CBHPM, próprio), categorias de anexos e tipos de identificação. | Implantador |
| Parâmetros do Sistema | /portal/configuracoes/parametros | Configurações globais: horário de funcionamento, duração padrão, obrigatoriedade de orçamento/autorização no agendamento, notificações, serviço online, tokens de API. Alterar de preferência com o suporte Rabi. | Implantador/Admin |
🔐 Segurança e Permissões
Como o acesso é controlado hoje — e o que muda pouco a pouco. Ver lição completa.
| Função | Rota / onde | O que faz | Quem usa |
|---|---|---|---|
| Permissões por módulo | Configurações → Usuários | Modelo: papel (Role) + 4 ações fixas por módulo — NONE < VIEW < CREATE < UPDATE < DELETE — nos grupos AGENDAMENTO, ATENDIMENTO, PACIENTES, FINANCEIRO, FATURAMENTO, CONFIGURACOES, ESTOQUE, RELATORIOS e DASHBOARD. A permissão configurada reflete exatamente o que o usuário pode fazer (revisão de ago/2026). | Admin |
| Sessão única | automático | O mesmo usuário não consegue estar logado em dois lugares ao mesmo tempo — barra o compartilhamento de senha e protege o log de auditoria. | Todos (automático) |
| Nível de alçada | aprovações no fluxo | Aprovações por nível hierárquico: desconto acima do limite, liberação de farol vermelho e edição de Atendido notificam todos os usuários do nível; quando um responde, a pendência se resolve para todos. | Gestor |
| Minha Conta | /portal/minha-conta | Dados do próprio perfil e credenciais (gerenciados pelo Keycloak). | Todos |
| Logs de Auditoria | /portal/relatorios/logs-auditoria | Registro imutável de todas as ações (quem, o quê, quando) — a prova em caso de dúvida ou incidente (LGPD). | Admin, Gestor |
| 🟠 Permissões granulares — em breve (Sprint 10) | — | Refactor RBAC (#395): múltiplos perfis por usuário e ações configuráveis além das 4 fixas. Ainda não disponível — hoje vale Role + 4 ações. | Admin |
✨ Funcionalidades transversais (valem em várias telas)
| Funcionalidade | Onde aparece | O que faz |
|---|---|---|
| Busca global | Topo de qualquer tela | Encontra o paciente por nome parcial, telefone, e-mail ou CPF — sem precisar abrir o módulo Pacientes. |
| Guard de edição | Todos os formulários | Ao sair de uma tela com alterações não salvas, pede confirmação antes de descartar — acabou o formulário perdido por clique acidental. |
| Setas próximo/anterior | Topo das telas de lista/detalhe | Navega para o registro seguinte/anterior sem voltar à lista — acelera conferências em série (guias, agendamentos). |
| Proteção anti-duplo-clique | Botões de salvar/enviar | Idempotência: clicar duas vezes não cria registro duplicado. |
| Farol 🟢🟡🔴🟣 | Orçamento, Autorização, Agendamento, Convênio, Relatórios | Semáforo de resultado por serviço/produto/taxa × convênio: 🟢 segue, 🟡 alerta, 🔴 bloqueia (liberação por alçada), 🟣 erro de preço (sem custo ou sem receita). Consolidado sobre serviço + produto + taxa. |
| Nível de alçada | Descontos, farol vermelho, edição de Atendido | Aprovações por nível hierárquico (ex.: 5% / 10% / 20% / sem limite); notifica todos do nível e resolve para todos quando um responde. |
| Edição de Atendido com aprovação | Agenda, Fila de Atendimento, Autorização | Atendido não se edita direto: botão "Editar" com motivo → aprovação → reflexo automático na Autorização; divergências sinalizadas na Agenda e na Fila (botão Corrigir). |
| Status "Pendente" | Board da Agenda | Status intermediário do agendamento enquanto falta orçamento ou autorização — a fila de trabalho da autorizadora, visível para todos. |
| "Faltam X de Y" | Board da Agenda | Contador de produtos controlados pendentes no agendamento, criticado a partir do orçamento/autorização (totais previstos × agendados). |
👥 Visão por perfil: suas telas do dia
Para cada função da clínica, as telas na ordem do dia (manhã → tarde → fechamento) e o link para a rotina passo a passo correspondente.
Recepcionista
- Manhã:
/dashboard/agendamentos(visão do dia) →/portal/agenda(board: confirmados, pendências) →/portal/agenda/acolhimento(chegadas e check-in, o dia inteiro). - Ao longo do dia: busca global para achar pacientes →
/portal/pacientes/criar(novos cadastros) →/portal/agenda/criar(marcações e encaixes) → remarcações e bloqueios. - Fechamento: Relatório de Rotina de Recepção em
/portal/relatorios(conferir o dia) → deixar a agenda de amanhã sem pendências no board. - ➡️ Rotina completa: Rotina de Recepção
Confirmação de Agenda / Contact
- Manhã:
/portal/agenda/confirmacao(lista de "Aguardando" de amanhã) → disparo/checagem dos lembretes automáticos da Central de Notificações (links de confirmação). - Tarde: segunda rodada em
/portal/agenda/confirmacao(quem não respondeu ao link, ligar) → remarcar os que não vêm (/portal/agenda/:id/editar). - Fechamento: board da Agenda com o dia seguinte todo Confirmado; Relatório de Agenda filtrado por status para medir a taxa de confirmação.
- ➡️ Rotina completa: Rotina de Confirmação de Agenda
Autorizadora / Faturista
- Manhã (autorização):
/dashboard/autorizacoes(fila do dia) → coluna de autorizações pendentes no board da Agenda e status "Pendente" →/portal/agenda/autorizacao(novos pedidos, retornos das operadoras) →/portal/agenda/orcamento(orçamentos aguardando aprovação). - Tarde (faturamento):
/portal/guia2/list/pre-faturamento(conferência de guias) → no calendário de cada convênio:/portal/faturamento/fechar-lotes→/portal/lote/administrar-lote→/portal/lote/gerar-contas-a-receber→/portal/glosas(tratativas no prazo). - Fechamento: Relatório de Rotina de Autorização + aba Dashboard → Faturamento (guias enviadas/glosadas).
- ➡️ Rotinas completas: Autorização e Orçamento · Calendário de Faturamento
Médico / Profissional de saúde
- Manhã: e-mail com a agenda do dia (só confirmados) →
/portal/fila-de-atendimento(chamar o primeiro paciente). - Durante os atendimentos: prontuário
/portal/pacientes/:id/atendimento/:id(anamnese, CID-10, procedimentos, receitas/atestados por modelo) → Finalizar Atendimento a cada consulta (dispara financeiro/faturamento) → responder notificações de liberação de encaixe. - Fechamento: fila zerada e área de divergências vazia; produção conferível em Produtividade da Agenda e Repasses.
- ➡️ Rotina relacionada: Liderança de Atendimento
Financeiro
- Manhã:
/dashboard/financeiro(saldo do dia) →/portal/financeiro/registros(baixas de recebimentos e pagamentos do dia) →/portal/financeiro/historico-contas(conferência de saldo por conta). - Tarde: lançamentos novos (
.../pagar/criar,.../receber/criar) → contas a receber geradas pelos lotes (filtro "A Receber") → aprovações de desconto por alçada. - Fechamento: relatório Fluxo de Caixa + Rotina de Fechamento: atendimentos × lançamentos × guias batendo. Emissão de NF de particular pelo emissor atual (🟠 NFS-e no Rabi: Sprint 9).
- ➡️ Rotina completa: Emissão de NF — Particular
Gestor / Liderança
- Manhã:
/dashboard(leitura geral) → abas Agendamentos, Autorizações e Faturamento → pendências de alçada (aprovações de desconto, farol vermelho, edição de Atendido). - Semana: Ocupação da Agenda + Produtividade (quem está ocioso, quem está lotado) → orçamentos: pipeline e conversão.
- Mês: Repasses por Colaborador → relatórios médicos×convênios e serviços×convênio com farol (renegociar tabela ou descredenciar onde dá vermelho) → Logs de Auditoria sob demanda.
- ➡️ Rotinas completas: Liderança de Atendimento · Sucesso do Paciente
Estoquista
- Manhã:
/dashboard/produtos+ Mapa de Estoque (itens CRÍTICOS) → separação dos materiais dos procedimentos do dia (previsão de estoque nos agendamentos). - Tarde: entradas de compras (movimentação) → pedidos de compra no módulo Compras e envio ao fornecedor → conferência das saídas vinculadas aos atendimentos.
- Fechamento: posição de estoque conferida (saldo real por depósito); nenhum item crítico sem pedido aberto.
- ➡️ Rotina relacionada: Calendário de Faturamento (materiais faturáveis) · Pré-requisitos de implantação
💡 Onde continuar
As Rotinas do Dia a Dia (Recepção, Confirmação, Sucesso do Paciente, Autorização e Orçamento, Liderança, Calendário de Faturamento, NF Particular) detalham o passo a passo de cada fase do dia. As lições da certificação aprofundam campo a campo cada tela deste mapa.