╔════════════════════════════════════════════════════════════════════════════════╗
║                     SUPERFLIX CLONE - GUIA DE INSTALAÇÃO                       ║
║                        Plataforma de Streaming em PHP                          ║
╚════════════════════════════════════════════════════════════════════════════════╝

📋 REQUISITOS MÍNIMOS
═════════════════════════════════════════════════════════════════════════════════

✓ PHP 7.4 ou superior
✓ Servidor Apache com mod_rewrite ativado
✓ Extensão cURL habilitada
✓ Permissões de escrita na pasta /data
✓ Domínio ou subdomínio apontando para a pasta /public


🚀 PASSO A PASSO DE INSTALAÇÃO
═════════════════════════════════════════════════════════════════════════════════

1. FAZER UPLOAD DOS ARQUIVOS
   ─────────────────────────────────────────────────────────────────────────────
   
   a) Extraia o arquivo superflix-clone.zip
   b) Faça upload de TODOS os arquivos para sua hospedagem via FTP/SFTP
   c) Estrutura esperada:
   
      seu-dominio.com/
      ├── public/              ← Aponte seu domínio aqui
      ├── includes/
      ├── data/
      ├── assets/
      ├── .htaccess
      └── README.md


2. CONFIGURAR PERMISSÕES
   ─────────────────────────────────────────────────────────────────────────────
   
   Via SSH (recomendado):
   $ chmod -R 755 data/
   $ chmod -R 755 data/users/
   $ chmod -R 755 data/favorites/
   $ chmod -R 755 data/cache/
   
   Via cPanel File Manager:
   - Clique direito na pasta "data"
   - Selecione "Change Permissions"
   - Configure para 755


3. CONFIGURAR O DOMÍNIO
   ─────────────────────────────────────────────────────────────────────────────
   
   Via cPanel:
   - Acesse Addon Domains ou Parked Domains
   - Aponte seu domínio para: /home/usuario/public_html/superflix-clone/public
   
   Via Painel da Hospedagem:
   - Document Root: /superflix-clone/public
   - Index Files: index.php


4. TESTAR A INSTALAÇÃO
   ─────────────────────────────────────────────────────────────────────────────
   
   a) Acesse https://seu-dominio.com
   b) Você deverá ver a página inicial do Superflix
   c) Clique em "Registrar" para criar sua primeira conta
   d) Use um email real e WhatsApp válido


5. CRIAR PRIMEIRO ADMINISTRADOR
   ─────────────────────────────────────────────────────────────────────────────
   
   a) Registre-se normalmente no site
   b) Via FTP, acesse: data/users/users.json
   c) Abra o arquivo e procure por seu email
   d) Altere o campo "role" de "user" para "admin"
   e) Salve o arquivo
   f) Faça logout e login novamente
   g) Você verá "Painel Admin" no menu


⚙️ CONFIGURAÇÕES IMPORTANTES
═════════════════════════════════════════════════════════════════════════════════

Arquivo: includes/config.php

BASE_URL
  - Altere para: https://seu-dominio.com/
  - Importante para links e redirecionamentos

SUPERFLIX_API_KEY
  - Já está configurada com a chave: 9ae9713b2292d6e130bb9e4c44db58e6
  - Não precisa alterar

SESSION_TIMEOUT
  - Tempo de sessão em segundos (padrão: 86400 = 24 horas)
  - Altere conforme necessário

CACHE_DURATION
  - Duração do cache de conteúdo (padrão: 3600 = 1 hora)
  - Aumentar melhora performance, diminuir atualiza mais rápido


🔐 SEGURANÇA
═════════════════════════════════════════════════════════════════════════════════

✓ Senhas armazenadas com hash BCRYPT
✓ Proteção contra XSS
✓ Headers de segurança HTTP configurados
✓ Validação de entrada em todos os formulários
✓ Sessões seguras com timeout

Recomendações:
- Use HTTPS (SSL/TLS) em produção
- Mantenha PHP atualizado
- Faça backup regular dos dados em /data
- Monitore logs de erro


📱 FUNCIONALIDADES PRINCIPAIS
═════════════════════════════════════════════════════════════════════════════════

USUÁRIOS
  ✓ Cadastro com email e WhatsApp obrigatórios
  ✓ Login/Logout seguro
  ✓ Perfil editável
  ✓ Favoritos sincronizados

CONTEÚDO
  ✓ Filmes, séries e animes
  ✓ Busca e filtros por gênero
  ✓ Reprodutor embed compatível
  ✓ Navegação de temporadas/episódios

ADMIN
  ✓ Dashboard com estatísticas
  ✓ Gerenciamento de usuários
  ✓ Envio de mensagens via WhatsApp
  ✓ Ativar/desativar usuários
  ✓ Promover usuários a admin


🐛 TROUBLESHOOTING
═════════════════════════════════════════════════════════════════════════════════

PROBLEMA: "Erro 404 - Página não encontrada"
SOLUÇÃO:
  - Verifique se mod_rewrite está ativado
  - Confirme que .htaccess está no diretório raiz
  - Reinicie o Apache

PROBLEMA: "Erro ao conectar à API"
SOLUÇÃO:
  - Verifique se cURL está habilitado: php -m | grep curl
  - Teste a conexão manualmente
  - Confirme a chave da API em config.php

PROBLEMA: "Erro de permissão ao salvar dados"
SOLUÇÃO:
  - Altere permissões da pasta data para 755 ou 777
  - Verifique se o usuário do PHP tem permissão de escrita

PROBLEMA: "Sessão não funciona"
SOLUÇÃO:
  - Verifique se cookies estão habilitados
  - Confirme session.save_path no php.ini
  - Limpe cookies do navegador

PROBLEMA: "Reprodutor não funciona"
SOLUÇÃO:
  - Verifique se JavaScript está habilitado
  - Teste em outro navegador
  - Verifique console do navegador (F12)


📞 SUPORTE
═════════════════════════════════════════════════════════════════════════════════

API Superflix:
  https://sfl.centralapps.space/api

Documentação:
  Veja o arquivo README.md para mais detalhes


✅ CHECKLIST DE INSTALAÇÃO
═════════════════════════════════════════════════════════════════════════════════

□ Arquivos enviados via FTP
□ Permissões configuradas (755)
□ Domínio apontando para /public
□ Página inicial carrega corretamente
□ Registro de usuário funciona
□ Login funciona
□ Catálogo de filmes carrega
□ Reprodutor funciona
□ Primeiro admin criado
□ Painel admin acessível


🎉 PRONTO!
═════════════════════════════════════════════════════════════════════════════════

Sua plataforma Superflix está instalada e pronta para uso!

Próximas ações:
1. Personalize cores e logotipo
2. Configure mensagens de boas-vindas
3. Teste todas as funcionalidades
4. Faça backup regular dos dados
5. Monitore performance e erros


Desenvolvido com ❤️ para streaming de qualidade
Superflix Clone v1.0 - Dezembro 2025
