コンテンツへスキップ
For Sellers

コード販売者のためのサポート、アップデート、バージョン管理

購入者がインストールしてカスタマイズする Web アプリにセマンティックバージョニングとわかりやすい変更履歴を適用する方法、実際に適用できるアップデートの提供方法、そして適切な範囲を定めたサポートポリシーの書き方を解説します。変更履歴の記載例とポリシーのテンプレート付きです。

• Nov 17, 2026 • 読了1分
コード販売者のためのサポート、アップデート、バージョン管理

ソースコードの購入者が何よりも気にしているのは、「お金を払ったあとも、このプロダクトはメンテナンスされ続けるのか」という点です。この不安には、3つの習慣で応えられます。バージョン番号を見ればアップデートのリスクがわかるように、セマンティックバージョニングを使うこと。すべてのリリースを平易な言葉で説明する変更履歴を維持すること。そして、どのような支援が、どれくらいの期間含まれ、何が含まれないのかを明記したサポートポリシーを公開することです。

これらの習慣は、一度きりの販売を継続的な関係へと変えます。また、Web アプリや SaaS のソースコードを販売する方法のガイドで説明しているとおり、購入者が出品を信頼する大きな要因にもなります。本記事では、リリース番号の付け方、変更履歴の書き方、カスタマイズされた環境向けのアップデートのパッケージング、そして自分の時間を守るサポート範囲の設定といった具体的な手順を扱います。

セマンティックバージョニングを Web アプリに適用するには

Semantic Versioning は、MAJOR.MINOR.PATCH という3つの数字を使います。この仕様は公開 API を持つライブラリ向けに書かれたものなので、アプリケーション全体を販売する場合は、何を自分の「公開 API」とみなすかを決める必要があります。ソースコード製品の場合、それは購入者がインストール、設定、カスタマイズ、アップグレードの際に依存するものすべてです。

  • サーバー要件(言語、データベース、拡張機能のバージョン)。
  • 環境変数と設定キー。
  • 購入者がクエリを実行したり拡張したりする可能性のあるデータベーススキーマ。
  • 拡張ポイント:フック、イベント、オーバーライド用フォルダー、テーマファイル、ドキュメント化されたクラス。
  • REST API、Webhook、インポート・エクスポートの形式。

これらのいずれかについて購入者に変更を強いる変更は、たとえアプリの見た目が同じでも破壊的変更です。

変更内容バージョンの上げ方例
要件、設定、拡張ポイントに変更のないバグ修正PATCH(2.4.1 → 2.4.2)月次レポートの合計が誤っていた問題を修正
後方互換性のあるセキュリティ修正PATCHエクスポート用ルートに欠けていた認可チェックを追加
新機能。既存環境はマイグレーション後も引き続き動作するMINOR(2.4.2 → 2.5.0)SMS リマインダーをオプションモジュールとして追加
安全なデフォルト値を持つ、新しい任意の設定や環境変数MINORREPORTS_CACHE_MINUTES を追加(デフォルト値は10)
PHP やデータベースの最低バージョンの引き上げMAJOR(2.5.0 → 3.0.0)PHP 8.4 を必須にする
設定キーの名称変更、フックの削除、API レスポンスの変更MAJORMAIL_FROM の扱いを変更、非推奨の v1 API を削除
オーバーライドのパスが変わるフレームワークのメジャーアップグレードMAJORフォルダー構成が新しくなるフレームワークの新メジャーバージョンへ移行

実務上役立つルールが2つあります。削除する前に非推奨にすること(ある MINOR リリースで警告し、次の MAJOR で削除する)、そして MAJOR リリースは頻度を抑え、十分にドキュメント化することです。購入者は破壊的変更なら許してくれますが、不意打ちは許してくれません。

購入者が信頼できる変更履歴を書く

変更履歴はコミットメッセージから自動生成するものではなく、人に向けて書くものです。広く使われている Keep a Changelog 形式では、変更を Added、Changed、Deprecated、Removed、Fixed、Security に分類し、最新のリリースを先頭に置いて、各バージョンに日付を付けます。良い記載例は次のとおりです。

[3.0.0] — 2026-11-10

アップグレード時の注意:PHP 8.4 が必要です。マイグレーションを実行してください。MAIL_FROM の設定は「設定 > メール」に移動しました。既存の値は自動的に移行されます。resources/views/invoices をオーバーライドしている場合は、お手元のコピーを新しいテンプレートと比較してください。

Added — 自動リマインダー付きの定期請求書。— 日本語翻訳。

Changed — 請求書 PDF のレイアウトが長い品目説明に対応しました。

Removed — 2.6.0 で非推奨となった v1 REST API。v2 をご利用ください。

Security — エクスポートされた CSV ファイルは、レポート権限を持つユーザーのみが利用できるようになりました。

[2.6.1] — 2026-09-22

Fixed — 夏時間の切り替え後、カレンダーに予約が1時間ずれて表示されていた問題。

細部に注目してください。日付、一覧の前に置かれたアップグレード時の注意、移動した設定の正確な名前、確認が必要になる可能性のあるフォルダー、そして何かを削除した理由が書かれています。「バグ修正と改善」という記載は購入者に何も伝えず、販売者自身も何が変わったのか把握していないのではないかという印象を与えます。

