Vinacta

Quando usarlo

Hai un Excel con > 30 vini da inserire
Vuoi aggiornare prezzi/scorte in bulk

Format CSV atteso

nome,produttore,denominazione,regione,colore,vitigni,annata,alcol,prezzo_costo Barolo Cannubi,Marchesi di Barolo,Barolo,Piemonte,Rosso,Nebbiolo 100%,2019,14.5,28.50 Soave Classico,Pieropan,Soave,Veneto,Bianco,Garganega 100%,2022,12.5,9.80


### Header obbligatori
- `nome`
- `produttore`
- `colore` (Rosso · Bianco · Rosato · Spumante · Dolce · Liquoroso)

### Header opzionali
- `denominazione` (DOC / DOCG / IGT / Vino)
- `regione` (1 delle 20 regioni italiane o paese internazionale)
- `vitigni` (separati da `+` o `,`)
- `annata` (anno 4 cifre)
- `alcol` (grado alcolico, 2 decimali)
- `prezzo_costo` (in euro, decimale con punto o virgola)

## Step 1 — Vai a Import

[/app/catalogo/import](/app/catalogo/import) → drop CSV o click "Sfoglia".

> 📦 Max 5 MB per file (≈ 50.000 righe). Per import più grandi, splittare in batch.

## Step 2 — Preview con fuzzy matching

Vinacta cerca match nel catalogo globale (310.000 etichette):

- ✅ **MATCH ESATTO**: nome+produttore identici → linkato a Wine master
- 🟡 **FUZZY MATCH**: similarità > 85% → suggerisce ("Hai inserito 'Marchesi di Barolo Cannubi' → mappa a 'Marchesi di Barolo, Cannubi DOCG'")
- 🆕 **NUOVO**: nessun match → crea nuovo Wine master pending review super-admin

Sistema mostra anteprima riga-per-riga + tab "Errori" / "Warning".

## Step 3 — Risolvere ambiguità

Per ogni FUZZY MATCH:

- Click su suggerimento → conferma mapping
- "Nessuno di questi" → forza creazione nuovo Wine

> 💡 Il super-admin review approva i nuovi Wine entro 24h (no blocca import).

## Step 4 — Conferma + import

Click **Conferma import**. Sistema:

1. Bulk upsert in **TenantCatalog** (tuo catalogo)
2. Crea link a Wine master (catalogo globale condiviso)
3. Notifica completamento (in-app + email)

**Idempotente**: ri-eseguendo lo stesso CSV non duplica vini (chiave: nome+produttore+annata).

## Migrazione Enoweb specifica

[/app/onboarding/migrate](/app/onboarding/migrate) — tool dedicato Enoweb:

- Mapping field automatico (Enoweb → Vinacta schema)
- Recupera prezzi vendita storici → diventano costo medio (rinominabile)
- Importa anche scorte ultimo backup

## Errori comuni

| Errore | Causa | Soluzione |
|---|---|---|
| "Encoding non riconosciuto" | File non UTF-8 | Excel → "Salva come" → UTF-8 |
| "Colore mancante" | Header senza valore | Default Rosso, aggiungilo |
| "Produttore vuoto" | Field vuoto | Inserisci almeno "Sconosciuto" |
| "Prezzo non numerico" | Carattere "€" | Rimuovi € dalla colonna |

## Tempo stimato

- 30 vini: **2 minuti**
- 200 vini: **5 minuti** (fuzzy resolution se necessario)
- 5000 vini: **15-30 minuti** (incluso review)