AXUMMapa · Gestão Clínica
Documento interno
Versão 1.2 · Junho 2026
App: app.axium.health

Mapa de Funcionalidades & Jornadas do Usuário

Inventário oficial do aplicativo de gestão da Axium Quiropraxia: módulos, capacidades, ações de backend e os fluxos de trabalho da recepção e da administração. Base para o manual do usuário e a documentação técnica.

01 · Visão geral

O que é o Axium Gestão

Aplicativo web de operação diária da clínica: cadastro de pacientes, venda e controle de planos (pacotes de sessões), registro de atendimentos, emissão de documentos jurídicos com numeração de controle, gestão de notas fiscais e painel de indicadores. Roda no navegador (desktop e celular), conectado a uma API Google Apps Script v5.9 sobre a planilha DB_Axium, com um microserviço dedicado para geração de PDFs.

02 · Mapa de funcionalidades

Módulos do aplicativo

Cabeçalho do sistema

presente em todas as telas
  • Indicadores ao vivo: atendimentos de hoje, do mês e receita do mês (incluindo os planos pagos pela convenção)
  • Badge de conexão com cronômetro ("online · 2.1s") e motivo do offline
  • Atalho direto para o app Prontuário

Registrar

aba REGISTRAR · tela inicial
  • Busca de paciente por nome com seleção rápida
  • Card do paciente: dados, barra de completude do cadastro (%) e campos faltantes para termos
  • Plano ativo: sessões usadas / restantes em tempo real
  • Registro de sessão: data, tipo (atendimento · falta · no-show), quiropraxista, unidade, observações
  • Venda de pacote na conversão: nasce 0/X — ou 1/X quando a 1ª sessão é feita na própria avaliação (campo "1ª sessão na avaliação?")
  • Renovação no retorno X/X: "Fechou plano? = Sim" cria o pacote novo (0/X), o valor fica no plano (sessão do dia sai R$ 0) e o pacote anterior é concluído automaticamente
  • Marcação de NF no ato do registro
saveAtendimentosavePlano

Termos e contratos

dentro do card do paciente
  • 4 documentos: Contrato, TCLE, Termo LGPD e Termo de Imagem
  • Numeração de controle TRM-XXXX registrada na planilha, com data/hora
  • Histórico de emissão por tipo ("✓ gerado em 03/06/2026 às 21:08")
  • 2ª via fiel ao documento original (snapshot dos dados da época)
  • PDF com rodapé de controle em todas as páginas (via PDF Service)
  • Geração em paralelo com progresso no botão; impressão (🖨) como plano B
saveTermolistTermosPacgerarPdf → PDF Service

Pacientes

aba PACIENTES
  • Lista completa com busca
  • Cadastro/edição: nome, CPF, RG, nascimento, contato (telefone, WhatsApp, e-mail)
  • Endereço com preenchimento automático por CEP (ViaCEP)
  • Canal de origem (Instagram, Google, Indicação… + descrição de parceria)
  • Profissão, queixa principal e quiropraxista responsável
  • Validações do servidor: CPF duplicado e nome idêntico bloqueados
savePacienteupdatePaciente

Planos

aba PLANOS
  • Filtro abre em "Ativos" — a carteira viva em primeiro plano
  • Contador X/X pelo vínculo explícito da sessão (PlanoID); janela de datas só para o legado
  • ✎ Editar plano: modal completo (sessões, abertura, valores, parcelas, NF, status, obs)
  • Controle de NF por plano
updatePlano

Atendimentos

aba ATEND.
  • Lista com filtros por mês, dia, tipo e quiropraxista (inclui o filtro "Pacotes", que mostra só os pacotes vendidos), ordenação e totalizador de caixa
  • Livro-caixa: pacotes pagos pela convenção nova (a partir de 05/06) entram como linha de plano, com o valor no plano e o atendimento R$ 0; a conversão (avaliação que abre pacote) segue contada uma vez só, pela avaliação, sem dobrar receita
  • Busca por nome do paciente — varre todos os meses; o CSV respeita a busca
  • Edição de registro (data, valores, observações)
  • Exclusão com confirmação
updateAtendimentodeleteAtendimento

Notas Fiscais

