システム開発のアイキャッチ

システム開発で必要なドキュメント類は、会社に規定のフォーマットがあればいいですが特にないという場合は内容だけでなくフレームから作らなければなりません。

これは結構大変で、仕様書や設計書の作成時間が倍ぐらいかかってしまいます。

またSEを目指している人がドキュメントから勉強しようとしても、システム開発用テンプレートはあまり多くないためなかなか思ったようなものが見つからないことも。

今回は、エクセル版のシステム開発用テンプレートと関連文書を無料でダウンロードできるようにしました。

システム開発の現場で異なる項目はあると思いますが、基本のひな型として活用していただければと思います。

システム開発の工程とドキュメント

システム開発のドキュメントのうち、要件定義書、基本設計書、詳細設計書、テスト仕様書・報告書のテンプレートがダウンロード可能です。

それぞれのテンプレートは、すべて日本語ファイル名のエクセルファイルなのでzipで圧縮してあります。解凍して使用してください。

要件定義書

要件定義書のエクセルテンプレートです。表紙、更新履歴、目次、内容の4つのシートがファイルに含まれています。見栄えの確認のため目次と内容の項目欄にはサンプルのデータが入っていますので削除してお使いください。

要件定義書 表紙 要件定義書 更新履歴 要件定義書 目次 要件定義書 内容

基本設計書

基本設計書は、一番テンプレートの種類が多い文書です。詳細設計を作らない小規模なプロジェクトでも基本設計書だけはきちんと作る場合が多いです。テンプレートの解説のため、テンプレート別にわけてありますが、それぞれのファイルを基本設計書としてzipで1つにまとめています。

基本設計書テンプレートに含まれているファイル
名称説明
システム構成図システムの全体の構成を図にします。
業務フロー図業務の流れを図で示します。
テーブル定義書DBのテーブルの定義
機能一覧システムの機能を一覧にした表
画面一覧システムで使用される画面の一覧
画面遷移図画面上の動きを図にしたもの
帳票一覧出力される帳票の一覧
帳票レイアウト(縦)縦形式の帳票のレイアウト
帳票レイアウト(横)横形式の帳票レイアウト

詳細設計書

詳細設計は、機能の内部的な設計を行うドキュメントのため表紙、更新履歴、フレームのテンプレートを用意しました。プロジェクトによっては、画面レイアウトや帳票レイアウトを詳細設計に含める場合もあるのでプロジェクトの規則に従ってください。

詳細設計書 表紙 詳細設計書 更新履歴 詳細設計書 フレーム

テスト仕様書

テスト仕様書は、一番プロジェクトで特徴がでる文書ですがテンプレートとして一般的なテスト項目と検証内容から実施日と結果だけを一覧で報告する形式を紹介します。

エビデンスや再現方法などの詳細用のテンプレートは別に必要かもしれません。ダウンロードできるファイルはzipの中に単体テスト、結合テスト、総合テスト用のエクセルファイルがまとめられています。この3つのファイルはタイトル以外は同じです。

テスト仕様書テンプレートに含まれているファイル
名称説明
単体テスト用のテンプレートファイル単体テスト単体テスト用のテンプレートファイル
結合テスト用のテンプレートファイル結合テスト結合テスト用のテンプレートファイル
総合テスト用のテンプレートファイル総合テスト総合テスト用のテンプレートファイル

システム開発の初期に必要なテンプレート

システム開発のプロジェクトを開始する前に作成しておきたい文書のテンプレートです。プロジェクトの規模や進め方によっては不要なものもあるのでプロジェクトに合わせて使用してください。

体制図

プロジェクトを始める前に、どのような人員構成で体制がどうなっているかを図にしておくと、後から参加した人にもわかりやすく説明することができます。担当を明確にするという意味でも作成しておいた方がいいでしょう。

システム開発の体制図1 システム開発の体制図2 システム開発の体制図3

議事録

システム開発は、要件定義や最初に行うヒアリングですべてが完成するということはまずありません。開発中に何度も打ち合わせをする必要があるので、決定事項を記録したり、後から証拠を残すという意味でも議事録は大切です。議事録は会議の内容を記録すれば足りるのですが、日付、出席者、内容など記録すべき項目が最初からわかっているテンプレートを利用すると便利です。

議事録テンプレート1 議事録テンプレート2 議事録テンプレート3

スケジュール管理・タスク管理用

システム開発の設計を始める前に必要なのが、いつまでに何を完成させるかというスケジュールを決めることです。

設計の段階で正しく進むスケジュールを組むことは非常に難しいですが、業務を細分化しておおまかな工期を設定することは意味があります。

WBS

WBSは、システム開発で必要な業務を細分化することです。WBSにバーチャートでのスケジュールの機能を追加したものが下記のガントチャートです。プロジェクトを開始する前に全体像と工数を把握するために作成しておくと今後の作業がはかどります。

ガントチャート

ガントチャートはプロジェクトのスケジュールや進捗を管理するために使われます。特に納期が厳しいプロジェクトでは、ガントチャートで進行を把握しておかないと直前になって徹夜や休出を繰り返すという悲惨なことになってしまいます。ガントチャートはWBSにスケジュール表を組み込んだものです。特にWBSを顧客に提出する必要がなければ、ガントチャートだけを使用してもいいでしょう。

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

システム開発を進めているときに必要になる管理表のテンプレートです。エクセルができる方ならすぐに作成できますが、ある程度どんな項目が必要かわかるテンプレートを活用した方が効率的に作成することができます。

Q&Aシート

システムを発注する顧客に使用の確認をする場合、質問と回答を管理するシートです。Q&Aシートをつくる意義としては、同じ質問を何度も繰り返さない、メンバーに質問を共有できる、過去にした質問がメールでは埋もれてしまうといった問題を解決することができます。

課題管理表

Q&Aシートが、顧客との間のやりとりだとすると、課題管理表はプロジェクトメンバー内で問題の提起と完了を報告するための管理表です。課題管理はクラウド型のツールを使うことが多いですが、小規模なシステム開発ではエクセルでの管理が手軽です。

まとめ

今回は、システム開発とプロジェクトの管理に役立つテンプレートを紹介しました。

プロジェクトや開発するシステムによって必要なドキュメントが異なってくるので、今回紹介したテンプレートで足りないものが出るかもしれませんが設計書のフレームだけでも使えると思います。

Twitterでフォローしよう

おすすめの記事