- Documentação detalhada do processo (PLANO_MIGRACAO_NOIDLE.md) - Guia rápido para executar (MIGRACAO_RAPIDA.md) - Script automatizado de migração (migrate_to_noidle.sh) - Renomeia pasta, código, PM2, docs - Backup automático e rollback - Tempo estimado: 5 minutos - Solução para organizar estrutura bagunçada
5.0 KiB
5.0 KiB
⚡ Migração Rápida: PointControl → NoIdle
🎯 Resumo Executivo
Seu projeto mudou de PointControl para NoIdle, mas os arquivos e código ainda usam "pointcontrol" em vários lugares. Isso cria confusão e desorganização.
Solução: Script automatizado que renomeia tudo em 5 minutos! ⏱️
🚀 Migração em 3 Passos
1️⃣ Verificar o que vai mudar
# Ver arquivos que serão afetados
cd /var/www/pointcontrol
grep -r "pointcontrol" . --include="*.js" --include="*.json" --include="*.md" | wc -l
2️⃣ Executar a migração
sudo bash /var/www/pointcontrol/migrate_to_noidle.sh
3️⃣ Verificar resultado
pm2 list
curl http://localhost:3005/api/health
📊 O Que Vai Ser Mudado
| Item | Antes | Depois |
|---|---|---|
| Pasta | /var/www/pointcontrol |
/var/www/noidle |
| PM2 | pointcontrol-api |
noidle-api |
| Backend | "name": "pointcontrol-api" |
"name": "noidle-api" |
| Frontend | "name": "pointcontrol-frontend" |
"name": "noidle-frontend" |
| Código | PointControl |
NoIdle |
| Logs | console.log('PointControl API') |
console.log('NoIdle API') |
✅ O Que o Script Faz
- ✅ Backup automático (salvo em
/tmp) - ✅ Para serviços (PM2)
- ✅ Renomeia pasta (
pointcontrol→noidle) - ✅ Atualiza package.json (backend e frontend)
- ✅ Atualiza código (todas as referências)
- ✅ Atualiza documentação (arquivos .md)
- ✅ Recria PM2 com novo nome
- ✅ Verifica funcionamento (testes automáticos)
🎬 Executar AGORA
cd /var/www/pointcontrol
sudo bash migrate_to_noidle.sh
Tempo estimado: 5 minutos ⏱️
⚠️ Importante
✅ Não Precisa Alterar:
- ✅ Banco de dados (continua igual)
- ✅ URLs externas (
admin.noidle.techjá está certo) - ✅ Certificados SSL (já estão corretos)
- ✅ Chaves de ativação (continuam funcionando)
⚠️ Verificar Depois:
- Nginx config (se tiver path hardcoded)
- Cliente Windows (se API_URL estiver hardcoded)
- Variáveis de ambiente
🔄 Rollback (Se der problema)
# Parar novo serviço
pm2 stop noidle-api
pm2 delete noidle-api
# Restaurar pasta
cd /var/www
mv noidle pointcontrol
# Restaurar PM2
cd pointcontrol/backend
pm2 start server.js --name pointcontrol-api
pm2 save
📝 Após a Migração
1. Atualizar Git
cd /var/www/noidle
git add .
git commit -m "refactor: Migração completa de PointControl para NoIdle"
git push
2. Atualizar Nginx (se necessário)
sudo nano /etc/nginx/sites-available/admin.noidle.tech
# Verificar se tem paths antigos
# /var/www/pointcontrol → /var/www/noidle
sudo nginx -t
sudo systemctl reload nginx
3. Testar Tudo
# API
curl http://localhost:3005/api/health
# Frontend
curl https://admin.noidle.tech
# PM2
pm2 list
pm2 logs noidle-api
🎯 Alternativa Manual (Se Preferir)
Opção A: Fazer Tudo Manualmente
Ver arquivo: PLANO_MIGRACAO_NOIDLE.md
Opção B: Fazer em Etapas
- Apenas renomear pasta
- Apenas atualizar PM2
- Apenas atualizar código
- etc...
Opção C: Manter Como Está
- NÃO recomendado (mantém confusão)
- Criar alias e documentar
📊 Estatísticas
Arquivos afetados:
- ~58 ocorrências em 21 arquivos
- Backend: ~5 arquivos
- Frontend: ~10 arquivos
- Docs: ~15 arquivos
Tempo necessário:
- Migração automática: ~5 minutos
- Migração manual: ~30 minutos
- Verificação e testes: ~10 minutos
🆘 Precisa de Ajuda?
Se o script falhar:
- Ver logs:
pm2 logs noidle-api --lines 50
- Verificar backup:
ls -lah /tmp/noidle_migration_backup_*
- Restaurar backup:
# Ver seção de Rollback acima
Contatos:
- Ver documentação completa:
PLANO_MIGRACAO_NOIDLE.md - Logs do PM2:
pm2 logs noidle-api
✨ Benefícios Após Migração
✅ Organização: Tudo consistente e limpo
✅ Clareza: Código fácil de entender
✅ Manutenção: Sem confusão entre nomes
✅ Profissionalismo: Nome correto em todo lugar
✅ Git: Histórico limpo e organizado
🎉 Resultado Final
/var/www/noidle/
├── backend/
│ ├── package.json (✅ "name": "noidle-api")
│ └── server.js (✅ console.log('NoIdle API'))
├── frontend/
│ ├── package.json (✅ "name": "noidle-frontend")
│ └── src/
│ └── components/ (✅ Todos: NoIdle)
└── *.md (✅ Documentação atualizada)
PM2: noidle-api (✅ online)
Git: /var/www/noidle (✅ atualizado)
🚀 Executar AGORA
cd /var/www/pointcontrol
sudo bash migrate_to_noidle.sh
Tempo: 5 minutos | Backup: Automático | Rollback: Disponível
Pronto para começar? Execute o comando acima! 🎯
Data: 2025-11-16