Chi acquista codice sorgente teme una cosa più di ogni altra: questo prodotto sarà ancora mantenuto dopo che avrò pagato? Rispondi a questa domanda con tre abitudini. Usa il versionamento semantico, così che il numero di versione dica agli acquirenti quanto è rischioso un aggiornamento. Tieni un changelog che spieghi ogni release in un linguaggio semplice. E pubblica una politica di supporto che dica quale assistenza è inclusa, per quanto tempo e cosa non è incluso.
Queste abitudini trasformano una vendita una tantum in una relazione e contribuiscono in larga parte a far sì che gli acquirenti si fidino di un annuncio, come descritto nella nostra guida su come vendere il codice sorgente della tua web app o del tuo SaaS. Questo articolo tratta gli aspetti pratici: numerare le release, scrivere le voci del changelog, confezionare aggiornamenti per installazioni personalizzate e fissare limiti di supporto che proteggano il tuo tempo.
Come si applica il versionamento semantico a una web app?
Il Semantic Versioning usa tre numeri, MAJOR.MINOR.PATCH. La specifica è stata scritta per librerie con un’API pubblica, quindi quando vendi un’intera applicazione devi decidere quale sia la tua «API pubblica». Per un prodotto di codice sorgente, è tutto ciò da cui dipende un acquirente quando installa, configura, personalizza e aggiorna:
- Requisiti del server (versioni del linguaggio, del database e delle estensioni).
- Variabili d’ambiente e chiavi di configurazione.
- Lo schema del database che gli acquirenti potrebbero interrogare o estendere.
- Punti di estensione: hook, eventi, cartelle di override, file dei temi, classi documentate.
- La tua API REST, i webhook e i formati di importazione o esportazione.
Una modifica che costringe gli acquirenti a cambiare uno qualsiasi di questi elementi è una breaking change, anche se l’app ha lo stesso aspetto.
| Modifica | Incremento di versione | Esempio |
|---|---|---|
| Correzione di un bug senza modifiche a requisiti, configurazione o punti di estensione | PATCH (da 2.4.1 a 2.4.2) | Correggere i totali errati nel report mensile |
| Correzione di sicurezza retrocompatibile | PATCH | Aggiungere il controllo di autorizzazione mancante sulla route di esportazione |
| Nuova funzionalità; le installazioni esistenti continuano a funzionare dopo le migrazioni | MINOR (da 2.4.2 a 2.5.0) | Aggiungere i promemoria via SMS come modulo opzionale |
| Nuova impostazione opzionale o variabile d’ambiente con un valore predefinito sicuro | MINOR | Aggiungere REPORTS_CACHE_MINUTES, predefinito 10 |
| Versione minima di PHP o del database innalzata | MAJOR (da 2.5.0 a 3.0.0) | Richiedere PHP 8.4 |
| Chiave di configurazione rinominata, hook rimosso, risposta dell’API modificata | MAJOR | Rinominare la gestione di MAIL_FROM; rimuovere l’API v1 deprecata |
| Upgrade di versione principale del framework che cambia i percorsi di override | MAJOR | Passare a una nuova versione principale del framework con una nuova struttura delle cartelle |
Due regole pratiche aiutano: depreca prima di rimuovere (avvisa in una release MINOR, rimuovi nella MAJOR successiva) e mantieni le release MAJOR rare e ben documentate. Gli acquirenti perdonano le breaking change; non perdonano le sorprese.
Scrivi un changelog di cui gli acquirenti si possano fidare
Un changelog si scrive per le persone, non si genera dai messaggi di commit. Il diffuso formato Keep a Changelog raggruppa le modifiche sotto Added, Changed, Deprecated, Removed, Fixed e Security (aggiunto, modificato, deprecato, rimosso, corretto e sicurezza), con la release più recente in alto e una data per ogni versione. Ecco un esempio di come appaiono delle buone voci:
[3.0.0] — 2026-11-10
Note di aggiornamento: richiede PHP 8.4. Esegui le migrazioni. L’impostazione
MAIL_FROMè stata spostata in Impostazioni > Email; i valori esistenti vengono migrati automaticamente. Se fai l’override diresources/views/invoices, confronta la tua copia con il nuovo template.Aggiunto — Fatture ricorrenti con promemoria automatici. — Traduzione giapponese.
Modificato — Il layout del PDF della fattura ora supporta descrizioni lunghe delle voci.
Rimosso — L’API REST v1, deprecata nella 2.6.0. Usa la v2.
Sicurezza — I file CSV esportati sono ora disponibili solo per gli utenti con il permesso Report.
[2.6.1] — 2026-09-22
Corretto — Il calendario mostrava le prenotazioni sfasate di un’ora dopo il cambio dell’ora legale.
Nota i dettagli: la data, le note di aggiornamento prima dell’elenco, l’impostazione esatta che è stata spostata, la cartella che potrebbe richiedere attenzione e il motivo per cui qualcosa è stato rimosso. «Correzioni di bug e miglioramenti» non dice nulla a un acquirente e lascia intendere che forse nemmeno tu sai cosa è cambiato.
Pubblica il changelog in tre posti: come file nel download, nel tuo annuncio e nell’area di amministrazione dell’app, se hai un avviso di aggiornamento. Una voce recente e datata nell’annuncio è uno dei segnali più forti che il prodotto è vivo.
Distribuisci aggiornamenti che gli acquirenti possano davvero applicare
Chi compra codice sorgente lo personalizza. Se il tuo processo di aggiornamento presuppone un’installazione intatta, ogni release diventa un’ondata di ticket di supporto. Progetta pensando alla personalizzazione fin dall’inizio.
Dai alle personalizzazioni un posto sicuro
- Cartelle di override per viste, traduzioni e temi, che il tuo codice controlla prima dei propri valori predefiniti.
- Eventi e hook nei punti importanti (fattura creata, utente registrato), così che gli acquirenti possano aggiungere comportamenti senza modificare le classi principali.
- Configurazione e impostazioni per tutto ciò che un acquirente potrebbe ragionevolmente voler cambiare.
- Un service provider personalizzato o una cartella di moduli che gli aggiornamenti non sovrascrivono mai.
Documenta questi punti di estensione; la nostra guida alla documentazione che riduce i ticket di supporto mostra come scrivere la guida alla personalizzazione.
Confeziona correttamente ogni release
- Pacchetto completo: il codice completo per le nuove installazioni e per gli acquirenti che non hanno mai personalizzato nulla.
- Note di aggiornamento: modifiche ai requisiti, migrazioni, nuove impostazioni, file modificati di cui gli acquirenti potrebbero aver fatto l’override.
- Un elenco dei file modificati rispetto alla release precedente, così che gli acquirenti che hanno modificato i file principali sappiano cosa confrontare.
- Migrazioni del database che vengono eseguite in sicurezza sui dati esistenti e sono testate su una copia di un database realistico.
- Una procedura di aggiornamento consigliata: backup di file e database, app in modalità manutenzione, sostituzione dei file, esecuzione delle migrazioni, svuotamento delle cache, test, riattivazione.
Agli acquirenti che usano Git, suggerisci di tenere la tua release originale su un branch separato e di fare il merge di ogni nuova release nel loro branch personalizzato. I conflitti mostrano così esattamente dove le loro modifiche incontrano le tue. Se il tuo prodotto è basato su Laravel, inserisci nelle note il link alla guida all’aggiornamento del framework ogni volta che una release passa a una nuova versione principale del framework.
Fai sapere agli acquirenti che esiste un aggiornamento
Su AppTrovo pubblichi una nuova versione del tuo prodotto e gli acquirenti possono scaricare le nuove versioni finché il loro periodo di supporto e aggiornamenti è attivo. Puoi anche mostrare un avviso di aggiornamento all’interno della tua app: l’API pubblica del prodotto restituisce la versione corrente, quindi la tua area di amministrazione può confrontarla con la versione installata e linkare il changelog. Controlla al massimo una volta al giorno e non bloccare mai l’app se il controllo fallisce. La guida all’integrazione della licenza include un esempio.
Checklist della release
- Scegli il numero di versione usando la tabella sopra.
- Scrivi la voce del changelog e le note di aggiornamento.
- Esegui i test, poi installa la release su un server pulito.
- Aggiorna una copia della versione precedente con dati realistici e alcuni override attivi.
- Aggiorna la documentazione e gli screenshot che sono cambiati.
- Crea il pacchetto da un commit taggato, senza file di sviluppo, log o segreti.
- Distribuisci la stessa build sulla tua demo live.
- Carica la nuova versione e aggiorna il changelog dell’annuncio.
- Monitora attentamente i ticket per 48 ore e tieniti pronto con una release PATCH.
Scrivi una politica di supporto con limiti equi
Senza una politica scritta, il «supporto» finisce per includere sviluppo personalizzato, amministrazione di server e formazione. Una breve politica nell’annuncio e nella documentazione lo evita, e gli acquirenti apprezzano sapere cosa aspettarsi. Su AppTrovo ogni prodotto ha un periodo di supporto incluso che configuri tu (6 mesi come impostazione predefinita), e puoi permettere agli acquirenti di acquistare un supporto più lungo al checkout o di estenderlo in seguito.
Ecco un modello che puoi adattare:
Politica di supporto
Incluso: assistenza nell’installazione del prodotto su un server supportato; risposte a domande su funzionalità e impostazioni; correzione dei bug nel codice originale; aggiornamenti di sicurezza; indicazioni su dove apportare le personalizzazioni più comuni.
Non incluso: sviluppo personalizzato o nuove funzionalità per un singolo acquirente; risoluzione di problemi causati da modifiche al codice; configurazione di server, hosting o provider email oltre ai requisiti documentati; plugin o servizi di terze parti.
Come ottenere assistenza: apri un ticket di supporto dal tuo acquisto. Indica la versione del prodotto, l’ambiente server (versione di PHP e del database), il messaggio di errore esatto e i passaggi per riprodurlo.
Tempi di risposta: puntiamo a rispondere entro due giorni lavorativi, dal lunedì al venerdì, in inglese. Le questioni complesse possono richiedere più tempo per essere risolte.
Periodo di supporto: supporto e aggiornamenti sono inclusi per il periodo indicato nella pagina del prodotto e possono essere estesi dalla tua dashboard.
Fissa un tempo di risposta che puoi davvero rispettare, anche durante le festività. Una risposta affidabile entro due giorni è meglio di una risposta entro un’ora promessa e poi mancata. Se offri personalizzazioni a pagamento, menzionale separatamente così che gli acquirenti sappiano a chi rivolgersi.
Il tempo di supporto è un costo reale di ogni vendita. Come esempio illustrativo, se un acquirente medio apre tre ticket che richiedono venti minuti ciascuno, ogni vendita ti costa un’ora di lavoro durante il periodo di supporto. Stima questo numero dai ticket dei primi mesi e includilo nel prezzo; la nostra guida su come prezzare il codice sorgente mostra come fare. Assicurati inoltre che la politica non contraddica i termini di licenza del marketplace, che definiscono cosa gli acquirenti possono fare con il codice.
Rendi i ticket efficienti
- Chiedi versione, ambiente, errore esatto e passaggi direttamente nel modulo del ticket.
- Aggiungi all’area di amministrazione una pagina con le informazioni di sistema che gli acquirenti possano copiare in un ticket.
- Rispondi con un link alla documentazione più un breve riepilogo, e migliora la pagina se il link non è stato d’aiuto.
- Rispondi pubblicamente a recensioni e domande quando la risposta è utile anche ai futuri acquirenti.
Gestisci i problemi di sicurezza in modo diverso
Le correzioni di sicurezza meritano un processo dedicato, perché gli acquirenti eseguono il tuo codice sui propri server con i dati dei propri clienti.
- Pubblica un modo per segnalare le vulnerabilità, come un indirizzo email dedicato nella documentazione. Un file
security.txt, definito nella RFC 9116, è il posto standard in cui indicarlo sul tuo sito web. - Prima correggi, poi divulga. Rilascia la PATCH, poi descrivi il problema nella sezione Sicurezza del changelog con dettagli sufficienti perché gli acquirenti possano valutarne l’urgenza, ma senza un exploit passo per passo.
- Correggi le versioni precedenti ancora supportate quando è possibile, oppure indica chiaramente agli acquirenti a quale versione devono passare.
- Invita gli acquirenti ad aggiornare attraverso ogni canale a tua disposizione: l’annuncio, l’avviso nell’app e le tue risposte di supporto.
Pianifica la fine del ciclo di vita
Nessun prodotto viene mantenuto per sempre. Decidi in anticipo come terminerai il supporto per una vecchia versione principale o per l’intero prodotto. Annuncialo nel changelog, concedi agli acquirenti un preavviso ragionevole e pubblica una release finale con tutte le correzioni di sicurezza note. Su AppTrovo, un prodotto che ha emesso licenze può essere ritirato invece che eliminato: viene rimosso dal catalogo, ma ogni licenza esistente continua a essere verificata, quindi le installazioni degli acquirenti non ne risentono.
Domande frequenti
Cos’è il versionamento semantico in parole semplici?
È uno schema di numerazione, MAJOR.MINOR.PATCH, in cui ogni numero dice agli utenti che tipo di modifica contiene una release. PATCH significa solo correzioni di bug, MINOR significa nuove funzionalità che mantengono funzionanti le configurazioni esistenti e MAJOR significa che è cambiato qualcosa che potrebbe richiedere un intervento dell’utente al momento dell’aggiornamento.
Cosa dovrebbe includere un changelog?
Ogni release ha bisogno di un numero di versione, di una data e di voci raggruppate per ciò che è stato aggiunto, modificato, deprecato, rimosso, corretto e messo in sicurezza. Per le applicazioni che gli acquirenti installano da sé, aggiungi in cima a ogni release le note di aggiornamento: nuovi requisiti, migrazioni, impostazioni spostate e file che le installazioni personalizzate dovrebbero confrontare.
Ogni quanto dovrei rilasciare aggiornamenti?
Rilascia le correzioni PATCH appena sono pronte, soprattutto per i problemi di sicurezza. Molti venditori raggruppano le funzionalità in release MINOR ogni uno-tre mesi, il che offre agli acquirenti un ritmo prevedibile. Release regolari e datate contano più di release frequenti.
Gli acquirenti devono pagare per gli aggiornamenti?
Su AppTrovo gli acquirenti possono scaricare le nuove versioni finché il loro periodo di supporto e aggiornamenti è attivo, e possono estendere tale periodo. Una volta scaduto, mantengono la versione che hanno e possono continuare a usarla secondo la loro licenza.
Il supporto dovrebbe includere l’assistenza sulle personalizzazioni?
La maggior parte dei venditori include indicazioni su dove apportare le modifiche più comuni, ma esclude la scrittura di codice personalizzato per i singoli acquirenti. Dichiaralo chiaramente nella tua politica di supporto. Se vuoi offrire lavori di personalizzazione, presentali come un servizio separato a pagamento.