# Migrazione configurazione MTM — vte_dev → produzione VTE 26

Pacchetto generato da `vte_dev` (26.04 build 3367). **Non include dati CRM** (record, utenti, allegati).

## Contenuto pacchetto (`_backups/mtm-config-26/`)

| Path | Descrizione |
|------|-------------|
| `modules/*.zip` | 16 moduli ModMaker + `EventiMacchine-extra-files.tar.gz` |
| `sql/mtm-sdk-config.sql` | `sdk_language` e altre righe SDK legate ai moduli MTM |
| `sql/mtm-vteprop-theme.sql` | Proprietà `theme.*` |
| `sql/mtm-organizationdetails.sql` | Dump società (revisionare prima dell’import) |
| `branding/` | File logo e wallpaper |
| `mtm-branding.tar.gz` | Archivio branding + SQL tema |

## Rigenerare il pacchetto (su mypantarei / vte_dev)

```bash
chmod +x /var/www/html/server-ops/mtm-migration/*.sh
chmod +x /var/www/html/server-ops/mtm-migration/*.php

php8.3 /var/www/html/server-ops/mtm-migration/mtm-export-modules-cli.php

php8.3 /var/www/html/server-ops/mtm-migration/mtm-export-sdk-config.php

bash /var/www/html/server-ops/mtm-migration/mtm-export-branding.sh
```

## 1. Prerequisiti produzione (obbligatori)

1. VTE **26.04**, PHP **8.3+**, licenza attiva.
2. **Backup** completo file + database.
3. Moduli standard attivi: SDK, Processes, PDFMaker (minimo).

```bash
php8.3 /var/www/html/server-ops/mtm-migration/mtm-verify-prerequisites-cli.php /path/to/vte/produzione
```

## 2. Import moduli (UI)

Impostazioni → **Module Manager** → Import, nell’ordine di `mtm-modules-order.txt`:

1. PacchettiOre → OrdiniPacchettiOre  
2. Sedi → Impianti  
3. Cantieri, Mezzi, Operatori, Lavori  
4. Interventi  
5. EventiMacchine  
6. ContrattiAssistenza, ScadenzeContratti, CorsiDiFormazione, AssegnazioneCorso  
7. Provasottoprocessi, Wpp  

Dopo ogni ZIP: verificare modulo nel menu e assenza errori in log PHP.

## 3. File e SQL aggiuntivi (SSH)

Copiare l’intera cartella `mtm-config-26` sul server produzione, poi:

```bash
export VTE_ROOT=/path/to/vte
export DB_NAME=nome_db
export DB_USER=utente
export DB_PASS='password'

bash /path/to/mtm-import-on-target.sh /path/to/mtm-config-26
```

**Nota:** gli ZIP moduli vanno importati dalla UI **prima** di `mtm-import-on-target.sh` (lo script gestisce branding, SQL, extra EventiMacchine, cache).

## 4. Cosa NON importare

- Dump completo DB `vte_dev_new`
- `config.inc.php` (site_URL, application_unique_key)
- Utenti/password da dev
- Integrazioni WPP / GoogleSyncPlus con URL `vtedev.mypantarei.net`
- Bypass licenza (`AuthControllerNoVTCH`, morphsuit)

## 5. Verifica post-migrazione

- [ ] Login: logo e sfondo MTM  
- [ ] Moduli MTM visibili (admin)  
- [ ] Creazione record vuoto: Cantieri, Mezzi, Interventi, EventiMacchine  
- [ ] DetailView senza pagina bianca (PHP 8.3)  
- [ ] `clear_sdk_cache` / reload php-fpm se anomalie SDK  
- [ ] Dati società e logo PDF corretti  

## Rollback

Ripristinare backup DB + file effettuato al passo 1.

## Supporto Pantarei

Script in [`/var/www/html/server-ops/mtm-migration/`](/var/www/html/server-ops/mtm-migration/).