aba NFS
  • Pendências de NF por atendimento e por plano
  • Marcar/desmarcar emissão com um clique
  • Ordenação e filtros de período
updateAtendimentoupdatePlano

Dashboard

aba DASHBOARD
  • Filtros por mês, dia, unidade e quiropraxista
  • Indicadores de produção e receita: faturamento, ticket médio, conversão, taxa de renovação, fidelização, pacientes e pacotes ativos (com marcação de mês parcial). Faturamento e ticket já incluem os planos pagos
  • Atualização automática sem perder os filtros escolhidos
03 · Jornadas do usuário

Fluxos de trabalho

Registrar um atendimento

Recepção · várias vezes ao dia
BuscarDigite o nome na tela inicial e toque no paciente.
ConferirO card mostra plano ativo e sessões restantes.
PreencherData, tipo (atendimento / falta / no-show) e observações.
SalvarConfirmação na hora; contadores do topo atualizam.
Falta e no-show seguem a regra de desconto de sessão definida no registro — o saldo do plano reflete imediatamente.

Cadastrar um paciente novo

Recepção · primeira visita
Abrir cadastroBusca sem resultado → "novo paciente", ou Editar cadastro no card.
Dados pessoaisNome, CPF, RG, nascimento e contatos.
CEP mágicoDigite o CEP — rua, bairro e cidade preenchem sozinhos.
OrigemCanal de chegada (e parceria, quando houver).
SalvarO servidor barra CPF repetido e avisa nome idêntico.
A barra de completude do card mostra o quanto falta — e exatamente quais campos faltam — para emitir os termos sem lacunas.

Vender ou renovar um pacote

Recepção / Gestão · conversão e renovação
ConversãoNa avaliação, "Fechou plano? = Sim": nasce o pacote 0/X.
RetornosCada Retorno Pacote marca 1/X… até X/X.
RenovaçãoNo retorno X/X, "Fechou plano? = Sim" de novo: pacote novo 0/X.
AutomáticoO valor fica no plano (sessão sai R$ 0) e o pacote anterior conclui sozinho.
Régua oficial: avaliação é primeiro contato e nunca desconta; o pagamento da renovação pertence ao bloco do plano, não ao retorno. Ninguém tem dois pacotes ativos.

Emitir os termos jurídicos

Recepção · na contratação · ~10 segundos para o lote
MarcarContrato, TCLE, LGPD e/ou Imagem no card do paciente.
GerarBotão dourado; o sistema confere cadastro e plano e avisa lacunas.
RegistrarCada termo ganha um nº TRM e entra no histórico.
BaixarPDFs descem em paralelo, com rodapé de controle em toda página.
AssinarImprimir e colher assinaturas; digitalizar para arquivo.
Se o paciente já tem emissão anterior, o sistema oferece: nova emissão (novo TRM, dados atuais) ou 2ª via idêntica ao documento original. A 2ª via reconstrói o termo a partir do snapshot da época — mesmo que o cadastro tenha mudado depois.

Fechar o mês

Gestão · mensal
AtendimentosConferir o mês na aba ATEND. (filtros + totalizador).
Notas fiscaisZerar pendências na aba NFS, marcando as emitidas.
DashboardLer produção e receita por unidade e quiropraxista.
AjustesCorrigir registros direto na lista (editar/excluir).
04 · Proteção de dados & infraestrutura

O que trabalha em silêncio

Rascunho automático

Formulários se salvam no navegador enquanto você digita. Fechou sem querer? O app oferece restaurar tudo ao voltar.

Fila de escrita

Gravação que falha por conexão fica guardada e é reenviada sozinha — faixa laranja avisa. Sobrevive a fechar o navegador.

Idempotência (v5.8)

Cada operação tem um nº único; o reenvio nunca duplica registro — o servidor reconhece e devolve o resultado original.

Atualização silenciosa

Dados se renovam ao voltar para a aba e a cada 5 min, sem mexer em filtros nem em formulário aberto — e mantêm o servidor aquecido.

Reconexão automática

Falha transitória do Google? O app tenta de novo sozinho (3×, com pausas crescentes) e o badge narra o processo.

Arquitetura em 2 serviços

API principal leve (só Planilhas → abertura rápida) + PDF Service dedicado (Docs/Drive) acionado só na geração de termos.