┌─────────────────────────────────────────────────────────────┐
│                    AMBIENTE SVILUPPO                        │
│  - PC Locale (Linux)                                        │
│  - Database PostgreSQL (mygest_dev)                         │
│  - Django Dev Server (localhost:8000)                       │
│  - React Dev Server (localhost:5173)                        │
└─────────────────────────────────────────────────────────────┘
                            ↕
                    [Git Push / Deploy]
                            ↕
┌─────────────────────────────────────────────────────────────┐
│                   SERVER PRODUZIONE (VPS)                   │
│  - Hostinger VPS (72.62.34.249)                            │
│  - Database PostgreSQL (mygest)                             │
│  - Gunicorn + Nginx                                         │
│  - Dominio: mygest.sandrochimenti.it                            │
└─────────────────────────────────────────────────────────────┘
                            ↕
                      [rclone backup]
                            ↕
┌─────────────────────────────────────────────────────────────┐
│                    ARCHIVIO DOCUMENTI                       │
│  - Locale Dev: /mnt/archivio                                │
│  - VPS Prod: /srv/mygest/archivio                           │
│  - Google Drive: backup cloud con rclone                    │
│  - Struttura: Cliente/Titolario/Anno/Documenti             │
└─────────────────────────────────────────────────────────────┘

# Python 3.10+
python3 --version  # Deve essere >= 3.10

# PostgreSQL
sudo apt install postgresql postgresql-contrib

# Git
sudo apt install git

# Node.js (per frontend)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install nodejs

# rclone (per backup NAS)
sudo apt install rclone

# WeasyPrint (per generazione PDF, opzionale)
sudo apt install python3-weasyprint

# Clone repository
git clone https://github.com/sandro6917/mygest.git
cd mygest

# Virtual environment
python3 -m venv venv
source venv/bin/activate

# Dipendenze Python
pip install -r requirements.txt

# Frontend
cd frontend
npm install
cd ..

# Database setup
createdb mygest_dev
python manage.py migrate

# Superuser
python manage.py createsuperuser

# Su PC locale
ssh-keygen -t ed25519 -C "tuo@email.com" -f ~/.ssh/mygest_deploy

# Copiare chiave pubblica sul VPS
ssh-copy-id -i ~/.ssh/mygest_deploy.pub mygest@72.62.34.249

# Creare/editare file
nano ~/.ssh/config

# Aggiungere:
Host mygest-vps
    HostName 72.62.34.249
    User mygest
    IdentityFile ~/.ssh/mygest_deploy
    ServerAliveInterval 60

ssh mygest-vps
# Dovrebbe connettersi senza password

# Verificare path applicazione
ls /srv/mygest/app
# Output: manage.py, mygest/, frontend/, ...

exit

# Configurare nome e email
git config --global user.name "Tuo Nome"
git config --global user.email "tuo@email.com"

# Personal Access Token (PAT) per push
# 1. Vai su GitHub > Settings > Developer settings > Personal access tokens
# 2. Generate new token (classic)
# 3. Seleziona scopes: repo, workflow
# 4. Copia il token generato

# Salvare credenziali
git config --global credential.helper store

# Al primo push ti chiederà:
# Username: tuo_username_github
# Password: [incolla il PAT generato]

# /home/sandro/mygest/.env
DEBUG=True
SECRET_KEY=<chiave-segreta-locale>
DATABASE_URL=postgresql://user:pass@localhost/mygest_dev
ALLOWED_HOSTS=localhost,127.0.0.1
ARCHIVIO_BASE_PATH=/mnt/archivio

# /srv/mygest/app/.env
DEBUG=False
SECRET_KEY=<chiave-segreta-produzione>
DATABASE_URL=postgresql://mygest:password@localhost/mygest
ALLOWED_HOSTS=mygest.sandrochimenti.it,72.62.34.249
ARCHIVIO_BASE_PATH=/srv/mygest/archivio

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   Sviluppo   │────▶│    GitHub    │────▶│     VPS      │
│  git push    │     │   Actions    │     │   Deploy     │
└──────────────┘     └──────────────┘     └──────────────┘
                           │
                           ├─ Checkout code
                           ├─ Run tests
                           ├─ SSH to VPS
                           ├─ Pull code
                           ├─ pip install
                           ├─ npm build
                           ├─ collectstatic
                           ├─ migrate
                           └─ restart gunicorn

cd /home/sandro/mygest

# Attivare virtualenv
source venv/bin/activate

# Creare/modificare codice
# ... modifiche ai file ...

# Test locale
python manage.py test
pytest

# Test server dev
python manage.py runserver
# Verificare http://localhost:8000

# Verificare modifiche
git status
git diff

# Aggiungere file modificati
git add .

# Commit con messaggio descrittivo
git commit -m "feat: aggiunta nuova funzionalità X"

# Push su GitHub (branch main)
git push origin main

# Aprire browser su:
# https://github.com/sandro6917/mygest/actions

# Verrai reindirizzato automaticamente all'ultimo workflow
# Osservare i vari step:
# - Checkout code ✓
# - Run tests ✓
# - Deploy to VPS ✓

