LeadPipeline - 営業案件パイプライン＆商談進捗管理システム

## 1. アプリの目的・ターゲットユーザー
中小企業の営業担当者・営業マネージャーが、案件の獲得から受注・失注までの商談プロセスを視覚的に管理できるパイプライン管理システム。ExcelやスプレッドシートでバラバラになりがちなSFA業務を、登録不要・ブラウザ完結で手軽に実現する。対象は1〜20名規模の営業チームを持つ中小企業・フリーランス・個人事業主。

---

## 2. 主要機能

- **カンバン型パイプラインボード**：「見込み → アプローチ中 → 提案済 → 交渉中 → 受注 / 失注」の6ステージをカードで視覚管理。カードのドラッグ＆ドロップでステージ移動。
- **案件カード詳細入力**：会社名・担当者名・案件名・受注予定金額・確度(%)・次回アクション・期日・担当営業・メモをフォームで管理。
- **加重パイプライン金額の自動集計**：ステージ×確度から期待売上を自動計算し、ダッシュボードにリアルタイム表示。目標売上との差分もグラフで可視化。
- **活動ログ**：各案件に対して「電話・メール・訪問・デモ・見積提出」などの活動種別と日時・内容を時系列で記録。次回アクション期日が迫るとカードにバッジ表示。
- **フィルター＆検索**：担当者別・ステージ別・期日超過・金額範囲・フリーワードで絞り込み。失注案件は失注理由（価格・競合・予算凍結・タイミング・ニーズ不一致）を選択して別アーカイブで管理。
- **月次営業レポート印刷 / CSV出力**：受注件数・失注件数・勝率・平均商談日数・担当者別実績を集計した月次サマリーをA4印刷レイアウトとCSVで出力。

---

## 3. 画面構成

### ① ダッシュボード（トップページ）
- 今月の受注金額 / 受注件数 / 勝率 / 加重期待売上を数値カードで表示
- ステージ別案件数の棒グラフ
- 今週アクション期日が迫る案件リスト（赤・黄バッジ付き）
- 担当者別パイプライン金額の水平バーグラフ

### ② パイプラインボード（メイン画面）
- 横スクロール対応のカンバン形式（6列）
- 各ステージ上部に「件数・合計金額・加重期待金額」を表示
- カードには「会社名・案件名・金額・確度・期日・担当者アイコン」を表示
- 右上の「＋新規案件」ボタンでモーダル入力フォームを開く
- カードクリックで詳細スライドパネルを展開（活動ログも同パネル内）

### ③ 案件詳細パネル（スライドオーバー形式）
- 基本情報編集フォーム
- 活動ログの時系列タイムライン（入力フォームと一体化）
- ステータス変更ドロップダウン
- 失注時は失注理由選択とアーカイブ処理ボタン

### ④ 失注アーカイブ
- 失注案件の一覧（フィルター・CSV出力対応）
- 失注理由の円グラフで改善ポイントを可視化

### ⑤ 月次レポート
- 月選択→自動集計→印刷プレビュー
- 受注・失注・進行中の推移折れ線グラフ
- 担当者別成績テーブル

---

## 4. データ構造（DBテーブル概要）

**deals（案件）**
| カラム | 型 | 説明 |
|---|---|---|
| id | INT PK AUTO_INCREMENT | |
| company_name | VARCHAR(100) | 会社名 |
| contact_name | VARCHAR(100) | 担当者名 |
| deal_name | VARCHAR(200) | 案件名 |
| amount | INT | 受注予定金額（円）|
| probability | TINYINT | 確度 0〜100(%) |
| stage | TINYINT | 0=見込み〜4=交渉中 |
| status | TINYINT | 0=進行中 1=受注 2=失注 |
| lost_reason | TINYINT NULL | 失注理由コード |
| next_action | VARCHAR(500) | 次回アクション内容 |
| next_action_date | DATE NULL | 次回アクション期日 |
| assignee | VARCHAR(100) | 担当営業名 |
| memo | TEXT | 備考 |
| created_at | DATETIME | |
| updated_at | DATETIME | |

**activities（活動ログ）**
| カラム | 型 | 説明 |
|---|---|---|
| id | INT PK AUTO_INCREMENT | |
| deal_id | INT FK | |
| activity_type | TINYINT | 0=電話 1=メール 2=訪問 3=デモ 4=見積 5=その他 |
| activity_date | DATETIME | |
| content | TEXT | 活動内容 |
| created_at | DATETIME | |

**settings（設定・任意）**
| カラム | 型 | 説明 |
|---|---|---|
| id | INT PK | |
| monthly_target | INT | 月次受注目標金額 |
| team_name | VARCHAR(100) | チーム名 |

---

## 5. デザインの方向性

- **カラーパレット**：ネイビー(#1E3A5F)をベースに、アクセントカラーをアンバー(#F59E0B)で統一。ステージカラーはグレー→ブルー→インディゴ→アンバー→グリーン(受注)→レッド(失注)のグラデーションで直感的に識別。
- **フォント**：日本語はNoto Sans JP、数値はInter(フォールバックはsystem-ui)でモダンなビジネスUIを実現。
- **カードUI**：白カード+細い左ボーダー（ステージカラー）+軽いドロップシャドウ。確度を細い水平バーで視覚表示。
- **スマホ対応**：ボードはスワイプで左右スクロール、詳細パネルはフルスクリーンモーダルに切り替え。活動ログ入力は大きなタップターゲットで現場入力に対応。
- **規模感**：登録不要(セッション単位またはPHP側で簡易認証なし公開)、DB操作はPDO+プリペアドステートメント、JS側はVanilla JSのみで外部フレームワーク不使用。1開発サイクルで完成できる現実的な規模。