Aller au contenu
For Sellers

Support, mises à jour et versionnage pour les vendeurs de code

Comment appliquer le versionnage sémantique et un changelog clair à une application web que les acheteurs installent et personnalisent, livrer des mises à jour qu’ils peuvent réellement appliquer et rédiger une politique de support aux limites équitables. Avec des exemples d’entrées de changelog et un modèle de politique.

• Nov 17, 2026 • 14 min de lecture
Support, mises à jour et versionnage pour les vendeurs de code

Les acheteurs de code source s’inquiètent avant tout d’une chose : ce produit sera-t-il encore maintenu une fois que j’aurai payé ? Vous y répondez avec trois habitudes. Utilisez le versionnage sémantique pour que le numéro de version indique aux acheteurs le niveau de risque d’une mise à jour. Tenez un changelog qui explique chaque version dans un langage simple. Et publiez une politique de support qui précise quelle aide est incluse, pendant combien de temps, et ce qui ne l’est pas.

Ces habitudes transforment une vente unique en relation durable, et elles comptent pour beaucoup dans la confiance qu’inspire une fiche produit, comme l’explique notre guide sur comment vendre le code source de votre application web ou SaaS. Cet article aborde les aspects pratiques : numéroter les versions, rédiger les entrées du changelog, préparer les mises à jour pour des installations personnalisées et fixer des limites de support qui protègent votre temps.

Comment le versionnage sémantique s’applique-t-il à une application web ?

Le Semantic Versioning utilise trois nombres, MAJEURE.MINEURE.CORRECTIF (MAJOR.MINOR.PATCH). La spécification a été rédigée pour des bibliothèques dotées d’une API publique ; vous devez donc décider de ce qu’est votre « API publique » lorsque vous vendez une application entière. Pour un produit en code source, c’est tout ce dont un acheteur dépend lorsqu’il installe, configure, personnalise et met à niveau :

  • Les prérequis serveur (versions du langage, de la base de données et des extensions).
  • Les variables d’environnement et les clés de configuration.
  • Le schéma de base de données que les acheteurs peuvent interroger ou étendre.
  • Les points d’extension : hooks, événements, dossiers de surcharge, fichiers de thème, classes documentées.
  • Votre API REST, vos webhooks et vos formats d’import ou d’export.

Un changement qui oblige les acheteurs à modifier l’un de ces éléments est un changement incompatible (breaking change), même si l’application semble identique.

ChangementIncrément de versionExemple
Correction de bug sans modification des prérequis, de la configuration ni des points d’extensionPATCH (2.4.1 vers 2.4.2)Corriger des totaux erronés dans le rapport mensuel
Correctif de sécurité rétrocompatiblePATCHAjouter une vérification d’autorisation manquante sur la route d’export
Nouvelle fonctionnalité ; les installations existantes continuent de fonctionner après les migrationsMINOR (2.4.2 vers 2.5.0)Ajouter des rappels par SMS sous forme de module optionnel
Nouveau paramètre ou nouvelle variable d’environnement optionnels avec une valeur par défaut sûreMINORAjouter REPORTS_CACHE_MINUTES, valeur par défaut 10
Relèvement de la version minimale de PHP ou de la base de donnéesMAJOR (2.5.0 vers 3.0.0)Exiger PHP 8.4
Clé de configuration renommée, hook supprimé, réponse d’API modifiéeMAJORRenommer la gestion de MAIL_FROM ; supprimer l’API v1 obsolète
Mise à niveau majeure du framework qui modifie les chemins de surchargeMAJORPasser à une nouvelle version majeure du framework avec une nouvelle arborescence de dossiers

Deux règles pratiques aident : dépréciez avant de supprimer (avertissez dans une version MINOR, supprimez dans la MAJOR suivante), et gardez les versions MAJOR rares et bien documentées. Les acheteurs pardonnent les changements incompatibles ; ils ne pardonnent pas les surprises.

Rédigez un changelog digne de confiance