# Tempo medio: 3-5 minuti

# Aprire browser su:
https://mygest.sandrochimenti.it

# Verificare:
# ✓ Applicazione risponde
# ✓ Login funzionante
# ✓ Nuove modifiche visibili

# Log server (se necessario)
ssh mygest-vps
sudo journalctl -u mygest -f

# 1. Controllare log su GitHub
# https://github.com/sandro6917/mygest/actions
# Clicca sul workflow fallito → Espandi step con errore

# 2. Errori comuni:

# a) Test failure
# Soluzione: Fixare test in locale, riprovare
pytest
git add -A
git commit -m "fix: correggi test"
git push origin main

# b) SSH connection failed
# Soluzione: Verificare chiave SSH su GitHub Secrets
# Settings > Secrets > Actions > SSH_PRIVATE_KEY

# c) Migration error
# Soluzione: Deploy manuale (vedi sezione successiva)

# 3. Forzare re-run workflow
# Su GitHub Actions > Workflow fallito > Re-run failed jobs

# Su PC locale, nella directory mygest
cd /home/sandro/mygest

# Eseguire script (richiede password sudo VPS)
./scripts/deploy.sh

# Output:
# 🚀 MyGest Deployment Script
# ================================
# 
# 📡 Connecting to VPS...
# ✓ Connected to mygest@72.62.34.249
# 
# 📥 Pulling latest code...
# ✓ Code updated
# 
# 📦 Installing dependencies...
# ✓ Python packages installed
# ✓ NPM packages installed
# 
# 🏗️  Building frontend...
# ✓ Frontend built
# 
# 📂 Collecting static files...
# ✓ Static files collected
# 
# 🗄️  Running migrations...
# ✓ Migrations applied
# 
# 🔄 Restarting services...
# ✓ Gunicorn restarted
# 
# ✅ Deployment completed successfully!

# 1. Connessione SSH al VPS
ssh mygest-vps

# 2. Navigare nella directory applicazione
cd /srv/mygest/app

# 3. Verificare branch Git
git branch
# Output: * main

git status
# Deve essere clean, altrimenti:
git stash  # Salva modifiche locali

# 4. Pull codice aggiornato
git pull origin main
# Output: Updating abc1234..def5678

# 5. Attivare virtualenv
source /srv/mygest/venv/bin/activate

# 6. Aggiornare dipendenze Python
pip install -r requirements.txt --upgrade

# 7. Frontend: installare dipendenze e build
cd frontend
npm install
npm run build
cd ..

# 8. Collect static files
python manage.py collectstatic --noinput
# Output: X static files copied

# 9. Verificare migrations
python manage.py showmigrations
# Verificare che tutte abbiano [X]

# 10. Applicare migrations (se necessario)
python manage.py migrate
# Output: Operations to perform: ...

# 11. Riavviare Gunicorn
sudo systemctl restart mygest

# 12. Verificare stato servizio
sudo systemctl status mygest
# Output: ● mygest.service - MyGest Gunicorn daemon
#         Active: active (running) since ...

# 13. Verificare log real-time
sudo journalctl -u mygest -f
# Premi Ctrl+C per uscire

# 14. Test applicazione
curl http://localhost:8000/api/v1/health/
# Output: {"status":"ok",...}

# 15. Exit SSH
exit

# ✓ 1. Applicazione risponde
curl -I https://mygest.sandrochimenti.it
# Output: HTTP/2 200 OK

# ✓ 2. Login funziona
# Aprire browser: https://mygest.sandrochimenti.it/login
# Inserire credenziali admin

# ✓ 3. API rispondono
curl https://mygest.sandrochimenti.it/api/v1/health/
# Output: {"status":"ok","database":"ok","redis":"ok"}

# ✓ 4. Static files caricati
curl -I https://mygest.sandrochimenti.it/static/admin/css/base.css
# Output: HTTP/2 200 OK

# ✓ 5. Frontend React funziona
# Aprire browser: https://mygest.sandrochimenti.it
# Verificare che React app si carichi (non errori console)

# ✓ 6. Database migrations applicate
ssh mygest-vps
cd /srv/mygest/app
source /srv/mygest/venv/bin/activate
python manage.py showmigrations | grep '\[ \]'
# Output vuoto = tutte applicate

# ✓ 7. Log senza errori
sudo journalctl -u mygest --since "5 minutes ago" | grep ERROR
# Output vuoto = nessun errore recente

# 1. Connessione SSH
ssh mygest-vps
cd /srv/mygest/app

# 2. Vedere commit recenti
git log --oneline -10
# Output:
# abc1234 (HEAD -> main, origin/main) feat: nuova funzione
# def5678 fix: correzione bug
# ghi9012 feat: altra modifica

# 3. Identificare commit precedente (es: def5678)
# Vedere dettagli:
git show def5678

# 4. Rollback a commit precedente
git reset --hard def5678
# ATTENZIONE: Questo elimina modifiche non committate!

# 5. Reinstallare dipendenze (potrebbero essere cambiate)
source /srv/mygest/venv/bin/activate
pip install -r requirements.txt

# 6. Rebuild frontend
cd frontend
npm install
npm run build
cd ..

