← Documentação

Primeiros passos

Modo demonstração

O que é o ambiente de demonstração, o que nele é fictício, o que não dispara de verdade e quando a base é recriada.

O que é

A instalação de demonstração é uma cópia completa do Orion com dados fictícios, para qualquer pessoa explorar o sistema inteiro sem risco. Nenhum paciente, tutor, valor ou documento ali corresponde a alguém real.

Uma faixa fixa no topo do painel avisa disso o tempo todo. Ela pode ser dispensada durante a visita, mas volta na próxima — é ela que impede alguém de confundir dado de vitrine com dado de clínica.

Pode mexer à vontade: cadastrar, editar, faturar, dar alta, fechar caixa. A base é recriada periodicamente, então nada do que você fizer atrapalha o próximo visitante — nem some enquanto você estiver testando.

O que NÃO dispara de verdade

Os módulos que dependem de um serviço externo funcionam na tela, mas não alcançam o mundo real. Cada um deles mostra um aviso explicando o que aconteceria em produção:

  • WhatsApp — as conversas são simuladas. Em produção, mensagens entram e saem pelo número oficial da clínica, pela API da Meta.
  • Instagram — Direct e comentários de exemplo; em produção a conta é conectada pelo login do Facebook.
  • Fiscal — nenhuma nota é transmitida à prefeitura ou à SEFAZ. A numeração oficial vem do provedor autorizado, e por isso nunca é inventada na demonstração.
  • Cobrança online — PIX, cartão e boleto não são gerados; em produção saem pelo gateway, com baixa automática.
  • Assinatura ICP-Brasil — indisponível. A assinatura simples continua valendo normalmente: autor, data e hora e hash SHA-256 são gravados, o registro fica imutável e correções entram por adendo.
  • Notificações push — desligadas. Em produção o tutor recebe no celular os lembretes de dose, retorno e vacina.
  • Suporte técnico — a tela conversa de verdade com a central de atendimento e os chamados listados são exemplos cadastrados lá, mas ela é somente leitura: abrir e responder estão desativados, para a fila da equipe não receber teste.

Tudo o mais é real: a contabilidade lança no razão, o estoque baixa por FEFO, a conta médica fecha e vira venda, o Glosa Zero acusa divergência.

Como a base é recriada

Um job semanal reconstrói a demonstração inteira, sempre ancorada em hoje — é o que garante que a agenda tenha compromissos na semana que vem, que haja internação em curso, cirurgia marcada para amanhã e caixa aberto no dia.

A reconstrução é feita num banco de rascunho: o sistema no ar só é trocado depois que o banco novo passa por seis verificações de sanidade, e se a aplicação não responder após a troca, ela volta sozinha para a base anterior. Na prática, a demonstração não fica fora do ar por causa do próprio reseed.

Restaurar quando quiser

Além da reconstrução semanal, qualquer pessoa logada na demonstração pode restaurá-la na hora, em Configurações → Restaurar a demonstração. É o caminho de quem vai apresentar e encontrou a base bagunçada pelo visitante anterior.

O botão pede uma confirmação digitada e mostra o log ao vivo. Três coisas que vale saber antes de apertar:

  • Todo mundo é desconectado, inclusive você. As sessões vivem no banco que será substituído; ao final a tela leva de volta ao login, já preenchido.
  • O sistema reinicia e fica cerca de um minuto fora do ar.
  • Se qualquer verificação falhar, nada é trocado: a base nova é construída num banco separado e a demonstração continua com a anterior.

Duas pessoas apertando ao mesmo tempo não é problema — a segunda entra de carona no mesmo log. E há um intervalo mínimo de cinco minutos entre uma restauração e a próxima, para o sistema não ser derrubado duas vezes seguidas.

Como ligar numa instalação

O modo demonstração é ligado por duas variáveis de ambiente: NEXT_PUBLIC_DEMO_EMAIL e NEXT_PUBLIC_DEMO_PASSWORD. Definir as duas liga, de uma vez, o preenchimento automático do login, a faixa no painel e os avisos nos módulos de integração.

São a afirmação de que os dados são fictícios — uma clínica real deixa as duas vazias, mesmo que queira agilizar o login de um ambiente interno de teste.

Duas armadilhas operacionais que valem saber:

  • Elas valem em tempo de build. Mudar o .env e reiniciar o serviço não liga nem desliga o modo demonstração — é preciso recompilar.
  • NEXT_PUBLIC_DEMO_PASSWORD precisa ser igual a DEMO_PASSWORD (a senha com que o seed cria as contas de demonstração) e ter ao menos 10 caracteres, o mínimo da política de senha. Diferentes, o login pré-preenchido falha; curta, o seed não consegue criar as contas.

Perguntas frequentes

Posso cadastrar um paciente de verdade aqui? Não. Além de ser um ambiente público, a base é recriada periodicamente — o cadastro seria perdido. Para operar de verdade, é a sua instalação licenciada.

Por que o botão de enviar no WhatsApp não faz nada? Porque a demonstração não fala com a API da Meta. A tela mostra o aviso explicando o que aconteceria numa instalação com o canal configurado.

O que eu fizer some quando? Na reconstrução semanal. Durante a sua visita, tudo permanece.

A contabilidade e o DRE são de mentira? Os valores são fictícios, mas a mecânica é real: cada venda e cada despesa gera lançamento no razão, e o DRE fecha com o balancete.