Un changelog s’écrit pour des personnes ; il ne se génère pas à partir des messages de commit. Le format très répandu Keep a Changelog regroupe les changements sous Added, Changed, Deprecated, Removed, Fixed et Security (ajouté, modifié, déprécié, supprimé, corrigé, sécurité), avec la version la plus récente en haut et une date pour chaque version. Voici un exemple de bonnes entrées :

[3.0.0] — 2026-11-10

Notes de mise à niveau : nécessite PHP 8.4. Exécutez les migrations. Le paramètre MAIL_FROM a été déplacé dans Paramètres > E-mail ; les valeurs existantes sont migrées automatiquement. Si vous surchargez resources/views/invoices, comparez votre copie avec le nouveau modèle.

Ajouté — Factures récurrentes avec relances automatiques. — Traduction en japonais.

Modifié — La mise en page des factures PDF prend désormais en charge les longues descriptions d’articles.

Supprimé — L’API REST v1, dépréciée depuis la 2.6.0. Utilisez la v2.

Sécurité — Les fichiers CSV exportés ne sont désormais accessibles qu’aux utilisateurs disposant de l’autorisation Rapports.

[2.6.1] — 2026-09-22

Corrigé — Le calendrier affichait les réservations avec une heure de décalage après un changement d’heure.

Remarquez les détails : la date, les notes de mise à niveau avant la liste, le paramètre exact qui a été déplacé, le dossier qui peut nécessiter une attention particulière et la raison d’une suppression. « Corrections de bugs et améliorations » n’apprend rien à l’acheteur et laisse penser que vous ne savez pas non plus ce qui a changé.

Publiez le changelog à trois endroits : sous forme de fichier dans le téléchargement, sur votre fiche produit et dans l’espace d’administration de l’application si vous affichez un avis de mise à jour. Une entrée récente et datée sur la fiche est l’un des signaux les plus forts que le produit est vivant.

Livrez des mises à jour que les acheteurs peuvent réellement appliquer

Les acheteurs de code source personnalisent. Si votre processus de mise à jour suppose une installation intacte, chaque version déclenche une vague de tickets de support. Concevez pour la personnalisation dès le départ.

Offrez aux personnalisations un emplacement sûr

  • Des dossiers de surcharge pour les vues, les traductions et les thèmes, que votre code consulte avant ses propres valeurs par défaut.
  • Des événements et des hooks aux moments importants (facture créée, utilisateur inscrit), pour que les acheteurs puissent ajouter un comportement sans modifier les classes du cœur.
  • Des options de configuration et des paramètres pour tout ce qu’un acheteur pourrait raisonnablement vouloir changer.
  • Un service provider personnalisé ou un dossier de modules que les mises à jour n’écrasent jamais.

Documentez ces points d’extension ; notre guide sur la documentation qui réduit les tickets de support montre comment rédiger le guide de personnalisation.

Préparez correctement chaque version

  1. Paquet complet : le code intégral pour les nouvelles installations et pour les acheteurs qui n’ont rien personnalisé.
  2. Notes de mise à niveau : changements de prérequis, migrations, nouveaux paramètres, fichiers modifiés que les acheteurs ont pu surcharger.
  3. Une liste des fichiers modifiés depuis la version précédente, pour que les acheteurs qui ont modifié des fichiers du cœur sachent quoi comparer.
  4. Des migrations de base de données qui s’exécutent sans risque sur les données existantes et qui sont testées sur une copie d’une base réaliste.
  5. Une procédure de mise à niveau recommandée : sauvegarder les fichiers et la base de données, passer l’application en mode maintenance, remplacer les fichiers, exécuter les migrations, vider les caches, tester, puis remettre l’application en ligne.

Pour les acheteurs qui utilisent Git, suggérez de conserver votre version d’origine sur une branche séparée et de fusionner chaque nouvelle version dans leur branche personnalisée. Les conflits montrent alors exactement où leurs modifications rencontrent les vôtres. Si votre produit repose sur Laravel, ajoutez dans vos notes un lien vers le guide de mise à niveau officiel du framework chaque fois qu’une version passe à une nouvelle version majeure du framework.

