=====================================================================
  PAINEL HORUS — INSTALAÇÃO NA PASTA /sysadmin
=====================================================================

REQUISITOS DA HOSPEDAGEM
  • PHP 8.0 ou superior (recomendado 8.2+)
  • MySQL 5.7+ ou MariaDB 10.3+
  • Extensões PHP: pdo_mysql, fileinfo, mbstring (e gd, recomendada)
  • Certificado SSL ativo (https) — quase todas as hospedagens dão grátis

---------------------------------------------------------------------
PASSO 1 — Criar o banco de dados
---------------------------------------------------------------------
  No cPanel (ou painel da sua hospedagem) → "Bancos de dados MySQL":
   1. Crie um banco (ex.: usuario_horus).
   2. Crie um usuário com uma senha forte.
   3. Adicione o usuário ao banco com TODOS os privilégios.
  Anote: nome do banco, usuário e senha.

---------------------------------------------------------------------
PASSO 2 — Enviar os arquivos
---------------------------------------------------------------------
  1. No Gerenciador de Arquivos, entre em public_html.
  2. Crie a pasta  sysadmin
  3. Envie o ZIP para dentro de public_html/sysadmin e extraia.
     O resultado deve ficar assim:
        public_html/sysadmin/index.php
        public_html/sysadmin/api.php
        public_html/sysadmin/app/ ...
        public_html/sysadmin/assets/ ...
        public_html/sysadmin/storage/ ...
  4. IMPORTANTE: ative "Mostrar arquivos ocultos" e confira se os
     arquivos  .htaccess  e  .user.ini  foram enviados junto.
  5. Permissões: pastas 755, arquivos 644. A pasta  storage  (e as
     subpastas) precisa de permissão de escrita (755 normalmente basta).

---------------------------------------------------------------------
PASSO 3 — Rodar o instalador
---------------------------------------------------------------------
  1. Acesse:  https://SEUSITE.com.br/sysadmin/instalar.php
  2. Confira se todos os requisitos aparecem em verde.
  3. Informe os dados do banco, o seu nome, e-mail e senha de admin
     e o e-mail remetente (crie antes, ex.: nao-responda@seusite.com.br).
  4. Clique em Instalar.
  5. >>> APAGUE o arquivo  instalar.php  do servidor. <<<
     (Ele já fica bloqueado depois de instalado, mas apagar é mais seguro.)

---------------------------------------------------------------------
PASSO 4 — Começar a usar
---------------------------------------------------------------------
  1. Entre em  https://SEUSITE.com.br/sysadmin/
  2. Cadastre a equipe (menu Equipe e acessos) e os clientes.
  3. Para cada pessoa que vai entrar no sistema, abra o cadastro e
     clique em "Acesso ao sistema". O painel gera uma senha temporária
     (e envia por e-mail, se marcado). No primeiro acesso a pessoa
     cria a própria senha.
     • Nível "Administrador" no cadastro da equipe = acesso total.
     • Funcionário = só a área de produção.
     • Cliente = só o próprio portal.
  4. Clique no seu nome (canto inferior esquerdo) para trocar a senha
     e ver o "Log de segurança".

---------------------------------------------------------------------
OPCIONAL — Resumo diário por e-mail
---------------------------------------------------------------------
  cPanel → Tarefas Cron → uma vez por dia (ex.: 07:30):
     php /home/SEU_USUARIO/public_html/sysadmin/cron/resumo-diario.php
  Envia aos administradores: recebimentos vencidos, contas a pagar dos
  próximos 3 dias e tarefas atrasadas.

---------------------------------------------------------------------
PROBLEMAS COMUNS
---------------------------------------------------------------------
  • "Arquivo acima do limite do servidor" ao enviar fotos:
      a hospedagem limita uploads. No cPanel → "Selecionar versão do
      PHP" → Opções, ajuste upload_max_filesize = 12M e
      post_max_size = 14M (o arquivo .user.ini já tenta fazer isso).
  • E-mails não chegam: use como remetente um e-mail do seu domínio
    criado na hospedagem, e veja a caixa de spam. O remetente pode ser
    alterado em app/config.php ("email_remetente").
  • Tela em branco / erro 500: veja  storage/logs/php-erros.log
  • Esqueci a senha de administrador e o e-mail não chega: crie uma
    Tarefa Cron única (ou use o terminal/SSH) com o comando:
      php /home/SEU_USUARIO/public_html/sysadmin/cron/redefinir-senha.php SEU@EMAIL
    A saída mostra uma senha temporária (o cPanel envia a saída do cron
    por e-mail). Apague a tarefa depois.
  • Usa Cloudflare? Em app/config.php mude 'confiar_proxy' para true,
    para o bloqueio por IP funcionar com o IP real dos visitantes.

BACKUP
  Faça backup periódico do banco (cPanel → Backup) e da pasta
  sysadmin/storage/uploads (fotos, boletos e notas).
