0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【保存版】現場で即使えるテスト仕様書・チェック表テンプレート集(単体〜E2E・BI対応)

0
Posted at

【保存版】現場で即使えるテスト仕様書・チェック表テンプレート集(単体〜E2E・BI対応)

はじめに

テスト工程で「何をどこまでテストすればいいかわからない」「チェック漏れが不安」といった経験はありませんか?

本記事では、実際の開発現場で即使える汎用的なテスト仕様書・チェック表のテンプレートを提供します。単体テストからE2Eテスト、さらにBI特有のテスト項目まで網羅しています。

対象読者

  • テスト設計・実施を担当するエンジニア
  • テスト仕様書のフォーマットを探している方
  • チーム内でテスト品質を標準化したい方

この記事で得られるもの

  • すぐに使えるテンプレート(コピペOK)
  • 各テスト工程の観点・チェック項目
  • BI特有のテスト項目

テスト仕様書 vs チェック表の使い分け

項目 テスト仕様書 チェック表
目的 テスト内容の詳細定義 実施漏れ防止・確認
作成タイミング テスト設計時 テスト実施前
粒度 詳細(入力値、期待値まで記載) 概要レベル(確認観点)
更新頻度 プロジェクト初期に作成 工程ごとに作成

推奨: テスト仕様書で詳細を管理し、チェック表で実施確認を行う二段構え


1. 単体テスト(ユニットテスト)

1-1. 単体テスト仕様書テンプレート

| No | テスト項目 | テスト対象 | 入力値 | 期待結果 | 実施結果 | 備考 |
|----|-----------|-----------|--------|---------|---------|------|
| UT-001 | 正常系:有効な入力値 | `calcTotal()` | price=100, tax=0.1 | 110 | ✓ PASS |  |
| UT-002 | 異常系:null入力 | `calcTotal()` | price=null, tax=0.1 | Exception発生 | ✓ PASS |  |
| UT-003 | 境界値:0円 | `calcTotal()` | price=0, tax=0.1 | 0 | ✓ PASS |  |
| UT-004 | 境界値:最大値 | `calcTotal()` | price=999999999, tax=0.1 | 1099999998.9 | ✓ PASS |  |

1-2. 単体テストチェック表

チェック観点 確認内容 備考
正常系 仕様通りの入力で正しい出力が得られるか
異常系 不正な入力値でエラーハンドリングされるか
境界値 最小値・最大値・0・nullで動作確認したか
例外処理 try-catchが適切に実装されているか
戻り値 関数の戻り値の型・値が仕様通りか
副作用 意図しない変数の変更がないか
コードカバレッジ カバレッジ目標(例:80%以上)を達成したか

2. 結合テスト

2-1. 結合テスト仕様書テンプレート

| No | テスト項目 | テスト対象モジュール | テストシナリオ | 期待結果 | 実施結果 | 備考 |
|----|-----------|-------------------|--------------|---------|---------|------|
| IT-001 | ユーザー登録フロー | フロント→API→DB | 新規ユーザー情報を入力し登録ボタンをクリック | DBに登録され確認メールが送信される | ✓ PASS |  |
| IT-002 | データ取得連携 | API→外部API→DB | 商品IDを指定してAPI呼び出し | 外部APIから取得した商品情報がDBに保存される | ✓ PASS |  |
| IT-003 | エラー時の連携 | フロント→API | 無効なトークンでAPIアクセス | 401エラーが返却されログイン画面へ遷移 | ✓ PASS |  |

2-2. 結合テストチェック表

チェック観点 確認内容 備考
I/F連携 モジュール間のデータ受け渡しが正しいか
データ整合性 複数モジュールで同じデータが正しく扱われるか
トランザクション 処理の原子性が保たれているか(Rollback確認含む)
外部連携 外部API・サービスとの連携が正常か
エラー伝播 エラーが適切に上位モジュールへ伝播するか
非同期処理 非同期処理の完了・タイムアウトが正しいか
セッション管理 セッション情報が適切に管理されているか

3. システムテスト

3-1. システムテスト仕様書テンプレート

| No | 機能 | テストケース | 操作手順 | 期待結果 | 実施結果 | 証跡 |
|----|-----|------------|---------|---------|---------|------|
| ST-001 | ログイン | 正常ログイン | ①ID/PWを入力 ②ログインボタンクリック | ダッシュボード画面に遷移 | ✓ PASS | screenshot_001.png |
| ST-002 | 検索機能 | 複合条件検索 | ①カテゴリ選択 ②価格範囲指定 ③検索実行 | 条件に合致する商品一覧が表示 | ✓ PASS | screenshot_002.png |
| ST-003 | データ出力 | CSV出力 | ①一覧画面でCSV出力ボタンクリック | 表示データがCSVでダウンロード | ✓ PASS | output_sample.csv |

