🌟 伴星（Co-Star）— プラットフォーム機能紹介

💰 支援システム

視聴者はクリエイター専用ページで複数の決済手段から支援できます。任意金額または固定金額を選べ、メッセージとニックネーム（または匿名）を添えられます。

• prod / stage の2環境に対応（stageはテスト用で、注文は実際に請求されません）
• TTSによるメッセージ読み上げ（有効化が必要）
• 固定支援金額の選択肢を設定できます

🎵 リクエスト曲ページ

• 視聴者は支払い後、クリエイターがアップロードした曲をリクエストできます
• クリエイターは管理画面で楽曲一覧（アップロード、並び順、有効／なし効）を管理できます
• リクエスト曲の結果はOBS表示と連携できます
• stageテスト環境にも対応しています

🎁 交換アイテム

• クリエイターは支援者向けに交換アイテム（カスタムグッズ、特別サービスなど）を設定できます
• 交換条件、説明、在庫は自由に設定できます
• ポイントによるメンバーランク交換に対応し、必要ポイント、有効期間、有効状態を設定できます
• メンバーランク交換はOBSアニメーションと連携でき、専用画像、効果音、TTS、表示テンプレートに対応します

🎬 OBS連携

すべてのOBS機能はBrowser Source URLとしてOBS Studioに埋め込みます。設定センターはクリエイター管理画面にあります。

• OBS進捗バー（obs_progress.php）には外部API支援金額も含まれます（プラットフォーム課金除外ルールの影響を受けません）
• アニメーショントリガーは obs_trigger.json で制御され、obs_check.php をBrowser Sourceがポーリングします

🔌 外部プラットフォームAPI

第三者システム（YouTubeやTwitch botなど）はAPI経由で支援イベントをプラットフォームへ送信し、OBSアニメーションとログをトリガーできます。

• payment_method は api_ を接頭辞にしてください（例：api_youtube、api_twitch）
• dry_run=1 に対応：データベースには書き込まず、OBSとログだけをトリガーするためテストに適しています
• すべてのレスポンスに env 項目が含まれます。dry_run 使用時はレスポンスにも dry_run が含まれます
• api_membership.php でメンバーランク状態を照会できます。creator とSecret Keyによる検証が必要です
• 外部API支援はプラットフォーム手数料の集計対象外です

🛠️ クリエイター管理画面

※ 管理画面はアカウント権限に応じて機能を表示します（一般クリエイター／プラットフォーム管理者）

📨 サポートチケットとメール対応

管理画面またはメールからサポートチケットを作成し、案件番号を使って継続的にやり取りできます。

• 登録済みアカウントのメールアドレスから送信すると、自動的にサポートチケットを作成します
• 未登録のメールアドレスには、ログイン後にチケットへ紐付けるための一回限りのリンクを送信します
• 受付確認と担当者からの返信はメールで通知され、件名の案件番号を保持して返信すると元のチケットへ追加されます
• Web 画面とメールの両方で複数添付に対応し、1 ファイル 10MB 上限で同じ返信内にまとめて表示されます
• メール内容と管理画面から追加したメッセージは、同じチケットの履歴としてまとめて確認できます

📊 料金説明

• 現在の試験運用期間中は、プラットフォーム手数料はかかりません
• 本番運用後、月間受取総額が 10,000（クリエイターの主要通貨） 以上の場合、既定の 1.5% でプラットフォーム手数料を計算します
• 本番運用後、月間プラットフォーム請求上限は 1,500（クリエイターの主要通貨） です。上限が0の場合は制限なしを意味します
• 課金統計には通常の決済注文のみを含め、外部API由来の注文は含めません