システム開発に必要な資材について

あくまで個人的見解です。

■資材を作成するスコープ

ウォータフォールの必然性が話題に上がるようになって久しいが、
フェーズとしてではなく設計図書類の作成単位のスコープ・用途としては、
以前として以下の切り口を意識する必要はあると思われる。

• 00.要求分析
• 01.要件定義
• 02.外部設計・基本設計
• 03.内部設計・詳細設計
• 04.ＰＧ設計
• 05.ＰＧ製造・ユニットテスト
• 06.単体試験
• 07.結合試験
• 08.総合試験・システムテスト
• 09.受入検査
• 10.本番移行
• 11.運用保守
• 99.案件管理

■00.要求分析

主に現行業務をまとめたり分析したりするフェーズ。
ユーザからのRFPや現行システムの設計書なども、
このスコープで管理するとわかりやすいように思われる。

基本的には、
後述する資材の一式が、
現行業務について揃っていることが望ましい。

■01.要件定義

要求分析をAsIsとするならここではToBeの定義を行う。
現行業務をどのように改善するのか。
どこからどこまでをシステム化するのかを線引きする。

1.業務要件

業務フロー図

改善後に予定する業務フロー（To Be）

システム化課題一覧

システム化範囲の明示とトリアージ

F&G検証結果

既存機能と改善後業務のFit&Gap結果

セキュリティ要件書

認証・認可、エラー処理の基本仕様

各業務要件書

各業務について機能レベルの仕様定義

2.基盤要件

非機能要件書

標準クライアント定義/レスポンス/多重化など運用上の前提条件

システム構成図

追加するHW/SW、採用する言語/FWも明記

ＤＢ一覧

新システムで予定するDBを追記

テーブル一覧

新システムのテーブル一覧

ＩＦ一覧

新システムのＩＦ一覧

3.機能要件

バッチ一覧

新システムのバッチ一覧

ジョブフロー図

新システムのジョブフロー図

ジョブスケジュール表

新システムのジョブスケジュール表

画面一覧

新システムの画面一覧

画面帳票遷移図

新システムの画面帳票遷移図

帳票一覧

新システムの帳票一覧

画面デモ

新システムの画面デモ

4.技術検証

技術検証

PoC。実装基盤・直接印刷など。技術的にトライアルが必要な場合。

5.概算見積もり

試験要件定義書

実施する試験の種別と実施方法

移行要件定義書

外部設計から本番移行までのマスタスケジュール、移行に関する特記事項

運用要件定義書

リリース後の体制と運用方針を明記

開発体制図

各担当者や人員計画、会議体などを明示

ＷＢＳ

作業内容および成果物の整理

概算見積書

開発費用の明示

9.変更仕様

追加要望（リリース後の要望）についての調整資料

■02.外部設計・基本設計

ユーザとの仕様調整に利用するドキュメントでもあり、
プログラマに製造を依頼する際のドキュメントにもなる。

1.機能設計

機能一覧

構成品目（バッチ・画面・帳票）ごとに、
機能（時刻起動/手サブ。初期表示/ボタン処理。ダウンロード/直接印刷）を明記。
バッチID・画面ID・帳票IDもここで管理すると便利。

機能要件書

特に認識合わせが必要な機能要件について資料作成

2.ＤＢ設計

テーブル一覧

新システムのテーブル一覧。命名規約（ドメイン）についても明記

ＥＲ図

新システムのＥＲ図

区分定義書

新システムの区分定義書

テーブル定義書

新システムのテーブル定義書

DDL

実施予定のDDLを準備

DML

実施予定のDMLを準備

3.ＩＦ設計

ＩＦ一覧

新システムのＩＦ一覧

各ＩＦ定義書

新システムのファイル定義書

4.バッチ設計

バッチ共通仕様書

命名規約/走行ログ/エラー処理など

バッチ一覧

新システムのバッチ一覧

ジョブフロー図

新システムのジョブフロー図

ジョブスケジュール表

新システムのジョブスケジュール表

各バッチ仕様書

各バッチの処理内容

5.画面設計

画面共通仕様書

サービス時間、認証・認可（AuthN/Z）、排他制御、基本レイアウト

画面一覧

新システムの画面一覧

画面帳票遷移図

新システムの画面帳票遷移図

各画面仕様書

各画面の画面レイアウト/項目定義/状態編集/処理内容

6.帳票設計

帳票一覧

新システムの帳票一覧

各帳票仕様書

各帳票の帳票レイアウト/項目定義/状態編集/表示内容

7.移行設計

サーバ移行計画書

移行元/移行方式/作業分担など、移行手順を整理

データ移行計画書

