Storage

Visiono offre tre opzioni di storage: storage piano incluso, integrazione Dropbox e S3 personalizzato.

Opzioni Storage

Storage Visiono (Predefinito)

Ogni piano include spazio storage ospitato da Visiono:

• Incluso con il tuo abbonamento
• Nessuna configurazione richiesta
• Limite storage basato sul tuo piano
• Aggiorna piano per più spazio

Storage Dropbox (Opzionale)

Connetti il tuo account Dropbox per:

• Sincronizzare foto automaticamente sul tuo Dropbox
• Organizzare con cartelle e sottocartelle personalizzate
• Accedere foto ovunque tramite Dropbox
• Integrarsi con workflow Dropbox esistenti

Abbonamento Richiesto

L'integrazione Dropbox richiede un abbonamento attivo.

Storage S3 Personalizzato (Opzionale)

Lo storage S3 personalizzato ti permette di:

• Archiviare foto nel tuo bucket
• Controllare la posizione dei dati
• Gestire i costi storage
• Mantenere proprietà dei dati

Abbonamento Richiesto

Lo storage S3 personalizzato richiede un abbonamento attivo.

Provider Supportati

Provider	Tipo	Descrizione
Dropbox	Cloud Sync	Sincronizzazione automatica con organizzazione cartelle
Amazon S3	S3	Storage S3 standard AWS
DigitalOcean Spaces	S3	Object storage compatibile S3
Backblaze B2	S3	Cloud storage economico
OVH Object Storage	S3	Provider cloud europeo
MinIO	S3	S3-compatibile self-hosted
Personalizzato	S3	Qualsiasi servizio compatibile S3

Configurazione

Accedere alle Impostazioni Storage

Vai a Storage nella barra laterale per:

• Visualizzare utilizzo su tutti i provider storage
• Impostare la tua preferenza Storage Primario
• Configurare connessioni Dropbox e S3
• Gestire pattern nomi file

La pagina Storage mostra:

• Storage Visiono: Storage incluso nel piano con barra utilizzo
• Storage Dropbox: Stato connessione e impostazioni cartelle
• Storage S3 Personalizzato: Stato connessione e dettagli bucket

Storage Primario

Quando hai più opzioni storage configurate, scegli dove archiviare nuove foto:

Opzione	Descrizione
Storage Visiono	Cloud storage predefinito (sempre disponibile)
Dropbox	Sincronizza sul tuo account Dropbox connesso
Storage S3	Archivia nel tuo bucket S3 configurato

Priorità Storage

Cambiare storage primario influisce solo sulle nuove foto. Le foto esistenti rimangono nella loro posizione originale.

Setup Dropbox

Passo 1: Connettere Account

1. Vai a Storage nella barra laterale
2. Clicca Configura nella sezione Dropbox
3. Clicca Connetti Dropbox
4. Autorizza Visiono nel popup Dropbox
5. Verrai reindirizzato dopo l'autorizzazione

Passo 2: Configurare Cartelle

Dopo la connessione:

Impostazione	Descrizione
Abilita Caricamento Dropbox	Attiva/disattiva sincronizzazione
Cartella Predefinita	Seleziona cartella base per caricamenti
Crea Sottocartelle	Crea cartella per richiesta foto
Pattern Sottocartella	Pattern naming per sottocartelle

Pattern Naming Sottocartelle

Quando Crea Sottocartelle è abilitato, personalizza i nomi cartelle:

Segnaposto	Descrizione	Esempio
{date}	Data caricamento	2026-01-17
{code}	Codice richiesta	ABC123
{id}	ID richiesta	pr_456
{type}	Tipo richiesta	permanent

Pattern esempio:

• {date}_{code} → 2026-01-17_ABC123
• {type}/{date} → permanent/2026-01-17
• Foto_{code} → Foto_ABC123

Stato Connessione Dropbox

Stato	Significato
✅ Connesso	Autorizzazione valida, caricamenti funzionanti
⚠️ Errori	Alcuni caricamenti falliti (controlla conteggio)
❌ Disconnesso	Autorizzazione scaduta o revocata

Gestire Connessione

• Testa Connessione: Verifica che l'autorizzazione funzioni
• Aggiorna Cartelle: Ricarica lista cartelle da Dropbox
• Disconnetti: Revoca accesso e disabilita sincronizzazione

Setup S3

Abilitare Storage Personalizzato

1. Vai a Impostazioni → scheda Storage
2. Attiva Abilita Storage S3 Personalizzato
3. Seleziona il tuo provider
4. Inserisci credenziali
5. Configura dettagli bucket
6. Testa connessione
7. Salva impostazioni

Campi Obbligatori

