関連記事 取引先マスタの正式登録・編集は顧客マスタを参照。見積の具体編集は見積作成（構成表）や見積（標準）へ。受注起票後の進捗追跡は受注進捗ボード、営業全体の導線は営業業務フローを参照。 CRM 周辺 7 画面（活動ボード / 商談ルーム / キャンペーン分析 / LINE マネージャ等）の個別記事は Phase 2 で整備予定です。

概要

CRM Hub は、Opportunity（案件）・Quotation（見積）・Customer（顧客）・Project（プロジェクト） を 1 画面に統合した営業向けの司令塔ダッシュボードです。内部実装のメインクラスは CrmCommandCenter（v3.0、3388 行の JS + 30 を超える公開 API）。CRM 関連 7 画面の入口と 統合ダッシュボード を兼ねており、KPI センター（/app/crm-kpi-center）の機能も吸収済みです。

画面URL: /app/crm-hub

CRM Hub 全景（3ペイン×2スコープ×4タブ）

こんなときに使う

朝一で KPI（受注額 / パイプライン / 活動数） を確認し、今日動かすべき案件を決める
今週クローズ予定の フォーカス案件 と、動きが止まっている 危険案件 を 1 画面で見る
複数の見積を一括で 所有者変更・失注マーク・Sales Order 変換 する
Opportunity を確度と規模で評価し、Project 化 する判断をする
任意の DocType の数値フィールドを 月次 KPI として登録し、目標対実績で追う

受注前と受注後の境界

フェーズ	中心画面
リード〜商談（受注前）	CRM Hub（本記事） / 活動ボード / 商談パイプライン
見積提案	見積作成（構成表） / 見積（標準）
受注起票	個別受注入力 / 受注 Hub / EDI 取込 / FAX 受注
受注後の進捗	受注進捗ボード / 出荷伝票

CRM Hub は まだ受注になっていない案件 と見積を扱う画面、と覚えると他画面との棲み分けが明確になります。

画面構成：3 ペイン × 2 スコープ × 4 タブ

スコープ切替（2 モード）

画面上部でスコープを切り替えることで、同じ画面の見え方を 営業運用モード と プロジェクト管理モード に切り替えられます。

スコープ	内部キー	既定タブ	用途
営業運用	`crm`	案件	通常の営業活動（Opportunity 中心）
プロジェクト管理	`project`	プロジェクト	受注後の Project 管理

URL に ?scope=crm&tab=sales のように付けることで スコープ + タブの組み合わせをブックマーク可能 です。

メインタブ（4 タブ）

タブ	内部キー	内容
案件	`sales`	Opportunity の一覧・詳細（既定、crm スコープ時）
見積	`quotation`	Quotation の一覧 + ダッシュボード
受注変換	`conversion`	Opportunity / Quotation → Sales Order 変換センター（動的ロード）
プロジェクト	`project`	Project Hub 的機能（project スコープ時の既定）

3 ペイン構成

ペイン	役割
左ペイン	ビュー切替（pipeline / list / kanban 等）+ 保存ビュー
中央ペイン	現在のタブの一覧・カンバン・パイプライン
右ペイン	選択案件の詳細（activity / project / その他、`detailTab` で細分）

右ペインは折りたたみ可能（detailCollapsed）で、広い画面で一覧を俯瞰したいときは閉じて使います。

ヘッダ

検索 / フィルタ / ソート: タブ横断の汎用
チームフィルタ: scope: self（自分） / team（部門） / all（全社）
- all は Sales Manager 級の権限が前提
- team は部門長
- self は個人（既定）

主要機能（タブ別）

「案件」タブ（Opportunity 中心）

機能	概要
KPI ダッシュボード	受注額・パイプライン合計・案件数・活動数など 6-8 指標をカード表示
本日の ToDo	今日期限の営業タスク一覧
フォーカス案件 / 危険案件	重点ウォッチ / 遅延・無動きを自動検出してハイライト
最近の案件・活動	直近更新された Opportunity と活動ログ
パイプラインサマリ	ステージ別の件数・金額
案件クイック登録（v3.0）	モーダルから素早く Opportunity を起票
顧客ミニカード	顧客名ホバーで直近情報をポップアップ表示

KPI ダッシュボード（上部カード群）

フォーカス案件 / 危険案件パネル

パイプラインビューに切り替えると、ステージ別の件数・金額が一覧できます。

パイプラインビュー（ステージ別）

右ペインの「活動」タブを開くと、選択案件の活動タイムラインが表示されます。

右ペイン活動タイムライン

「見積」タブ

機能	概要
見積ダッシュボード	発行中・期限切れ間近・失注見込みの可視化
見積詳細	選択見積の要約と関連 Opportunity / Customer 情報
一括操作	所有者変更 / 失注マーク / Sales Order 一括変換

「受注変換」タブ

機能	概要
変換候補スコアリング	受注化確度を自動算出し候補を並べる
保存ビュー	スコアリング条件 + 期間などを保存・共有
一括変換	チェック選択した複数見積を一度に Sales Order 化

