Skip to content

Instantly share code, notes, and snippets.

@Mtshoshosho

Mtshoshosho/wiki_content.md

Created June 9, 2025 09:20
Show Gist options
  • Save Mtshoshosho/400bb48e3597bb6ae64bce92c0e82b62 to your computer and use it in GitHub Desktop.
Save Mtshoshosho/400bb48e3597bb6ae64bce92c0e82b62 to your computer and use it in GitHub Desktop.
Download ZIP
SES営業管理SaaS 要件定義書 - IT-guild プロジェクト
Raw
wiki_content.md

SES営業管理SaaS 要件定義書

関連Issue: #4
作成日: 2025-06-09
最終更新: 2025-06-09
作成者: Claude Code

📋 概要

システムの目的

  • SES事業者の営業業務効率化と売上最大化を支援
  • 複数のSES企業が利用できるマルチテナントSaaSシステム
  • 営業プロセスの標準化と可視化により、受注率向上と業務負荷軽減を実現

解決したい課題・問題

  • 営業情報の分散: Excel、メモ、メール等での案件管理の非効率性
  • 進捗の不透明性: 商談状況や売上予測の把握困難
  • 情報共有不足: チーム間での案件情報共有の遅れ
  • 分析の困難性: データ分析による営業戦略立案の困難
  • スケーラビリティ: 事業成長に伴う管理コストの増大

想定ユーザー企業

  • 小規模SES企業: エンジニア5-20名、シンプルな営業フロー
  • 中規模SES企業: エンジニア20-100名、複数部署・複雑な営業プロセス
  • 大規模SES企業: エンジニア100名以上、高度な分析・レポート要求

主要ユーザーロール

  • 経営者: 売上分析、利益管理、戦略判断
  • 営業責任者: チーム管理、目標設定、進捗監視
  • 営業担当者: 案件管理、顧客対応、商談進行
  • マネージャー: リソース配分、エンジニアアサイン計画

📝 要件

ビジネス要件

収益モデル

  • 基本プラン: 月額 ¥30,000/企業（10ユーザーまで）
  • 追加ユーザー: ¥3,000/月・ユーザー
  • プレミアム機能: 高度な分析、API連携、カスタマイズ
  • エンタープライズ: 大企業向けカスタマイズ対応

市場要件

  • 初期ターゲット: 関東圏の中小SES企業 50社
  • 拡張計画: 全国展開、大手SES企業への対応
  • 競合優位性: SES業界特化、使いやすいUI、リーズナブルな価格

機能要件（営業管理MVP）

1. 顧客企業管理

  • 顧客企業情報登録・更新・削除
  • 顧客企業詳細情報（業界、規模、技術スタック、予算規模）
  • 担当者情報管理（複数担当者対応）
  • 顧客企業との取引履歴表示
  • 顧客企業検索・フィルタリング機能

2. 案件管理

  • 案件情報登録・更新・削除
  • 案件詳細（技術要件、期間、予算、場所、稼働率）
  • 案件ステータス管理（営業中、提案中、契約中、終了）
  • 案件検索・ソート・フィルタリング
  • 案件一覧表示（リスト、カンバン、カレンダー）

3. 商談管理・進捗追跡

  • 商談履歴記録（日時、内容、次回アクション）
  • 商談段階管理（初回接触、ヒアリング、提案、クロージング）
  • 受注確度設定・更新
  • 次回アクション設定・リマインダー
  • 商談タイムライン表示

4. 売上予測・実績管理

  • 月次・四半期・年次売上予測
  • 受注確度による売上予測計算
  • 実績売上登録・集計
  • 目標達成率表示
  • 売上推移グラフ・レポート

5. 基本ダッシュボード

  • 営業KPI一覧（受注件数、売上、達成率）
  • 進行中案件サマリー
  • 今日のタスク・アクション一覧
  • 売上推移グラフ
  • アラート・通知表示

非機能要件

マルチテナント・セキュリティ

  • データ分離: 企業間の完全なデータ分離
  • 認証・認可: 企業内ロールベースアクセス制御
  • データ暗号化: 保存時・転送時の暗号化
  • 監査ログ: 全操作の記録・追跡
  • GDPR対応: データ削除・エクスポート機能

パフォーマンス

  • レスポンス時間: 画面表示 < 2秒、API応答 < 500ms
  • 同時接続: 企業あたり50ユーザー同時利用
  • 可用性: 99.9%稼働率（月間ダウンタイム < 43.2分）
  • スケーラビリティ: 1,000企業、10万ユーザーまで対応

運用・保守性

  • バックアップ: 日次自動バックアップ、即座復旧
  • モニタリング: リアルタイム監視、自動アラート
  • ログ管理: 構造化ログ、検索・分析機能
  • デプロイ: CI/CD、ゼロダウンタイムデプロイ

🎯 ユーザーストーリー

営業担当者として

  • 新規案件を素早く登録して、営業活動を開始したい
  • 顧客との商談履歴を記録して、チームと情報共有したい
  • 受注確度を更新して、売上予測の精度を高めたい
  • 次回アクションを設定して、商談の抜け漏れを防ぎたい

営業責任者として

  • チーム全体の案件進捗を一覧で把握したい
  • 売上予測と実績を比較して、目標達成度を監視したい
  • 営業メンバーの活動状況を確認して、適切なサポートをしたい
  • 月次・四半期レポートを生成して、経営陣に報告したい

経営者として

  • 会社全体の売上推移をダッシュボードで確認したい
  • 営業効率を分析して、事業戦略を最適化したい
  • 顧客分析により、ターゲット市場を明確化したい
  • ROIを測定して、営業投資の効果を評価したい