# 7. Collectstatic
python manage.py collectstatic --noinput

# 8. Rollback migrations (SE NECESSARIO)
# Solo se il commit aveva migrations che causano problemi
python manage.py showmigrations app_name
# Identificare ultima migration da mantenere (es: 0008)
python manage.py migrate app_name 0008

# 9. Riavviare servizio
sudo systemctl restart mygest

# 10. Verificare
curl http://localhost:8000/api/v1/health/
sudo systemctl status mygest

# 1. BACKUP IMMEDIATO (prima di rollback)
ssh mygest-vps
cd /srv/mygest/backups
pg_dump -U mygest -F c mygest > pre_rollback_$(date +%Y%m%d_%H%M%S).dump

# 2. Elencare backup disponibili
ls -lh /srv/mygest/backups/*.dump
# Scegliere backup prima del deploy problematico

# 3. ATTENZIONE: Questo sovrascrive il database!
# Confermare che è l'azione corretta

# 4. Restore database
sudo systemctl stop mygest
pg_restore -U mygest -d mygest --clean --if-exists /srv/mygest/backups/backup_YYYYMMDD.dump

# 5. Riavviare
sudo systemctl start mygest

# 6. Verificare dati
psql -U mygest -d mygest -c "SELECT COUNT(*) FROM anagrafiche_anagrafica;"

# PIANO A: Rollback completo
ssh mygest-vps
cd /srv/mygest/app

# 1. Git rollback (vedi sopra)
git reset --hard <commit_precedente_funzionante>

# 2. Database restore (vedi sopra)
pg_restore -U mygest -d mygest --clean /srv/mygest/backups/ultimo_backup.dump

# 3. Rebuild tutto
source /srv/mygest/venv/bin/activate
pip install -r requirements.txt
cd frontend && npm install && npm run build && cd ..
python manage.py collectstatic --noinput
python manage.py migrate

# 4. Restart
sudo systemctl restart mygest nginx

# PIANO B: Ripristino da snapshot VPS
# Se hai snapshot VPS su Hostinger:
# 1. Login Hostinger panel
# 2. VPS > Snapshots
# 3. Restore snapshot pre-deploy
# Tempo: 10-30 minuti

# Su PC locale
cd /home/sandro/mygest

# Dry-run (simulazione, non modifica)
./scripts/sync_dev_to_prod.sh --dry-run

# Output:
# 🔄 MyGest Database Sync: DEV → PROD
# ====================================
# 
# 📊 Exporting from DEV...
# ✓ Exported 1886 records to fixtures/sync/dev_export_20260221_143022.json
# 
# 📤 Uploading to VPS...
# ✓ Uploaded (245 KB)
# 
# 🔍 DRY RUN - Simulating import...
# 
# Model                  | Create | Update | Delete | Skip  | Errors
# ------------------------------------------------------------------
# anagrafiche.Anagrafica |   15   |   230  |   0    |   0   |   0
# anagrafiche.Cliente    |    5   |    96  |   0    |   0   |   0
# documenti.Documento    |   87   |   413  |   0    |   0   |   0
# fascicoli.Fascicolo    |   12   |   349  |   0    |   0   |   0
# pratiche.Pratica       |    3   |    94  |   0    |   0   |   0
# ------------------------------------------------------------------
# TOTALS                 |  122   |  1182  |   0    |   0   |   0
# 
# ⚠️  DRY RUN: No changes applied to database
# 
# To apply changes, run without --dry-run

# Se tutto OK, eseguire sync reale
./scripts/sync_dev_to_prod.sh

# Confermare quando richiesto:
# ⚠️  This will modify production database!
# Continue? (yes/no): yes

# Output:
# 🔄 Sync completed successfully!
# ✓ 122 records created
# ✓ 1182 records updated
# ✓ Backup saved: /srv/mygest/backups/sync/pre_sync_20260221_143045.sql

# SEMPRE dry-run prima!
./scripts/sync_dev_to_prod.sh --full-replace --dry-run

# Leggere attentamente output:
# Model                  | Create | Update | Delete | Skip  | Errors
# ------------------------------------------------------------------
# anagrafiche.Anagrafica |  245   |    0   |  230   |   0   |   0
# documenti.Documento    |  500   |    0   |  489   |   0   |   0
#                           ^^^^             ^^^^
#                        Crea tutti      Elimina tutti esistenti!

# Se sicuro, eseguire:
./scripts/sync_dev_to_prod.sh --full-replace --force

# Richiede doppia conferma:
# ⚠️  FULL REPLACE MODE - Will delete existing data!
# Type 'DELETE ALL DATA' to confirm: DELETE ALL DATA
# Are you absolutely sure? (yes/no): yes

# Solo anagrafiche
./scripts/sync_dev_to_prod.sh --models anagrafiche

# Output:
# 📊 Exporting only: anagrafiche.Anagrafica, anagrafiche.Cliente, ...
# ✓ Exported 346 records

# Più modelli
./scripts/sync_dev_to_prod.sh --models anagrafiche,fascicoli

# Vedere modelli disponibili:
python manage.py export_data --help | grep "Available models"

# Su PC locale
cd /home/sandro/mygest

# Dry-run
./scripts/sync_prod_to_dev.sh --dry-run

# Output simile a dev→prod ma in direzione inversa
# ⚠️  Mostrerà quanti record locali saranno modificati

# Eseguire sync
./scripts/sync_prod_to_dev.sh

# Confermare:
# ⚠️  This will modify local development database!
# Continue? (yes/no): yes

# Verifica locale dopo sync
source venv/bin/activate
python manage.py shell

>>> from anagrafiche.models import Cliente
>>> Cliente.objects.count()
101  # Numero da produzione

>>> from documenti.models import Documento
>>> Documento.objects.count()
500  # Allineato con prod

# TODO: Feature da implementare
# Permetterebbe di:
# - Anonimizzare nomi/CF/P.IVA
# - Mantenere struttura dati
# - Offuscare documenti sensibili

# Workaround attuale:
# 1. Sync normale
./scripts/sync_prod_to_dev.sh

# 2. Script Python per anonimizzare
python manage.py shell
>>> from anagrafiche.models import Anagrafica
>>> for a in Anagrafica.objects.all():
...     if a.tipo == 'PF':
...         a.nome = f"Cliente {a.pk}"
...         a.cognome = "Test"
...         a.codice_fiscale = "TSTCLI80A01H501X"
...     a.save()

# Su PC locale (per rollback DEV)
cd /home/sandro/mygest
./scripts/rollback_last_sync.sh

# Output:
# 🔙 MyGest Database Sync Rollback
# =================================
# 
# 📋 Available backups:
# 1. pre_sync_20260221_143045.sql  (245 MB) - 10 minutes ago
# 2. pre_sync_20260220_162222.sql  (242 MB) - 1 day ago
# 3. pre_sync_20260215_091530.sql  (238 MB) - 6 days ago
# 
# Select backup number (or 'q' to quit): 1
# 
# ⚠️  This will restore database to state before last sync!
# Current data will be LOST!
# Continue? (yes/no): yes
# 
# 🔄 Restoring backup...
# ✓ Database restored successfully!

# Su VPS (per rollback PROD)
ssh mygest-vps
cd /srv/mygest/app
./scripts/rollback_last_sync.sh
# Procedura identica

# Esempio su DEV (stesso procedimento su PROD)

# 1. Vedere backup disponibili
ls -lh /home/sandro/mygest/backups/sync/
# -rw-r--r-- 1 sandro sandro 245M Feb 21 14:30 pre_sync_20260221_143045.sql

# 2. Stopare applicazione (se in uso)
# Su DEV non necessario, su PROD:
ssh mygest-vps
sudo systemctl stop mygest

# 3. Drop database attuale
dropdb mygest_dev  # Su DEV
# dropdb mygest     # Su PROD

# 4. Ricreare database vuoto
createdb mygest_dev  # Su DEV
# createdb mygest     # Su PROD

# 5. Restore da backup
pg_restore -U sandro -d mygest_dev /home/sandro/mygest/backups/sync/pre_sync_20260221_143045.sql

# Su PROD:
# pg_restore -U mygest -d mygest /srv/mygest/backups/sync/pre_sync_20260221_143045.sql

# 6. Verificare
psql mygest_dev -c "SELECT COUNT(*) FROM anagrafiche_anagrafica;"

# 7. Riavviare (su PROD)
# sudo systemctl start mygest

□ Backup database destinazione eseguito
□ Dry-run verificato e output confermato
□ Nessun utente sta lavorando (per prod→dev)
□ Applicazione in manutenzione (per sync prod)
□ Spazio disco sufficiente (backup + export)
□ Connessione internet stabile

# I backup sync sono in:
# DEV: /home/sandro/mygest/backups/sync/
# PROD: /srv/mygest/backups/sync/

# Retention automatica (ultimi 10 backup):
# - Script mantiene automaticamente 10 backup più recenti
# - Backup più vecchi eliminati automaticamente

# Backup manuali importanti:
# Creare in /backups/manual/ per conservazione permanente
pg_dump -U mygest -F c mygest > /srv/mygest/backups/manual/pre_upgrade_v2.0.dump

# Mount point NAS locale
/mnt/archivio/

# Struttura directory:
/mnt/archivio/
├── clienti/                    # Documenti per cliente
│   ├── CLI001_ROSSI_MARIO/
│   │   ├── 01_CONTABILITA/
│   │   │   ├── 2024/
│   │   │   │   ├── FAT-2024-001.pdf
│   │   │   │   └── FAT-2024-002.pdf
│   │   │   └── 2025/
│   │   ├── 02_FISCALE/
│   │   ├── 03_LAVORO/
│   │   └── ...
│   └── CLI002_BIANCHI_SRL/
├── archivio_fisico/            # Ubicazioni fisiche
│   ├── UF001_UFFICIO_PRINCIPALE/
│   ├── UF002_ARCHIVIO_SEMINTERRATO/
│   └── ...
└── temp/                       # Upload temporanei
    └── pending_uploads/

CLI001_ROSSI_MARIO
CLI042_ACME_SRL

01_CONTABILITA
02_FISCALE
03_LAVORO
04_SOCIETARIO

FAT-2024-001-Fattura_fornitore_X.pdf
CEDU-2024-12-Dicembre_2024.pdf
UNILAV-2025-003-Assunzione_Rossi.pdf

# Locale
mount | grep /mnt/archivio
df -h /mnt/archivio

# VPS  
mount | grep /srv/mygest/archivio
df -h /srv/mygest/archivio

# Creare mount point
sudo mkdir -p /mnt/archivio

# Mount CIFS da NAS locale
sudo mount -t cifs //192.168.1.4/documenti/archivio /mnt/archivio \
  -o username=admin,uid=1000,gid=1000,file_mode=0664,dir_mode=0775

# Verificare accesso
ls -la /mnt/archivio (o /srv/mygest/archivio su VPS)
touch /mnt/archivio (o /srv/mygest/archivio su VPS)/test.txt
rm /mnt/archivio (o /srv/mygest/archivio su VPS)/test.txt

# Creare file credenziali
sudo nano /root/.nascreds

# Contenuto:
username=mygest
password=password_nas
domain=WORKGROUP

# Proteggere file
sudo chmod 600 /root/.nascreds

# Editare /etc/fstab
sudo nano /etc/fstab

# Aggiungere riga:
//192.168.1.100/mygest /mnt/archivio (o /srv/mygest/archivio su VPS) cifs credentials=/root/.nascreds,uid=1000,gid=1000,file_mode=0664,dir_mode=0775,_netdev 0 0

# Testare mount senza reboot
sudo mount -a

# Verificare
df -h | grep nas_mygest

# User/group che esegue Django (su VPS)
id mygest
# uid=1001(mygest) gid=1001(mygest)

# Verificare permessi directory
ls -ld /mnt/archivio (o /srv/mygest/archivio su VPS)
# drwxrwxr-x 5 mygest mygest 4096 Feb 21 14:00 /mnt/archivio (o /srv/mygest/archivio su VPS)

# Correggere se necessario
sudo chown -R mygest:mygest /mnt/archivio (o /srv/mygest/archivio su VPS)
sudo chmod -R u+rwX,g+rwX,o+rX /mnt/archivio (o /srv/mygest/archivio su VPS)

# Test scrittura
sudo -u mygest touch /mnt/archivio (o /srv/mygest/archivio su VPS)/test_permissions.txt
# Deve avere successo
sudo -u mygest rm /mnt/archivio (o /srv/mygest/archivio su VPS)/test_permissions.txt

# Su shell Django
python manage.py shell

>>> import os
>>> nas_path = '/mnt/archivio (o /srv/mygest/archivio su VPS)'
>>> 
>>> # Test lettura
>>> os.listdir(nas_path)
['clienti', 'archivio_fisico', 'temp']
>>> 
>>> # Test scrittura
>>> test_file = os.path.join(nas_path, 'test_django.txt')
>>> with open(test_file, 'w') as f:
...     f.write('Test Django write access')
>>> 
>>> # Test cancellazione
>>> os.remove(test_file)
>>> 
>>> # Success = permessi OK

# Su VPS
ssh mygest-vps

# Verificare config rclone
cat ~/.config/rclone/rclone.conf

# Output:
# [gdrive_mygest]
# type = drive
# client_id = ...
# client_secret = ...
# token = {"access_token":"...","token_type":"Bearer",...}
# root_folder_id = 1A2B3C4D5E6F7G8H9I0J

# Testare accesso Google Drive
rclone lsd gdrive_mygest:
# Output:
# 0 2026-02-21 10:30:00        -1 MyGest_Backup

# Installare rclone (se non presente)
sudo apt install rclone

# Configurazione interattiva
rclone config

# Seguire wizard:
# n) New remote
# name> gdrive_mygest
# Storage> drive (Google Drive)
# client_id> (premere Enter per default o inserire)
# client_secret> (premere Enter per default o inserire)
# scope> drive (accesso completo)
# root_folder_id> (lasciare vuoto o inserire folder ID)
# service_account_file> (lasciare vuoto)
# Edit advanced config? n
# Use auto config? n (su server senza GUI)

# Seguire URL per autorizzazione:
# 1. Copiare URL mostrato
# 2. Aprire in browser
# 3. Autorizzare accesso Google Drive
# 4. Copiare codice autorizzazione
# 5. Incollare nel terminale

# Confermare e salvare config

# Sync dry-run (simulazione)
rclone sync /mnt/archivio (o /srv/mygest/archivio su VPS)/ gdrive_mygest:MyGest_Backup/ \
  --dry-run \
  --progress \
  --exclude "temp/**" \
  --exclude ".DS_Store" \
  --log-file=/var/log/rclone_sync.log

# Output:
# 2024/02/21 15:00:00 NOTICE: MyGest_Backup/: 0 differences, 0 copies, 0 deletions, 0 new, 0 errors
# 2024/02/21 15:00:01 NOTICE: Transferred: 0 B / 0 B, -, 0 B/s, ETA -

# Sync reale
rclone sync /mnt/archivio (o /srv/mygest/archivio su VPS)/ gdrive_mygest:MyGest_Backup/ \
  --progress \
  --exclude "temp/**" \
  --log-file=/var/log/rclone_sync.log

# Progress bar:
# Transferred:        1.234 GiB / 1.234 GiB, 100%, 5.123 MiB/s, ETA 0s
# Checks:         1234 / 1234, 100%
# Elapsed time:   4m30s

# Su VPS
ssh mygest-vps

# Creare script backup
sudo nano /usr/local/bin/mygest_backup.sh

# Contenuto:
#!/bin/bash
# MyGest NAS → Google Drive Backup Script

LOG_FILE="/var/log/mygest_backup.log"
DATE=$(date +"%Y-%m-%d %H:%M:%S")

echo "[$DATE] Starting backup..." >> $LOG_FILE

rclone sync /mnt/archivio (o /srv/mygest/archivio su VPS)/ gdrive_mygest:MyGest_Backup/ \
  --exclude "temp/**" \
  --exclude ".DS_Store" \
  --log-file=$LOG_FILE \
  --log-level INFO \
  --stats 1m

RESULT=$?

if [ $RESULT -eq 0 ]; then
  echo "[$DATE] Backup completed successfully" >> $LOG_FILE
else
  echo "[$DATE] Backup failed with error code $RESULT" >> $LOG_FILE
fi

# Rendere eseguibile
sudo chmod +x /usr/local/bin/mygest_backup.sh

# Testare script
sudo /usr/local/bin/mygest_backup.sh

# Configurare cron job (esecuzione notturna)
sudo crontab -e

# Aggiungere:
# Backup NAS ogni notte alle 2:00 AM
0 2 * * * /usr/local/bin/mygest_backup.sh

# Verificare cron job
sudo crontab -l

# Ultimi backup
tail -50 /var/log/mygest_backup.log

# Errori recenti
grep ERROR /var/log/mygest_backup.log | tail -20

# Statistiche ultimo backup
grep "Transferred" /var/log/mygest_backup.log | tail -1
# Output: Transferred:        1.234 GiB / 1.234 GiB, 100%

rclone about gdrive_mygest:

# Output:
# Total:   15.0 GiB
# Used:     8.5 GiB
# Free:     6.5 GiB
# Trashed:  0.1 GiB

# Modificare script backup per inviare email su errore
sudo nano /usr/local/bin/mygest_backup.sh

# Aggiungere dopo RESULT=$?:
if [ $RESULT -ne 0 ]; then
  echo "MyGest backup failed on $(hostname) at $(date)" | \
    mail -s "ALERT: MyGest Backup Failed" admin@example.com
fi

# Installare mailutils se necessario
sudo apt install mailutils

# Su VPS o PC locale

# 1. Verificare spazio disco disponibile
df -h /mnt/archivio (o /srv/mygest/archivio su VPS)
# Deve avere almeno spazio = dimensione backup

# 2. Creare directory temporanea restore
sudo mkdir -p /mnt/nas_restore
sudo chown mygest:mygest /mnt/nas_restore

# 3. Download da Google Drive
rclone copy gdrive_mygest:MyGest_Backup/ /mnt/nas_restore/ \
  --progress \
  --log-file=/var/log/rclone_restore.log

# Progress bar:
# Transferred:        8.5 GiB / 8.5 GiB, 100%, 10 MiB/s, ETA 0s
# Elapsed time:   15m30s

# 4. Verificare integrità dati
du -sh /mnt/nas_restore
# 8.5G    /mnt/nas_restore

tree /mnt/nas_restore -L 2
# Verificare struttura directory corretta

# 5. Stopare applicazione (per evitare scritture)
sudo systemctl stop mygest

# 6. Backup NAS corrente (se parzialmente recuperabile)
sudo mv /mnt/archivio (o /srv/mygest/archivio su VPS) /mnt/archivio (o /srv/mygest/archivio su VPS).old

# 7. Spostare restore in produzione
sudo mv /mnt/nas_restore /mnt/archivio (o /srv/mygest/archivio su VPS)

# 8. Ripristinare permessi
sudo chown -R mygest:mygest /mnt/archivio (o /srv/mygest/archivio su VPS)
sudo chmod -R u+rwX,g+rwX,o+rX /mnt/archivio (o /srv/mygest/archivio su VPS)

# 9. Riavviare applicazione
sudo systemctl start mygest

# 10. Verificare accesso documenti
curl https://mygest.sandrochimenti.it/api/v1/documenti/1/
# Verificare che "file" URL sia accessibile

# Esempio: restore solo documenti cliente CLI042

# 1. Elencare contenuto backup remoto
rclone lsf gdrive_mygest:MyGest_Backup/clienti/

# Output:
# CLI001_ROSSI_MARIO/
# CLI042_ACME_SRL/
# CLI089_VERDI_GIUSEPPE/

# 2. Download singola directory
rclone copy \
  gdrive_mygest:MyGest_Backup/clienti/CLI042_ACME_SRL/ \
  /tmp/restore_cli042/ \
  --progress

# 3. Verificare file
ls -lR /tmp/restore_cli042/

# 4. Copiare in NAS produzione
sudo cp -r /tmp/restore_cli042/* /mnt/archivio (o /srv/mygest/archivio su VPS)/clienti/CLI042_ACME_SRL/

# 5. Correggere permessi
sudo chown -R mygest:mygest /mnt/archivio (o /srv/mygest/archivio su VPS)/clienti/CLI042_ACME_SRL/

# rclone tiene versioni Google Drive (se attivato)

# 1. Vedere versioni file
rclone lsl gdrive_mygest:MyGest_Backup/clienti/CLI001_ROSSI_MARIO/01_CONTABILITA/2024/FAT-2024-001.pdf --drive-v2-download-min-size 0

# 2. Restore con versione specifica
# Google Drive tiene automaticamente versioni ultimi 30-100 giorni

# Metodo alternativo: snapshot NAS periodici
# Configurare snapshot giornalieri su NAS per point-in-time recovery

# File temp più vecchi di 7 giorni
find /mnt/archivio (o /srv/mygest/archivio su VPS)/tmp/ -type f -mtime +7 -delete

# Verificare spazio liberato
du -sh /mnt/archivio (o /srv/mygest/archivio su VPS)/tmp/

# Cron job pulizia automatica
sudo crontab -e

# Aggiungere:
# Pulizia temp ogni domenica alle 3 AM
0 3 * * 0 find /mnt/archivio (o /srv/mygest/archivio su VPS)/tmp/ -type f -mtime +7 -delete

# Verificare file corrotti (PDF)
find /mnt/archivio (o /srv/mygest/archivio su VPS)/clienti/ -name "*.pdf" -type f | while read pdf; do
  pdfinfo "$pdf" > /dev/null 2>&1 || echo "Corrupt: $pdf"
done

# Log file problematici
# Manualmente verificare e risolvere

# Spazio per cliente (top 20)
du -sh /mnt/archivio (o /srv/mygest/archivio su VPS)/clienti/*/ | sort -hr | head -20