変更履歴は3か所で公開しましょう。ダウンロードパッケージ内のファイルとして、出品ページ上で、そしてアップデート通知の仕組みがあればアプリの管理画面内でです。出品ページに日付入りの最近の記載があることは、プロダクトが活発に開発されていることを示す最も強力なシグナルの1つです。

購入者が実際に適用できるアップデートを提供する

ソースコードの購入者はカスタマイズを行います。アップデートの手順が手を加えていない環境を前提にしていると、リリースのたびにサポートチケットが押し寄せることになります。最初からカスタマイズを想定した設計にしましょう。

カスタマイズのための安全な置き場所を用意する

  • ビュー、翻訳、テーマ用のオーバーライド用フォルダー。コードは自身のデフォルトより先にこれらを確認します。
  • 重要なタイミング(請求書の作成、ユーザー登録など)でのイベントとフック。これにより、購入者はコアクラスを編集せずに動作を追加できます。
  • 購入者が変更したいと考えるのが自然なものすべてに対する設定と設定画面。
  • アップデートで決して上書きされない、カスタムのサービスプロバイダーやモジュール用フォルダー。

これらの拡張ポイントはドキュメント化してください。カスタマイズガイドの書き方は、サポートチケットを減らすドキュメントのガイドで紹介しています。

リリースごとに適切にパッケージングする

  1. フルパッケージ:新規インストール用、およびカスタマイズしていない購入者向けの完全なコード。
  2. アップグレード時の注意:要件の変更、マイグレーション、新しい設定、購入者がオーバーライドしている可能性のある変更ファイル。
  3. 前回のリリースからの変更ファイル一覧:コアファイルを編集した購入者が、何を比較すればよいかわかるようにします。
  4. データベースマイグレーション:既存データに対して安全に実行でき、現実的なデータベースのコピーでテスト済みであること。
  5. 推奨アップグレード手順:ファイルとデータベースをバックアップし、アプリをメンテナンスモードにし、ファイルを置き換え、マイグレーションを実行し、キャッシュをクリアし、テストしてから、アプリを再開します。

Git を使っている購入者には、オリジナルのリリースを別ブランチで管理し、新しいリリースが出るたびに自分たちのカスタマイズ済みブランチへマージする方法を勧めましょう。そうすれば、競合箇所が、購入者の変更とあなたの変更がぶつかる場所を正確に示してくれます。プロダクトが Laravel で構築されている場合は、フレームワークの新しいメジャーバージョンに移行するリリースのたびに、注意事項の中でフレームワーク公式のアップグレードガイドへのリンクを示してください。

アップデートの存在を購入者に知らせる

AppTrovo では、プロダクトの新しいバージョンを公開すると、購入者はサポートとアップデートの期間が有効な間、新しいバージョンをダウンロードできます。アプリ内でアップデート通知を表示することも可能です。公開プロダクト API が現在のバージョンを返すので、管理画面でインストール済みのバージョンと比較し、変更履歴へのリンクを表示できます。チェックは多くても1日1回にとどめ、チェックが失敗してもアプリの動作を妨げないようにしてください。ライセンス連携ガイドに実装例があります。

リリースチェックリスト

  1. 上の表を参考にバージョン番号を決めます。
  2. 変更履歴の記載とアップグレード時の注意を書きます。
  3. テストを実行し、クリーンなサーバーにリリースをインストールします。
  4. 現実的なデータといくつかのオーバーライドを入れた旧バージョンのコピーをアップグレードします。
  5. 変更のあったドキュメントとスクリーンショットを更新します。
  6. 開発用ファイル、ログ、シークレットを含めずに、タグ付きコミットからパッケージをビルドします。
  7. 同じビルドをライブデモにデプロイします。
  8. 新しいバージョンをアップロードし、出品ページの変更履歴を更新します。
  9. 48時間はチケットを注意深く見守り、すぐに PATCH リリースを出せるよう備えておきます。

適切な範囲を定めたサポートポリシーを書く

文書化されたポリシーがないと、「サポート」はいつの間にかカスタム開発、サーバー管理、さらには指導まで含むように膨らんでいきます。出品ページとドキュメントに短いポリシーを掲載すればそれを防げますし、購入者も何を期待すればよいかがわかるので歓迎してくれます。AppTrovo では、各プロダクトに販売者が設定する付属サポート期間(デフォルトは6か月)があり、購入者が購入時により長いサポートを購入したり、後から延長したりできるようにすることも可能です。

以下は、自由にアレンジして使えるテンプレートです。

サポートポリシー

含まれるもの:サポート対象のサーバーへのプロダクトのインストール支援、機能や設定に関する質問への回答、オリジナルのコードに含まれるバグの修正、セキュリティアップデート、よくあるカスタマイズをどこで行えばよいかについての案内。

含まれないもの:特定の購入者のためのカスタム開発や新機能の追加、コードの改変によって生じた問題の修正、ドキュメントに記載された要件を超えるサーバー・ホスティング・メールプロバイダーの設定、サードパーティのプラグインやサービス。