3-2. システムテストチェック表

チェック観点 確認内容 備考
機能要件 要件定義書の全機能が実装されているか
画面遷移 すべての画面遷移が仕様通りか
入力検証 各入力項目のバリデーションが機能しているか
権限制御 ロール・権限ごとのアクセス制御が正しいか
エラーメッセージ ユーザーフレンドリーなエラー表示か
レスポンシブ 各デバイスサイズで正しく表示されるか
多言語対応 (該当する場合)言語切替が正しく機能するか
ブラウザ互換性 対象ブラウザすべてで動作確認したか

4. E2Eテスト(End to End)

4-1. E2Eテスト仕様書テンプレート

| No | シナリオ名 | ユーザーストーリー | 操作フロー | 期待結果 | 実施結果 | 備考 |
|----|-----------|------------------|-----------|---------|---------|------|
| E2E-001 | 新規会員登録〜初回購入 | 新規ユーザーが会員登録して商品を購入する | ①会員登録 ②ログイン ③商品検索 ④カート追加 ⑤決済 ⑥購入完了 | 注文完了メール受信、マイページに注文履歴表示 | ✓ PASS |  |
| E2E-002 | データ更新反映フロー | 管理者が商品情報を更新し、ユーザー画面に反映される | ①管理画面で商品価格更新 ②ユーザー画面で該当商品表示 | 更新後の価格が即座に反映 | ✓ PASS |  |

4-2. E2Eテストチェック表

チェック観点 確認内容 備考
業務フロー 実際のユーザー行動に沿ったシナリオか
データライフサイクル データの作成〜更新〜削除まで確認したか
通知・メール 各イベントで通知が正しく送信されるか
バッチ処理連携 夜間バッチ等の定期処理との連携を確認したか
パフォーマンス 実運用に近い負荷での動作確認をしたか
障害復旧 システム障害からの復旧シナリオを確認したか
セキュリティ 認証・認可が全フローで機能しているか

5. BI特有のテスト

5-1. BIテスト仕様書テンプレート

| No | テスト項目 | 対象 | 検証内容 | 期待結果 | 実施結果 | 備考 |
|----|-----------|-----|---------|---------|---------|------|
| BI-001 | データ正確性 | 売上集計ダッシュボード | 元データとダッシュボード表示値を突合 | 誤差0% | ✓ PASS | サンプル期間: 2024/01 |
| BI-002 | ETL処理 | 日次データ取り込み | 前日データが正しく取り込まれているか確認 | 全レコード取込完了、エラー0件 | ✓ PASS |  |
| BI-003 | クエリパフォーマンス | 年次レポート | レポート表示時間を計測 | 10秒以内 | ✓ PASS | 実測: 7.2秒 |
| BI-004 | フィルタ機能 | 地域別売上 | 複数フィルタの組み合わせ動作 | フィルタ条件通りのデータ表示 | ✓ PASS |  |
| BI-005 | データ権限 | 部門別レポート | ユーザーの所属部門データのみ表示されるか | 他部門データは非表示 | ✓ PASS |  |

5-2. BIテストチェック表

チェック観点 確認内容 備考
データソース整合性 元データ(DB/API)との突合確認をしたか
集計ロジック SUM/AVG/COUNT等の集計が正しいか
ディメンション 期間・地域・カテゴリ等の切り口が正確か
データ更新頻度 リアルタイム/日次/月次等、更新タイミングが仕様通りか
NULL/欠損値処理 欠損データの扱いが適切か(除外 or 0表示等)
ドリルダウン 詳細データへの掘り下げが正しく機能するか
エクスポート機能 CSV/Excel/PDF出力が正常に動作するか
パフォーマンス 大量データでの表示速度が許容範囲か
データリフレッシュ スケジュール更新が正常に実行されているか
計算フィールド カスタム計算式が正しく動作するか
履歴管理 過去データの参照・比較が可能か
アラート機能 閾値超過時の通知が正常に動作するか

6. 非機能テスト(NFT)チェック表

システムの品質を担保するため、非機能要件も忘れずにチェックしましょう。

