Home → Manuale d'uso

Manuale Utente Iridai

Versione App: 0.3.0 Ultimo aggiornamento: 11 maggio 2026 Lingua: Italiano

Iridai è il tuo assistente AI da campo per verifiche CE, audit di sicurezza, sopralluoghi industriali — pensato per ingegneri consulenti che indossano Ray-Ban Meta o usano l'iPhone.

Indice

1. Cos'è Iridai
2. Requisiti
3. Prima installazione
4. Onboarding guidato
5. La schermata principale
6. I quattro pulsanti rapidi
7. Il sopralluogo
8. Comandi vocali e wake word
9. Il tap della stanghetta Ray-Ban Meta
10. Impostazioni — guida sezione per sezione
11. Modelli AI cloud e locali
12. Contesti e prompt personalizzati
13. Personas
14. Modalità di attivazione
15. Funzioni agentiche avanzate
16. Integrazioni esterne
17. Generazione PDF e condivisione verbali
18. Privacy e modello locale (zero-cloud)
19. Risoluzione problemi
20. Domande frequenti
21. Sicurezza e responsabilità
22. Glossario
23. Contatti e supporto

1. Cos'è Iridai

Iridai è un'app iOS professionale che usa l'intelligenza artificiale per aiutarti durante:

• Verifiche di marcatura CE delle macchine industriali (Direttiva Macchine 2006/42/CE, EN ISO 13857, EN ISO 13854, EN 60204-1, ecc.).
• Audit di sicurezza sul lavoro (D.Lgs. 81/08, accordi Stato-Regioni, DPI, ATEX, ecc.).
• Manutenzione 4.0 (interconnessione, cybersecurity OT, MES/ERP).
• Sopralluoghi specialistici (rischio chimico, impianti elettrici, scenari security, identificazione armi, tabaccheria, ecc. — tutto personalizzabile).

Lavora in due modalità:

• A mani libere con Ray-Ban Meta: scatti foto con un tap sulla stanghetta, l'AI analizza, ti risponde via TTS in cuffia.
• Con il solo iPhone: pulsanti grandi sullo schermo, fotocamera dell'iPhone come fallback automatico.

Ogni analisi può produrre non conformità (NC) categorizzate per severità che vengono raccolte in un sopralluogo e impaginate automaticamente in un PDF tecnico professionale con riferimenti normativi, foto allegate, distanze di sicurezza calcolate.

2. Requisiti

2.1 Cosa serve assolutamente

• iPhone con iOS 17 o successivo.
• Account Apple ID (per scaricare l'app via TestFlight o App Store).
• Almeno una chiave API verso un provider AI cloud (Anthropic Claude consigliato per qualità) oppure dispositivo compatibile per il modello AI locale (almeno 4.5 GB di RAM, quindi iPhone 13+).

2.2 Cosa è consigliato ma opzionale

• Occhiali Ray-Ban Meta Gen 2 o successivi (l'app fa fallback automatico sulla camera dell'iPhone se non sono connessi).
• WiFi per i primi download (modello locale ~1.5-7 GB).
• Connessione dati 4G/5G sul campo per analisi cloud.

2.3 Abbonamento Iridai Pro Mensile

L'accesso alle funzionalità AI di Iridai richiede l'abbonamento auto-rinnovabile "Iridai Pro Mensile" disponibile come acquisto in-app:

• Prezzo: € 9,90 al mese (IVA inclusa ove applicabile)
• Prova gratuita: 3 giorni per nuovi utenti idonei (durata minima supportata da Apple StoreKit per gli intro offer)
• Rinnovo: automatico ogni mese, cancellabile in qualsiasi momento dalle Impostazioni iOS → Apple ID → Abbonamenti almeno 24 ore prima della scadenza
• Family Sharing: condivisibile con i membri del tuo Family Group Apple
• Ripristino: dopo reinstallazione o cambio dispositivo, il pulsante "Ripristina acquisti" in app rinnova l'accesso

L'abbonamento è gestito interamente da Apple (Apple Distribution International Ltd.): RAVENG non riceve né tratta i tuoi dati di pagamento.

2.4 Chiavi API dei Provider AI (opzionali, costi separati)

L'abbonamento Iridai Pro non include le chiamate ai Provider AI cloud. Se vuoi usare i modelli cloud, ti serve una chiave API personale verso il provider scelto (i costi delle API si aggiungono al canone mensile dell'abbonamento). Alternativa zero-costo: usa il modello locale MLX scaricabile dall'app.

💡 Suggerimento: comincia con Anthropic Claude (qualità migliore per analisi tecnica italiana), Google Gemini Flash (più economico) oppure il modello locale MLX (zero costi ricorrenti dopo il download).

3. Prima installazione

3.1 Da TestFlight (beta)

