ソフトウェア開発プロセス 包括的調査レポート¶

1. はじめに
   1.1 目的 — 本書はXXシステムの要件を定義する
   1.2 スコープ — 対象範囲と除外範囲
   1.3 用語定義 — ドメイン用語一覧

2. システム概要
   2.1 システムの目的と背景
   2.2 ユーザーと利害関係者
   2.3 前提条件と制約

3. 機能要件
   3.1 FR-001: ユーザー登録機能
       - 概要: 新規ユーザーがメール/パスワードでアカウント作成
       - 入力: メールアドレス、パスワード、氏名
       - 処理: バリデーション → DB登録 → 確認メール送信
       - 出力: 登録完了画面
       - 例外: 重複メール → エラーメッセージ表示
   3.2 FR-002: ログイン機能
       ...

4. 非機能要件
   4.1 性能: 画面応答3秒以内、同時接続1000ユーザー
   4.2 可用性: 99.9% SLA
   4.3 セキュリティ: OWASP Top10対応
   4.4 運用: 24/365監視体制

5. 外部インターフェース
   5.1 外部API連携 (決済ゲートウェイ、SSO等)

6. データ要件
   6.1 データモデル概要
   6.2 データ量見積もり

1. システムアーキテクチャ
   1.1 全体構成図 (Web/AP/DBの3層構成)
   1.2 サーバー/インフラ構成
   1.3 ネットワーク構成

2. 画面設計
   2.1 画面遷移図
   2.2 画面一覧
   2.3 各画面のワイヤーフレーム + 詳細仕様
       - 画面ID: SCR-001
       - 画面名: ログイン画面
       - URL: /login
       - 表示項目: メールアドレス(text), パスワード(password), ログインBtn
       - バリデーション: メール形式チェック, パスワード8文字以上
       - イベント: ログインBtn押下 → API呼び出し → ダッシュボードへ遷移

3. データベース設計
   3.1 ER図
   3.2 テーブル定義一覧
       - テーブル名: users
       - カラム: id(PK), email(UNIQUE), password_hash, name, created_at, updated_at

4. API設計
   4.1 API一覧
   4.2 各APIの入出力仕様 (リクエスト/レスポンス例)

[ストーリーID] US-042
[タイトル] 商品検索機能
[ストーリー] ECサイトの利用者として、
             キーワードで商品を検索したい。
             なぜなら、欲しい商品を素早く見つけたいからだ。

[受入基準 (Acceptance Criteria)]
  ✅ 商品名での部分一致検索ができる
  ✅ カテゴリでフィルタリングできる
  ✅ 検索結果は価格順/新着順でソートできる
  ✅ 検索結果が0件のとき「見つかりませんでした」と表示する
  ✅ 1ページに20件表示、ページネーション可能

[ストーリーポイント] 5
[優先度] Must (MoSCoW)

[テストケースID] TC-FR001-003
[対象機能] ユーザー登録
[テスト区分] 結合テスト
[前提条件] テスト用DBがクリーンな状態

[テスト手順]
  1. 登録画面を開く
  2. メール: test@example.com を入力
  3. パスワード: P@ssw0rd123 を入力
  4. 「登録」ボタンをクリック

[期待結果]
  - HTTP 201 が返却される
  - DBにユーザーレコードが1件追加される
  - 確認メールが送信される
  - 登録完了画面に遷移する

[実施結果] ○ (Pass)
[実施日] 2026-02-15
[実施者] 田中太郎
[備考] メール到達確認済み

sequenceDiagram
    participant CL as 顧客
    participant PM as プロジェクトマネージャー
    participant SA as システムアーキテクト
    participant DEV as 開発チーム
    participant QA as QAチーム
    participant OPS as 運用チーム

    rect rgb(255, 245, 235)
    Note over CL,OPS: 【Phase 1】要件定義
    CL->>PM: 要望・課題のヒアリング
    PM->>SA: 業務分析・要件整理
    SA->>PM: 要件定義書 (SRS) 作成
    PM->>CL: 要件定義書レビュー・承認
    CL-->>PM: 署名・合意
    end

    rect rgb(235, 245, 255)
    Note over CL,OPS: 【Phase 2】基本設計
    SA->>SA: システム構成・DB設計
    SA->>DEV: 基本設計書作成 (画面/DB/API)
    PM->>CL: 基本設計レビュー
    CL-->>PM: 承認
    end

    rect rgb(235, 255, 245)
    Note over CL,OPS: 【Phase 3】詳細設計
    SA->>DEV: 詳細設計書作成
    DEV->>DEV: クラス図・シーケンス図作成
    PM->>SA: 詳細設計レビュー
    end

    rect rgb(255, 255, 235)
    Note over CL,OPS: 【Phase 4】実装
    DEV->>DEV: コーディング
    DEV->>DEV: 単体テスト実施
    DEV->>PM: 単体テスト成績書提出
    end

    rect rgb(255, 235, 245)
    Note over CL,OPS: 【Phase 5】テスト
    DEV->>QA: 結合テスト実施
    QA->>QA: システムテスト実施
    QA->>PM: テスト成績書・不具合報告
    QA->>CL: 受入テスト実施依頼
    CL->>CL: UAT実施
    CL-->>PM: 検収書発行
    end

    rect rgb(245, 235, 255)
    Note over CL,OPS: 【Phase 6】運用・保守
    OPS->>OPS: 本番環境デプロイ
    OPS->>CL: リリースノート提出
    OPS->>PM: 障害発生時→障害報告書
    end

sequenceDiagram
    participant SH as ステークホルダー
    participant PO as プロダクトオーナー
    participant SM as スクラムマスター
    participant DT as 開発チーム

    rect rgb(230, 247, 255)
    Note over SH,DT: 【初期】プロダクトバックログ作成
    SH->>PO: ビジネス要件・ビジョン共有
    PO->>PO: プロダクトバックログ作成 (優先順位付き)
    PO->>DT: バックログリファインメント (詳細化・見積り)
    end

    loop スプリント (2週間)
        rect rgb(255, 245, 230)
        Note over SH,DT: スプリントプランニング
        PO->>DT: スプリントゴール提示
        DT->>DT: バックログからアイテム選択・タスク分解
        DT->>SM: スプリントバックログ完成
        end

        rect rgb(230, 255, 240)
        Note over SH,DT: 開発 (設計→実装→テスト)
        loop 毎日
            DT->>SM: デイリースクラム (15分)
            SM->>DT: 障害除去
        end
        DT->>DT: 設計・実装・テスト (一気通貫)
        DT->>DT: インクリメント完成 (DoD充足)
        end

        rect rgb(255, 240, 245)
        Note over SH,DT: スプリントレビュー
        DT->>SH: インクリメントのデモ
        SH->>PO: フィードバック
        PO->>PO: バックログ更新
        end

        rect rgb(245, 240, 255)
        Note over SH,DT: レトロスペクティブ
        DT->>SM: KPT振り返り
        SM->>DT: 改善アクション決定
        end
    end