# Output:
# 450M    /mnt/archivio (o /srv/mygest/archivio su VPS)/clienti/CLI042_ACME_SRL/
# 320M    /mnt/archivio (o /srv/mygest/archivio su VPS)/clienti/CLI001_ROSSI_MARIO/
# 280M    /mnt/archivio (o /srv/mygest/archivio su VPS)/clienti/CLI089_VERDI_GIUSEPPE/
# ...

# File più grandi (top 50)
find /mnt/archivio (o /srv/mygest/archivio su VPS)/clienti/ -type f -exec du -h {} + | sort -hr | head -50

# Trend crescita (da monitorare)
df -h /mnt/archivio (o /srv/mygest/archivio su VPS) | awk '{print $5}' | tail -1
# Output: 61% (uso attuale)

Error: Connection timed out
Error: Could not connect to 72.62.34.249:22

# 1. Verificare VPS online
ping 72.62.34.249

# 2. Verificare SSH manuale
ssh mygest@72.62.34.249

# 3. Verificare GitHub Secret SSH_PRIVATE_KEY
# Settings > Secrets > Actions > SSH_PRIVATE_KEY
# Deve contenere chiave privata completa:
# -----BEGIN OPENSSH PRIVATE KEY-----
# ...
# -----END OPENSSH PRIVATE KEY-----

