VigilanzaTurni/GUIDA-DEPLOYMENT-FINALE.md

🚀 Guida Deployment Finale - vt.alfacom.it

✅ Modifiche Applicate

1. Compatibilità Server Esterno

• ✅ server/replitAuth.ts - REPLIT_DOMAINS ora opzionale
• ✅ Fallback automatico: REPLIT_DOMAINS → DOMAIN → "vt.alfacom.it"
• ✅ REPL_ID opzionale (default: "vigilanza-turni")

2. Fix Build & Dependencies

• ✅ deploy/deploy.sh - usa npm ci --include=dev
• ✅ Vite e drizzle-kit installati correttamente (devDependencies)

3. Script Automazione

• ✅ fix-server.sh - automatizza fix server
• ✅ DEPLOYMENT-FIX.md - documentazione troubleshooting

---

🎯 Deployment in 4 Comandi

1. Push Modifiche a GitLab

# Su Replit (esegui nel terminale)
git add .
git commit -m "Fix deployment server esterno - REPLIT_DOMAINS opzionale"
git push origin main

Oppure usa lo script:

./push-to-gitlab.sh "Fix deployment server esterno"

2. Copia Script Fix sul Server

# Dal tuo PC/terminale
scp fix-server.sh root@vt.alfacom.it:/var/www/vigilanza-turni/

3. Esegui Fix sul Server

# SSH al server
ssh root@vt.alfacom.it

# Naviga alla directory
cd /var/www/vigilanza-turni

# Pull ultime modifiche
git pull origin main

# Dai permessi ed esegui fix
chmod +x fix-server.sh
bash fix-server.sh

4. Deploy Finale

# Ancora sul server
bash deploy/deploy.sh

---

📋 Output Atteso

✅ Fix Script Success:

🔧 Fix Deployment Server - vt.alfacom.it
==========================================
📝 Step 1: Aggiornamento package.json scripts...
✅ Aggiunto DOMAIN=vt.alfacom.it
✅ Aggiunto ISSUER_URL
✅ deploy.sh già configurato correttamente
✅ Fix completato!

✅ Deploy Success:

🚀 Deployment VigilanzaTurni - Thu Oct 16 12:01:24 EDT 2025
📥 Pull ultime modifiche da GitLab...
💾 Backup database pre-deployment...
✅ Backup salvato: /var/backups/vigilanza-turni/backup_20251016_120124.sql.gz
📥 Installazione dipendenze (include devDependencies)...
added 521 packages, and audited 522 packages in 12s
🏗️  Build frontend Vite...
vite v6.4.0 building for production...
✓ 2683 modules transformed.
✓ built in 9.75s
🗄️  Verifica database schema...
✅ Schema sincronizzato
🔄 Restart applicazione...
✅ Deployment completato con successo!

✅ PM2 Running:

┌────┬────────────────────┬──────────┬──────┬───────────┬──────────┬──────────┐
│ id │ name               │ mode     │ ↺    │ status    │ cpu      │ memory   │
├────┼────────────────────┼──────────┼──────┼───────────┼──────────┼──────────┤
│ 0  │ vigilanza-turni    │ fork     │ 0    │ online    │ 0%       │ 66.1mb   │
└────┴────────────────────┴──────────┴──────┴───────────┴──────────┴──────────┘

---

✅ Verifica Applicazione Online

# Test HTTPS
curl -I https://vt.alfacom.it

# Verifica PM2 logs (no errors)
pm2 logs vigilanza-turni --lines 50 --nostream

# Check database connection
pm2 logs vigilanza-turni | grep -i "serving\|error" | tail -10

Output atteso:

✅ Deployment completato con successo!
🌐 Applicazione disponibile su: https://vt.alfacom.it

---

🆘 Troubleshooting

❌ Errore: "REPLIT_DOMAINS not provided"

Causa: .env mancante di DOMAIN
Fix: echo "DOMAIN=vt.alfacom.it" >> .env

❌ Errore: "Cannot find package vite"

Causa: devDependencies non installate
Fix: Verifica deploy.sh usa npm ci --include=dev

❌ Errore: PM2 restart loop

Causa: Variabili env non caricate
Fix: Controlla .env e verifica source .env in deploy.sh

❌ Errore: drizzle-kit push fallisce

Nota: È normale se schema già aggiornato
Output: ⚠️ Schema push skipped (database già aggiornato)

---

📊 Checklist Post-Deployment

• Git push modifiche a GitLab ✅
• Script fix-server.sh eseguito ✅
• Deploy completato senza errori ✅
• PM2 status = online ✅
• https://vt.alfacom.it risponde ✅
• Logs PM2 senza errori REPLIT_DOMAINS ✅
• Database connesso ✅
• Backup automatici attivi ✅

---

🎉 Risultato Finale

✅ Applicazione VigilanzaTurni online su: https://vt.alfacom.it

Funzionalità Attive:

• ✅ Build Vite (521 pacchetti)
• ✅ Database PostgreSQL connesso
• ✅ Autenticazione OIDC funzionante
• ✅ PM2 process manager attivo
• ✅ Backup automatici (retention 30 giorni)
• ✅ SSL/TLS (Let's Encrypt)
• ✅ Nginx reverse proxy

---

📝 File Principali

File	Descrizione
server/replitAuth.ts	Fix compatibilità server esterno
fix-server.sh	Script automazione fix
deploy/deploy.sh	Script deployment automatico
DEPLOYMENT-FIX.md	Troubleshooting dettagliato
.env	Variabili ambiente (DOMAIN, ISSUER_URL)

---

🔄 Workflow Futuro

Per deployment successivi:

# 1. Sviluppo su Replit
git add . && git commit -m "Nuova feature" && git push origin main

# 2. Deploy su server
ssh root@vt.alfacom.it "cd /var/www/vigilanza-turni && bash deploy/deploy.sh"

Semplice! 🚀

---

Supporto: Per problemi consulta DEPLOYMENT-FIX.md o controlla logs con pm2 logs vigilanza-turni