移行元/移行方式/作業分担など、移行手順を整理

モジュール移行計画書

モジュール形式や作成手順/移行方式/作業分担など、移行手順を整理

9.管理資料

外部設計レビュー管理表

各外部設計レビュー時の指摘事項。レビュー結果・日付、承認者など。

詳細見積書

開発費用の明示。必要なら。

■03.内部設計・詳細設計

外部設計だけでは実装が困難な場合、
また特に実現方法について検討が必要な機能がある場合は、
プログラマとＳＥのコミュニケーションのために資料を作成することが多い。
プロセスチャートやシーケンス図など。
サンプルのＳＱＬを記述することもある。

ＤＢ物理設計書

テーブルスペース/初期化パラメータ など

バッチ設計

特に検討が必要な機能があれば、機能ごとに設計書を保管

画面設計

特に検討が必要な機能があれば、機能ごとに設計書を保管

帳票設計

特に検討が必要な機能があれば、機能ごとに設計書を保管

■04.ＰＧ設計

メッセージ一覧

メッセージ文言とコードの管理

バッチ実装基盤設計書

命名規約/採用するFW/クラス図/シーケンス図

画面実装基盤設計書

命名規約/採用するFW/クラス図/シーケンス図、webならタグ構成/CSS

帳票実装基盤設計書

命名規約/採用するFW/クラス図/シーケンス図

■05.ＰＧ製造・ユニットテスト

1.開発ＰＣ構築

開発ＰＣ構築手順書

使用するツールと設定内容を明記。ローカルDB構築手順。

開発ライセンス管理表

ソフト名および期間を明記

インストーラ

各種exeファイル

2.製造規約

製造規約書

ブランチ設計、SQL・PGのコメント/フォーマット/文字コード

3.開発サーバ構築

開発サーバ設定手順書

開発サーバ構築と作業ログの記録。CI環境設定内容など。

開発ＤＢ構築

create/exp/imp/表領域変更など

4.技術検討

技術検討

SlickGridのオプションなど、実装上検討が必要になった資料

■06.単体試験

単体試験計画書

テストケース標準・フォーマットなど

単体試験仕様書

データは手製でも可・エビデンス

■07.結合試験

結合試験計画書

対象機能の選定

結合試験仕様書

データの手製は不可・エビデンス

■08.総合試験・システムテスト

0.移行リハ

サーバ移行リハ手順書

移行計画書に則って、作業日時・内容を整理

データ移行リハ手順書

移行計画書に則って、作業日時・内容を整理

モジュール移行リハ手順書

移行計画書に則って、作業日時・内容を整理

移行リハ仕様書

テスト仕様およびエビデンス

1.シナリオテスト

シナリオテスト計画書

カレンダ/ユーザ/業務/データの想定

シナリオテスト仕様書

テスト仕様およびエビデンス

2.ストレステスト

ストレステスト計画書

対象機能/負荷/レスポンスの想定

ストレステスト仕様書

テスト仕様およびエビデンス

3.現新比較テスト

現新比較テスト計画書

対象機能の想定

現新比較テスト仕様書

テスト仕様およびエビデンス

4.回帰テスト

回帰テスト

テスト仕様およびエビデンス

■09.受入検査

ユーザ指摘管理表

実装バグ/仕様バグ/変更要望の切り分け

■10.本番移行

サーバ移行手順書

移行設計書に則って、作業時刻・内容を整理。最終のリハ手順書を展開。

データ移行手順書

移行設計書に則って、作業時刻・内容を整理。最終のリハ手順書を展開。

モジュール移行手順書

移行設計書に則って、作業時刻・内容を整理。最終のリハ手順書を展開。

本番ライセンス管理表

ミドルウェア名および期間を明記

インストーラ

サーバ構築に必要な各種exeファイル

リリース資材

リリース対象の最新ソース・モジュール一式

■11.運用保守

運用資料

維持管理上必要な資料を作成。日次/週次/旬次/月次/四半期/半期/年次

操作マニュアル

システムの操作マニュアル

本番リリース

yyyymmddごとに、リリース手順書・本番変更リスト

■99.案件管理

1.議事管理

外部打合せ

キックオフから、打合せ毎に議事録作成

内部打合せ

内部の認識合わせ

2.課題管理

課題管理表

外部設計以降に発生する話題を管理

3.予実管理

WBS

成果物単位に予実管理

収支計画表

メンバの単価・稼働時間を各月ごとに評価

4.要員管理

作業報告書

パートナーの日報・週報・月報

コミュニケーションルール

ツール・手順書

5.受領物管理

受領物

外部から受領したファイル

6.提出物管理

提出物

外部へ提出したファイル