チェック観点 確認内容 備考
パフォーマンス レスポンスタイムが要件を満たすか
負荷耐性 同時アクセス数に耐えられるか
可用性 SLA/SLOを満たすか(稼働率99.9%等)
セキュリティ 脆弱性診断を実施したか
データバックアップ バックアップ・リストアが正常に動作するか
ログ出力 エラーログ・アクセスログが適切に記録されるか
監視・アラート 異常検知の仕組みが機能しているか
災害対策 DR(Disaster Recovery)シナリオを確認したか

7. テスト実施管理表

テスト全体の進捗管理に使えるマスター表です。

| テスト工程 | 計画数 | 実施数 | 合格数 | 不具合数 | 進捗率 | ステータス | 担当者 | 完了予定日 |
|----------|-------|-------|-------|---------|--------|----------|-------|----------|
| 単体テスト | 150 | 150 | 148 | 2 | 100% | ✓完了 | 山田 | 2024/02/15 |
| 結合テスト | 80 | 65 | 60 | 5 | 81% | 実施中 | 佐藤 | 2024/02/28 |
| システムテスト | 120 | 30 | 28 | 2 | 25% | 実施中 | 鈴木 | 2024/03/15 |
| E2Eテスト | 25 | 0 | 0 | 0 | 0% | 未着手 | 田中 | 2024/03/20 |
| BIテスト | 40 | 0 | 0 | 0 | 0% | 未着手 | 高橋 | 2024/03/10 |

8. 不具合管理表

発見した不具合を一元管理する表です。

| No | 発見日 | 発見工程 | 重要度 | タイトル | 内容 | 再現手順 | ステータス | 修正担当 | 修正予定日 |
|----|-------|---------|--------|---------|------|---------|----------|---------|----------|
| BUG-001 | 2024/02/10 | 結合テスト | 高 | ログイン後にセッションタイムアウト | 一定時間操作なしでセッションが切れない | ①ログイン ②30分放置 ③操作実行 | 対応中 | 山田 | 2024/02/20 |
| BUG-002 | 2024/02/12 | システムテスト | 中 | CSV出力時に文字化け | 特定の文字が含まれるとShift_JISで文字化け | ①データ一覧表示 ②CSV出力 | 修正済 | 佐藤 | - |

重要度の定義例

  • : 業務継続不可、データ損失の恐れ
  • : 機能が使えないが回避策あり
  • : 軽微な表示崩れ、誤字等

9. 運用のコツ・ベストプラクティス

✅ テンプレートのカスタマイズ

  • プロジェクトの特性に応じて項目を追加・削除
  • チーム内で合意したフォーマットを使う

✅ 証跡の残し方

  • スクリーンショット、ログファイル、動画キャプチャを活用
  • 証跡ファイルは命名規則を統一(例: ST-001_login_success.png

✅ レビュー体制

  • テスト仕様書はピアレビューを実施
  • レビュー観点: 網羅性、曖昧さがないか、再現可能か

✅ 自動化との組み合わせ

  • 単体・結合テストは自動化を推進
  • E2E・BIテストは初回手動→徐々に自動化

✅ 継続的改善

  • テスト実施後に「見落としていた観点」を追記
  • プロジェクト終了時に振り返り、テンプレートを更新

10. よくある質問(FAQ)

Q1. すべてのチェック項目を埋める必要がありますか?

A. プロジェクトの規模・性質に応じて取捨選択してください。小規模なら主要項目のみでOKです。

Q2. ExcelとMarkdownどちらで管理すべき?

A. チームの慣習次第ですが、以下を参考に:

  • Excel: 非エンジニアとの共有、複雑な集計が必要な場合
  • Markdown: Git管理、バージョン管理、CI/CDとの連携

Q3. テスト自動化ツールとの併用方法は?

A. 本テンプレートで「何をテストするか」を定義→自動化ツールで「どう実行するか」を実装、という流れが効果的です。


まとめ

本記事では、以下のテンプレートを提供しました:

  1. ✅ 単体テスト仕様書・チェック表
  2. ✅ 結合テスト仕様書・チェック表
  3. ✅ システムテスト仕様書・チェック表
  4. ✅ E2Eテスト仕様書・チェック表
  5. ✅ BI特有のテスト仕様書・チェック表
  6. ✅ 非機能テストチェック表
  7. ✅ テスト実施管理表
  8. ✅ 不具合管理表

これらをベースに、あなたのプロジェクトに最適化してご活用ください!

0
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?