Assist_Design/docs/ja/how-it-works/subscriptions.md

sidebar_position, title

sidebar_position	title
8	サブスクリプション

サブスクリプションとサービス

アクティブなサービスの表示と更新方法を説明します。

データソース

• サブスクリプション（サービス/商品）はマッピングされたクライアントID経由でWHMCSから読み取ります。
• ステータス（Active、Pending、Suspended、Cancelled、Completed）はWHMCSから直接取得。

鮮度

• サブスクリプション一覧は5分、個別サブスクリプションは10分キャッシュ。
• WHMCSが変更を通知（Webhook）するか、関連サービスに影響する可能性のあるプロフィール/住所データを更新した際にキャッシュをクリア。

表示内容

• WHMCSに保存されているサービス名、ステータス、開始日、金額、通貨。
• サブスクリプションはダッシュボード統計にも使用（例：アクティブ数）。統計はキャッシュ無効化後に更新。

エラー時の動作

• WHMCSマッピング不足：空のリストではなく明確なエラーを返却。
• WHMCS利用不可：「後でやり直してください」を表示。失敗をキャッシュしません。