実装メモ: 受注変換タブは conversion_tab.js に切り出されており、タブを開いたタイミングで動的ロードされます。初回表示が若干遅れる場合があります。

「プロジェクト」タブ（project スコープ時の既定）

機能	概要
Opportunity → Project 変換	受注確度・規模に応じて Project を自動作成
Project 一覧 / 進捗	現在進行中のプロジェクト

KPI センター（統合機能）

CRM Hub は KPI センター（旧 /app/crm-kpi-center）の機能を吸収しており、CRM Hub 内で KPI 運用が完結します。

KPI の仕組み

任意の DocType の数値フィールド を KPI として登録可能
月次で 目標値 と 実績値 を管理
実績は collect_all_kpi_actuals が自動集計（DocType + フィルタ条件で抽出）
目標は save_kpi_targets で手動入力
集計プレビュー（preview_kpi_collection）で登録前に確認可能

代表的な KPI 設定例

指標	DocType	数値フィールド	フィルタ例
月次受注額	Sales Order	`grand_total`	status=Submitted
新規案件数	Opportunity	カウント	作成日 = 今月
商談転換率	計算値	—	Won / (Won + Lost)
月次売上高	Sales Invoice	`grand_total`	status=Paid

扱う DocType

DocType	用途
Opportunity（案件）	中核。`opportunity_from / party_name / customer_name / opportunity_amount / probability / expected_closing / status / sales_stage`
Quotation（見積）	「見積」タブの基盤
Customer（顧客）	ミニカード・紐付け
Project（プロジェクト）	Opportunity 変換時に自動作成
KPI Setting（カスタム）	KPI センターの設定保存先

UTM パラメータ（v16 以降）

Opportunity に utm_source / utm_campaign / utm_medium / utm_content の UTM プレフィックス化フィールドが存在します。流入経路の分析やキャンペーン分析（Phase 2 記事化予定）との連動基盤です。

主な操作

1. 朝一 15 分ルーチン（営業個人）

CRM Hub を開く（?scope=crm&tab=sales をブックマークしておくと早い）
KPI ダッシュボード で当月の受注額・パイプラインを確認
本日の ToDo で今日の予定をチェック
フォーカス案件 / 危険案件 パネルで動かす案件を決定
必要なら右ペインで 活動を追加（電話・メール・訪問）

2. 案件を Opportunity として起票する

「案件」タブ右上の 「＋案件」 ボタン（v3.0 から）をクリック
モーダルで最低限 顧客 / 金額 / 確度 / 予想成約日 を入力
保存 → 一覧に即時反映
詳細編集は右ペインで行うか、標準フォーム /app/opportunity/<name> へ遷移

3. 見積を一括で失注マークする

「見積」タブを開く
ダッシュボードで 期限切れ・長期停滞 のフィルタを適用
該当見積を複数選択
上部の 「一括失注マーク」 をクリック
失注理由を共通メモで付与 → 確定

4. 受注変換センターを使う

「受注変換」タブを開く（初回は動的ロードで少し待つ）
スコアリング結果で受注化確度の高い順に並ぶ候補を確認
条件（期間・顧客グループ等）を変えて 保存ビュー として登録
候補を複数チェック → 一括変換 で Sales Order 化
作成された Sales Order は /app/simple-order から以降の処理へ

5. Opportunity を Project 化する

「案件」タブで対象の Opportunity を選択
右ペインで 「Project 化」 をクリック
変換ダイアログで プロジェクト名 / 開始日 / 終了予定日 を入力
確定すると Project DocType が作成され、以降はプロジェクトスコープで管理

6. KPI を登録して月次で追う

CRM Hub 内の KPI センター領域を開く
「＋ KPI 追加」 をクリック
DocType + 数値フィールド + 集計方法（SUM / COUNT / AVG）+ フィルタ を設定
「プレビュー」 で集計結果を確認
月次目標 を登録 → 毎月実績が自動集計

ロールと権限

page role（[crm_hub.json]）に含まれるロール:

ロール	想定される用途
System Manager	全機能
Sales User	自担当の案件・見積・顧客の閲覧/編集
Sales Manager	team / all スコープ・KPI 目標設定・一括操作
Demo Viewer	読み取り専用（デモ紹介用）
Demo Operator	書込可のデモ運用

チームフィルタの scope=all は Sales Manager 級の権限、team は部門長、self は個人で使い分けます。

設定依存

必須

CRM Settings（ERPNext 標準） — 商談ステージ・販売ソース等
User の default_company（カスタムフィールド） — KPI 集計の会社スコープ

推奨事前データ

Sales Person マスタ（営業担当者マスタ） — 未整備だとチームフィルタが空になる
Territory マスタ（地域別集計）
Customer Group / Industry — 顧客分類
Sales Stage（商談ステージ） — Opportunity に紐づく、パイプラインビューの基盤

KPI 機能

カスタム KPI Setting DocType（collect_all_kpi_actuals が参照）
各 KPI の doctype + numeric_field + filter 設定
save_kpi_targets は Sales Manager ロール必要と推定

デモ環境の注意点

