TOP
＞
プロジェクト管理
＞ 開発ドキュメントの種類と内訳
即活用！業務システムの開発ドキュメント標準化
第１回：開発ドキュメント体系と業務フロー
著者：
システムインテグレータ 梅田 弘之
2005/6/10
前のページ
1
2
3
4
次のページ
開発ドキュメントの種類と内訳
DUNGEONでターゲットとしているのは、主に業務系システムの開発です。これにはWebのポータルサイトやe-Learningなども含まれますが、ゲームソフトや組み込み系ソフトウェアなどは想定していません。C/SやWebなどのシステム開発において、最適なドキュメントはどういうものかというテーマを主体として体系化しています。
業務系システムの開発フェーズは、「要求分析 → 基本設計 → 詳細設計 → プログラミング → 単体テスト → 結合テスト → 総合テスト」という順に工程が進んでカットオーバーを迎えます。DUNGEONでは、各々のフェーズにおいて作成するドキュメントを表1のように定めています。
工程
ドキュメント成果物
内容
範囲
媒体
要求分析
（要件定義）
要求分析書
（要件定義書）
要求概要
システムの目的
現状の課題と改善案
基本要件と優先順位
到達目標
システムの実現手段
システム化の範囲
概略費用
効果（定性/定量）
体制図
概略スケジュール
全体
Excel
基本設計
（外部設計）
業務フロー
全体
Excel
システム構成図
全体
Excel
ER図
全体
OBER
テーブル定義書
全体
OBER
機能一覧表
全体
Excel
設計書記述様式
全体
Excel
基本設計書
（外部設計書）
概要
I/O関連図
画面/帳票レイアウト
個別
Excel
詳細設計
（内部設計）
画面遷移図
全体
Excel
詳細設計書
（内部設計書）
概要
I/O関連図
画面/帳票レイアウト
項目説明書
更新仕様書
補足説明
個別
Excel
プロジェクト共通ルール
全体
Excel
プログラミング
単体テスト
単体テスト仕様書
/報告書
全体
Excel
結合テスト
結合テスト仕様書
/報告書
全体
Excel
総合テスト
総合テスト仕様書
/報告書
全体
Excel
表1：開発フェーズにおけるドキュメント成果物
これらのドキュメントの標準フォーマットを規定し、そのテンプレート（記入例を含む）を提供するのがDUNGEONの位置づけとなります。
全体／個別
表1の「範囲」欄には、ドキュメントが全体か個別かを記しています。これは、ドキュメントファイルがシステム全体で1ファイルとなるか、プログラム個別にファイル分割されるかを表したものです。
例えば、業務フローやシステム構成図はシステム全体に対して1ファイル（枚数は複数枚となりますが）作成されるので"全体"、基本設計書や詳細設計書はプログラム単位（例えば受注入力など）で個別ファイルとなるので"個別"ということになります。
ドキュメント媒体
表1の「媒体」欄にはドキュメントのファイル様式（WordやExcel、PowerPointなど）が記されています。皆さんは、普段どのアプリケーションで設計書を書いていますか？著者自身は「文章なんだから当然Word」という根っからのWord派なのですが、社内にはなぜかExcel派も多く棲息しています（PowerPoint派もいました）。
どちらも、それなりの譲れない主張はあるようなのですが、あくまでも"ドキュメントの標準化"を目指しているので、WordとExcelを混在してテンプレートを作成しておくのは非合理的です。Word派 VS. Excel派の大議論の結果、DUNGEONではプロジェクト管理手法PYRAMIDに合わせてExcelを基準とすることになりました（無念）。
ただし、PYRAMID同様、ツールが有効な部分はできるだけツールを活用する方針です。現段階ではER図とテーブル定義書に関しては、自社ツール「SI Object Browser ER」を使うことにしています（自社ソフトなので当然ですが…）。
前のページ
1
2
3
4
次のページ
著者プロフィール
株式会社システムインテグレータ 梅田 弘之
東芝、住商情報システムを経て1995年にシステムインテグレータ社を設立。 常駐・派遣主体の労働集約的な日本のソフトウェア業の中で、創造性にこだわってパッケージビジネスを行っている。 国際競争力のない日本のIT産業が、ここから巻き返しを図るための切り札は「プロジェクト管理」だと信じ、実践的なプロジェクト管理手法「PYRAMID」を自社開発している。
INDEX
第1回：開発ドキュメント体系と業務フロー
常駐・派遣型ビジネスから脱却するには
開発ドキュメントの種類と内訳
基本設計工程のドキュメント
画面や帳票はすべて記載
