Lição: Relatórios
Esta lição prepara você para operar e explicar o módulo de Relatórios do Sistema Rabi. O conteúdo cobre cada relatório disponível em produção, os filtros de cada um, o passo a passo de geração e exportação, as regras de negócio e as permissões necessárias. Ao final há os pontos-chave e o que a prova de certificação vai cobrar.
🟢 Em produção. Todos os relatórios descritos nesta lição estão disponíveis no ambiente de produção do Rabi e podem ser ensinados como uso real.
Objetivo do módulo e onde fica
O módulo de Relatórios agrega dados de todos os outros módulos (agenda, financeiro, faturamento, estoque, colaboradores) e os apresenta em análises filtráveis e, em vários casos, exportáveis. É a principal ferramenta de decisão gerencial da clínica.
- Menu: Relatórios
- Rota principal:
/portal/relatorios - Rota dos logs de auditoria:
/portal/relatorios/logs-auditoria - Grupo de permissão:
RELATORIOS— apenas a ação VIEW (relatórios são de leitura; não há CREATE/UPDATE/DELETE).
🟢 Acesso restrito por função. A permissão de RELATORIOS deve ser concedida apenas a perfis de gestão e financeiro. Recepcionistas e médicos normalmente não precisam de acesso a relatórios gerenciais.
Catálogo de relatórios
Os relatórios disponíveis em produção, com sua finalidade, principais filtros e formato de exportação:
| Relatório | Para que serve | Principais filtros | Exportação |
|---|---|---|---|
| Relatório de Agenda | Lista todos os agendamentos do período com detalhes completos | Data (inicial/final), Especialidade, Profissional, Status, Unidade, Procedimento, CPF, Celular, Cidade, Encaixe | CSV |
| Ocupação da Agenda | Taxa de ocupação por profissional e período | Data, Profissional, Unidade | CSV |
| Produtividade da Agenda | Quantidade de atendimentos por colaborador | Data, Profissional, Especialidade | CSV |
| Repasses por Colaborador | Valor de repasse por colaborador no período | Data, Colaborador | CSV |
| Fluxo de Caixa | Saldo diário, acumulado, máximo e mínimo por conta/caixa | Data, Conta, Tipo de Saldo | — |
| Mapa de Estoque | Saldo atual vs. estoque mínimo; itens críticos | Produto, status CRÍTICO | — |
| Logs de Auditoria | Registro completo e imutável de ações no sistema | Data, Usuário, Ação, Módulo | — |
Relatório de Agenda
É o relatório mais utilizado. Lista todos os agendamentos do período, com campos completos do agendamento e do paciente.
Filtros do Relatório de Agenda
| Filtro | Obrigatório? | Tipo / validação |
|---|---|---|
| Data Agendamento Inicial | Sim | Data dd/mm/aaaa |
| Data Agendamento Final | Sim | Data dd/mm/aaaa (deve ser ≥ à inicial) |
| Especialidade | Não | Multi-seleção |
| Colaborador (Profissional) | Não | Multi-seleção |
| Status | Não | Multi-seleção: Aguardando, Confirmado, Cancelado, Atendido, Acolhido, Remarcado |
| Unidade | Não | Multi-seleção |
| Procedimento | Não | Multi-seleção |
| CPF / Celular / Cidade | Não | Texto livre (filtro por paciente) |
| Encaixe | Não | Sim / Não |
| Data Acolhimento | Não | Data dd/mm/aaaa |
| Data Atendimento | Não | Data dd/mm/aaaa |
Passo a passo — gerar o Relatório de Agenda
- Acesse o menu Relatórios e escolha Relatório de Agenda.
- Preencha o período: Data Agendamento Inicial e Data Agendamento Final (formato dd/mm/aaaa).
- Aplique os filtros opcionais desejados (Especialidade, Profissional, Status, Unidade, etc.). Em campos multi-seleção, clique e escolha um ou mais valores; em campos de texto, digite e confirme.
- Clique em Aplicar Filtros. A tabela é montada e o sistema exibe "Total de registros: N" abaixo dela.
- Confira o total de registros para validar se os filtros estão corretos.
- Clique em Exportar CSV para baixar o arquivo (abre no Excel, Google Sheets, etc.).
- Se precisar recomeçar, use Limpar Filtros para resetar tudo.
Fluxo de Caixa
Mostra a movimentação financeira ao longo do tempo, por conta/caixa. Não possui exportação de arquivo — é uma visão em tela.
| Indicador | Significado |
|---|---|
| Saldo do Dia | Entradas menos saídas no dia específico |
| Saldo Acumulado | Saldo progressivo ao longo do período |
| Saldo Máximo | Maior saldo alcançado no período |
| Saldo Mínimo | Menor saldo registrado no período |
| Positivo | Dias com entradas maiores que saídas |
| Negativo | Dias com saídas maiores que entradas |
Filtros: Data (inicial/final), Conta e Tipo de Saldo. Valores exibidos em moeda R$ 1.234,56.
Produtividade e Repasses
Analisam o desempenho de cada colaborador e calculam os valores de repasse.
- Produtividade da Agenda: quantidade de atendimentos por profissional, especialidade e procedimento.
- Repasses por Colaborador: valor total calculado automaticamente com base no percentual de repasse configurado no cadastro do colaborador.
🟢 Regra de negócio — repasse. O percentual de repasse é definido em Configurações → Colaboradores. O relatório de repasses não pede o percentual manualmente: ele calcula sozinho, cruzando os atendimentos realizados com o percentual cadastrado.
Mapa de Estoque
Visão consolidada do estoque de produtos, destacando itens em situação crítica (abaixo do estoque mínimo).
- Est. Base: estoque mínimo configurado no cadastro do produto.
- Saldo Atual: quantidade disponível no momento.
- Status CRÍTICO: saldo abaixo do estoque base — indica que a reposição é necessária.
Filtros e exportação (regras gerais)
Como usar os filtros
- Selecione o período em Data Inicial e Data Final.
- Aplique filtros adicionais: multi-seleção (clique e escolha) ou texto (digite e confirme).
- Clique em Aplicar Filtros.
- Use Limpar Filtros para resetar todos os filtros aplicados.
Exportação de dados
- CSV: disponível nos relatórios de agenda, ocupação, produtividade e repasses — botão Exportar CSV (compatível com Excel e Google Sheets).
- Excel (.xlsx): disponível em alguns relatórios — botão Exportar Excel.
- Fluxo de Caixa, Mapa de Estoque e Logs de Auditoria são visões em tela, sem botão de exportação de arquivo.
🟢 Sempre confira o total. O sistema mostra "Total de registros: N" abaixo da tabela. Verifique esse número antes de exportar para garantir que os filtros estão corretos.
Logs de Auditoria
Registro completo e imutável de todas as ações realizadas no sistema, garantindo rastreabilidade total. Rota: /portal/relatorios/logs-auditoria.
| Campo registrado | Descrição |
|---|---|
| Data e Hora | Momento exato da ação (com fuso horário América/São_Paulo) |
| Usuário | Nome do usuário que realizou a ação |
| Ação | Tipo: criação, edição, exclusão, login, logout |
| Módulo / Entidade | Qual módulo e qual registro foi afetado |
⚠️ Acesso restrito (LGPD). Os logs de auditoria devem ser acessíveis apenas por administradores. Configure a permissão de logs de auditoria somente para gestores e administradores. Os logs ajudam a apurar quem fez o quê e quando, sem expor dados pessoais desnecessários.
Permissões
O modelo de permissões atual do Rabi é papel (Role) + 4 ações fixas por módulo (VIEW / CREATE / UPDATE / DELETE). Para Relatórios, apenas a ação relevante é VIEW:
| Recurso | Permissão necessária |
|---|---|
| Ver e exportar relatórios gerenciais | RELATORIOS → VIEW |
| Logs de auditoria | RELATORIOS → VIEW (recomendado somente para administradores) |
Sem a permissão VIEW no grupo RELATORIOS, o usuário não vê o menu Relatórios nem consegue abrir a rota.
Erros comuns e como resolver
| Situação | Como resolver |
|---|---|
| "Menu Relatórios não aparece" | Falta a permissão RELATORIOS → VIEW. Peça ao administrador para conceder no perfil. |
| Relatório vazio / "Total de registros: 0" | Período muito restrito ou filtros excessivos. Amplie as datas e remova filtros; clique em Limpar Filtros e refaça. |
| Data final anterior à inicial | Ajuste as datas — a final deve ser igual ou posterior à inicial (dd/mm/aaaa). |
| Não encontro o botão exportar | Nem todo relatório exporta. Fluxo de Caixa, Mapa de Estoque e Logs de Auditoria são só em tela. |
| Repasse com valor inesperado | O cálculo usa o percentual cadastrado em Configurações → Colaboradores. Verifique o percentual do colaborador. |
Novidades de julho/2026 ✅ Novo — jul/2026
Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
- Rotina de fechamento (#384): relatório de rotina de fechamento.
- Relatório de autorizações (#371): relatório dedicado às autorizações.
🟠 Em finalização (Sprint 8, 28/ago–04/set) — ainda NÃO entregues, trate como "em breve": rotina de recepção (#381), rotina de acolhimento (#382), rotina de autorização (#383) e produtividade por usuário (#385).
Pontos-chave
- Relatórios é módulo de leitura: permissão relevante é
RELATORIOS → VIEW. - Rota principal
/portal/relatorios; logs em/portal/relatorios/logs-auditoria. - Sete relatórios em produção: Agenda, Ocupação, Produtividade, Repasses, Fluxo de Caixa, Mapa de Estoque e Logs de Auditoria.
- Exportam em CSV: Agenda, Ocupação, Produtividade e Repasses. Fluxo de Caixa, Mapa de Estoque e Logs são só em tela.
- Sempre confira "Total de registros: N" antes de exportar.
- Repasse é calculado automaticamente a partir do percentual do colaborador.
- Logs de auditoria são imutáveis e restritos a administradores (LGPD).
- O ciclo de julho/2026 entregou a rotina de fechamento (#384) e o relatório de autorizações (#371); os relatórios de rotina de recepção/acolhimento/autorização e produtividade por usuário (#381–#383, #385) estão em finalização (Sprint 8) e ainda não foram entregues.
O que a prova vai cobrar
- Qual permissão dá acesso a Relatórios e por que é só VIEW.
- Quais relatórios exportam CSV e quais são apenas em tela.
- O passo a passo para gerar e exportar o Relatório de Agenda, incluindo o campo obrigatório (período).
- Como o valor de repasse é calculado e onde o percentual é configurado.
- O que os Logs de Auditoria registram e por que o acesso é restrito.