AXUMChecklist de Estabilidade
Documento operacional
Junho 2026 · Versão 1.0
Validade: até o retorno

Checklist de Estabilidade
& Cartão de Operação

Estado auditado do sistema, verificação de pré-viagem e guia de bolso para a equipe: o que cada aviso significa e o que fazer — sem precisar de suporte técnico.

01 · Estado do sistema (auditoria de 04/06/2026)

O que está rodando, e onde

ComponenteVersãoOnde viveStatus
gestao.html — app de gestãoprotege v2app.axium.health (GitHub Pages)auditado ✓
prontuario.html — prontuárioprotege v2app.axium.health (GitHub Pages)auditado ✓
Axium_Code — API principal (só Planilhas)v5.8Apps Script · implantação principalauditado ✓
Axium PDF Service — geração de PDFsv1.1Apps Script · projeto separadoauditado ✓
DB_Axium — base de dadosschema v3Google Sheetsdeduplicada ✓

Auditoria executável: sintaxe 4/4 · URLs cruzadas OK · idempotência cobrindo 100% das escritas dos dois apps · baterias: proteção de dados 9/9, rascunho v2 6/6, tipografia dos termos 16/16, integridade jurídica dos 4 termos ÍNTEGRA.

02 · Verificação de pré-viagem (5 minutos)

Antes de embarcar, confira

01
Ping da API principalAbrir no navegador: …/exec?action=ping da URL principal — deve responder JSON (não página de login). Se pedir login: refazer "Nova versão" na implantação.
02
Ping do PDF ServiceAbrir: …AKfycbx5SkS…/exec?action=ping — deve responder {"ok":true,"service":"axium-pdf","v":"1.1"}. Se a versão for "1.0": colar o arquivo v1.1 e fazer nova versão na implantação do serviço.
03
Abertura duplaAbrir o gestao 2× seguidas — o badge deve mostrar online · 1-4s na segunda. Primeira carga do dia mais lenta (~20s) é normal (servidor frio).
04
Teste do anti-duplicataCom um paciente de teste: desligar o Wi-Fi → salvar uma evolução → faixa laranja aparece → religar → toast de confirmação → conferir na planilha: um registro só.
05
Lote de termosGerar os 4 termos de um paciente de teste: PDFs em paralelo, timbre limpo, fonte única, rodapé de controle em todas as páginas.
03 · Guia de bolso da equipe — sintoma → ação

Se acontecer, é assim que se resolve

badge offline · reconectando (1/3)…

Significado: soluço momentâneo do Google.
Ação: nenhuma. O app tenta de novo sozinho (3×). Só recarregue se passar de 1 minuto.

faixa laranja ⏳ gravação pendente — reenviando…

Significado: um salvar não confirmou; está guardado e será reenviado sozinho.
Ação: NÃO preencher de novo. Continue trabalhando; a faixa some quando confirmar. Nunca duplica.

prompt "Encontrei um RASCUNHO não salvo…"

Significado: um formulário foi fechado no meio (queda de luz, aba fechada).
Ação: OK restaura o que foi digitado (do mesmo paciente); Cancelar descarta de vez.

abertura primeira carga do dia ~20s

Significado: servidor "frio" no primeiro acesso.
Ação: normal. Depois da primeira carga, o app se mantém aquecido sozinho durante o expediente.

PDF "Falha ao gerar… use o botão imprimir"

Significado: o serviço de PDF engasgou (já tentou 2× sozinho).
Ação: usar o botão 🖨 do termo (imprimir/salvar como PDF pelo navegador) e seguir o dia. Tentar o ⬇ de novo mais tarde.

erro vermelho "CPF já cadastrado" e similares

Significado: o sistema barrou um dado inválido — proteção, não defeito.
Ação: corrigir o dado e salvar de novo (ex.: buscar o paciente existente em vez de recadastrar).

04 · Regras de ouro (não negociáveis)

Para o sistema continuar estável

  • Ninguém mexe no Apps Script durante a viagem. Sem editar código, sem nova implantação, sem rodar funções no editor — em especial, jamais executar setupProntuario() (recriaria as abas clínicas).
  • Planilha DB_Axium: não renomear abas, não inserir/remover/renomear colunas, não ordenar manualmente. Editar valores de células específicas, se preciso, é seguro.
  • Deploys futuros (no retorno): sempre "Gerenciar implantações → lápis → Nova versão" — nunca "Nova implantação" (mudaria a URL e quebraria os apps).
  • Se tudo falhar: o Google Sheets guarda histórico de versões (Arquivo → Histórico de versões) — nenhum dado gravado se perde, mesmo no pior cenário.
  • Faixa laranja na tela = não repreencher. Vale repetir: é a regra que protege contra duplicatas.