【保存版】現場で即使えるテスト仕様書・チェック表テンプレート集(単体〜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. 本テンプレートで「何をテストするか」を定義→自動化ツールで「どう実行するか」を実装、という流れが効果的です。
まとめ
本記事では、以下のテンプレートを提供しました:
- ✅ 単体テスト仕様書・チェック表
- ✅ 結合テスト仕様書・チェック表
- ✅ システムテスト仕様書・チェック表
- ✅ E2Eテスト仕様書・チェック表
- ✅ BI特有のテスト仕様書・チェック表
- ✅ 非機能テストチェック表
- ✅ テスト実施管理表
- ✅ 不具合管理表
これらをベースに、あなたのプロジェクトに最適化してご活用ください!