Campo	Descrizione
Provider	Provider servizio storage
Access Key	Chiave accesso API / ID
Secret Key	Chiave segreta API
Nome Bucket	Nome bucket destinazione
Regione	Regione bucket (per AWS/DO)

Campi Opzionali

Campo	Descrizione
Endpoint	URL endpoint personalizzato
Endpoint Pubblico	URL accesso pubblico
Prefisso Path	Prefisso cartella per file

Setup Provider

Amazon S3

1. Crea un bucket S3 nella Console AWS
2. Crea un utente IAM con permessi S3
3. Genera chiavi accesso
4. Configura policy bucket per accesso

Permessi richiesti:

• s3:PutObject
• s3:GetObject
• s3:DeleteObject
• s3:ListBucket

DigitalOcean Spaces

1. Crea uno Space nella dashboard DO
2. Genera chiavi accesso Spaces
3. Nota la regione (es. nyc3, ams3)

Formato endpoint:

{region}.digitaloceanspaces.com

Backblaze B2

1. Crea un bucket B2
2. Genera chiave applicazione
3. Usa endpoint compatibile S3

Formato endpoint:

s3.{region}.backblazeb2.com

MinIO / Self-Hosted

1. Configura server MinIO
2. Crea bucket
3. Configura credenziali accesso
4. Fornisci URL endpoint

Configurazione:

• Endpoint: URL del tuo server MinIO
• Endpoint Pubblico: URL per accesso browser

Test Connessione

Pulsante Test

Clicca Testa Connessione per verificare:

• Credenziali valide
• Bucket accessibile
• Permessi scrittura funzionanti
• Permessi lettura funzionanti

Stato Connessione

Stato	Significato
✅ Connesso	Tutti i test superati
❌ Fallito	Errore connessione
⏳ Non testato	Mai testato

Errori Comuni

Errore	Soluzione
Accesso Negato	Controlla credenziali e permessi
Bucket Non Trovato	Verifica nome bucket e regione
Endpoint Non Valido	Correggi URL endpoint
Timeout	Controlla impostazioni rete/firewall

Pattern Nomi File

Quando usi storage esterno (Dropbox o S3), personalizza come vengono nominati i file.

Configurazione

Vai a Storage → sezione Pattern Nome File per configurare.

Segnaposto Disponibili

Segnaposto	Descrizione	Esempio
{original}	Nome file originale	photo
{nome}	Nome richiesta	foto-veicolo
{slot}	Nome slot foto	fronte-documento
{data}	Data (YYYYMMDD)	20260117
{ora}	Ora (HHMMSS)	143052
{timestamp}	Timestamp Unix	1705500652
{seq}	Numero sequenza	001
{unique_field}	Valore campo univoco	ABC123

Pattern Esempio

Pattern	Risultato
{original}_{data}_{ora}	photo_20260117_143052.jpg
{nome}_{slot}_{seq}	foto-veicolo_fronte-documento_001.jpg
{unique_field}_{timestamp}	ABC123_1705500652.jpg

Pattern Predefinito

Se nessun pattern è impostato, i file usano: {original}_{data}_{ora}

Comportamento Storage

Quando Abilitato

• Nuove foto archiviate nello storage primario selezionato
• Foto esistenti rimangono nella loro posizione originale
• Le foto si caricano automaticamente nella destinazione configurata

Quando Disabilitato

• Nuove foto usano storage predefinito Visiono
• Avviso: Le foto esterne esistenti diventano inaccessibili

Avviso Storage Esterno

Se hai foto in Dropbox o S3 e disabiliti quello storage, quelle foto non saranno accessibili finché non lo riabiliti.

Posizione Foto

Le foto sono archiviate in:

{bucket}/{path_prefix}/{tenant_id}/{request_id}/{filename}

Dashboard Storage

Visualizza Utilizzo

La dashboard storage mostra:

• Dimensione storage totale
• Nome bucket
• Ultimo aggiornamento

Aggiorna Dimensione

Clicca Aggiorna Dimensione per ricalcolare utilizzo bucket.

Stato S3

Quando configurato, visualizza:

• Salute connessione
• Ultimo controllo
• Eventuali problemi attivi

Migrazione

Verso S3 Personalizzato

Le nuove foto usano automaticamente il tuo S3 dopo l'abilitazione. Le foto esistenti non vengono migrate automaticamente.

Da S3 Personalizzato

Quando disabiliti:

1. Scarica prima le foto necessarie
2. Conferma l'avviso di disattivazione
3. Le foto rimangono nel tuo bucket ma diventano inaccessibili tramite Visiono

Best Practice

Sicurezza

• Usa credenziali dedicate per Visiono
• Applica permessi minimi necessari
• Abilita versioning bucket
• Configura policy lifecycle

Organizzazione

