業務システムの開発ドキュメント標準化 第１回：開発ドキュメント体系と業務フロー

常駐・派遣型ビジネスから脱却するには

   ソフトウェア業界の仕事は、下請け・孫請けのピラミッド構成となることが多く、常駐・派遣型のビジネスがかなりのパーセンテージを占めています。そんな中、他の業界と同じように、下請け脱却を目指して"一括請負"で仕事を引き受けたいとする会社もあります。

   その志は善しとしましょう。しかし、肝心の"実力"が伴っていないと発注者も受託者もお互いに手痛い目に遭います。ここで言う"実力"とは、単なる技術力のことではありません。スケジュール管理や品質管理、コスト管理などのプロジェクト管理の技術・体制を社内で持っているかどうかが成否の鍵となるのです。

   筆者の会社は創立11年目なのですが、創業以来「常駐・派遣の仕事はやらない！」という起業時のポリシーを貫いて来ました。C/SやWebのシステム開発を主体としているのですが、10年間の中では当然（？）、いくつかの失敗プロジェクトもありました。その苦い経験の中で「成功率と生産性の向上」を永遠の経営課題と定めて取り組んできたのです。

   前回の連載「即活用！企業システムにおけるプロジェクト管理」では、この成功率向上という課題解決のために体系化したプロジェクト管理手法「PYRAMID（ピラミッド）」について紹介しました。

   今回は、もうひとつの課題「生産性の向上」に対する取り組みのひとつである業務システムの開発ドキュメント標準「DUNGEON（ダンジョン）」について紹介していきます。

   これは、システム開発における「ドキュメントの標準化」を目的とするものです。担当者ごとに異なる"自己流"のドキュメントではなく、各人のノウハウを結集したベストのドキュメントフォームを策定しました。「PYRAMID」と同じく、「DUNGEON」も組織全体で管理し、各プロジェクトでこれを活用しながらバージョンアップを行っています。

   PYRAMIDもDUNGEONも、"実践的"なものを目指しており、即活用できるようなテンプレートを用意しています。PYRAMIDではプロジェクト管理、DUNGEONでは開発資料に関するドキュメントを定めています。図1は、プロジェクトサイクルにおけるPYRAMIDとDUNGEONのドキュメント範囲を表したものです。

図1：プロジェクト管理手法「PYRAMID」と開発ドキュメント標準「DUNGEON」
（画像をクリックするとExcelファイルをダウンロードできます。/44.0KB）

http://thinkit.co.jp/images/project/1/1/document.xls  

 今回の連載ではDUNGEONのドキュメントを説明しながら、テンプレートなどを順次ダウンロードできるようにしています。試用してみたい方は、自社の開発スタイルに合わせて手直しして使ってみてください。これらの資料を活用していただいて、日本のIT業界が常駐・派遣スタイルから脱却するのに少しでもお役に立てれば幸いです。

開発ドキュメントの種類と内訳

   DUNGEONでターゲットとしているのは、主に業務系システムの開発です。これにはWebのポータルサイトやe-Learningなども含まれますが、ゲームソフトや組み込み系ソフトウェアなどは想定していません。C/SやWebなどのシステム開発において、最適なドキュメントはどういうものかというテーマを主体として体系化しています。

   業務系システムの開発フェーズは、「要求分析 → 基本設計 → 詳細設計 → プログラミング → 単体テスト → 結合テスト → 総合テスト」という順に工程が進んでカットオーバーを迎えます。DUNGEONでは、各々のフェーズにおいて作成するドキュメントを表1のように定めています。

表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」を使うことにしています（自社ソフトなので当然ですが…）。