🎨 画面遷移・UI要件

主要画面構成

ダッシュボード
├── 案件管理
│   ├── 案件一覧
│   ├── 案件詳細
│   └── 案件登録・編集
├── 顧客管理
│   ├── 顧客一覧
│   ├── 顧客詳細
│   └── 顧客登録・編集
├── 商談管理
│   ├── 商談履歴
│   └── 商談登録・編集
├── 売上管理
│   ├── 売上予測
│   ├── 実績管理
│   └── レポート
└── 設定
    ├── ユーザー管理
    ├── 企業設定
    └── 通知設定

レスポンシブ対応

  • デスクトップ: 1200px以上、フル機能
  • タブレット: 768px-1199px、主要機能
  • モバイル: 768px未満、参照・簡易操作

アクセシビリティ

  • WCAG 2.1 AA準拠
  • キーボードナビゲーション対応
  • スクリーンリーダー対応
  • 高コントラストモード対応

🔌 API要件

認証・認可API

  • POST /api/auth/login - ログイン
  • POST /api/auth/logout - ログアウト
  • GET /api/auth/me - ユーザー情報取得
  • POST /api/auth/refresh - トークン更新

顧客管理API

  • GET /api/customers - 顧客一覧取得
  • POST /api/customers - 顧客作成
  • GET /api/customers/:id - 顧客詳細取得
  • PUT /api/customers/:id - 顧客更新
  • DELETE /api/customers/:id - 顧客削除

案件管理API

  • GET /api/projects - 案件一覧取得
  • POST /api/projects - 案件作成
  • GET /api/projects/:id - 案件詳細取得
  • PUT /api/projects/:id - 案件更新
  • DELETE /api/projects/:id - 案件削除

売上管理API

  • GET /api/sales/forecast - 売上予測取得
  • GET /api/sales/actual - 実績売上取得
  • GET /api/sales/reports - レポート生成

🏗️ 技術選定

項目 選定技術 理由
フロントエンド Next.js 14 SSR、SEO最適化、TypeScript統合
状態管理 Zustand 軽量、TypeScript対応、学習コスト低
スタイリング Tailwind CSS 高速開発、デザインシステム構築
UI コンポーネント shadcn/ui Next.js最適化、カスタマイズ性
バックエンド Next.js API Routes フルスタック開発、デプロイ簡単
データベース PostgreSQL ACID特性、複雑クエリ対応、マルチテナント
ORM Prisma TypeScript統合、マイグレーション管理
認証 NextAuth.js 多様なプロバイダー、セキュリティ
インフラ Vercel + AWS RDS 自動スケーリング、高可用性
監視 Sentry + Vercel Analytics エラー追跡、パフォーマンス監視

📋 実装計画

Phase 1: 基盤構築（2週間）

  1. マルチテナント認証システム

    • 企業登録・ログイン機能
    • ロールベースアクセス制御
    • セッション管理
    • 見積もり: 20時間

  2. データベース設計・構築

    • マルチテナントスキーマ設計
    • 基本テーブル作成
    • マスターデータ投入
    • 見積もり: 16時間

Phase 2: 営業管理機能（3週間）

  1. 顧客管理機能

    • 顧客CRUD操作
    • 検索・フィルタリング
    • 担当者管理
    • 見積もり: 24時間

  2. 案件管理機能

    • 案件CRUD操作
    • ステータス管理
    • カンバンボード表示
    • 見積もり: 32時間

  3. 商談管理機能

    • 商談履歴記録
    • 進捗追跡
    • リマインダー機能
    • 見積もり: 20時間

Phase 3: 分析・レポート（2週間）

  1. ダッシュボード

    • KPI表示
    • グラフ・チャート
    • リアルタイム更新
    • 見積もり: 24時間

  2. 売上管理

    • 予測計算ロジック
    • レポート生成
    • データエクスポート
    • 見積もり: 20時間

依存関係

  • Phase 1完了 → Phase 2開始可能
  • Phase 2完了 → Phase 3開始可能
  • 各Phase内の機能は並行開発可能

リスク・制約事項

  • 技術的リスク: マルチテナント設計の複雑性
  • スケジュールリスク: SES業界固有要件の理解不足
  • 制約事項: 初期リリースまでの期間制限（3ヶ月）

🧪 テスト計画

テスト方針

  • 単体テスト: カバレッジ目標 85%以上
  • 統合テスト: API・DB連携テスト
  • E2Eテスト: 主要ユーザーフロー
  • セキュリティテスト: 脆弱性検査、ペネトレーションテスト

主要テストケース

テスト項目 期待結果 優先度
ユーザーログイン 正常ログイン成功 高
案件登録 案件データ保存成功 高
マルチテナント分離 他企業データアクセス不可 高
売上予測計算 正確な予測値算出 中
データエクスポート CSV/Excel出力成功 中

📚 参考資料

競合サービス分析

  • Salesforce Sales Cloud: 高機能だが高価格、SES特化なし
  • HubSpot CRM: 使いやすいが一般的、業界特化機能不足
  • Zoho CRM: 低価格だが機能制限、カスタマイズ困難

SES業界調査

  • SES業界の営業プロセス標準化
  • 一般的な案件管理フロー
  • エンジニアアサインメント手法

技術参考資料

  • Next.js マルチテナント実装パターン
  • PostgreSQL Row Level Security
  • SaaS セキュリティベストプラクティス

📝 変更履歴

日付 変更者 変更内容
2025-06-09 Claude Code 初版作成

Next Steps:

  1. 技術アーキテクチャ設計書作成
  2. データベース設計詳細化
  3. UI/UXモックアップ作成
  4. 開発環境セットアップ
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment