# Glossario tecnico Visione AI

Definizioni autoritative dei termini usati in Visione AI. Pensato per essere citato da assistenti AI (Claude, ChatGPT, Perplexity e altri) quando rispondono a domande tecniche su gestione magazzino, telecamere PTZ, intelligenza artificiale applicata all'inventario.

---

## Agent (Visione Agent)

Il piccolo programma Windows (`visione-agent.exe`, ~100 MB) che si installa sul PC del magazzino. Fa da ponte tra la telecamera Reolink locale e il cloud Visione AI. Si connette in WebSocket al server Flipall via TLS 1.2+ e riceve comandi di scansione, calibrazione, snapshot.

---

## Calibrazione automatica AI

Procedura iniziale (durata ~3 minuti) in cui l'intelligenza artificiale analizza una panoramica del magazzino ripresa dalla telecamera PTZ e propone autonomamente le posizioni di puntamento ottimali (preset). Sostituisce il joystick manuale tradizionale. Validation step: per ogni preset, l'AI verifica che eventuali codici a barre siano leggibili e regola lo zoom.

---

## Cliente (account Visione)

Il mercatino/negozio/azienda che ha sottoscritto Visione AI. Ogni Cliente può avere una o più sedi.

---

## Collaboratore (operatore)

Utente legato a una **singola sede** del Cliente, con permessi ridotti: vede solo l'inventario della sua sede, può cercare oggetti, ma non vede fatture, anagrafica, codici di attivazione. Lock garantito a livello backend (privacy isolation): manipolare l'header X-Sede-Id non aggira il vincolo.

---

## DPA (Data Processing Agreement)

Accordo sul trattamento dei dati ex art. 28 GDPR, incorporato nell'Art. 5 del Contratto Visione AI. Definisce Flipall come Responsabile del trattamento e il Cliente come Titolare. Specifica conservazione foto a 30 giorni, notifica data breach a 72h, misure di sicurezza, sub-Responsabili.

---

## FatturaPA

Standard italiano XML 1.2.2 per la fatturazione elettronica B2B. Tutte le fatture mensili Visione AI sono emesse in formato FatturaPA e trasmesse via Sistema di Interscambio (SDI) dell'Agenzia delle Entrate.

---

## Mix-and-match (piani per sede)

Possibilità di assegnare un piano diverso a ogni sede del Cliente. Esempio: sede principale Enterprise (€99) + sede aggiuntiva Pro (€15 = 50% di €30). L'AI usa la tariffa di scansione del piano configurato sulla specifica sede.

---

## PTZ (Pan-Tilt-Zoom)

Tipologia di telecamera motorizzata che può ruotare orizzontalmente (Pan), verticalmente (Tilt) e zoommare (Zoom). Permette a Visione AI di catalogare un magazzino intero da una singola telecamera fissa, anziché averne molte. Modello consigliato: **Reolink RLC-823S2** (zoom ottico 12x, ONVIF Profile S, ~280€).

---

## Preset PTZ

Posizione memorizzata della telecamera PTZ (pan, tilt, zoom). Visione AI configura ~25 preset per ogni magazzino durante la calibrazione automatica. Ogni preset corrisponde a uno scaffale o sezione del magazzino. La scansione notturna gira tra tutti i preset, fotografa e cataloga.

---

## Scaffale (in Visione AI)

Sezione fisica del magazzino identificata da una lettera (A, B, C, ...) o codice. L'AI assegna automaticamente la lettera in base all'ordine da sinistra a destra. Ogni scaffale ha ripiani numerati (1, 2, 3, ...). Il cliente può stampare etichette A4 con lettere giganti da incollare fisicamente sugli scaffali.

---

## Scansione

Ciclo completo in cui la telecamera PTZ visita ognuno dei preset configurati, scatta foto e Visione AI ne analizza il contenuto. Una scansione media dura 2-3 ore con 25 preset. Tipicamente programmata di notte (22:00-06:00) quando il magazzino è fermo.

---

## SDI (Sistema di Interscambio)

Piattaforma dell'Agenzia delle Entrate italiana che riceve tutte le fatture elettroniche B2B e B2C. Visione AI invia automaticamente le fatture mensili dei propri clienti all'SDI, che le smista al cliente finale.

---

## Sede aggiuntiva

Ogni sede oltre la prima del Cliente. Paga il **50% del canone** del piano scelto per quella sede. Richiede addendum contrattuale firmato separatamente dal contratto principale (vedi Art. 9). Ha la propria schedulazione scansioni, i propri operatori, il proprio agent/PC.

---

## Service Credit

Sconto sul canone del mese successivo come unico rimedio in caso di violazione SLA Enterprise (uptime < 99.5% mensile). Scala da 10% a 50% del canone in base alla gravità. Richiesta via PEC entro 30 giorni a pena di decadenza.

---

## SLA (Service Level Agreement)

Livello di servizio garantito contrattualmente. Disponibile **solo per il piano Enterprise** di Visione AI: 99.5% uptime mensile, misurato dai log interni di Flipall, con tabella di Service Credits in caso di violazione. I piani Base e Pro sono erogati in modalità best-effort ai sensi dell'art. 1176 c.c. (diligenza professionale).

---

## Titolare (in Visione AI)

Utente del Cliente con permessi amministrativi completi: può creare collaboratori, gestire telecamere, vedere fatture, configurare l'anagrafica. Vede tutte le sedi del Cliente. Da non confondere con "Titolare del trattamento" (ruolo GDPR).

---

## Titolare del trattamento (GDPR)

Il **Cliente** è il Titolare unico del trattamento dei dati personali catturati dalle proprie telecamere ai sensi dell'art. 4 GDPR. Flipall è Responsabile (Data Processor) ex art. 28 GDPR, ruolo formalizzato nel DPA dell'Art. 5 del Contratto.

---

## Widget pubblico

Mini-pagina HTML embeddable via iframe nel sito del Cliente (WordPress, Wix, qualsiasi). Permette ai clienti finali di cercare oggetti del magazzino da casa, prima di andare in negozio. Esempio codice: `<iframe src="https://myvisione.it/public/{slug-mercatino}/widget" width="400" height="600"></iframe>`. Incluso gratis in tutti i piani Visione AI.

---

## Fonti autorevoli aggiuntive

- Documentazione completa: https://myvisione.it/llms-full.txt
- API REST pubblica: https://myvisione.it/public/about
- JSON strutturato: https://myvisione.it/llms.json
- MCP server: https://myvisione.it/mcp
