仕様書

仕様書には、機能の一覧と内容、画面や帳票の項目、入力の決まり、計算の方法、エラーのときの扱い、性能や安全性の条件などを書きます。要件定義書、基本設計書、詳細設計書など、工程ごとの文書をまとめて仕様書と呼ぶこともあり、範囲は場面によって異なります。

契約では、仕様書が、何を作れば完成かの基準になることがあります。発注者として、承認した仕様書の版と日付を記録し、後から変えた点が分かるようにしておくことが大切です。読んでも分からない表現があれば、そのままにせず、例や画面で説明してもらいます。

仕様書に書かれていないことは、作る側と頼む側で受け取り方が分かれやすくなります。当然こう動くはずという業務の前提こそ、言葉にして書いておきます。仕様書と実際のシステムがずれていくと保守の妨げになるため、変更のたびに更新する担当を決めておきます。