One Hat Cyber Team

View File Name : manual.txt

=============================================================================
                     MANUAL DE INSTALACAO E USO
                     Central de APIs - Grupos WhatsApp
=============================================================================

1. REQUISITOS DO SISTEMA
------------------------------------------------------------------------------
- PHP 8.0 ou superior
- MySQL 5.7+ / MariaDB 10.3+
- Extensoes PHP: pdo_mysql, mbstring, openssl, json
- Apache com mod_rewrite habilitado
- Permissao de escrita na pasta config/


2. INSTALACAO RAPIDA (RECOMENDADO)
------------------------------------------------------------------------------
Passo 1: Envie todos os arquivos para o servidor via FTP

Passo 2: Acesse no navegador:
   http://seudominio.com/install.php

Passo 3: O instalador vai guiar voce por 3 etapas:
   [1] Verificar requisitos do servidor
   [2] Configurar banco de dados + sistema + super admin
   [3] Confirmacao e acesso ao painel

Passo 4: Apos a instalacao, remova o arquivo install.php e a pasta tools/
   por seguranca.


3. INSTALACAO MANUAL
------------------------------------------------------------------------------
Se preferir configurar manualmente:

3.1. Crie um banco de dados MySQL (ex: app_central)

3.2. Importe o arquivo schema.sql via phpMyAdmin ou linha de comando:
   mysql -u usuario -p banco < schema.sql

3.3. Crie o arquivo config/database.php com o conteudo abaixo
    (ajuste os dados do seu banco):

   <?php
   define('DB_HOST', 'localhost');
   define('DB_PORT', '3306');
   define('DB_NAME', 'app_central');
   define('DB_USER', 'root');
   define('DB_PASS', 'sua_senha');
   define('JWT_SECRET', 'sua_chave_secreta_aqui');
   define('JWT_EXPIRY', 3600 * 24);
   define('APP_NAME', 'Central de APIs');
   define('APP_URL', 'http://seudominio.com');
   function logoUrl() {
       $base = __DIR__ . '/../public/assets/img/logo.';
       foreach (['png','jpg','jpeg','gif','webp'] as $e) {
           if (file_exists($base . $e)) return 'assets/img/logo.' . $e;
       }
       return '';
   }
   define('APP_LOGO', logoUrl());

3.4. Crie o super admin executando no banco:
   (substitua pelo email e senha desejados)

   INSERT INTO super_admins (nome, email, senha)
   VALUES ('Super Admin', 'admin@meusite.com', '$2y$10$...');

   Para gerar o hash da senha, use o arquivo hash.php:
   http://seudominio.com/hash.php?senha=minhasenha

3.5. Configure o .htaccess:
   Verifique se o arquivo .htaccess esta presente na raiz com:
   RewriteEngine On
   RewriteCond %{REQUEST_FILENAME} !-f
   RewriteCond %{REQUEST_FILENAME} !-d
   RewriteRule ^(.*)$ index.php [L,QSA]

   Se tiver acesso ao httpd.conf / apache2.conf, assegure que:
   AllowOverride All
   esteja configurado para o diretorio do projeto.


4. ESTRUTURA DE DIRETORIOS
------------------------------------------------------------------------------
   /config/           - Configuracoes do banco
   /public/           - Arquivos publicos (acessiveis via URL)
     /assets/         - CSS, JS, imagens
     /api/            - API REST
     /painel/         - Painel do cliente
     /superadmin/     - Painel do super admin
   /src/              - Classes PHP (Auth, Database, SuperAdmin, etc.)
   /tools/            - Ferramentas (backup, etc.)
   index.php          - Front Controller / Router
   .htaccess          - Regras de URL amigavel
   schema.sql         - Estrutura do banco
   install.php        - Instalador web
   manual.txt         - Este arquivo


5. ACESSO AO SISTEMA
------------------------------------------------------------------------------
   Url Principal:     http://seudominio.com/
   Painel Cliente:    http://seudominio.com/login.php
   Super Admin:       http://seudominio.com/superadmin/login.php
   API REST:          http://seudominio.com/api/v1/


6. SUPER ADMIN
------------------------------------------------------------------------------
   Acesse /superadmin/login.php com o email e senha cadastrados na instalacao.

   Funcionalidades:
   - Dashboard com metricas do sistema
   - Gerenciar grupos, categorias, planos
   - Gerenciar clientes e pagamentos
   - Configurar gateways (Mercado Pago, Asaas)
   - Relatorios de uso
   - Alterar nome do sistema e logo
   - Backup do banco de dados


7. BACKUP DO BANCO DE DADOS
------------------------------------------------------------------------------
   Opcao 1 - Via Super Admin:
      Acesse Configuracoes > Botao "Baixar Backup SQL"

   Opcao 2 - Via Ferramenta:
      Acesse http://seudominio.com/tools/backup.php
      (requer login de super admin)

   Opcao 3 - Via phpMyAdmin:
      Exporte manualmente pelo phpMyAdmin do cPanel


8. IMPORTACAO DE DADOS
------------------------------------------------------------------------------
   Acesse http://seudominio.com/tools/backup.php
   (requer login de super admin)

   Aba "Importar SQL":
   - Envie um arquivo .sql
   - Ou cole o conteudo SQL diretamente

   ATENCAO: A importacao sobrescreve dados existentes.
   Faca um backup antes de importar.


9. PLANOS DISPONIVEIS
------------------------------------------------------------------------------
   Gratuito     R$ 0,00     Mensal
   Basico       R$ 29,90    Mensal
   Profissional R$ 79,90    Mensal
   Enterprise   R$ 199,90   Mensal
   Vitalicio    R$ 499,90   Vitalicio


10. TECNOLOGIAS
------------------------------------------------------------------------------
   - PHP 8.x com PDO
   - MySQL / MariaDB
   - Bootstrap 5.3 + Bootstrap Icons
   - JWT para autenticacao
   - Argon2ID para hash de senhas
   - API REST


11. SOLUCAO DE PROBLEMAS
------------------------------------------------------------------------------
   Erro 404 ao acessar /superadmin:
   - Verifique se o .htaccess existe na raiz
   - Verifique se AllowOverride All esta ativo no Apache
   - Verifique se o mod_rewrite esta habilitado

   Erro de conexao com banco:
   - Verifique os dados em config/database.php
   - Verifique se o MySQL esta rodando
   - Se for hospedagem, use o host fornecido (ex: mysql.seudominio.com)

   Pagina sem CSS:
   - O sistema usa Bootstrap via CDN - verifique internet
   - O CSS customizado fica em public/assets/css/custom/futuristic.css


12. SEGURANCA
------------------------------------------------------------------------------
   Apos a instalacao, remova ou proteja:
   - install.php
   - setup.php
   - hash.php
   - tools/ (pasta com ferramentas)
   - schema.sql

   Mantenha o JWT_SECRET em config/database.php como uma chave forte e unica.

   Mantenha o .htaccess para proteger arquivos do src/ e config/.

=============================================================================
                        FIM DO MANUAL
=============================================================================