📥 Instalacao

O PulseHub e instalado atraves de um assistente baseado em navegador em dois passos. Nao ha nada para compilar e nenhum acesso a linha de comando e necessario.

---

Passo 1 — Enviar os Arquivos

1. Baixe pulsehub-php.tar.gz e extraia no seu computador local. Voce tera uma pasta chamada pulsehub-php/.
2. Envie o conteudo dessa pasta (nao a pasta em si) para a raiz web. Na maioria das hospedagens compartilhadas, e public_html/ ou www/. Em um VPS, e onde seu virtual host aponta (ex: /var/www/pulsehub/).

Apos o envio, sua raiz web deve ficar assim:

public_html/
├── index.php
├── .htaccess
├── cron.php
├── install/
├── app/
├── public/
├── config/        ← vazio neste ponto, criado durante a instalacao
└── data/

Instalacoes em subdiretorio: Se voce quer o PulseHub em https://yourdomain.com/support/ ao inves da raiz, envie os arquivos para public_html/support/. O arquivo .htaccess lida com o caminho automaticamente.

---

Passo 2 — Executar o Instalador do Banco de Dados

Abra seu navegador e navegue ate:

https://yourdomain.com/install/

Instalador — Etapa 1: Configuracao do Banco de Dados

Preencha suas credenciais MySQL:

Campo	Descricao
Database Host	Geralmente localhost. Em alguns hosts e um endereco IP — consulte a documentacao do seu host.
Port	O padrao e 3306. Altere apenas se seu host usar uma porta nao padrao.
Database Name	O nome do banco de dados que o PulseHub deve usar. Sera criado automaticamente se seu usuario MySQL tiver privilegio CREATE DATABASE.
Database User	O nome de usuario MySQL com acesso completo ao banco acima.
Database Password	A senha para esse usuario.

Clique em Connect & Create Tables →

Instalador — Etapa 2: Conta do Administrador

Campo	Descricao
Workspace Name	O nome da sua organizacao, exibido na barra lateral.
Your Name	O nome de exibicao do primeiro usuario administrador.
Email Address	Usado para login. Deve ser um formato de email valido.
Password	Minimo de 8 caracteres. Armazenado como hash bcrypt — nunca em texto simples.
Confirm Password	Deve corresponder exatamente.

Clique em Create Account & Finish →

---

Passo 3 — Fazer Login

Clique em Go to PulseHub → na tela de sucesso, ou navegue ate https://yourdomain.com/. Insira o email e a senha que acabou de criar.

---

Pos-Instalacao: Bloquear o Instalador

O instalador se desativa automaticamente quando config/database.php existe. Como precaucao extra, voce pode deletar o diretorio install/ inteiramente apos a configuracao usando o Gerenciador de Arquivos do seu painel de hospedagem ou seu cliente FTP.

---

Verificando uma Instalacao Bem-Sucedida

Apos o login, voce deve ver:

• A barra lateral com Inbox, Contacts, Channels, Automations, Analytics, Settings
• O nome do seu workspace e seu nome no rodape da barra lateral
• A caixa de entrada mostrando "Select a conversation" (vazia — sem mensagens ainda)

---

Instalacao Nginx (Apenas VPS — Pule em Hospedagem Compartilhada)

Usuarios de hospedagem compartilhada: Seu host ja lida com a configuracao do servidor web. Esta secao e apenas para VPS ou servidores dedicados executando Nginx. Voce pode pula-la inteiramente.

Se voce esta executando Nginx + PHP-FPM, copie o exemplo de configuracao fornecido:

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/pulsehub;
    index index.php;

    location ~ ^/(config|app|data)/ {
        deny all;
    }

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Em seguida, habilite o site e recarregue o Nginx (terminal VPS):

sudo ln -s /etc/nginx/sites-available/pulsehub /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx