Regras de Negócio
Regras formalizadas que regem o comportamento do sistema. Referência para implantadores, suporte e desenvolvimento.
Princípios gerais
- Centralização: todas as informações de pacientes, atendimentos e convênios em um único ambiente digital.
- Automação: processos de agendamento, faturamento e controle financeiro automatizados.
- Compliance: aderência a LGPD, com auditoria de ações e criptografia de dados sensíveis.
- Indicadores: dashboards e relatórios gerenciais como apoio à decisão.
Cadastro e Administração
- Pacientes, profissionais, convênios, serviços, taxas e unidades são cadastros core; cada um pode ser inativado mas não excluído se tiver histórico.
- Hierarquia de perfis de acesso: Administrador > Gestor > Operador > Visualizador.
- Níveis de permissão por módulo: NONE < VIEW < CREATE < UPDATE < DELETE.
- Toda ação de alteração, exclusão ou inativação gera registro em logs de auditoria.
Agendamento e Atendimento
- Agendamento só é aceito se houver disponibilidade do profissional e do equipamento (quando aplicável).
- Verificação automática de autorização prévia segundo regras do convênio.
- ✅ Novo — jul/2026 Bloqueio no prazo de retorno: o sistema bloqueia novo agendamento dentro do prazo de retorno do convênio (#414), com prazo configurável por convênio e por serviço (#415). Entregue no ciclo de julho/2026; se ainda não apareceu no seu ambiente, chega na próxima atualização.
- Status do agendamento: Aguardando Confirmado Atendido Em Atendimento Cancelado Acolhido Remarcado
- Acolhimento confere dados do paciente antes do atendimento; pode acionar checkin que move paciente para fila do médico.
Faturamento e Glosas
- Pré-faturamento permite conferência de guias antes do envio para o convênio.
- Quando houver guia principal vinculada a guias secundárias, todas são exibidas no mesmo lote.
- Geração de XML segue padrão TISS/TUSS da ANS — ver seção TISS/TUSS.
- Glosas são tratadas em fluxo dedicado com prazo de recurso definido por convênio.
Financeiro
- Controle de contas a pagar e a receber com data de vencimento e categoria.
- Emissão de NF-e integrada à movimentação financeira.
- Cobrança automática após 30 dias de teste, se o sistema continuar em uso.
- Controle de fluxo de caixa por conta/caixa, com saldo em tempo real.
Estoque
- Entrada e saída de produtos registrada em movimentos com timestamp e responsável.
- Produtos podem ser associados a atendimentos (consumo clínico) ou a vendas.
- Estoque mínimo configurável por produto — dispara alerta no relatório Mapa de Estoque.
Segurança e Compliance
Dados pessoais são protegidos: criptografia em campos sensíveis, backup automático, auditoria completa de acessos, logs sem PII explícito.
- Autenticação por SSO (Keycloak) com OAuth2/OIDC.
- Sessão expira após inatividade configurável.
- Toda exclusão crítica gera registro em log com motivo opcional.
Regras levantadas na reunião 18/06/2026 (#373–#385)
Treze itens foram abertos como issues no GitLab. Atenção: parte já está em produção e parte é planejamento (roadmap). A coluna Status indica a situação real (auditada em 20/06/2026 contra produção; revisada em 24/07/2026 contra as issues fechadas no GitLab). Itens com selo ✅ Novo — jul/2026 foram entregues no ciclo de julho/2026 no desenvolvimento; se ainda não apareceram no seu ambiente, chegam na próxima atualização.
| # | Regra | Status | Issue |
|---|---|---|---|
| 1 | Agendamento exige orçamento aprovado antes de criar (conforme parametrização). | ✅ Novo — jul/2026 | #373 |
| 2 | Agendamento exige autorização da operadora antes de confirmar (conforme parametrização). | ✅ Novo — jul/2026 | #374 |
| 3 | Novo status "Pendente" enquanto faltar orçamento/autorização (Sprint 5, agosto). | 🟠 Planejado | #375 |
| 4 | Convênio pode bloquear serviços específicos. | 🟠 Planejado | #376 |
| 5 | Avisos na grade (indisponibilidade, manutenção, bloqueio). | 🟠 Planejado | #377 |
| 6 | Agendamento em série (semanal/quinzenal/mensal). | ✅ Em produção | #378 |
| 7 | Bloqueio de agenda (feriados, férias, manutenção). | ✅ Em produção | #380 |
| 8 | Atendimento finalizado exige documento. | 🟠 Planejado | #379 |
| 9 | Pré-solicitação interna da autorização. | ✅ Em produção | #381 |
| 10 | Fila de espera com encaixe automático. | ✅ Em produção | #382 |
| 11 | Encaixe manual em horário cheio. | ✅ Em produção | #383 |
| 12 | Espera de atendimento (pacientes com check-in). | ✅ Em produção | #384 |
| 13 | Histórico do atendimento em timeline. | ✅ Em produção | #385 |
Regras transversais
Entregues no ciclo de julho/2026 ✅ Novo — jul/2026 — se ainda não apareceram no seu ambiente, chegam na próxima atualização:
- Guard de edição não salva: ao sair de formulário com alterações pendentes, o sistema pede confirmação — ver página dedicada (#401, #404).
- Idempotência em criações/edições: sem duplicidades por duplo clique ao salvar (#408).
- Busca global: busca por parte do nome/sobrenome, telefone, e-mail ou CPF (#456).
- Setas de navegação: setas próximo/anterior no topo das telas (#459).
Farol de resultado por convênio ✅ Novo — jul/2026: farol 🟢🟡🔴 receita × custo por serviço/produto com bloqueio no vermelho foi entregue em 22/07 (#390, #434). Detalhes na página de Orçamento.
Itens transversais ainda não disponíveis 🟠 planejados — no roadmap:
- Travas de proteção entre usuários: evitar edição simultânea do mesmo registro por dois usuários (#407 — Sprint 5).
- Filtros padrão: busca em toda a base filtrada, filtros persistentes e URL compartilhável em ~40 listagens (#396).