要件定義
このツールの用語・計算式・閾値・優先順ルール
概要
CS 部(カスタマーサポート部)の日次対応をバリュー換算して可視化・目標管理する社内ツール。 オペレーターが受電・架電・テキスト対応の中でアクション(解約阻止、アップセル、クロスセル等)を記録し、 それぞれに設定された単価で集計される。
データは Supabase の daily_records テーブルに蓄積され、 リアルタイムでビュー v_daily_records_with_value を通じて集計される。
| パス | 対象 | 役割 |
|---|---|---|
| /me | オペレーター | 個人実績・履歴・編集 |
| /input | オペレーター | カート式でアクション記録 |
| /teams | SV / リーダー | チーム内 4タブ |
| /unpaid | 専任者 | 未入金了承・回収率 |
| /analytics | 部長 | 6タブ・CSV出力 |
| /targets | 部長 | フロント目標(学生チーム除外) |
| /targets/students | 部長 | 学生目標(学生チームのみ) |
| /admin | 部長 | マスタ管理・データ管理 |
| /products | 部長 | 商品別の推移 |
区分・カテゴリ
アクションを大きく分類する軸。目標設計の基礎単位になる。
- リピート: 既存顧客の離脱防止・売上拡大(解約阻止達・アップセル・クロスセル・年間)
- CPO: 新規獲得コスト系(カゴ落ち・受電新規)
- 決済: 単独区分(クレジット)
チーム・メンバー
| チーム | 種別 | 在籍 |
|---|---|---|
| 西田チーム | フロント | 5 |
| 岩本チーム | フロント | 5 |
| 岩下チーム | フロント | 5 |
| 川口チーム | フロント | 5 |
| 渡邊チーム | フロント | 5 |
| 学生チーム | 学生 | 20 |
| 林チーム | 管理 | 5 |
| その他 | その他 | 2 |
チーム所属は記録時点でスナップショットされ、過去実績はメンバーが異動しても変わらない(daily_records.team_id_at_record)。
商品
チャネル
- 受電
- 架電
- テキスト
バリュー計算
アクション1件ごとのバリュー = 商品 × アクション の単価
単価は value_coefficients に 商品 × アクションの 525 通りで格納。期間の有効性(valid_from / valid_to)も持つ。
/targets の「事業計画ベース」で 予測問い合わせ数 × この単価 を目標値として使う。
目標算出
基準は「3ヶ月平均」または「直近月のみ」から選択可。
問い合わせ数と単価は手動入力可。空欄時は過去実績から自動算出。
- 手動修正が最優先(合計セルクリックで絶対値上書き)
- 手動修正以外のチームは
生産性DPP × 在籍数 × 重みで按分 - 合計が常に部門目標と一致するように正規化
目標設計は「/targets(フロント目標)」と「/targets/students(学生目標)」の2ページに分離。 チーム特性が大きく異なるため混在を避け、各ページに独自の季節プリセット・重み・手動修正を持つ。
両ページに 全社合計 ヘッダーを表示(このページ + もう片方)。もう片方のページへのリンク付き。
プリセットはページごとに異なる(選択できるのは当該スコープ内のチームに適した係数のみ)。
| プリセット | 係数 | ページ | 用途 |
|---|---|---|---|
| 通常月 | ×1.00 | 両ページ | 実績どおり |
| 年始 / 正月 | ×0.85 | フロント | 営業日減・閑散期 |
| キャンペーン月 | ×1.20 | フロント | 販促強化で +20% |
| 保守 | ×0.90 | フロント | 確実に達成 |
| 学生 長期休み | ×1.15 | 学生 | GW / 夏休み / 春休み |
| 大学期 | ×0.70 | 学生 | 授業期間でシフト大幅減 |
1.0 基準で 0〜3.0 の範囲で調整可(0 で当該チームを完全除外)。重みを適用するとチーム配分ロジックに反映され、 対象月とスコープごとに LocalStorage cs.team_weights.{scope}.{YYYY-MM} に保存(scope = front / student)。
- 前月比 ±20% 以上 → 「急増 / 急減」バッジ+赤/緑着色
- ±20% 未満 → グレー表示
- 前月に team_targets が未設定なら表示しない
達成色の閾値(マイページ専用)
- ¥100,000 以上 → 赤(HOT)
- ¥200,000 以上 → 金(GOLD)
- ¥300,000 以上 → 虹(RAINBOW)
- ¥1,000,000 以上 → 赤
- ¥2,000,000 以上 → 金
- ¥3,000,000 以上 → 虹
日数比例。日あたり ¥100k / 200k / 300k 換算で判定。
達成色は /me のみ。/teams・/analytics・/targets 等では装飾なしで比較しやすさを優先。
未入金フロー
クレジット決済の失敗・督促が必要な顧客の月次管理。専任者が手動記録。
- 了承数: 顧客が支払同意した件数
- 回収率: 了承数 ÷ 未入金件数
- 月次推移: 回収率のトレンド
セッション管理
認証なし。メンバー選択を LocalStorage cs.me に保存するのみ。 社内ツール前提。B2B販売時は Supabase Auth + RLS に切替予定。
旧キー 志.me は自動マイグレーションで透過的に移行。
優先順ルール
- 手動修正(合計セル直接編集)
- 重み × 生産性DPP × 成長率係数
- 部門目標は過去実績方式 または 事業計画ベース のどちらかで算出
team_id_at_record(記録時点のチーム)を優先- メンバーがチームを移動しても過去実績は変わらない
編集保存時に updated_at が一致しない場合は保存を拒否。 他ブラウザでの同時編集による上書きを防ぐ。
このページはコード・DB 定義から自動生成される運用想定。チーム・商品・アクション等の一覧は Supabase から取得(マスタ変更で自動反映)。 計算式・閾値・優先順はコード側で管理(変更時はこのページも手動更新必須)。