#CRM 2.0 システム詳細設計

#1. システム概要と設計理念

#1.1 システムのポジショニング

本システムは、NocoBase 構成済みのノーコードプラットフォームをベースに構築された CRM 2.0 営業管理プラットフォームです。主な目標は以下の通りです：

営業担当者がデータ入力や繰り返しの分析ではなく、顧客との関係構築に集中できるようにする

システムはワークフローを通じて定型業務を自動化し、AI の補助を借りてリードスコアリングや商機分析などを行うことで、営業チームの効率向上を支援します。

#1.2 設計理念

#理念 1：完全なセールスファネル

エンドツーエンドの営業プロセス：

なぜこのように設計するのか？

#理念 2：設定可能なセールスパイプライン

業界ごとにセールスパイプラインのステージをカスタマイズでき、コードの修正は不要です。

#理念 3：モジュール化設計

• コアモジュール（顧客 + 商機）は必須、その他のモジュールは必要に応じて有効化可能
• モジュールの無効化にコードの修正は不要で、NocoBase のインターフェース設定から行えます
• 各モジュールは独立して設計されており、結合度を低く保っています

#2. モジュールアーキテクチャとカスタマイズ

#2.1 モジュールの概要

CRM システムはモジュール化アーキテクチャを採用しており、各モジュールはビジネスニーズに応じて独立して有効化または無効化できます。

#2.2 モジュールの依存関係

#2.3 プリセットバージョン

#2.4 モジュールとコレクションのマッピング

#コアモジュールのコレクション（常に必須）

#2.5 モジュールの無効化方法

NocoBase 管理画面で該当モジュールのメニューエントリを非表示にするだけです。コードの修正やコレクションの削除は必要ありません。

#3. コアエンティティとデータモデル

#3.1 エンティティ関係の概要

#3.2 コアコレクションの詳細

#3.2.1 リードテーブル（nb_crm_leads）

簡略化された 4 ステージのワークフローによるリード管理。

ステージプロセス：

新規 → 対応中 → 検証済み → 顧客/商機へ変換
         ↓          ↓
      不適格      不適格

主要フィールド：

#3.2.2 顧客テーブル（nb_crm_customers）

海外取引にも対応した顧客/会社管理。

主要フィールド：

#3.2.3 商機テーブル（nb_crm_opportunities）

設定可能なセールスパイプラインステージを採用した商機管理。

主要フィールド：

#3.2.4 見積テーブル（nb_crm_quotations）

多通貨と承認フローをサポートする見積管理。

ステータスフロー：

下書き → 承認待ち → 承認済み → 送付済み → 承諾/却下/期限切れ
           ↓
        却下済み → 修正 → 下書き

主要フィールド：

#3.2.5 注文テーブル（nb_crm_orders）

入金追跡を含む注文管理。

主要フィールド：

#3.3 コレクション一覧

#CRM 業務コレクション

#基礎データコレクション（共通モジュール）

#3.4 補助テーブル

#3.4.1 コメントテーブル（nb_crm_comments）

多様な業務オブジェクトに関連付け可能な汎用コメント/備考テーブル。

#3.4.2 顧客共有テーブル（nb_crm_customer_shares）

顧客の複数人での共同作業と権限共有を実現します。

#3.4.3 商機共同作業者テーブル（nb_crm_opportunity_users）

商機の営業チームによる共同作業をサポートします。

#3.4.4 地域テーブル（nb_cbo_regions）

国/地域の基礎データ辞書。

#4. リードのライフサイクル

リード管理は簡略化された 4 ステージのワークフローを採用しています。新規リード作成時にワークフローを通じて AI スコアリングを自動実行し、営業担当者が高品質なリードを迅速に特定できるよう支援します。

#4.1 ステータスの定義

#4.2 ステータスフロー図

#4.3 リード変換プロセス

変換インターフェースでは 3 つのオプションを同時に提供し、ユーザーは作成または関連付けを選択できます：

• 顧客：新規顧客を作成、または既存顧客に関連付け
• 連絡先：新規連絡先を作成（顧客に関連付け）
• 商機：商機の作成は必須

変換後の記録：

• converted_customer_id：関連付けられた顧客 ID
• converted_contact_id：関連付けられた連絡先 ID
• converted_opportunity_id：作成された商機 ID

#5. 商機のライフサイクル

商機管理は設定可能なセールスパイプラインステージを採用しています。商機のステージ変更時に AI 成約率予測を自動実行し、営業担当者がリスクとチャンスを特定できるよう支援します。

#5.1 設定可能なステージ

ステージは nb_crm_opportunity_stages テーブルに保存され、カスタマイズ可能です：

#5.2 パイプラインフロー

#5.3 停滞検知

活動のない商機にはフラグが立てられます：

-- 停滞日数の計算
UPDATE nb_crm_opportunities
SET stagnant_days = EXTRACT(DAY FROM NOW() - last_activity_at)
WHERE stage NOT IN ('won', 'lost');

#5.4 受注/失注処理

受注時：

1. ステージを 'won' に更新
2. 実際の完了日を記録
3. 顧客ステータスを 'active' に更新
4. 注文作成をトリガー（見積が承諾されている場合）

