# 🚀 Guia de Execução - Tutorial e Blog ## ⚡ Comandos para Executar no Servidor Execute estes comandos em ordem no servidor de produção: ### 1. Ir para o diretório do projeto ```bash cd /var/www/gestorstream ``` ### 2. Fazer pull das alterações ```bash git pull origin main ``` ### 3. Executar migrations ```bash cd backend php artisan migrate ``` ### 4. Criar link do storage (se ainda não existir) ```bash php artisan storage:link ``` ### 5. Garantir permissões corretas ```bash sudo chown -R www-data:www-data storage sudo chown -R www-data:www-data public/storage sudo chmod -R 775 storage sudo chmod -R 775 public/storage ``` ### 6. Limpar cache (opcional mas recomendado) ```bash php artisan cache:clear php artisan config:clear php artisan route:clear ``` ### 7. Reconstruir frontend ```bash cd ../frontend sudo -u www-data npm run build ``` ### 8. Recarregar nginx ```bash sudo systemctl reload nginx ``` --- ## ✅ Verificação Após executar os comandos, verifique: 1. **Acesse o sistema**: https://gestor.jf.eng.br 2. **Faça login** com um usuário normal 3. **Verifique se o ícone "Tutorial"** aparece no menu lateral (📖) 4. **Verifique se o ícone "Blog"** aparece no menu lateral (📚) 5. **Acesse `/tutorial`** - Deve mostrar o tutorial interativo 6. **Acesse `/blog`** - Deve mostrar a página do blog (vazia inicialmente) ### Como Admin: 1. **Faça login** com um usuário admin 2. **Verifique se o ícone "Gerenciar Blog"** aparece no menu lateral admin (📝) 3. **Acesse `/admin/blog`** - Deve mostrar o painel de gerenciamento 4. **Clique em "Novo Post"** - Deve abrir o editor 5. **Crie um post de teste** com: - Título: "Bem-vindo ao Sistema" - Conteúdo: "Este é um post de teste" - Marque como "Publicado" 6. **Volte ao blog como usuário** - Deve ver o post criado --- ## 🔍 Solução de Problemas ### Erro: "Table not found" ```bash cd /var/www/gestorstream/backend php artisan migrate ``` ### Erro: "Permission denied" no storage ```bash sudo chown -R www-data:www-data /var/www/gestorstream/backend/storage sudo chmod -R 775 /var/www/gestorstream/backend/storage ``` ### Frontend não carrega ícones novos ```bash cd /var/www/gestorstream/frontend sudo rm -rf dist sudo -u www-data npm run build sudo systemctl reload nginx ``` ### Erro 500 ao acessar /blog ou /tutorial ```bash # Verificar logs tail -50 /var/www/gestorstream/backend/storage/logs/laravel.log # Limpar cache cd /var/www/gestorstream/backend php artisan cache:clear php artisan config:clear ``` ### Imagens não aparecem ```bash # Verificar link simbólico ls -la /var/www/gestorstream/backend/public/storage # Recriar se necessário cd /var/www/gestorstream/backend rm -f public/storage php artisan storage:link # Permissões sudo chown -R www-data:www-data storage public/storage sudo chmod -R 775 storage public/storage ``` --- ## 📋 Checklist de Funcionalidades Após a instalação, teste: ### Tutorial (Usuário Logado) - [ ] Ícone "Tutorial" aparece no menu lateral - [ ] Acesso a `/tutorial` funciona - [ ] As 3 etapas são exibidas - [ ] Barra de progresso está visível - [ ] Links para configurações funcionam - [ ] Marcar etapa como concluída atualiza a interface - [ ] Após conclusão, aparecem sugestões de próximos passos ### Blog (Usuário Logado) - [ ] Ícone "Blog" aparece no menu lateral - [ ] Acesso a `/blog` funciona - [ ] Posts publicados são exibidos - [ ] Clicar em um post abre a página individual - [ ] Vídeos do YouTube são incorporados corretamente - [ ] Contador de visualizações funciona - [ ] Paginação funciona (se houver muitos posts) ### Blog Admin (Admin Logado) - [ ] Ícone "Gerenciar Blog" aparece no menu lateral admin - [ ] Acesso a `/admin/blog` funciona - [ ] Botão "Novo Post" está visível - [ ] Criar novo post funciona - [ ] Upload de thumbnail funciona - [ ] Upload de imagens funciona - [ ] URL do YouTube é aceita - [ ] Publicar/Despublicar funciona - [ ] Editar post funciona - [ ] Excluir post funciona - [ ] Filtros (todos/publicados/rascunhos) funcionam --- ## 🎯 Primeiro Uso Recomendado ### 1. Criar Post de Boas-Vindas ``` Título: Bem-vindo ao Sistema de Gestão Conteúdo:

Olá! 👋

Seja bem-vindo ao nosso sistema de gestão de servidores e clientes!

Primeiros Passos:

  1. Complete o tutorial de primeiro acesso
  2. Configure seu WhatsApp
  3. Crie seus templates de mensagem
  4. Adicione seus servidores e clientes

Qualquer dúvida, estamos à disposição!

YouTube URL: (Opcional - cole aqui link de vídeo tutorial) Publicado: ✅ Sim ``` ### 2. Criar Post com Tutorial em Vídeo ``` Título: Como Conectar o WhatsApp Conteúdo:

Neste vídeo, mostramos passo-a-passo como conectar seu WhatsApp ao sistema.

Resumo:

YouTube URL: (Cole o link do seu vídeo tutorial) Publicado: ✅ Sim ``` ### 3. Orientar Usuários Envie uma mensagem para seus usuários: ``` 🎉 Novidades no Sistema! 📖 Tutorial Interativo Agora temos um guia passo-a-passo para te ajudar! Acesse o ícone "Tutorial" no menu lateral. 📚 Central de Conhecimento Publicamos vídeos e tutoriais para você! Acesse o ícone "Blog" no menu lateral. Qualquer dúvida, estamos à disposição! ``` --- ## 💡 Dicas de Conteúdo para o Blog Sugestões de posts úteis: 1. **Como Criar Clientes no Sistema** 2. **Como Renovar Assinaturas** 3. **Configurando Avisos de Vencimento** 4. **Marketing com WhatsApp - Melhores Práticas** 5. **Como Importar Clientes em Massa** 6. **Gerenciando Múltiplos Servidores** 7. **Relatórios e Análises** 8. **Dicas de Automação** 9. **Perguntas Frequentes** 10. **Atualizações e Novidades do Sistema** --- ## 🎨 Personalização ### Alterar Texto do Tutorial Edite: `frontend/src/pages/TutorialPage.tsx` ### Alterar Texto do Blog Edite: `frontend/src/pages/BlogPage.tsx` ### Alterar Cores/Estilo Os componentes já usam as cores do sistema (roxo/azul para usuário, vermelho/roxo para admin) --- ## 📞 Suporte Se encontrar qualquer problema: 1. Verifique os logs: `/var/www/gestorstream/backend/storage/logs/laravel.log` 2. Verifique se as migrations rodaram: `php artisan migrate:status` 3. Verifique permissões do storage 4. Limpe o cache 5. Reconstrua o frontend --- **Tudo pronto! Bom uso do Tutorial e Blog! 🚀**