1. Apri sul tuo iPhone il link TestFlight che hai ricevuto (es. https://testflight.apple.com/join/xxxxxxxx).
2. Tocca "Installa" (se non hai TestFlight, l'iPhone ti indirizza ad App Store per scaricarla — è di Apple, gratuita).
3. Aspetta che Iridai compaia sulla home screen (icona viola/blu con simbolo otturatore + AI).
4. Tocca l'icona per aprirla.

3.2 Da App Store (quando sarà pubblicata)

1. Apri App Store sull'iPhone.
2. Cerca "Iridai".
3. Tocca "Ottieni" → autenticati con Face ID / Touch ID / password Apple ID.
4. Apri Iridai dalla home screen.

3.3 Cosa succede al primo avvio

Al primo lancio parte automaticamente l'onboarding guidato in 8 step. Non chiudere l'app durante l'onboarding: ogni step ha un pulsante grande "Continua" o un'azione specifica che lo conclude.

4. Onboarding guidato (otto step)

L'onboarding è progettato per essere a prova di errore: ogni step ha sfondo gradiente diverso e progress dot in alto. Non puoi saltare passi senza una scelta esplicita.

Step 1 · Benvenuto

Vedi il logo Iridai animato (entra con scala + glow blu/viola). Spiega in due righe cosa fa l'app.

✋ Cosa fare: leggi e tocca "Inizia".

Step 2 · Cosa puoi fare

Lista delle funzionalità chiave: verifiche CE, audit sicurezza, sopralluoghi, generazione PDF.

✋ Cosa fare: tocca "Continua".

Step 3 · Permessi iOS

Iridai chiede uno per uno i permessi che gli servono, con spiegazione del perché. Approva tutti per esperienza completa, ma puoi anche rifiutarne alcuni:

✋ Cosa fare: tocca "Concedi" per ciascuno; sblocca col Face ID se richiesto.

Step 4 · Chiave API Anthropic

Iridai ti chiede di inserire una chiave API. Anthropic è il default consigliato ma puoi mettere anche OpenAI o Gemini in seguito dalle Impostazioni.

✋ Cosa fare:

1. Apri Safari sull'iPhone (non chiudere Iridai, vai in background).
2. Vai su https://console.anthropic.com.
3. Crea account / accedi.
4. Sezione "API Keys" → "Create Key".
5. Copia la chiave (comincia con sk-ant-).
6. Torna in Iridai, incolla nel campo, tocca "Salva".
7. Iridai cercherà di scaricare la lista modelli disponibili: vedrai un menu a tendina con tutti i Claude disponibili → scegli Claude Opus 4.7 (massima qualità) o Sonnet 4.6 (più economico).

💡 Puoi anche saltare questo step: ti verrà ricordato in Impostazioni. Ma senza nessuna chiave né modello locale, l'app non potrà fare analisi AI.

Step 5 · Pairing occhiali Ray-Ban Meta

✋ Cosa fare:

1. Indossa gli occhiali e accendili.
2. Apri l'app Meta AI sull'iPhone e accedi al tuo account Meta.
3. Verifica che gli occhiali siano connessi in Meta AI.
4. Torna in Iridai e tocca "Avvia pairing".
5. L'iPhone passa brevemente all'app Meta AI per autorizzare l'accesso camera, poi torna in Iridai.
6. Vedrai "Connesso" nel banner in alto.

⚠️ Se non hai gli occhiali: tocca "Salta". Iridai userà la camera dell'iPhone come fallback automatico. Tutte le funzioni AI funzionano comunque.

Step 6 · Modello AI locale (opzionale)

Se il tuo iPhone ha almeno 4.5 GB di RAM (iPhone 13+), Iridai ti propone di scaricare un modello AI on-device che funziona offline, senza cloud, senza costi API.

✋ Cosa fare:

• "Più tardi": salta, lo scarichi quando vuoi da Impostazioni → Modelli AI → Modelli locali.
• "Vado a scaricarlo dalle Impostazioni": salta lo step + memo per dopo.

💡 Se vuoi farlo subito (consigliato per privacy massima): salta lo step, vai in Impostazioni e segui §11.2.

Step 7 · Tour dei quick action

Mostra in animazione i 4 pulsanti della home + il pulsante grande "Premi per parlare". Puoi tornarci dalle Impostazioni se vuoi rivederlo.

✋ Cosa fare: tocca "Continua".

Step 8 · Pronto!

Schermata di celebrazione con confetti animati. Iridai è ora configurato.

✋ Cosa fare: tocca "Inizia a usare Iridai" → si apre la schermata principale.

5. La schermata principale

Aprila e guarda dall'alto verso il basso. Tutto è progettato per essere leggibile a colpo d'occhio anche col sole forte sullo schermo:

┌─────────────────────────────────────────┐
│ [iridai mini-icon]      [gear ⚙]         │  ← toolbar
│                                          │
│ 👓 Connesso          Iride · Pronto      │  ← banner connessione + persona
│                                          │
│ [⚠ Sopralluogo attivo: …  3 NC  Chiudi] │  ← banner sopralluogo (solo se aperto)
│                                          │
│ ● PRONTO                                  │  ← chip status (sotto)
│                                          │
│   Risposta dell'AI compare qui in        │
│   font grande, leggibile, scrollabile    │  ← area risposta (riempie schermo)
│                                          │
│ ──────────────────────────────────       │  ← progress bar WOW (visibile in elaborazione)
│                                          │
│ [Descrivi] [Analisi CE] [Sicurezza] [4°] │  ← quick action row
│                                          │
│ [🎤  Premi per parlare]   [📂 Sopralluoghi]│  ← bottone grande + apri storico
└─────────────────────────────────────────┘

5.1 Toolbar (icone in alto)

• In alto a sinistra · Mini icona Iridai: non fa nulla al tap, è solo branding. Long-press 0.6s: apre il pannello Debug nascosto (utile per troubleshooting — vedi §19).
• In alto a destra · Ingranaggio: apre Impostazioni.

5.2 Banner connessione

Mostra lo stato BT degli occhiali. Stati possibili:

Se "Non connesso" → vedi un pulsante "Pair" che apre Meta AI per il pairing.

A destra: l'icona della Persona attiva (Iride di default).

5.3 Banner sopralluogo attivo

Visibile solo quando hai un sopralluogo aperto. Mostra:

• Icona del dominio (ce-mark, scudo sicurezza, ingranaggi I40).
• Titolo del sopralluogo + ID leggibile (es. "VCE-2026-05-11-1430").
• Contatori contestuali (NC + macchine se applicabile).
• Pulsante ❌ rosso (Annulla — distruttivo, con conferma) e "Chiudi" arancione (salva PDF).

5.4 Chip status

Riga sottile sotto il banner che ti dice cosa sta facendo l'app in questo momento:

5.5 Area risposta

Riempie tutto lo spazio centrale dello schermo. Il testo della risposta AI compare qui con font grande (.title3) e spaziatura aerata. Scrolla con il dito se la risposta è lunga.

Quando non c'è risposta vedi un hint discreto: ✨ "Le risposte appariranno qui".

5.6 Progress bar WOW

Striscia colorata che si anima durante l'elaborazione, mostra le fasi:

1. Acquisizione foto (giallo)
2. Attesa shutter occhiali / iPhone (arancione)
3. Invio al modello AI (azzurro)
4. Generazione TTS (verde)

Non è interattiva — è solo per farti capire a che punto è il lavoro.

5.7 Quick action row

Quattro pulsanti grandi sempre disponibili (dettaglio §6).

5.8 Pulsante "Premi per parlare" + storico

• Pulsante grande blu/rosso in basso: comando voce + stop di tutto (vedi §8.3).
• Pulsante quadrato arancione sulla destra: apre la lista dei sopralluoghi (correnti + storico chiusi).

6. I quattro pulsanti rapidi

Sono scorciatoie one-tap alle analisi più frequenti. Ognuno fa lo stesso flusso: scatto foto → AI → NC nel sopralluogo → riassunto vocale.

6.1 👁 Descrivi

Cosa vedi? Risposta breve 2-3 frasi.

L'analisi più rapida e generica. Non apre un sopralluogo, dà solo una descrizione concisa di quello che inquadri.

Quando usarlo: vuoi sapere "che cos'è questa cosa?" senza creare un verbale.

6.2 ✅ Analisi CE

Verifica conformità marcatura CE / Direttiva Macchine.

Analizza la foto come fosse una macchina o componente da verificare ex 2006/42/CE. Cerca:

• Marcatura CE presente / leggibile
• Dichiarazione di conformità (DoC)
• Manuale d'uso in italiano
• Ripari mobili / interblocchi (EN ISO 14119)
• Distanze di sicurezza (EN ISO 13857 / EN ISO 13854)
• Comandi e arresti di emergenza (EN ISO 13850, EN 60204-1)
• Marcature di sicurezza (EN ISO 7010)
• Tutela acustica (EN ISO 11688)

🎯 Caratteristica killer: se metti un oggetto di riferimento (carta di credito 85.6×54 mm, biglietto da visita, monete, righelli) accanto a un'apertura del riparo, l'AI stima le dimensioni in mm, classifica la forma dell'apertura e applica le tabelle EN ISO 13857 / EN ISO 13854 per calcolare la distanza minima di sicurezza richiesta.

Output: NC categorizzata per severità (critica / maggiore / minore / osservazione) con riferimenti normativi precisi e tabelle.

6.3 🛡 Audit Sicurezza

Audit di sicurezza sul lavoro D.Lgs. 81/08.

Analizza l'ambiente / situazione / documentazione cercando rischi:

• DPI obbligatori e loro stato (UNI ISO 45001, Reg. UE 2016/425)
• Segnaletica EN ISO 7010
• Vie di fuga, antincendio (DM 03/08/2015)
• Rischio caduta dall'alto, schiacciamento, scivolamento
• Rischio chimico (REACH/CLP)
• Rischio elettrico (DPR 462/01)
• Formazione e addestramento (Accordi Stato-Regioni)
• DVR / POS / PSC presenti

6.4 4° pulsante personalizzabile

Per default mostra "Industria 4.0" ma puoi cambiarlo dal long-press (apre un menu con tutti i contesti disponibili). Contesti built-in disponibili:

Tap singolo sul pulsante → esegue il contesto correntemente selezionato. Long press → menu di scelta tra tutti i 6+.

💡 Puoi creare contesti custom in Impostazioni → Contesti personalizzabili (vedi §12).

7. Il sopralluogo (il cuore dell'applicazione)

Un sopralluogo è una sessione di lavoro che raccoglie tutte le NC scattate durante l'analisi di un sito o macchina.

7.1 Come si apre

Si apre automaticamente la prima volta che premi un pulsante CE / Sicurezza / contesto. Non devi fare nulla di esplicito.

Il sopralluogo è identificato da un ID leggibile del tipo:

• VCE-2026-05-11-1430 per verifiche CE
• SAFE-2026-05-11-1430 per audit sicurezza
• M40-2026-05-11-1430 per manutenzione 4.0

7.2 Cosa contiene

7.3 Aggiungere NC al sopralluogo

Ogni volta che premi un pulsante AI (CE / Sicurezza / contesto) mentre il sopralluogo è già aperto, la nuova NC viene aggiunta al sopralluogo corrente. Il sopralluogo continua a crescere finché non lo chiudi o annulli.

7.4 Workflow tipico (consigliato)

1. Arrivi sul cantiere/azienda cliente.
2. Premi "Analisi CE" sulla prima macchina → si apre il sopralluogo VCE-….
3. Cammini, premi "Analisi CE" su ogni macchina che vedi → si aggiungono NC.
4. Eventualmente premi anche "Sicurezza" per rischi generali del sito (le NC vanno in un sopralluogo separato SAFE-… perché il dominio è diverso).
5. A fine giornata, tap "Chiudi" sul banner del sopralluogo → genera PDF + Markdown.
6. Tap sul pulsante 📂 quadrato in basso a destra → apri la lista sopralluoghi → seleziona quello chiuso → "Condividi PDF" → invia via Mail/AirDrop/WhatsApp al cliente.

7.5 Sopralluogo: "Chiudi" vs "Annulla"

Sul banner del sopralluogo attivo trovi due pulsanti:

• ❌ Annulla (rosso, icona X): distruttivo. Cancella foto, NC, e cartella del sopralluogo. Mostra una conferma:

  "Annullare il sopralluogo? Tutte le foto, le NC e i dati raccolti finora verranno cancellati definitivamente. L'app torna allo stato iniziale senza salvare il sopralluogo né elaborare nulla."

  Tap "Annulla sopralluogo" (rosso) per confermare, "Mantieni" per tornare indietro.

• "Chiudi" (arancione): conservativo. Salva il sopralluogo come chiuso, genera verbale.md + verbale.pdf nella cartella del sopralluogo. Resta visibile nello storico (Impostazioni → Sopralluoghi).

💡 Nota importante: un sopralluogo chiuso si può riaprire dal menu Sopralluoghi → tap sul sopralluogo → "Riapri".

7.6 Storico sopralluoghi

Accessibile in due modi:

• Pulsante 📂 quadrato in basso a destra della home.
• Impostazioni → Sopralluoghi → Storico e in corso.

Lista divisa in "In corso" (max 1 attivo per volta) e "Storico" (chiusi).

Tap su un sopralluogo → vedi dettaglio con:

• Riepilogo (ID, cliente, date, GPS)
• Lista NC con severità color-coded
• Lista macchine ispezionate (se applicabile)
• Sezione Verbale: pulsanti "Anteprima PDF", "Condividi PDF", "Condividi Markdown".

8. Comandi vocali e wake word

Tre modi per parlare con Iridai:

8.1 Wake word "hey iridai"

Configurabile (default: "hey iridai" — funzionano anche "ciao iridai" e "ehi iridai").

Mentre l'app è aperta (o in background se hai attivato la modalità sempre-in-ascolto), pronuncia la wake phrase + la tua domanda:

"Hey iridai, che ora è?" "Ciao iridai, cosa vedi?" → scatta foto + descrive "Ehi iridai, ricordami di chiamare il cliente alle 14"

L'app riconosce la frase e processa il resto.

💡 La wake word funziona anche se gli occhiali sono spenti (usa il microfono dell'iPhone in fallback).

8.2 Tap-to-talk

Il pulsante blu grande "Premi per parlare" in basso registra finché lo tieni premuto (push-to-talk). Quando rilasci, l'app trascrive e processa.

8.3 Stop di tutto

Durante l'elaborazione o il TTS che parla, il pulsante grande diventa rosso con etichetta:

• "Stop ascolto" (se sta registrando)
• "Interrompi" (se sta ragionando)
• "Stop voce" (se TTS sta parlando)

Tap → ferma immediatamente tutto.

9. Il tap della stanghetta Ray-Ban Meta

Iridai può intercettare il tocco della stanghetta degli occhiali — opzionale, opt-in dalle Impostazioni.

9.1 Cosa fa la stanghetta di default (sistema Meta)

Su Ray-Ban Meta vergini:

• Tap singolo: play/pause musica (AVRCP)
• Tap doppio: traccia successiva
• Tap triplo: traccia precedente
• Long press: attiva Meta AI

9.2 Cosa fa con Iridai (quando intercept attivo)

9.3 Come attivare l'intercept

✋ Cosa fare:

1. Impostazioni → Modalità di attivazione.
2. Sezione "Scorciatoia tasto media" → attiva il toggle "Tap stanghetta = scorciatoia".
3. Scegli il preset che il tap singolo deve usare per aprire il sopralluogo (consigliato: "Analisi CE" o "Audit Sicurezza" in base al lavoro che fai oggi).

9.4 Trade-off da sapere

Quando l'intercept è attivo:

1. La wake word vocale viene sospesa (l'audio session diventa esclusiva di Iridai per ricevere comandi AVRCP).
2. Il tap stanghetta non controlla più Apple Music / Spotify — usali dal Centro di Controllo iOS.
3. Iridai diventa l'app "Now Playing" — la vedrai con il titolo "Scorciatoia stanghetta — Iridai" nel widget musica.

Quando disattivi il toggle, wake word + controllo musica tornano normali entro un paio di secondi.

10. Impostazioni — guida sezione per sezione

Si apre toccando l'ingranaggio in alto a destra. La struttura segue questa gerarchia:

Impostazioni
├─ AI
│   ├─ Modelli AI e API key
│   └─ Prompt
├─ Voce
│   ├─ Personas
│   └─ Modalità di attivazione
├─ Contesti di analisi
│   └─ Contesti personalizzabili
├─ Sopralluoghi
│   └─ Storico e in corso
├─ Agentico
│   ├─ Funzionalità agentiche
│   ├─ Integrazioni esterne
│   └─ Integrazione con Software RAVENG
├─ Privacy & altre
│   ├─ Privacy
│   └─ Profilo operatore
└─ Informazioni
    ├─ Iridai (versione, build, bundle)
    ├─ Titolare (RAVENG by CE4U Srl)
    ├─ Documenti legali (Privacy, Cookies, Termini)
    └─ Licenza

11. Modelli AI cloud e locali

In Impostazioni → Modelli AI e API key.

11.1 Modello attivo

Picker in cima alla schermata. Mostra tutti i modelli configurati:

• Anthropic Claude Opus 4.7
• Anthropic Claude Sonnet 4.6
• Anthropic Claude Haiku 4.5
• OpenAI GPT-5
• Google Gemini 2 Flash
• (Se compatibile) SmolVLM2 2.2B locale, Qwen2-VL 2B/7B locale, ecc.

Iridai usa il modello scelto per tutte le analisi (Descrivi, CE, Sicurezza, ecc.) e per le risposte vocali generiche.

💡 Fallback automatico: se selezioni un provider per cui non hai una chiave salvata, Iridai instrada all'altro provider per cui hai una chiave (es. hai solo Claude, scegli OpenAI, l'analisi va comunque su Claude). Niente più "missing API key".

11.2 API key

Cinque righe, una per provider:

• Anthropic: chiave per Claude
• OpenAI: chiave per GPT-5
• Google Gemini: chiave per Gemini Flash
• ElevenLabs (TTS premium): voce sintetica più naturale (opzionale)
• Perplexity (web search): ricerca web in tempo reale (opzionale)

✋ Come salvare una chiave:

1. Tocca il campo, inserisci la chiave (es. sk-ant-...).
2. Tocca "Salva" alla destra del campo.
3. Vedi per ~2 secondi "Salvata ✓" verde — la chiave è stata cifrata e salvata nel Keychain iOS.
4. Sotto compare un picker "Modelli disponibili": Iridai ha contattato il provider per chiedere quali modelli la tua chiave abilita → scegli da lì.

🔒 Le chiavi sono cifrate nel Keychain con Secure Enclave quando disponibile. Non sono accessibili ad altre app né visibili in chiaro.

11.3 Modello locale (MLX)

Pulsante "Modelli locali (MLX)" in fondo alla schermata Modelli AI → apre una pagina con catalogo di modelli on-device.

Card "Il tuo dispositivo" in alto: ti dice modello iPhone + RAM + qual è il modello consigliato per le tue specifiche.

Catalogo (ordinato dal più leggero al più pesante):

Badge sulla card di ogni modello:

• 🟢 Consigliato (verde) — sweet-spot ottimale per il tuo iPhone.
• 🔵 Compatibile (azzurro) — funziona ma non sfrutta tutto il device.
• 🟠 Al limite (arancione) — potrebbe rallentare o crashare per memoria.
• 🔴 Non compatibile (rosso) — RAM insufficiente, download bloccato.

✋ Come scaricare un modello:

1. Tap "Scarica · X.X GB" sul modello consigliato.
2. Stai su WiFi se possibile (1.5-7 GB di download).
3. Barra di progresso live mostra Scaricamento da HuggingFace… 42%.
4. A fine download, tap "Usa questo" per renderlo il modello attivo.
5. Da quel momento le analisi possono andare completamente offline.

Pulsanti per modello scaricato:

• "In uso ✓" (badge verde) se è il modello attivo.
• "Usa questo" per attivarlo.
• 🗑 Cestino per "dimenticarlo" (libera memoria + cache).

12. Contesti e prompt personalizzati

Impostazioni → Contesti personalizzabili.

12.1 Cos'è un contesto

Un contesto è un bundle che configura:

• Nome + icona mostrati nella UI
• Prompt specialistico iniettato come system override nell'LLM
• Modello AI preferito (opzionale, es. Opus 4.7 per analisi pesanti)
• Dominio sopralluogo (CE / Sicurezza / I40)

Iridai ships con 6 contesti built-in pre-configurati. Puoi:

• Modificare il prompt di un built-in (tap sulla riga → editor) e ripristinare in qualsiasi momento.
• Aggiungere contesti custom (es. "Verifica HACCP", "Audit caserma militare", "Manutenzione tubazioni ATEX") con prompt che scrivi tu.

12.2 Workflow di creazione contesto custom

✋ Cosa fare:

1. Impostazioni → Contesti personalizzabili.
2. Pulsante "+ Aggiungi contesto custom" in basso.
3. Si apre l'editor:
   • Nome (es. "Verifica HACCP")
   • Icona (SF Symbol, es. fork.knife)
   • Modello AI dedicato (opzionale)
   • Dominio sopralluogo (CE / Sicurezza / I40 / nessuno)
   • Prompt — il cuore della cosa. Scrivi in italiano un prompt del tipo:

     Comportati come il miglior consulente HACCP con 50+ anni di esperienza
     in laboratori, ristoranti, mense scolastiche, industria alimentare.
     Verifica criticità in: temperatura conservazione, contaminazione crociata,
     identificazione lotti, MOCA, formazione operatori, autocontrollo, ecc.
     Cita sempre il riferimento normativo (Reg. CE 852/2004, Reg. CE 853/2004,
     D.Lgs 193/07, ecc.).
     
     [Schema JSON v2 di output viene iniettato automaticamente]

4. Tap "Salva" in alto.
5. Il contesto compare nell'elenco — puoi attivarlo come default del 4° pulsante dalla home (long-press sul 4° pulsante).

12.3 Schema JSON v2 (output strutturato)

Tutti i contesti chiedono al modello una risposta in JSON strutturato con campi:

• riassunto_vocale: 1-2 frasi italiane lette via TTS
• titolo: max 10 parole
• descrizione: descrizione tecnica dettagliata
• criticita: array di criticità
• rischi_visibili: array di rischi
• mitigazione: array di azioni correttive
• riferimenti_normativi: array di norme con articolo/comma
• severita: critica / maggiore / minore / osservazione

Più campi opzionali WOW: confidenza, categoria_principale, parole_chiave, proprietà_estratte, azioni_consigliate (con priorità + tempo_stimato), dettagli_visivi (cosa-dove), marker_normativi indicizzati.

Tutti questi campi compaiono nel PDF impaginati automaticamente.

13. Personas

Impostazioni → Personas.

Una persona è una combinazione di:

• Voce TTS
• Wake phrase dedicata
• Modello AI
• Preset di prompt (sistema voce, non di analisi)

13.1 Persone built-in

💡 Puoi creare personas custom se vuoi avere identità AI differenti per clienti diversi (es. una più formale, una più amichevole).

13.2 Cambiare persona attiva

Tap su una persona nella lista. Spunta verde ✓ accanto alla persona attiva.

Da quel momento le wake phrase di quella persona attivano l'app, e la voce TTS cambia.

14. Modalità di attivazione

Impostazioni → Modalità di attivazione. Decide come Iridai ti ascolta quando non stai usando il pulsante grande.

14.1 Tre preset

14.2 Toggle individuali

Sotto i preset, i toggle granulari:

• Usa il microfono degli occhiali (yes/no)
• Wake phrase (modificabile)
• Silenzioso (no wake word, no TTS) — utile in riunione
• Voce solo se occhiali connessi — il TTS parla solo se gli occhiali sono attivi

14.3 Scorciatoia tasto media (stanghetta)

Vedi §9.

15. Funzioni agentiche avanzate

Impostazioni → Funzionalità agentiche.

15.1 Visione proattiva

Toggle che attiva un'osservazione passiva continua: ogni X minuti l'app scatta una foto automatica e l'AI commenta cosa vede ("noto che sei in officina con luce scarsa", "vedo che stai guardando un quadro elettrico"). Utile per briefing situazionale automatico.

⚠ Attenzione privacy: comporta scatti automatici. Disattiva quando entri in aree riservate / private.

15.2 Documenti agente

Tre documenti che condizionano il comportamento dell'AI:

• Soul — chi è l'AI, voce, missione, contesto utente.
• Skills — strumenti che ha a disposizione e come usarli.
• Memory — fatti memorizzati ("[REMEMBER]" annotation).

Tap su uno → editor → modifica → salva.

15.3 Playbooks

Sequenze guidate di passi per attività ricorrenti (es. "Apertura cantiere", "Sopralluogo trimestrale", "Procedura DPI"). Puoi crearle / importarle.

15.4 Task pianificati

Briefing ricorrenti tipo "ogni mattina alle 8:00 dimmi le scadenze in calendario". L'app li esegue in background.

16. Integrazioni esterne

16.1 Twilio (SMS)

Permette al modello AI di inviare SMS automaticamente (es. avvisare il cliente che è stato rilevato un pericolo critico).

✋ Vai su https://console.twilio.com, crea Account SID + Auth Token + un numero verificato, inserisci tutto in Iridai → Impostazioni → Integrazioni esterne → Twilio.

16.2 n8n (workflow)

Triggera workflow di automazione su un'istanza n8n self-hosted o cloud (es. quando viene chiuso un sopralluogo, n8n crea un task in ClickUp + invia email al cliente).

16.3 Integrazione con Software RAVENG

Placeholder per il portale RAVENG by CE4U Srl (in sviluppo). Permette di sincronizzare automaticamente sopralluoghi con il tuo tenant RAVENG.

✋ Per richiedere l'attivazione: vai in Impostazioni → Integrazione con Software RAVENG → attiva il toggle → tocca il link info@raveng.it. Riceverai URL del tuo tenant + Secret Key.

17. Generazione PDF e condivisione verbali

Ogni sopralluogo genera automaticamente un PDF impaginato professionalmente all'atto della chiusura.

17.1 Cosa contiene il PDF

1. Hero copertina con fascia colorata per dominio + ID sopralluogo grande
2. Card riepilogo (cliente, sito, operatore, data, GPS)
3. Statistiche numeriche in 4 colonne (macchine, NC, near miss, foto)
4. Sezione Macchine ispezionate (per CE/I40)
5. Sezione Non Conformità — ogni NC è una card con:
   • Header colorato per severità (rosso / arancione / giallo / blu)
   • Numero NC + ora
   • Descrizione tecnica dettagliata
   • Riferimento normativo
   • GPS / indirizzo
   • Confidenza AI (pill colorato verde/giallo/rosso)
   • Categoria principale
   • Parole chiave (chip pillole)
   • Proprietà estratte (matricola, marchio, modello, anno, ecc.)
   • Azioni consigliate con priorità + tempo stimato (alta=rosso, media=giallo, bassa=blu)
   • Dettagli visivi ("vedo X in posizione Y")
   • Marker normativi indicizzati (codice + articolo + descrizione)
6. Sezione Near miss + Osservazioni
7. Galleria fotografica con didascalia tecnica per ogni foto
8. Riferimenti normativi citati alfabetici indicizzati
9. Footer con paginazione + brand Iridai

17.2 Come condividere

1. Lista sopralluoghi → tap sul sopralluogo chiuso.
2. Sezione "Verbale":
   • Anteprima PDF — visualizzazione QuickLook nativa iOS.
   • Condividi PDF — apre Share Sheet iOS (Mail, WhatsApp, AirDrop, Salva su File…).
   • Condividi Markdown — versione testo grezzo del verbale.

💡 Triplo tap sulla stanghetta Ray-Ban Meta = scorciatoia per Share Sheet del sopralluogo corrente (vedi §9.2).

18. Privacy e modello locale (zero-cloud)

🔒 Iridai è progettato per essere privacy-first.

18.1 Cosa NON facciamo mai

• ❌ Vendere, cedere, monetizzare i tuoi dati.
• ❌ Integrare analytics di terze parti (Google Analytics, Firebase, AppsFlyer, ecc.).
• ❌ Usare l'identificatore pubblicitario IDFA.
• ❌ Inviare dati al server di RAVENG senza il tuo opt-in esplicito.
• ❌ Tracciare l'attività dell'utente attraverso app o siti web.

18.2 Cosa facciamo

• ✅ Salvare tutti i dati localmente sul tuo iPhone (sandbox app).
• ✅ Cifrare le credenziali nel Keychain iOS Secure Enclave.
• ✅ Trasmettere foto / testo al provider AI solo quando esplicitamente richiesto (premi un pulsante AI).
• ✅ Offrire il modello locale MLX per scenari zero-cloud.

18.3 Come azzerare ogni trasferimento extra-UE

1. Scarica un modello locale (§11.3).
2. Selezionalo come modello attivo.
3. Disattiva l'integrazione con Twilio / n8n / RAVENG (se attiva).
4. Da quel momento nessun dato esce dal tuo iPhone. L'app funziona 100% offline.

18.4 Documenti completi

Impostazioni → Informazioni → Documenti legali:

• Informativa Privacy (GDPR Art. 13)
• Cookie Policy
• Termini di Utilizzo

19. Risoluzione problemi (troubleshooting)

19.1 Pannello Debug

Long-press 0.6s sulla mini-icona Iridai in alto a sinistra → si apre Debug.

Mostra:

• Stato connessione occhiali
• Processing in corso (sì/no)
• Wake word listening (sì/no)
• TTS in riproduzione (sì/no)
• Streaming attivo (sì/no)
• GPS + indirizzo correnti
• Ring buffer eventi (ultimi 200) — qui vedi cosa sta facendo l'app momento per momento

19.2 Problemi comuni e soluzioni

19.3 Reset totale

Se nulla funziona:

1. Annulla tutti i sopralluoghi attivi.
2. Disinstalla l'app (long-press icona home → Rimuovi → Elimina app).
3. Reinstalla da TestFlight / App Store.
4. Tutti i dati locali (foto, sopralluoghi, preferenze, chiavi API) verranno cancellati. Le chiavi API andranno re-inserite.

20. Domande frequenti (FAQ)

D: Posso usare Iridai senza Ray-Ban Meta? R: Sì, completamente. La fotocamera dell'iPhone subentra automaticamente.

D: Quanto costa Iridai? R: L'app richiede l'abbonamento auto-rinnovabile "Iridai Pro Mensile" a € 9,90 al mese (IVA inclusa). I nuovi utenti idonei hanno 3 giorni di prova gratuita (durata minima supportata da Apple StoreKit). Il pagamento è gestito interamente da Apple tramite l'Apple ID — RAVENG non riceve né tratta dati di pagamento. Puoi cancellare in qualsiasi momento da Impostazioni iOS → Apple ID → Abbonamenti.

D: L'abbonamento include i costi delle API cloud? R: No. L'abbonamento Iridai Pro sblocca le funzionalità AI dell'app, ma le chiamate a Claude / GPT / Gemini hanno costo separato secondo il listino del provider (tipicamente ~1-15 centesimi per analisi). Per zero costi ricorrenti aggiuntivi usa il modello locale MLX scaricabile dall'app — funziona completamente offline.

D: Quanto mi costa un'analisi CE cloud? R: Dipende dal modello AI scelto. Anthropic Claude Opus 4.7 ~10-15 centesimi, Haiku 4.5 ~1 centesimo, Gemini Flash ~1 centesimo. Modello locale: 0 centesimi (paghi solo l'elettricità).

D: Posso ottenere un rimborso? R: I rimborsi sono gestiti esclusivamente da Apple tramite la procedura standard reportaproblem.apple.com. RAVENG non può rimborsare direttamente. Ai sensi del Codice del Consumo italiano, il diritto di recesso può essere escluso per contenuti digitali la cui esecuzione abbia avuto inizio con il tuo consenso espresso (art. 59 lett. m D.Lgs. 206/2005).

D: Il PDF generato dall'app ha valore legale? R: No. È una bozza di lavoro che tu, in qualità di professionista abilitato, devi revisionare e firmare. Vedi §21 e l'art. 7 dei Termini di Utilizzo.

D: Posso usare l'app per fare ispezioni in zone militari / aeroporti / strutture sensibili? R: No se è vietato dalle norme del committente. L'utente è responsabile della legittimità degli scatti.

D: I miei dati finiscono nei modelli di Anthropic / OpenAI / Google per il training? R: Solitamente no — i provider AI usano i dati delle API a pagamento solo per fornire la risposta (Anthropic Default API: 30 giorni retention, no training; OpenAI: opt-out by default; Google: configurabile). Verifica policy specifica del provider scelto.

D: Posso usare Iridai offline? R: Sì, con un modello locale MLX scaricato + Ray-Ban Meta opzionali. Niente cloud, niente connessione.

D: Cosa succede se mi cade l'iPhone e si rompe? R: I dati locali si perdono. Iridai 0.3.0 non sincronizza ancora con il cloud RAVENG (in arrivo). Suggerimento: condividi i PDF dei sopralluoghi importanti via Mail/AirDrop subito dopo averli chiusi.

D: Posso configurare un wake word personalizzato (es. "ehi cantiere")? R: Sì. Impostazioni → Modalità di attivazione → campo "Wake phrase". Validazione: minimo 3 caratteri.

D: L'app raccoglie metriche di utilizzo / telemetria? R: No. Tutti i log diagnostici sono locali (OSLog) — visibili solo a te tramite il pannello Debug.

D: Posso esportare i dati di un sopralluogo per archivio? R: Sì. Tap sul sopralluogo → "Condividi PDF" o "Condividi Markdown" → salva su iCloud Drive / Dropbox / OneDrive / File.

D: Funziona su iPad? R: L'app è progettata solo per iPhone (TARGETED_DEVICE_FAMILY = 1). Un'eventuale versione iPad richiede una build dedicata.

D: Funziona su Apple Watch? R: Non ancora. Roadmap futuro.

21. Sicurezza e responsabilità professionale

⚠ LEGGI ATTENTAMENTE QUESTA SEZIONE.

21.1 L'AI commette errori

I modelli AI possono e devono essere considerati fallibili. Possono:

• Citare riferimenti normativi inesatti o abrogati.
• Sbagliare classificazioni di severità.
• Allucinare dati tecnici (matricole, marchi, anni).
• Stimare dimensioni / distanze in modo approssimativo.
• Confondere contesti professionali differenti.
• Restituire diagnosi errate o omettere criticità importanti.

21.2 Tu sei il responsabile

In quanto ingegnere consulente / perito tecnico / professionista abilitato:

• Devi verificare ogni output dell'app prima di utilizzarlo.
• Devi firmare i verbali tecnici solo dopo revisione personale.
• Non puoi delegare all'AI la responsabilità professionale.
• L'app è uno strumento di supporto, non un sostituto del tuo giudizio.

21.3 Manleva contrattuale

RAVENG by CE4U Srl, Carlo Tenca e tutti i collaboratori sono completamente sollevati da qualsiasi responsabilità per:

• Danni a persone, attrezzature, smartphone derivanti da install/disinstallazione/uso dell'app.
• Perdita di dati locali (foto, sopralluoghi, configurazioni).
• Errori, omissioni o allucinazioni dei modelli AI.
• Uso scorretto o fuori contesto degli output.
• Consegna di verbali a clienti / autorità senza adeguata verifica professionale.
• Sanzioni amministrative, penali, danni reputazionali conseguenti.

Vedi articolo 7 e 8 dei Termini di Utilizzo per il dettaglio completo della manleva.

22. Glossario

• NC — Non Conformità: criticità rilevata durante un sopralluogo, categorizzata per severità.
• Severità: critica / maggiore / minore / osservazione (in ordine decrescente).
• TTS — Text-To-Speech: il sintetizzatore vocale che legge le risposte.
• STT — Speech-To-Text: la trascrizione vocale (SFSpeechRecognizer di Apple).
• Wake word — parola-chiave che attiva l'assistente in ascolto continuo.
• MLX — framework Apple per modelli AI eseguiti on-device.
• VLM — Vision-Language Model (LLM con capacità di analisi immagini).
• AVRCP — Audio/Video Remote Control Profile, lo standard BT che la stanghetta degli occhiali usa per inviare play/pause.
• SDK DAT — Meta Wearables Device Access Toolkit, il framework Meta per accedere alla camera Ray-Ban.
• Keychain — storage cifrato iOS per le credenziali sensibili.
• Sandbox — area isolata di filesystem dedicata a una specifica app.
• JSON v2 Schema — formato strutturato di risposta dell'AI con campi WOW (confidenza, marker normativi, ecc.).
• EN ISO 13857 / 13854 — norme europee per le distanze di sicurezza relative all'accesso con arti superiori/inferiori.
• D.Lgs. 81/08 — Testo Unico sulla Sicurezza sul Lavoro italiano.
• Direttiva Macchine 2006/42/CE — direttiva europea sulla marcatura CE delle macchine.

23. Contatti e supporto

23.1 Titolare

RAVENG by CE4U S.r.l. Sede legale: Via Gioacchino Rossini 29/2, 37012 Bussolengo (VR), Italia P.IVA / C.F.: 04731920239

23.2 Email

• Supporto tecnico generale: c.tenca@raveng.it
• Privacy / GDPR: privacy@raveng.it
• Richiesta integrazione portale RAVENG: info@raveng.it

23.3 Rispondiamo entro

• Supporto tecnico: 3 giorni lavorativi
• Privacy: 30 giorni (estensibili a 60 ex art. 12.3 GDPR per casi complessi)

Versione manuale: 1.0 Versione App: Iridai 0.3.0 Data: 11 maggio 2026 © 2026 RAVENG by CE4U S.r.l. — Tutti i diritti riservati