Guida wrapper-client OASI

Il wrapper-client è un piccolo servizio che gira sul PC della cassa / accettazione e parla con il gateway OASI per ricevere comandi di stampa.

Cos'è?

• Un servizio Windows / app macOS che gira in background.
• Stampa scontrini / cedole sulla POS891 (USB) quando il sistema OASI invia un comando.
• Non rallenta il PC: usa ~30MB RAM, ~0% CPU in idle.

Come installarlo?

L'amministratore OASI ti invia un link diretto della forma:

https://oasi.io/device/setup/dev_xxx/abc123token

Click → scarica installer → wizard → installato.

Come capisco se funziona?

Dopo l'installazione:

• Windows: apri Servizi (services.msc) → cerca "OASI Print Agent" → deve essere "In esecuzione".
• macOS: apri Terminale → launchctl list | grep oasi.print-agent → deve apparire una riga.
• L'amministratore può chiederti di leggere health.json per dettagli.

Top 5 problemi

1. Windows SmartScreen blocca l'installer

Click Maggiori info → Esegui comunque. È normale finché non firmiamo con un certificato Authenticode (v2 roadmap).

2. La stampa non esce

Verifica che la POS891 stampi da Windows: tasto dx sulla coda → Stampa pagina di prova. Se non stampa da Windows, non stamperà neanche da OASI. Controlla cavo USB + carta.

3. "Connesso: NO" nel health.json

• L'URL del gateway è raggiungibile? Apri CMD: curl https://gateway.tuoprogetto.oasi/diagnostics
• Token registrazione scaduto (>24h)? Chiedi link nuovo.

4. Stampa "stretta" o "larga" (formato sbagliato)

Apri C:\ProgramData\OASI\PrintAgent\config.json → "PRINTER_LINE_WIDTH": 48 per 72mm (POS891 standard), 32 per 58mm, 42 per 80mm. Salva, riavvia servizio.

5. Voglio disabilitare il supporto remoto Claude

Modifica config.json → "inspection.enabled": false → salva. Il wrapper lo nota entro 10 secondi (nessun restart richiesto).

Dove sono i log?

Audit del supporto remoto (Claude) — append-only, mai cancellato: