プロンプトテンプレート利用状況のカウント機能¶

1. メタデータ¶

• 作成者: 明石穂崇
• 作成日: 2026/03/26
• 承認日: 2026/03/27

2. 目的と背景 (Why)¶

• なぜこれを作るのか？: 現在提供しているRAGサービスにおいて、ユーザーがコピーして利用できる「プロンプトテンプレート」があるが、どのテンプレートがどの程度活用されているかのデータが取得できていない。利用実態を可視化することで、UXの改善やコンサルティングにおける提案の質を向上させる必要がある。
• 目指すゴール: 各プロンプトテンプレートの利用回数（コピー回数や適用回数）が自動的にカウントされ、統計データとして管理者が確認できる状態。

3. ターゲットユーザー (Who)¶

• 誰のための機能か？:
• サービス運営者（どのテンプレートが人気か把握したい）
• コンサルタント（ユーザーの利用傾向を分析し、より良い提案に繋げたい）
• エンドユーザー（間接的に：よく使われているテンプレートが優先表示されるなどのUX改善の恩恵を受ける）

4. ユーザーメリットと想定効果 (Value & ROI)¶

• ユーザーが得られる価値:
• 運営側は、ユーザーのニーズを正確に把握し、より実用的なテンプレートの拡充が可能になる。
• コンサルタントは、利用統計に基づいた具体的なアドバイスが可能になり、顧客満足度が向上する。
• 想定効果: テンプレートの利用率向上、ユーザー離脱率の低下、コンサルティング業務の効率化と品質向上。

5. 機能要件 (What)¶

• 主要な機能 / ユーザーストーリー:
• イベントトラッキング: ユーザーがテンプレート詳細を表示、または「コピー」ボタンをクリックした際に、イベントを記録する。
• 利用数カウント: テンプレートごとの累積利用回数をデータベース（Firestore等）に保存・更新する。
• 統計データの可視化: 管理画面等で、期間別やテンプレート別の利用ランキング・推移を確認できる。

6. 非機能要件・やらないこと¶

• システム要件: カウント処理がメインのチャット機能やRAGのレスポンス性能に影響を与えないこと（非同期処理の検討）。