Informez les acheteurs qu’une mise à jour existe

Sur AppTrovo, vous publiez une nouvelle version de votre produit et les acheteurs peuvent télécharger les nouvelles versions tant que leur période de support et de mises à jour est active. Vous pouvez aussi afficher un avis de mise à jour dans votre application : l’API produit publique renvoie la version actuelle, de sorte que votre espace d’administration peut la comparer à la version installée et renvoyer vers le changelog. Vérifiez au maximum une fois par jour, et ne bloquez jamais l’application si la vérification échoue. Le guide d’intégration des licences contient un exemple.

Liste de contrôle de publication

  1. Choisissez le numéro de version à l’aide du tableau ci-dessus.
  2. Rédigez l’entrée du changelog et les notes de mise à niveau.
  3. Exécutez les tests, puis installez la version sur un serveur vierge.
  4. Mettez à niveau une copie de la version précédente contenant des données réalistes et quelques surcharges.
  5. Mettez à jour la documentation et les captures d’écran qui ont changé.
  6. Construisez le paquet à partir d’un commit tagué, sans fichiers de développement, journaux ni secrets.
  7. Déployez ce même build sur votre démo en ligne.
  8. Téléversez la nouvelle version et mettez à jour le changelog de la fiche produit.
  9. Surveillez attentivement les tickets pendant 48 heures et tenez-vous prêt à publier une version PATCH.

Rédigez une politique de support aux limites équitables

Sans politique écrite, le « support » finit par englober le développement sur mesure, l’administration de serveurs et la formation. Une courte politique sur votre fiche et dans votre documentation l’évite, et les acheteurs apprécient de savoir à quoi s’attendre. Sur AppTrovo, chaque produit dispose d’une période de support incluse que vous configurez (6 mois par défaut), et vous pouvez permettre aux acheteurs d’acheter un support plus long au moment du paiement ou de le prolonger plus tard.

Voici un modèle que vous pouvez adapter :

Politique de support

Inclus : aide à l’installation du produit sur un serveur compatible ; réponses aux questions sur les fonctionnalités et les paramètres ; corrections des bugs du code d’origine ; mises à jour de sécurité ; conseils sur l’endroit où effectuer les personnalisations courantes.

Non inclus : développement sur mesure ou nouvelles fonctionnalités pour un seul acheteur ; résolution de problèmes causés par des modifications du code ; configuration du serveur, de l’hébergement ou du fournisseur d’e-mail au-delà de nos prérequis documentés ; plugins ou services tiers.

Comment obtenir de l’aide : ouvrez un ticket de support depuis votre achat. Indiquez la version du produit, l’environnement serveur (versions de PHP et de la base de données), le message d’erreur exact et les étapes pour reproduire le problème.

Délai de réponse visé : nous nous efforçons de répondre sous deux jours ouvrés, du lundi au vendredi, en anglais. La résolution des problèmes complexes peut prendre plus de temps.

Période de support : le support et les mises à jour sont inclus pendant la période indiquée sur la page du produit et peuvent être prolongés depuis votre tableau de bord.

Fixez un délai de réponse que vous pouvez réellement tenir, y compris pendant les vacances. Une réponse fiable en deux jours vaut mieux qu’une réponse promise en une heure que vous ne tenez pas. Si vous proposez de la personnalisation payante, mentionnez-la séparément pour que les acheteurs sachent à qui s’adresser.

Le temps de support est un coût réel de chaque vente. À titre d’exemple, si un acheteur moyen ouvre trois tickets de vingt minutes chacun, chaque vente vous coûte une heure de travail pendant la période de support. Estimez ce chiffre à partir de vos premiers mois de tickets et intégrez-le à votre prix ; notre guide sur comment fixer le prix d’un code source explique comment. Vérifiez aussi que la politique ne contredit pas les conditions de licence de la place de marché, qui définissent ce que les acheteurs peuvent faire du code.