失注時：

1. ステージを 'lost' に更新
2. 失注理由を記録
3. 競合他社 ID を記録（競合に負けた場合）
4. マネージャーに通知

#6. 見積のライフサイクル

#6.1 ステータスの定義

#6.2 承認ルール（検討中）

承認フローは以下の条件に基づいてトリガーされます：

#6.3 多通貨対応

#設計理念

すべてのレポートと分析において 米ドル（USD）を統一基準通貨 として使用します。各金額レコードには以下を保存します：

• 元の通貨と金額（顧客に提示するもの）
• 取引時の為替レート
• 米ドル換算額（内部比較用）

#通貨辞書テーブル（nb_cbo_currencies）

通貨設定は共通基礎データテーブルを使用し、動的な管理をサポートします。current_rate フィールドは現在の為替レートを保持し、定期タスクによって nb_crm_exchange_rates の最新レコードから更新されます。

#為替レート履歴テーブル（nb_crm_exchange_rates）

過去の為替レートデータを記録します。定期タスクが最新レートを nb_cbo_currencies.current_rate に同期します。

説明：見積書は currency_id 外鍵を通じて nb_cbo_currencies テーブルに関連付けられ、為替レートは current_rate フィールドから直接取得されます。商機と注文は currency VARCHAR フィールドを使用して通貨コードを保存します。

#金額フィールドのパターン

金額を含むテーブルはこのパターンに従います：

適用対象：

• nb_crm_opportunities.amount → amount_usd
• nb_crm_quotations.total_amount → total_amount_usd

#ワークフロー連携

為替レート取得ロジック：

1. 業務操作時に nb_cbo_currencies.current_rate からレートを直接取得
2. 米ドル取引：レート = 1.0、検索不要
3. current_rate は定期タスクにより nb_crm_exchange_rates の最新レコードから同期

#6.4 バージョン管理

見積が却下または期限切れになった場合、新しいバージョンとしてコピーできます：

QT-20260119-001 v1 → 却下済み
QT-20260119-001 v2 → 送付済み
QT-20260119-001 v3 → 承諾

#7. 注文のライフサイクル

#7.1 注文の概要

注文は見積が承諾されたときに作成され、確定したビジネス上の約束を表します。

#7.2 注文ステータスの定義

#7.3 注文データモデル

#nb_crm_orders

#nb_crm_order_items

#7.4 入金追跡

#nb_crm_payments

#8. 顧客のライフサイクル

#8.1 顧客の概要

顧客はリード変換時または商機受注時に作成されます。システムは獲得から推奨者（アドボケイト）までのライフサイクル全体を追跡します。

#8.2 顧客ステータスの定義

#8.3 顧客健全性スコアリング

複数の要因に基づいて顧客健全性を計算します：

健全性しきい値：

if (health_score >= 90) status = 'advocate';
else if (health_score >= 70) status = 'active';
else if (health_score >= 50) status = 'growing';
else status = 'at_risk';

#8.4 顧客セグメンテーション

#自動セグメンテーション

#9. メール連携

#9.1 概要

NocoBase は Gmail と Outlook をサポートする組み込みのメール連携プラグインを提供しています。メールがシステムに同期されると、ワークフローを通じて AI がメールの感情や意図を自動分析し、営業担当者が顧客の態度を迅速に把握できるよう支援します。

#9.2 メールの同期

サポートされているプロバイダー：

• Gmail（OAuth 2.0 経由）
• Outlook/Microsoft 365（OAuth 2.0 経由）

同期動作：

• 送受信メールの双方向同期
• メールの CRM レコード（リード、連絡先、商機）への自動関連付け
• 添付ファイルは NocoBase ファイルシステムに保存

#9.3 メール-CRM 関連付け (検討中)

#9.4 メールテンプレート

営業担当者はプリセットされたテンプレートを使用できます：

#10. AI 補助機能

#10.1 AI 社員チーム

CRM システムは NocoBase AI プラグインを統合し、以下の組み込み AI 社員を CRM シナリオ専用のタスクで活用します：

#10.2 AI タスクリスト

AI 機能は、相互に独立した 2 つのカテゴリに分かれます：

#1. AI 社員（フロントエンドブロックからトリガー）

ユーザーはフロントエンドの AI 社員ブロックを通じて AI と直接対話し、分析や提案を取得します。

#2. ワークフロー LLM ノード（バックエンドで自動実行）

ワークフロー内に組み込まれた LLM ノードで、テーブルイベント、操作イベント、定期タスクなどによって自動的にトリガーされます。AI 社員とは無関係に動作します。

説明：ワークフロー LLM ノードはプロンプトと Schema 出力を使用して構造化された JSON を生成し、解析後に業務データフィールドへ書き込みます。ユーザーの介入は不要です。

#10.3 データベース内の AI フィールド

#11. ワークフローエンジン

#11.1 実装済みワークフロー

#11.2 未実装ワークフロー

#12. メニューとインターフェース設計

#12.1 管理画面の構造

#12.2 ダッシュボードビュー

#営業マネージャービュー

#営業担当者ビュー

#経営層ビュー

ドキュメントバージョン: v2.0 | 更新日: 2026-02-06