Checklist de Estabilidade
O que cada aviso das telas quer dizer e o que fazer, sem precisar de suporte técnico. Mais uma verificação que a própria página roda e como o sistema está montado.
Avisos e o que fazer
Regra de todas: faixa âmbar quer dizer "espere, o sistema está resolvendo"; vermelho quer dizer "alguém precisa olhar".
Gravação
O que é: o salvar ainda não foi confirmado. Está guardado neste computador e sai sozinho; ao lado do selo aparece “N na fila”.
O que fazer: não preencher de novo. Pode continuar trabalhando. Se fechar, reabra o sistema neste mesmo computador.
O que é: o mesmo caso, na hora do clique. O formulário limpa porque o registro já está a caminho.
O que fazer: nada. A confirmação verde vem quando a fila sair.
O que é: o servidor disse não a esse registro (regra do sistema ou permissão). Não gravou, mas o que foi digitado não se perdeu.
O que fazer: clicar, ler o motivo, “Copiar tudo”, refazer do jeito certo e só então “Já refiz — descartar”. Motivo sem sentido: avise o administrador.
Conexão: o selo no rodapé do menu (no celular, no topo)
O que é: os dados são os de agora; o número é quanto a última carga levou. Nada a fazer.
O que é: a tela abriu com o último dado conhecido e está buscando o de agora. Nada a fazer: o selo fica verde sozinho.
O que é: a resposta está demorando. A tela tenta de novo sozinha e mantém o que já tinha.
O que fazer: nada, e não recarregar a página. Passou de alguns minutos? Avise o administrador.
O que é: o servidor respondeu com erro; não é lentidão. A tela continua tentando.
O que fazer: se não passar em alguns minutos, avise o administrador. Parar o mouse sobre o selo mostra o detalhe.
O que é: a primeira carga ainda não chegou. No servidor novo, que fica ligado o dia inteiro, isso não devia acontecer.
O que fazer: esperar ou tocar em “Ver a tela mesmo assim”. No sistema novo, avise o administrador.
Entrar no sistema
O que é: 4 horas sem uso em nenhuma tela do sistema, ou 12 horas desde o login (mesmo em uso). 15 minutos antes, uma faixa âmbar avisa a hora do fim, com "Continuar conectado". Proteção do balcão compartilhado.
O que fazer: entrar de novo. A tela volta para onde você estava, e a fila sai sozinha.
O que fazer: abrir o link (funciona uma vez só). Não chegou? Olhe o spam ou peça ao administrador uma senha provisória.
O que fazer: criar a senha nova, com pelo menos 10 caracteres, misturando letras e números. A provisória vence em 72 horas.
O que fazer: conferir o usuário (não é o e-mail). Depois de 5 erros seguidos, esperar 15 minutos ou pedir uma senha provisória.
O que é: o seu perfil não inclui aquela ação, ou o acesso foi desligado. Não é defeito.
O que fazer: se precisar, peça ao administrador para ajustar em Acessos.
Agenda
O que fazer: marcar, remarcar ou desmarcar direto na Google Agenda e avisar o administrador. A tela lista o que falta.
O que fazer: esperar a agenda recarregar e olhar o horário. Não marcar de novo antes de conferir.
O que é: o filtro está escondendo horários; os marcados direto no Google não têm unidade.
O que fazer: para ver tudo, volte o filtro para todas as unidades.
O que fazer: escolher o quiropraxista ao marcar, ou lançar a escala do dia na agenda.
Segurança e reserva
O que é: a resposta veio de uma planilha que não é a da clínica, e a tela travou de propósito.
O que fazer: tocar em “Abrir o sistema de reserva” (app.axium.health/antigo/) e avisar o administrador.
O que fazer: usar só enquanto o principal estiver fora. Gravações pendentes do principal saem sozinhas quando ele voltar: não refazer. Para voltar, “Voltar ao principal”.
Formulários e documentos
O que é: um formulário fechou no meio. O rascunho vale 24 horas, só para o mesmo paciente; no cadastro, volta sem CPF, RG, e-mail e endereço.
O que fazer: “Restaurar” traz de volta; “Começar do zero” descarta.
O que fazer: ler antes de confirmar. Na dúvida, cancele e confira o paciente.
O que fazer: buscar o paciente que já existe, ou corrigir o número.
O que é: o serviço de PDF não respondeu (a tela já tentou 2 vezes). O termo foi registrado; só o arquivo não saiu.
O que fazer: usar o 🖨 do termo e seguir o dia. Tentar o ⬇ mais tarde.
Verificação
O que é: a página pergunta a versão do servidor e mede o tempo das consultas. Só leitura: não grava, não altera nada e não mostra dado de paciente. Pode rodar com a clínica funcionando.
- Entre no sistema neste navegador (as consultas de planos e atendimentos usam a sua sessão).
- Toque em Rodar verificação e espere.
- Se o resultado pedir, toque em Copiar resultado e mande para o administrador.
- Sem sessão aberta, essas linhas saem como “não medida”, nunca com um número falso.
- Nenhuma senha fica nesta página, e o texto copiado nunca leva o seu acesso.
| Verificação | Tempo | Tamanho | Resultado |
|---|---|---|---|
| Toque em Rodar verificação. Leva alguns segundos no servidor novo; no sistema antigo, a primeira chamada pode levar até 2 minutos. | |||
Como ler os tempos
A primeira linha diz qual servidor respondeu, e a régua muda com ele. O tempo inclui a internet da clínica.
| Quem respondeu | O esperado | Quando avisar o administrador |
|---|---|---|
| Servidor da clínica (Cloud Run) | ligado o dia inteiro; em 21/09 respondeu em 1,1 s | alguma linha acima de 5 s, erro, ou a planilha lida não ser a da clínica |
| Sistema antigo (Apps Script, também a reserva) | a primeira chamada depois de um tempo parado pode levar até 2 minutos; as seguintes, poucos segundos | as consultas seguintes também lentas (acima de 8 s). Depois da virada, se a primeira linha disser Apps Script, a página está medindo a reserva |
Regras de ouro
- Faixa âmbar na tela: não preencher de novo. É o que protege contra registro duplicado.
- Computador compartilhado: ao terminar, use Sair, que também apaga os rascunhos e a lista de pacientes guardada. Se esquecer, a sessão acaba sozinha com 4 horas sem uso.
- Sistema de reserva: só enquanto o principal estiver fora, e nunca os dois ao mesmo tempo: eles gravam na mesma planilha, e o que foi registrado num não se registra de novo no outro.
- Planilha DB_Axium: não renomear abas; não inserir, apagar, renomear, reordenar nem ordenar colunas à mão. Coluna nova só entra no fim, pelo próprio sistema.
- Nenhum teste na planilha da clínica. Teste é no servidor de ensaio, com dados fictícios.
- Se tudo falhar: o Google Sheets guarda o histórico de versões (Arquivo › Histórico de versões). Nenhum dado gravado se perde.
Como o sistema está montado
| Parte | O que faz | Onde fica |
|---|---|---|
| Telas | o que a equipe usa, com o mesmo menu em todas | app.axium.health |
| Servidor da clínica | lê e grava na planilha; recusa quem não entrou; confere de que planilha lê; guarda o documento de remuneração | Google Cloud Run, em São Paulo, ligado o dia inteiro |
| Planilha DB_Axium | a base de dados da clínica | Google Sheets |
| Agenda | os horários, vistos e marcados de dentro do sistema | Google Agenda da clínica |
| senha provisória, link de “esqueci minha senha” e avisos de acesso | e-mail da clínica, enviado pelo servidor | |
| Serviço de PDF | gera os PDFs dos termos | Google Apps Script, projeto separado |
| Sistema de reserva | o sistema de antes da virada, gravando na mesma planilha | app.axium.health/antigo/ |
Para quem cuida do sistema
Publicar uma mudança
O que éO único caminho: aprovar a mudança no GitHub. A publicação roda mais de 1.400 testes automáticos, com dados fictícios, e só segue com todos verdes; depois confere que o servidor lê a planilha da clínica.
Atenção- Nada de editar código no Apps Script, e nunca executar setupProntuario(): ela apaga as abas clínicas.
- Os 18 fluxos no navegador rodam antes, no computador de quem programa: node --test tests/*.test.mjs e node tests/e2e/run-e2e.mjs.
Conferências à mão, no servidor de ensaio
Como usar- Suba o ensaio no próprio computador: AXIUM_FUNDO=memoria node backend/servidor.mjs; as telas ficam em http://127.0.0.1:8080/app/.
- Sem internet não duplica: com um paciente fictício, corte a conexão pelo navegador (F12 › Rede › Offline) e salve uma evolução. Tem de aparecer o aviso âmbar e a faixa de pendência; volte a conexão: a faixa some e a evolução aparece uma vez só.
- Termos: com cadastro fictício completo, gere os 4 termos pelo 🖨 e confira timbre, uma fonte só, rodapé de controle em todas as páginas e o endereço da unidade do plano. O ⬇ se confere na próxima emissão de verdade.
- Renovação: renove um plano fictício com sessões sobrando. A forma de pagamento vem em branco e é exigida, o resumo avisa quantas sessões serão descartadas, e o plano novo nasce do zero.
- Não existe servidor de teste no ar, e nenhum teste se faz na planilha da clínica. Desligar o Wi-Fi não corta o ensaio, que roda no mesmo computador.