Sostituire le fondamenta sotto un’app di pagamento, mentre la gente ci pagava.

Il prodotto

Che cos’è OPTO, e perché la stabilità non è un dettaglio estetico

OPTO è la soluzione di pagamento digitale di Paytec per il vending. Il telefono comunica con la macchina per via ottica — attraverso la luce del proprio schermo, non NFC e non un codice QR — verso un piccolo lettore installato sulla macchina, con un sensore ottico e un modulo Bluetooth, senza modem e senza SIM. L’utente tiene un saldo nell’applicazione, lo ricarica con carta o in contanti e, sulle macchine adeguatamente attrezzate, seleziona il prodotto dal telefono e paga con un solo gesto. La parte monetaria è in capo a un emittente di moneta elettronica autorizzato nell’Unione europea.

Tutto questo è la descrizione che Paytec pubblica del proprio prodotto, ed è su questa pagina per un motivo: fissa lo standard che il software deve raggiungere. Un’applicazione a volte lenta è una seccatura. Un’applicazione che fallisce nel momento del pagamento, davanti a una macchina, con un saldo già caricato, è una chiamata all’assistenza, un rimborso e un cliente che torna alle monete. Qui l’affidabilità non è un attributo di qualità. È il prodotto.

Che cosa abbiamo fatto

Prima la migrazione, poi tutto ciò che la migrazione ha reso possibile

Siamo entrati in un codice che non avevamo scritto, per un prodotto che non avevamo progettato, senza la possibilità di metterlo in pausa. L’incarico aveva due parti, e non erano equivalenti: portare OPTO da Xamarin a .NET MAUI, e uscirne più stabile di come era entrata. Una migrazione che approda a un framework supportato e a un tasso di crash peggiore è fallita, qualunque cosa dicano le note di rilascio.

La cosa utile da capire di questo tipo di migrazione è dove sta davvero il lavoro. La logica di business — saldi, transazioni, le regole che li governano — si porta in modo relativamente pulito, perché è codice ordinario. Quello che non si porta da sé è il livello di piattaforma: come l’applicazione parla con il lettore, come si comporta quando il sistema operativo la sospende, come si chiedono i permessi su ciascuna versione di ciascuna piattaforma e quanto tutto questo cambi tra un telefono Android di quattro anni e un iPhone attuale. In un’applicazione di pagamento, a quel livello non è consentito essere approssimativamente corretto.

Il team è stato di due persone per tutta la durata: un ingegnere mobile che portava sia iOS sia Android su .NET MAUI e un ingegnere backend su un servizio PHP. Citiamo la dimensione perché è la forma onesta di questo tipo di lavoro. Una migrazione non diventa più sicura aggiungendo persone; diventa più sicura se le stesse due teste tengono insieme tutto il sistema in una volta.

L’instabilità non era tutta nell’applicazione

Questa è la parte che vale la pena portarsi via da questa pagina. Il sintomo visibile era l’applicazione: crash, blocchi, l’app terminata in background, utenti che perdevano il filo in mezzo a un acquisto. La conclusione ovvia era che la colpa fosse del codice client, e in parte lo era.

Ma una parte dei guasti si concentrava nelle ore di punta — e questa è una forma, non una coincidenza. Invece di discuterne, l’abbiamo riprodotta sotto carico, e la causa si è rivelata dall’altra parte: l’applicazione perdeva la connessione al backend quando la domanda si concentrava. Nessuna quantità di lavoro sul codice mobile l’avrebbe risolto. Si è risolto aumentando la capacità del backend, ed è il motivo per cui l’incarico aveva un ingegnere backend e non soltanto uno mobile.

L’altra cosa che è cambiata per gli utenti è poco vistosa e conta ogni singola volta: ora l’applicazione si apre più in fretta da freddo. Davanti a un distributore automatico, con qualcuno in attesa dietro di voi, i secondi prima che compaia la prima schermata sono tutta l’esperienza.

OPTO come la vedono i suoi utenti, dalla scheda store pubblicata da Paytec. La migrazione deliberatamente non ha cambiato questo: l’incarico era sostituire ciò su cui l’applicazione si appoggia, non il suo aspetto.

La seconda fase è arrivata dopo che la prima si era dimostrata valida: Paytec ci ha chiesto di continuare, e abbiamo portato l’applicazione da .NET 9 a .NET 10, migliorando per strada parti del suo comportamento. Quell’aggiornamento sembra manutenzione di routine e non lo è. Un’applicazione .NET MAUI corre su due orologi, e quello più corto è facile da non vedere: .NET MAUI 9 è uscito dal supporto il 12 maggio 2026, sei mesi prima che .NET 8 e .NET 9 stessi arrivino a fine supporto il 10 novembre 2026. .NET 10 è una release a supporto a lungo termine, portata fino a novembre 2028. Spostarci quando lo abbiamo fatto è stata la differenza tra pianificare un aggiornamento ed esservi costretti.

Oggi manteniamo la generazione che è in produzione mentre ne costruiamo accanto la successiva. L’applicazione distribuita resta supportata e rilasciabile per tutta la durata — che è l’unico assetto che funziona quando la cosa che state sostituendo è anche la cosa che incassa i soldi. La prossima generazione avrà una pagina propria quando sarà nelle mani delle persone; preferiamo scriverla dopo piuttosto che annunciarla ora.