サポートの受け方:購入履歴からサポートチケットを作成してください。プロダクトのバージョン、サーバー環境(PHP とデータベースのバージョン)、正確なエラーメッセージ、再現手順を記載してください。

回答目標:月曜日から金曜日の営業日において、2営業日以内に英語で回答することを目標としています。複雑な問題は解決までにさらに時間がかかる場合があります。

サポート期間:サポートとアップデートは商品ページに表示された期間内に含まれており、ダッシュボードから延長できます。

回答目標は、休暇の時期も含めて実際に守れる水準に設定してください。約束しても守れない1時間以内の回答より、確実に守れる2日以内の回答のほうが優れています。有償のカスタマイズを提供する場合は、購入者がどこに依頼すればよいかわかるよう、別途記載しましょう。

サポートにかかる時間は、すべての販売に伴う実際のコストです。説明用の例として、平均的な購入者が1件20分かかるチケットを3件作成するとすれば、サポート期間中に1件の販売ごとに1時間の作業が発生します。最初の数か月のチケットからこの数字を見積もり、価格に織り込みましょう。その方法はソースコードの価格設定方法のガイドで紹介しています。また、購入者がコードで何をしてよいかを定めたマーケットプレイスのライセンス条項と、ポリシーの内容が矛盾していないことも確認してください。

チケット対応を効率化する

  • バージョン、環境、正確なエラー、再現手順をチケットのフォーム自体で尋ねるようにします。
  • 購入者がチケットにコピーできるシステム情報ページを管理画面に追加します。
  • ドキュメントへのリンクと短い要約で回答し、リンクが役に立たなかった場合はそのページを改善します。
  • 回答が将来の購入者にも役立つ場合は、レビューや質問に公開の場で返信します。

セキュリティ問題は別扱いにする

購入者はあなたのコードを自社のサーバーで、自社の顧客データとともに運用しています。そのため、セキュリティ修正には専用のプロセスを設けるべきです。

  • 脆弱性の報告窓口を公開します。たとえば、ドキュメントに専用のメールアドレスを記載します。security.txt ファイル(RFC 9116 で定義)は、Web サイト上でそれを掲載するための標準的な場所です。
  • まず修正し、その後で公表します。PATCH をリリースしてから、変更履歴の Security セクションで問題を説明します。購入者が緊急度を判断できる程度の詳細を記載しつつ、段階的な攻撃手順は書かないようにします。
  • サポート対象の旧バージョンも修正します。現実的に可能な場合は修正し、難しければどのバージョンに移行する必要があるかを購入者に明確に伝えます。
  • 購入者にアップデートを促します。出品ページ、アプリ内の通知、サポートでの返信など、利用できるあらゆるチャネルを使います。

サポート終了を計画する

永遠にメンテナンスされるプロダクトはありません。古いメジャーバージョン、あるいはプロダクト全体のサポートをどのように終了するかを事前に決めておきましょう。変更履歴で告知し、購入者に十分な猶予期間を設け、既知のセキュリティ修正をすべて含めた最終リリースを公開します。AppTrovo では、ライセンスを発行済みのプロダクトは削除ではなく「引退」させることができます。出品一覧からは外れますが、既存のライセンスはすべて引き続き検証されるため、購入者のインストール環境には影響しません。

よくある質問

セマンティックバージョニングを簡単に言うと何ですか?

MAJOR.MINOR.PATCH という番号付けのルールで、それぞれの数字がリリースにどのような種類の変更が含まれているかをユーザーに伝えます。PATCH はバグ修正のみ、MINOR は既存の環境を壊さない新機能、MAJOR はアップグレード時にユーザー側で作業が必要になる可能性のある変更を意味します。

変更履歴には何を含めるべきですか?

各リリースには、バージョン番号、日付、そして追加、変更、非推奨、削除、修正、セキュリティ対応の内容を分類した記載が必要です。購入者が自分でインストールするアプリケーションの場合は、各リリースの冒頭にアップグレード時の注意を加えましょう。新しい要件、マイグレーション、移動した設定、カスタマイズ済みの環境で比較すべきファイルなどです。

アップデートはどのくらいの頻度でリリースすべきですか?

PATCH の修正は、特にセキュリティ問題の場合、準備ができ次第リリースしてください。多くの販売者は、1〜3か月ごとに機能をまとめて MINOR リリースとして出しており、購入者にとって予測しやすいリズムになっています。頻度よりも、日付の入ったリリースを定期的に出すことのほうが重要です。

購入者はアップデートに料金を払う必要がありますか?

AppTrovo では、購入者はサポートとアップデートの期間が有効な間、新しいバージョンをダウンロードでき、その期間を延長することもできます。期間が終了した後も、手元のバージョンはそのまま保持され、ライセンスの範囲内で使い続けられます。

サポートにカスタマイズの支援を含めるべきですか?

多くの販売者は、よくある変更をどこで行えばよいかの案内は含めつつ、個々の購入者向けにカスタムコードを書くことは除外しています。この点はサポートポリシーで明確に述べてください。カスタマイズ作業を提供したい場合は、別の有償サービスとして提示しましょう。