Manual de Instalação
SisPanel Consultório

O que é o SisPanel

O SisPanel é uma aplicação de apoio a consultórios, recepções e pontos de atendimento. Operadores emitem senhas normais ou preferenciais; a equipe chama os pacientes; e uma tela pública mostra as chamadas e o consultório.

Requisitos da instalação

1. PHP 8.2 ou mais recente, com extensões PDO, pdo_mysql e mbstring.
2. Um banco MySQL 5.7+ ou MariaDB 10.3+ e usuário com permissão de criar e alterar tabelas.
3. Hospedagem Apache ou servidor com proteção equivalente para arquivos sensíveis.
4. Acesso ao Gerenciador de Arquivos, FTP/SFTP ou Git e certificado SSL (HTTPS).
5. Pacote ZIP do SisPanel extraído corretamente.

Preparar hospedagem e domínio

1. Acesse a Hostinger e escolha uma hospedagem com suporte a PHP e MySQL.
2. Associe o domínio ou subdomínio ao plano de hospedagem.
3. No hPanel, abra a área de sites e encontre o Gerenciador de Arquivos do domínio.
4. Confirme o diretório público da aplicação (geralmente public_html).
5. Selecione PHP 8.2+ e habilite SSL/HTTPS, quando disponível.

Os nomes exatos das telas podem variar conforme a versão do hPanel.

Enviar arquivos sem criar pastas duplicadas

Envie o conteúdo do ZIP para o diretório público do domínio. O arquivo index.php deve estar diretamente na pasta de publicação.

public_html/
├── index.php
├── install.php
├── login.php
├── app.php
├── schema.php
├── conexao.php
├── database.sql
├── registro.php
├── painel.php
├── usuarios.php
├── relatorio.php
├── manual.html
├── README.txt
├── .htaccess
├── assets/
├── imagens/
├── img/
└── audio/

Criar o banco MySQL

1. No hPanel, abra a seção de bancos MySQL e crie um banco de dados vazio.
2. Crie um usuário com senha forte e associe-o ao banco.
3. Anote host, porta, nome do banco, usuário e senha. Esses dados variam entre hospedagens.
4. Para instalação nova, não é necessário importar SQL manualmente; o instalador cria as tabelas.
5. Se optar por importar manualmente, utilize database.sql em um banco vazio e depois execute o instalador para registrar o primeiro gerente.

Primeira instalação pelo navegador

Abra o seguinte endereço, substituindo pelo domínio da instalação:

1. Informe as credenciais do MySQL que você criou na hospedagem.
2. Cadastre o nome, CPF válido e uma senha forte (mínimo 12 caracteres) para o primeiro gerente.
3. Clique em Criar tabelas e concluir instalação.
4. O instalador cria as tabelas necessárias, insere o gerente e gera um arquivo privado sispanel_config.php com os dados do servidor.
5. Abra login.php e entre com o perfil Gerente.
6. Após testar o acesso, exclua install.php da hospedagem.

Gerentes e operadores

Há dois perfis de acesso: gerente e operador. Ambos autenticam por CPF e senha. O gerente pode administrar a equipe e acessar relatórios. O operador pode emitir senhas e chamar pacientes.

1. Entre como gerente.
2. Abra o menu Equipe (usuarios.php).
3. Selecione o tipo de perfil, informe nome, CPF e senha forte.
4. Salve e teste o login da nova conta em outro navegador ou sessão privada.

Emitir e chamar senhas

1. Após entrar, abra Emitir senha (registro.php).
2. Informe nome e CPF válido da pessoa, selecione atendimento Normal ou Preferencial e indique o consultório.
3. Clique em Gerar senha e cadastrar. Um número como N0001 ou P0001 será criado no banco.
4. Abra a página Chamar (validacao_atendimento.php), selecione a senha pendente e confirme a sala.
5. O painel público passa a exibir a nova chamada.

Monitor de atendimento

Abra a página pública a seguir no monitor ou TV conectada a um navegador:

O monitor exibe a senha atual, consultório, senha anterior e quantidade de pessoas aguardando. Ele verifica novidades a cada cinco segundos.

Os endereços painel1.php, painel2.php, painel3.php e validados.php permanecem como rotas de compatibilidade para o painel unificado.

Consulta de relatórios

O gerente pode personalizar o nome da unidade e a mensagem da TV em configuracoes.php e consultar o histórico em relatorio.php. O relatório exibe senha, nome, prioridade, consultório e data/hora de emissão e chamada, com pesquisa por nome ou número da senha.

Se você já tem um banco antigo

O SQL de 2024 usa MyISAM e colunas antigas. Esta edição prevê atualizações aditivas para os relacionamentos de chamada, contadores e configurações, mas instalações existentes exigem cuidados especiais.

1. Faça backup integral dos arquivos e do MySQL antes de atualizar.
2. Crie uma cópia de testes do banco existente, não opere diretamente na produção.
3. Verifique os dados das tabelas clientes, atendimentos, funcionarios e gerentes.
4. Se o banco já contém gerentes, o instalador bloqueia a criação de outro administrador. Prepare a configuração privada com suporte técnico e execute as migrações somente após validação.
5. Senhas legadas armazenadas em texto simples não são aceitas; redefina-as com hashes seguros.

Publicar no repositório GitHub

Este pacote foi pensado para github.com/alemaodacapa/sispanel. O arquivo README.md que já existe lá deve ser preservado.

1. Descompacte o ZIP em seu computador.
2. No repositório, use Add file → Upload files e selecione o conteúdo extraído (não apenas o arquivo ZIP).
3. Este ZIP contém README.txt e manual.html, mas não contém README.md; portanto o documento atual do GitHub não será substituído pela simples importação.
4. Remova arquivos legados que não foram corrigidos e não são mais usados (server.js, package.json, package-lock.json, scripts temporários) caso permaneçam no repositório antigo.
5. Nunca publique a configuração privada do seu servidor (sispanel_config.php).

Segurança, privacidade e boas práticas

• Ative HTTPS e mantenha PHP atualizado.
• Guarde sispanel_config.php apenas na hospedagem, bloqueado contra downloads.
• Revogue ou altere credenciais antigas do sistema original, pois estavam em código distribuído anteriormente.
• Não envie backups de bancos reais com nomes/CPFs para GitHub.
• Evite divulgar nomes completos/CPF em TVs públicas.
• Use controles de sessão, senha individual e perfis de acesso.
• Crie aviso de privacidade e políticas de retenção de dados coerentes com a LGPD.

Problemas frequentes

Lista final de instalação

Marque os testes antes de colocar o sistema em atendimento real.