Rendez les tickets efficaces

  • Demandez la version, l’environnement, l’erreur exacte et les étapes directement dans le formulaire de ticket.
  • Ajoutez à l’espace d’administration une page d’informations système que les acheteurs peuvent copier dans un ticket.
  • Répondez avec un lien vers la documentation accompagné d’un court résumé, et améliorez la page si le lien n’a pas suffi.
  • Répondez publiquement aux avis et aux questions lorsque la réponse peut aussi aider de futurs acheteurs.

Traitez les problèmes de sécurité à part

Les correctifs de sécurité méritent leur propre processus, car les acheteurs exécutent votre code sur leurs serveurs avec les données de leurs clients.

  • Publiez un moyen de signaler les vulnérabilités, par exemple une adresse e-mail dédiée dans votre documentation. Un fichier security.txt, défini dans la RFC 9116, est l’emplacement standard pour l’indiquer sur votre site web.
  • Corrigez d’abord, divulguez ensuite. Publiez le PATCH, puis décrivez le problème dans la section Sécurité du changelog avec suffisamment de détails pour que les acheteurs puissent juger de l’urgence, mais sans exploit pas à pas.
  • Corrigez les anciennes versions encore prises en charge lorsque c’est possible, ou indiquez clairement aux acheteurs vers quelle version ils doivent migrer.
  • Demandez aux acheteurs de mettre à jour par tous les canaux dont vous disposez : la fiche produit, l’avis dans l’application et vos réponses au support.

Prévoyez la fin de vie

Aucun produit n’est maintenu éternellement. Décidez à l’avance comment vous mettrez fin au support d’une ancienne version majeure ou du produit entier. Annoncez-le dans le changelog, accordez aux acheteurs un préavis raisonnable et publiez une version finale contenant tous les correctifs de sécurité connus. Sur AppTrovo, un produit ayant émis des licences peut être retiré plutôt que supprimé : il n’est plus listé, mais chaque licence existante continue d’être vérifiée, de sorte que les installations des acheteurs ne sont pas affectées.

Questions fréquentes

Qu’est-ce que le versionnage sémantique, en termes simples ?

C’est un schéma de numérotation, MAJOR.MINOR.PATCH, dans lequel chaque nombre indique aux utilisateurs le type de changement contenu dans une version. PATCH signifie uniquement des corrections de bugs, MINOR de nouvelles fonctionnalités qui préservent le fonctionnement des installations existantes, et MAJOR un changement susceptible de demander du travail à l’utilisateur lors de la mise à niveau.

Que doit contenir un changelog ?

Chaque version a besoin d’un numéro, d’une date et d’entrées regroupées pour ce qui a été ajouté, modifié, déprécié, supprimé, corrigé et sécurisé. Pour les applications que les acheteurs installent eux-mêmes, ajoutez des notes de mise à niveau en tête de chaque version : nouveaux prérequis, migrations, paramètres déplacés et fichiers que les installations personnalisées doivent comparer.

À quelle fréquence publier des mises à jour ?

Publiez les correctifs PATCH dès qu’ils sont prêts, en particulier pour les problèmes de sécurité. De nombreux vendeurs regroupent les fonctionnalités dans des versions MINOR tous les un à trois mois, ce qui donne aux acheteurs un rythme prévisible. Des versions régulières et datées comptent plus que des versions fréquentes.

Les acheteurs doivent-ils payer les mises à jour ?

Sur AppTrovo, les acheteurs peuvent télécharger les nouvelles versions tant que leur période de support et de mises à jour est active, et ils peuvent prolonger cette période. Une fois celle-ci terminée, ils conservent la version dont ils disposent et peuvent continuer à l’utiliser dans le cadre de leur licence.

Le support doit-il inclure l’aide aux personnalisations ?

La plupart des vendeurs incluent des conseils sur l’endroit où effectuer les modifications courantes, mais excluent l’écriture de code sur mesure pour des acheteurs individuels. Indiquez-le clairement dans votre politique de support. Si vous souhaitez proposer des travaux de personnalisation, présentez-les comme un service payant distinct.