✅ 大型空調導入プロジェクトの為の商談進捗管理アプリ｜要件定義書（Qiita投稿用）
0. はじめに（背景）
業務用空調の大型プロジェクトにおいて、商談ステージごとに必要なタスクや承認フロー、書類チェックが煩雑化し、属人化・進捗不透明といった課題がありました。
Salesforceの標準機能を活用して、以下のような課題を解決するためのアプリを構築します。
1. ビジネス要件
- 商談の進捗を明確に管理したい（ステージごとのタスク完了確認）
- 上司による承認フローを可視化・通知したい
- 商談に関わる複数の取引先社員を管理したい
- ダッシュボードで全体進捗を俯瞰したい
2. 業務フロー概要
商談は以下の5ステージで進行：
引合 → ヒアリング → 製図 → 見積提出 → 成約
各ステージにチェックリストがあり、すべて完了すると「ステージ更新申請」が可能。
承認されると、商談ステージが次に進みます。
3. 機能要件
- チェック項目入力（数値・テキスト）
- ステージ更新申請（承認/否認）
- Chatter通知 & メール通知
- 関係取引先社員の紐付け（N:N）
- ダッシュボード/レポート
- 入力バリデーション（文字数・数値範囲など）
4. 使用技術（Salesforce）
| 分類 | 機能 |
|---|---|
| 自動化 | レコードトリガーフロー / 画面フロー / その他フロー |
| 通知 | Chatter通知 / メール通知 |
| 分析 | 結合レポート / ダッシュボード |
| UI | Lightning App Builder / LWC |
| 承認 | 承認プロセス |
| 権限 | 権限セット / プロファイル設定 |
| 関係管理 | N:Nカスタムオブジェクト |
5. オブジェクト構成
Opportunity（商談：標準）
- StageName（進捗ステージ）
- その他営業情報
CheckItemStatus__c（N:N中間：入力情報）
- Opportunity__c（Lookup）
- CheckItem__c（引き合い／ヒアリング／製図／見積もり／成約）
- InputText__c
- InputNumber__c
- IsCompleted__c（完了フラグ）
StageApprovalRequest__c（ステージ更新申請）
- Opportunity__c
- RequestedStage__c
- Status__c（申請中／承認／否認）
- Approver__c（User）
- Comment__c（否認理由）
OpportunityContactRole（標準）
- 商談と取引先責任者の関連（N:N）
6. 画面構成一覧（Lightningページ）
| 名称 | 用途 |
|---|---|
| 商談レコードページ | ステージ・チェック項目・申請状況の管理（中心画面） |
| 承認者画面（上長） | ステージ更新の承認/否認画面（画面フロー） |
| チェック項目入力画面 | チェックリストの入力画面（画面フロー） |
| ダッシュボード | 商談全体進捗・申請ステータス集計用 |
7. 権限設計
| ロール | 権限概要 |
|---|---|
| 営業担当者 | 自分の商談・チェック項目を閲覧・編集可 |
| 上司（承認者） | 申請承認／否認、全体ダッシュボード閲覧可 |
| 管理者 | 全データ管理、全機能アクセス可 |
7. デモ
作成中
8. 気づいたこと
マスタの量が多くなければ、マスタ用DBを持たせるのではなくPicklistにした方がフローで扱いやすい