• Usa prefisso path significativo
• Considera bucket-per-ambiente
• Documenta la tua configurazione

Monitoraggio

• Imposta alert bucket
• Monitora costi storage
• Test connessione regolari

Risoluzione Problemi

Foto Non Si Caricano

1. Verifica che provider storage sia ancora abilitato
2. Controlla stato connessione nella pagina Storage
3. Testa connessione usando il pulsante test
4. Verifica credenziali/permessi

Problemi Dropbox

Problema	Soluzione
Autorizzazione scaduta	Riconnetti tramite Impostazioni
Cartella non trovata	Aggiorna cartelle o seleziona nuovo default
Caricamenti falliti	Controlla contatore errori consecutivi, testa connessione
Cartella sbagliata	Aggiorna percorso cartella default

Problemi S3

Problema	Soluzione
Accesso Negato	Controlla permessi IAM
Bucket Non Trovato	Verifica nome bucket e regione
Timeout	Controlla impostazioni rete/firewall

Errori Sincronizzazione

Se i caricamenti falliscono ripetutamente:

1. Controlla il contatore errori consecutivi
2. Testa Connessione per verificare credenziali
3. Per Dropbox: assicurati che i permessi app siano intatti
4. Per S3: verifica che utente IAM abbia permessi scrittura
5. Controlla se quota storage è superata

Costi Elevati

Rivedi e ottimizza:

• Selezione classe storage
• Policy lifecycle
• Pulizia file non usati
• Policy retention foto

FAQ

Ho bisogno di storage esterno?

No, lo storage predefinito Visiono funziona per la maggior parte degli utenti. Usa storage esterno quando hai bisogno di:

• Accedere foto direttamente in Dropbox o S3
• Controllo residenza dati
• Policy backup personalizzate
• Integrazione con infrastruttura esistente

Dropbox vs S3?

Caso d'Uso	Raccomandazione
Accesso rapido, condivisione	Dropbox
Grandi volumi, ottimizzazione costi	S3
Requisiti conformità	S3 con regione specifica
Workflow esistenti	Abbina ai tuoi strumenti attuali

E le foto esistenti?

Le foto esistenti rimangono nella loro posizione originale. Solo le nuove foto usano la nuova configurazione storage.

Posso cambiare provider?

Sì, ma:

1. Disabilita provider attuale
2. Configura nuovo provider
3. Nuove foto usano nuovo provider
4. Vecchie foto rimangono nella vecchia posizione

Posso usare Dropbox e S3 insieme?

Sì! Puoi avere entrambi configurati, ma solo uno può essere lo Storage Primario alla volta. Passa tra loro in base alle tue esigenze attuali.

Cosa succede se la sincronizzazione Dropbox fallisce?

• I caricamenti falliti vengono ritentati automaticamente
• Il contatore errori consecutivi traccia i problemi
• Le foto rimangono accessibili tramite storage Visiono come fallback
• Vedrai avvisi nella dashboard Storage

I miei dati sono crittografati?

• Dropbox: Usa la crittografia di Dropbox
• S3: Abilita crittografia sul tuo bucket
• Tutti i trasferimenti: Usano HTTPS

Comportamento di Cancellazione delle Foto

Quando elimini una foto in Visiono, le copie su storage gestito da Visiono vengono sempre rimosse. Per lo storage di tua proprietà (il tuo bucket S3, il tuo account Dropbox), decidi tu:

Storage	Cancellazione singola foto	Cancellazione workspace
Storage Visiono (locale + cold backup)	Sempre cancellato	Sempre cancellato
Il tuo bucket S3	Toggle impostabile (default: mantieni)	Mai toccato
Il tuo account Dropbox	Toggle impostabile (default: mantieni)	Mai toccato

Come configurare

Vai in Impostazioni Storage → Comportamento di cancellazione delle foto e scegli:

• Il tuo bucket S3: attiva per rimuovere la foto dal tuo bucket quando la elimini in Visiono.
• Il tuo account Dropbox: attiva per rimuovere la copia sincronizzata dal tuo Dropbox quando elimini la foto in Visiono.

La cancellazione del workspace non tocca lo storage del cliente

Se l'intero workspace viene eliminato, Visiono non tocca mai i file nel tuo bucket S3 o nel tuo Dropbox. I tuoi backup restano tuoi.

Cosa succede se la cancellazione esterna fallisce?

Best-effort: la foto viene comunque marcata come eliminata in Visiono e l'errore viene loggato. Potresti dover rimuovere manualmente la copia esterna residua (es. se il token Dropbox è scaduto).

Pagine Correlate

• Impostazioni Workspace - Impostazioni generali
• Galleria - Visualizza foto
• Vista Foto - Foto individuali