# 🚀 Quick Start - Deployment VigilanzaTurni

Guida rapida per deployment da Replit → GitLab → Server AlmaLinux 9

## 📝 Checklist Pre-Deployment

- [ ] Server AlmaLinux 9 disponibile (min 2GB RAM)
- [ ] Dominio configurato (es. vigilanza.tuodominio.it)
- [ ] Account GitLab su git.alfacom.it
- [ ] SSH access al server

---

## ⚡ Setup Rapido (15 minuti)

### 1️⃣ Setup Server (5 min)

```bash
# SSH nel server
ssh root@ip-del-server

# Download e esegui setup automatico
curl -o setup.sh https://git.alfacom.it/marco/VigilanzaTurni/-/raw/main/deploy/setup-server.sh
chmod +x setup.sh
sudo bash setup.sh

# ⚠️ IMPORTANTE: Salva la password PostgreSQL mostrata!
```

### 2️⃣ Configura GitLab CI/CD (3 min)

**Genera SSH Key:**
```bash
# Sul tuo PC
ssh-keygen -t ed25519 -C "gitlab-deploy" -f ~/.ssh/gitlab-deploy
ssh-copy-id -i ~/.ssh/gitlab-deploy.pub root@ip-del-server
cat ~/.ssh/gitlab-deploy  # Copia output
```

**GitLab → Settings → CI/CD → Variables:**

| Nome | Valore |
|------|--------|
| `SSH_PRIVATE_KEY` | [chiave privata copiata sopra] |
| `DEPLOY_HOST` | ip-del-server |
| `DEPLOY_USER` | root |
| `DEPLOY_DOMAIN` | vigilanza.tuodominio.it |

### 3️⃣ Configura Replit (2 min)

```bash
# In Replit Shell
git remote add production https://git.alfacom.it/marco/VigilanzaTurni.git

# Crea Personal Access Token su GitLab e salvalo in Replit Secrets
# GitLab → User Settings → Access Tokens → write_repository
```

### 4️⃣ Configura Server .env (3 min)

```bash
# Sul server
cd /var/www/vigilanza-turni

# Clone iniziale
git clone https://git.alfacom.it/marco/VigilanzaTurni.git .

# Crea .env
cp .env.production.example .env
nano .env
```

**Inserisci:**
```bash
# Password DB dal setup (vedi /root/.vigilanza_db_password)
DATABASE_URL=postgresql://vigilanza_user:PASSWORD_GENERATA@localhost:5432/vigilanza_turni
SESSION_SECRET=$(openssl rand -base64 32)
REPLIT_DOMAINS=vigilanza.tuodominio.it
```

### 5️⃣ Nginx e SSL (2 min)

```bash
# Copia config Nginx
sudo cp deploy/nginx.conf /etc/nginx/conf.d/vigilanza-turni.conf

# Modifica con il tuo dominio
sudo nano /etc/nginx/conf.d/vigilanza-turni.conf
# Sostituisci "tuodominio.it" → "vigilanza.tuodominio.it"

# Test e reload
sudo nginx -t
sudo systemctl reload nginx

# SSL Certificate
sudo certbot --nginx -d vigilanza.tuodominio.it
```

### 6️⃣ Primo Deploy (1 min)

```bash
# Sul server
cd /var/www/vigilanza-turni
bash deploy/deploy.sh
```

---

## 🔄 Workflow Quotidiano

### Da Replit → Produzione

```bash
# 1. Fai modifiche in Replit
# 2. Push a GitLab
bash push-to-gitlab.sh

# 3. Vai su GitLab
https://git.alfacom.it/marco/VigilanzaTurni/-/pipelines

# 4. Clicca su "deploy_production" quando pronto
```

---

## 📊 Comandi Utili

```bash
# Status applicazione
pm2 status

# Logs real-time
pm2 logs vigilanza-turni

# Restart
pm2 restart vigilanza-turni

# Backup database
sudo -u postgres pg_dump vigilanza_turni > backup_$(date +%Y%m%d).sql
```

---

## 🆘 Problemi Comuni

**App non risponde:**
```bash
pm2 restart vigilanza-turni
sudo systemctl reload nginx
```

**Errore database:**
```bash
# Verifica password in .env corrisponde a quella in /root/.vigilanza_db_password
cat /root/.vigilanza_db_password
```

**SSL scaduto:**
```bash
sudo certbot renew
sudo systemctl reload nginx
```

---

## 📚 Documentazione Completa

Per dettagli completi: [DEPLOYMENT.md](./DEPLOYMENT.md)

---

**Setup completato?** ✅ Vai su https://vigilanza.tuodominio.it