# ⚡ Quick Start - GitLab Deployment

Guida rapida per iniziare subito con il deployment su GitLab.

---

## 🚀 Setup in 3 Passi

### 1️⃣ Ottieni Token GitLab

```bash
# Vai su GitLab → Settings → Access Tokens
# https://gitlab.com/-/profile/personal_access_tokens
# 
# Crea token con permessi: api, read_repository, write_repository
```

### 2️⃣ Configura git.env

```bash
# Modifica git.env con le tue credenziali
nano git.env
```

```env
GITLAB_USER=tuo-username
GITLAB_TOKEN=glpat-xxxxxxxxxxxxxxxxxx
GITLAB_REPO=https://gitlab.com/tuo-username/vigilanzaturni.git
GITLAB_BRANCH=main
```

### 3️⃣ Deploy!

```bash
# Rendi eseguibile (solo prima volta)
chmod +x push-gitlab.sh

# Deploy!
./push-gitlab.sh
```

---

## 📝 Comandi Principali

```bash
# Bug fix, piccole modifiche (1.0.0 → 1.0.1)
./push-gitlab.sh

# Nuove funzionalità (1.0.5 → 1.1.0)
./push-gitlab.sh minor

# Breaking changes (1.1.5 → 2.0.0)
./push-gitlab.sh major
```

---

## ✅ Cosa Succede

1. ✅ **Backup Database** automatico (compressi .gz)
2. ✅ **Incrementa Versione** semantica
3. ✅ **Commit e Push** su GitLab
4. ✅ **Crea Tag** versione (es. v1.0.1)
5. ✅ **Aggiorna** version.json

---

## 📊 Versioning Cheat Sheet

| Tipo | Comando | Esempio | Quando |
|------|---------|---------|--------|
| **Patch** | `./push-gitlab.sh` | 1.0.0 → 1.0.1 | Bug fix |
| **Minor** | `./push-gitlab.sh minor` | 1.0.5 → 1.1.0 | Nuove feature |
| **Major** | `./push-gitlab.sh major` | 1.5.2 → 2.0.0 | Breaking changes |

---

## 🔍 Verifica Stato

```bash
# Versione corrente
cat version.json

# Ultimi backup
ls -lh database-backups/

# Configurazione
cat git.env
```

---

## 📖 Documentazione Completa

Per dettagli completi vedi: **[GITLAB-DEPLOY.md](GITLAB-DEPLOY.md)**

---

**Setup time**: ~2 minuti 🎉