Opportunity / Quotation / Customer はデモ環境に存在しますが、Sales Stage の充実度によって パイプラインビューが空白 になる可能性
Sales Person マスタが未整備だとチームフィルタが有効にならない
Project 連携 には Project マスタのデータが必要
KPI 目標 が未登録だと KPI 関連パネルが空白になる
撮影向けのシナリオ:
- パイプラインビュー: Opportunity が各ステージに 最低 2 件ずつ 分布していると見栄え良し
- 受注変換タブ: get_conversion_candidates が返す候補が 5 件以上

ショートカット

CRM Hub 固有のキーボードショートカットは 現時点で未実装
Ctrl+F のフィルタフォーカス等はブラウザ / Frappe 標準ハンドラ
Awesome Bar (Ctrl+K) から CRM Hub と入力して遷移するのが最短

挙動の注意点

スコープ切替で URL が書き換わる — ?scope=project に変わると次回ロード時にプロジェクトモードで開く
タブ別の再読み込み制御: _tabLastLoad で直近読込時刻を記録し、短時間のタブ切替では再 fetch しない（キャッシュ的挙動）
受注変換タブは初回のみ遅延: conversion_tab.js が動的ロードされるため初回は若干重い
ローカル更新（v2.1 以降）: API 呼び出し後もローカルデータを直接更新してレスポンス速度を優先。サーバー側の再計算とズレる瞬間があり得る
楽観的ロックは不明: 複数人で同じ Opportunity を同時編集した場合は標準の Frappe 挙動（最後の保存が勝つ）

他の CRM 系 7 画面との関係

画面	関係性
CRM 活動ボード (`/app/crm-activity-board`)	独立画面。CRM Hub 右ペインの活動タブから連携
CRM 活動詳細 (`/app/crm-activity-detail`)	1 活動の深掘り
CRM キャンペーン分析 (`/app/crm-campaign-analytics`)	キャンペーン単位の成果分析
CRM 商談パイプライン (`/app/crm-deal-pipeline`)	CRM Hub のパイプラインビューと機能重複（将来統合候補）
CRM 商談ルーム (`/app/crm-deal-room`)	1 商談の深掘り専用ビュー
CRM KPI センター (`/app/crm-kpi-center`)	CRM Hub に吸収済
CRM LINE マネージャ (`/app/crm-line-manager`)	マネジメント専用、CRM Hub の team スコープと重複の可能性

Phase 2 で上記画面の個別記事化と整理（重複統合）を進める予定です。

Tips

ブックマーク URL: ?scope=crm&tab=sales / ?scope=project&tab=project など、運用ごとの起動 URL をブックマークして時短
KPI を 3 個まで: 最初から多くを登録せず、本当に追う指標 3 個に絞ると運用が定着しやすい
フォーカス案件は金額順に見ない: 金額順ではなく 確度 × 期限 で優先付けされる設計。表示順が直感と違うときはスコアリング条件を確認
受注変換の保存ビュー化: 四半期ごとの変換キャンペーン等、スコアリング条件を保存ビュー化しておくとチーム共有しやすい
UTM を埋める: 流入経路の UTM を埋めておくとキャンペーン分析 / 予実分析がリッチになる

よくある質問

Q: CRM Hub と受注 Hub（EC受注ワークベンチ）の違いは？

CRM Hub: リード〜商談〜見積の 受注前 の活動管理
受注 Hub: 確定済み注文（EC / EDI / FAX 等）の取込・レビュー

受注前（営業活動）と受注後（処理）で使い分けます。

Q: KPI センターは別画面と聞きました

以前は /app/crm-kpi-center として存在していましたが、CRM Hub v3.0 で本画面に統合されました。旧画面はまだアクセス可能ですが、機能は CRM Hub 側で完結します。

Q: Opportunity を Project 化すると Sales Order は作られますか？

いいえ、Opportunity → Project 変換と、Opportunity → Sales Order 変換は別物です。案件の性質に応じて使い分けます（長期スコープのプロジェクト型 vs 単発の受注型）。

Q: パイプラインビューが空白です

Sales Stage マスタが未整備か、Opportunity のステージが設定されていない可能性があります。管理者に Sales Stage マスタの整備を依頼してください。

Q: チームフィルタの `all` が表示されません

Sales Manager ロールまたは System Manager ロールが必要です。権限管理は管理者向けマニュアルを参照。

Q: UTM フィールドはどこで埋めますか？

主に Web フォームや外部連携で埋める想定ですが、手動でも Opportunity フォームから入力可能です（v16 以降の標準フィールド）。詳細はキャンペーン分析（Phase 2 記事化予定）で扱います。

Q: 一括操作で失敗した行はどう確認しますか？

一括操作の結果は処理後トーストに件数表示されますが、失敗行の詳細は現時点ではログから追う 必要があります。複数選択する場合は 10-20 件程度に区切って実行するとリスク低減できます。

次のステップ

顧客マスタの正式登録 → 顧客マスタ
構成表型の見積を作る → 見積作成（構成表）
標準の見積を作る → 見積（標準）
受注進捗の追跡 → 受注進捗ボード
営業業務全体像 → 営業業務フロー

概要