# 4. Verificare authorized_keys su VPS
ssh mygest-vps
cat ~/.ssh/authorized_keys
# Deve contenere chiave pubblica corrispondente

FAILED tests/test_models.py::TestModel::test_validation

# 1. Eseguire test in locale
pytest tests/test_models.py::TestModel::test_validation -vv

# 2. Fixare errore
# ... modifiche codice ...

# 3. Re-commit e push
git add -A
git commit -m "fix: risolto test validation"
git push origin main

ERROR: Could not find a version that satisfies the requirement package==1.2.3

# 1. Verificare Python version
python --version
# Deve essere >= 3.10

# 2. Aggiornare pip
pip install --upgrade pip setuptools wheel

# 3. Verificare package disponibile
pip search package

# 4. Installare con verbose
pip install -r requirements.txt -v

Error: ENOSPC: System limit for number of file watchers reached

# Aumentare limite watchers Linux
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

OSError: [Errno 28] No space left on device

# Verificare spazio disco
df -h

# Pulire cache vecchi static
rm -rf /srv/mygest/app/staticfiles/*
python manage.py collectstatic --noinput --clear

# Pulire log vecchi
sudo journalctl --vacuum-time=7d

sudo systemctl status mygest

# Output:
# ● mygest.service - MyGest Gunicorn daemon
#    Loaded: loaded
#    Active: failed (Result: exit-code)

# 1. Vedere log dettagliato
sudo journalctl -u mygest -n 100 --no-pager

# Errori comuni:

# a) ModuleNotFoundError: No module named 'X'
# Soluzione: pip install mancante
source /srv/mygest/venv/bin/activate
pip install X

# b) django.db.utils.OperationalError: FATAL: database "mygest" does not exist
# Soluzione: ricreare database
createdb -U mygest mygest
python manage.py migrate

# c) PermissionError: [Errno 13] Permission denied: '/srv/mygest/...'
# Soluzione: correggere ownership
sudo chown -R mygest:mygest /srv/mygest/

# 2. Riavviare servizio
sudo systemctl restart mygest

# 3. Verificare OK
sudo systemctl status mygest
curl http://localhost:8000/api/v1/health/

ssh: connect to host 72.62.34.249 port 22: Connection refused

django.db.utils.OperationalError: canceling statement due to statement timeout

# Database troppo grande, export selettivo
./scripts/sync_dev_to_prod.sh --models anagrafiche,clienti

# Oppure aumentare timeout PostgreSQL
psql -U mygest -d mygest -c "ALTER DATABASE mygest SET statement_timeout = '600s';"

django.db.utils.IntegrityError: duplicate key value violates unique constraint "anagrafiche_anagrafica_codice_fiscale_key"

# 1. Verificare dati duplicati in sorgente
python manage.py shell
>>> from anagrafiche.models import Anagrafica
>>> Anagrafica.objects.values('codice_fiscale').annotate(count=models.Count('id')).filter(count__gt=1)

# 2. Risolvere duplicati manualmente o:

# 3. Usare --full-replace per reset completo (ATTENZIONE)
./scripts/sync_dev_to_prod.sh --full-replace --dry-run

Error: /srv/mygest/backups/sync/pre_sync_20260221_143045.sql not found

# 1. Vedere backup disponibili
ls -lh /srv/mygest/backups/sync/

# 2. Usare backup più recente disponibile
pg_restore -U mygest -d mygest /srv/mygest/backups/sync/pre_sync_<altra_data>.sql

# 3. Se nessun backup sync, usare backup giornaliero
ls -lh /srv/mygest/backups/daily/
pg_restore -U mygest -d mygest /srv/mygest/backups/daily/backup_<data>.dump

ls /mnt/archivio (o /srv/mygest/archivio su VPS)
# ls: cannot access '/mnt/archivio (o /srv/mygest/archivio su VPS)': Input/output error

# 1. Unmount forzato
sudo umount -f /mnt/archivio (o /srv/mygest/archivio su VPS)

# 2. Verificare NAS accessibile
ping 192.168.1.100

# 3. Testare connessione SMB
smbclient -L //192.168.1.100 -U mygest

# 4. Remount
sudo mount /mnt/archivio (o /srv/mygest/archivio su VPS)

# 5. Verificare
ls -la /mnt/archivio (o /srv/mygest/archivio su VPS)

PermissionError: [Errno 13] Permission denied: '/mnt/archivio (o /srv/mygest/archivio su VPS)/clienti/CLI001/test.pdf'

# 1. Verificare ownership
ls -ld /mnt/archivio (o /srv/mygest/archivio su VPS)
# Deve essere: drwxrwxr-x mygest mygest

# 2. Correggere
sudo chown -R mygest:mygest /mnt/archivio (o /srv/mygest/archivio su VPS)
sudo chmod -R u+rwX,g+rwX /mnt/archivio (o /srv/mygest/archivio su VPS)

# 3. Verificare mount options in /etc/fstab
# Deve avere: uid=1001,gid=1001 (id user mygest)

# 4. Remount con opzioni corrette
sudo umount /mnt/archivio (o /srv/mygest/archivio su VPS)
sudo mount /mnt/archivio (o /srv/mygest/archivio su VPS)

ERROR : Failed to copy: googleapi: Error 403: User rate limit exceeded

# 1. Google Drive quota exceeded, attendere o:

# 2. Usare --drive-chunk-size più piccolo
rclone sync /mnt/archivio (o /srv/mygest/archivio su VPS)/ gdrive_mygest:MyGest_Backup/ \
  --drive-chunk-size 32M \
  --transfers 1

# 3. Oppure aumentare quota Google Drive (Google One)

ERROR : Failed to create file system: token refresh failed

# 1. Refresh token rclone
rclone config reconnect gdrive_mygest:

# Seguire URL per re-autorizzare

# 2. Testare
rclone lsd gdrive_mygest:

# .github/workflows/deploy.yml
on:
  push:
    branches: [ main, staging ]  # Aggiungi branch

# Revert ultimo commit (crea nuovo commit)
git revert HEAD
git push origin main

# Oppure reset hard (PERICOLOSO, riscrive storia)
git reset --hard HEAD~1
git push origin main --force

./scripts/sync_dev_to_prod.sh --models anagrafiche

# Sync DB
./scripts/sync_dev_to_prod.sh

# Sync file (da implementare script dedicato)
rsync -avz /mnt/archivio (o /srv/mygest/archivio su VPS)/ mygest-vps:/mnt/archivio (o /srv/mygest/archivio su VPS)/

du -sh /mnt/archivio (o /srv/mygest/archivio su VPS)/
rclone about gdrive_mygest:

rclone config
# Scegliere: Dropbox, OneDrive, AWS S3, etc.

python manage.py changepassword admin
# Reimpostare password conosciuta

# Killare processo gunicorn appeso
sudo pkill -9 gunicorn

# Riavviare servizio
sudo systemctl restart mygest