システム開発の成果物とは?工程別の一覧と受け取る前の確認点

説明用の生成画像です。実在の会社や顧客、発注・納品・検収が済んだ場面を示す写真ではありません。
企業向けの研修を運営する会社で、研修の申込業務を兼任する社内IT担当が、研修の申込受付と、当日の受付名簿の準備を見直そうとしています。今は申込表と取消のメールを別々に確認し、取り消した申込みが受付名簿に残らないよう手で照合している状態です。申込みの取消を登録したら、当日の受付名簿の対象から外れる仕組みを相談したい一方で、開発会社から何を受け取れば、作った内容を確かめ、使い続けられるのかが分かりません。「システム一式、資料一式」という説明だけでは、どこまでを頼むか判断しにくくなっています。
この記事は、外部へ業務システム開発を依頼する発注担当・社内IT担当向けです。成果物の意味と工程別の一覧から、申込受付の架空例、依頼する範囲の選び方、受け取る前後の確認まで説明します。「設計書」などの名前だけでなく、誰が何のために読み、どこを見るかが分かるように整理します。
以下は説明用の架空例です。 実顧客の事例ではありません。 実際の発注はしていません。 実物の成果物は未受領です。 内容の確認は未実施です。 業務での試験も未実施です。 本番への導入もしていません。
成果物は、依頼した仕事から受け取る具体物。作業や効果と分ける
たとえば「申込受付の仕組みを設計する」は作業です。その結果を説明する画面・処理の設計資料は成果物の候補になります。「使い方を説明する」は作業で、操作手順や説明資料は具体物です。「名簿の照合作業を減らす」は目指す効果であり、資料を受け取ったことだけで効果が出たとは判断できません。
| 作業:何をしてもらうか | 要件を整理する、設計する、開発・設定する、試験する、使い方を説明するなど。役割と対象範囲を決めます。 |
|---|---|
| 成果物:何を受け取って使うか | 動作するシステム、提供対象のプログラムや設定、設計資料、試験記録、操作・運用の資料など。中身と用途を確かめます。 |
| 効果:業務がどう変わったか | 手作業の照合や確認待ちがどう変わったかなど。実際の利用条件と結果で確かめることで、納品された数からは決まりません。 |
「成果物」と「納品物」は、今回の依頼で受け取る対象を確認する
開発中に作るものを広く成果物と呼ぶ場合も、納入する対象を成果物と呼ぶ場合もあります。用語だけで判断せず、今回どれを受け取り、どれは開発側の内部資料で、どれを確認のために閲覧できるかを合わせます。完成したシステムを使えることと、内部のプログラムや全ての設計資料を受け取れることは同じではありません。
受け取る対象は、依頼の範囲や契約、利用するサービスの条件によって異なります。この記事の一覧は全てを必須納品にする規則ではなく、自社が使う目的から質問するための代表例です。
工程別の成果物一覧は、「何に使うか」と組にして読む
開発の工程名や資料名は会社・案件によって違います。基本設計・詳細設計を分ける場合も、短い周期で設計・開発・試験を繰り返し、管理ツールに内容を残す場合もあります。次の区分は、確認する目的から代表例を整理したものです。一つの工程ごとに一冊の資料や一枚の画像を作るという意味ではありません。
| 要件を決める |
受け取る候補:業務の流れ・要件の資料 使う目的:何を実現し、どの仕事を人が続けるかを合わせる |
|---|---|
| 仕組みを設計する |
受け取る候補:画面・処理・データの設計資料 使う目的:入力する状態と名簿に載せる条件のつながりを読む |
| 開発・設定する |
受け取る候補:今回提供するプログラム・設定と、その説明 使う目的:動作する対象と、変更・再設定に必要な物を対応させる |
| 試験する |
受け取る候補:試験の条件・手順・結果の記録 使う目的:何を、どの版と条件で確かめたかを読む |
| 移行・使い始める |
受け取る候補:移行の手順・操作手順・運用の資料 使う目的:情報を移し、日々の受付と困ったときの対応を続ける |
要件の資料では、実現したい仕事と対象外を合わせる
要件定義書、業務の流れ、機能・データ・画面や帳票の一覧、性能や利用条件などが候補になります。何を実現するか、誰が使い、どんな条件が必要かを説明するための物です。業務の対象とシステム化する範囲、業務担当が続ける判断も確認します。
IPAの要件定義の説明も、業務の要求を文書化し、システムの機能・非機能の要求を整理して関係者と合意する流れを示し、作成する文書はプロジェクトによって異なるとしています。IPA DX SQUARE:要件定義の説明
設計資料では、画面・処理・データの対応を見る
画面の項目、入力や変更の処理、保存するデータ、他のシステムへ渡す情報などが、要件とどう対応しているかを読みます。発注側が確認する資料と、開発者が実装・変更のために使う詳細資料を区別し、読む人に必要な説明があるかを相談してください。
IPAのアーカイブには、業務の流れ、データ項目、システム間の情報、画面・帳票、運用などを説明する資料の実例分類があります。名前だけをコピーするより、何を明確にする資料かを読む参考になります。掲載サンプルや旧規格の分類を、全案件の必須書式として使う説明ではありません。IPA:要件定義の成果物事例の分類
プログラム・設定は、どこまでを提供し、どう変更できるかを聞く
ソースコードは、人が記述したプログラムの元の内容です。実行するファイル、設定、構築に必要な情報、利用する部品やサービスの説明とは役割が違います。コードを受け取る範囲、対象の版、動かすための前提、保管先と変更する担当を具体に聞きます。自社で実装の内容を判断できない場合は、必要な経験を持つ確認担当や支援の範囲を決めます。
試験記録は、手順の案と実際の結果を分ける
試験計画や確認する項目、条件、手順、期待する結果、実際の結果、問題と再確認の記録などが候補です。「試験済み」という一語では、どの版をどの環境で、どこまで確かめたかが分かりません。計画だけがある状態を、結果が合格した状態へ置き換えないようにします。
移行・操作・運用は、使い始めた後の仕事につなげる
情報を移す対象と手順、確かめ方、日々の操作、問い合わせや障害時の連絡先、更新・バックアップなどの運用に必要な資料を相談します。作業手順を受け取ることと、その担当が必要な操作を行えることは別です。サービス側が担う仕事と自社が担う仕事も分けてください。
同じ「取消を名簿へ反映する」仕事で、資料の中身をつなぐ
この会社の相談で大切なのは、資料名の数ではなく、同じ申込業務が要件から操作までつながることです。取消の連絡内容の確認と、当日の受付での例外判断は、業務担当に残すという役割も残しながら、次のような中身を依頼する候補にします。以下の抜粋は、説明用に作った案です。実際の画面やコード、受領した資料を示すものではありません。
| 研修の申込表(架空) | 申込みと現在の受付状態を確かめる |
|---|---|
| 当日の受付名簿(架空) | 当日に受け付ける参加者を確かめる |
要件の抜粋案
取消を登録した申込みは、当日の受付名簿の対象にしない。取消の連絡内容は業務担当が確認する
設計の抜粋案
申込状態が「取消」の記録は、受付名簿を作る対象から除く。どの画面で状態を変え、誰が変えられるかも設計する
プログラム・設定の提供範囲の案
申込状態を保存する処理と、受付名簿の対象を選ぶ処理に対応するプログラム・設定の提供範囲を明記する
試験で確認する内容の案
確認する案:取消を登録して名簿を作る。期待する結果:取り消した申込みは名簿に載らない。実際の結果はまだ記録していない
操作手順の抜粋案
操作手順の案:対象の申込みを確かめ、取消を登録し、名簿の対象から外れたかを確かめる。誤って変更したときの相談先も決める
設計資料に「取消は対象外」と書いてあっても、何を取り消す操作なのか、名簿のどの条件へ反映するのかが分からなければ質問が残ります。試験でも、取消の登録を行い、対応する名簿の対象を確かめるように、同じ業務のつながりをたどります。入力を間違えた場合、変更権限がない場合、変更を戻す場合など、業務で必要な例外も確認対象へ相談します。
図で見る問い:取消の連絡を受けた担当が、どの資料のどこを見れば、名簿へ反映する仕組みを確かめられるでしょうか。同じ申込みを扱う要件のメモと設計の条件、試験の案を見てください。
この解説図を原寸で見る図の読み方:「取消は名簿の対象外」という一つの条件を、要件・設計・確認する案へ結び付けます。資料が並んでいること自体を、実装や試験の完了にはしません。
今回受け取る範囲は、開発方法と自社で続ける仕事から選ぶ
後半の受領・内容確認・業務確認を分ける図も使い、受け取る物を、誰がどの仕事で確かめるかへ結び付けます。
独自に開発する部分と、既製品の設定で使う部分、外部サービスを利用する部分では、受け取れる物と必要な確認が変わります。自社の今後の更新や、別担当への引継ぎで何が必要になるかを考え、提供対象と利用条件を個別に確認します。
| 独自開発する部分 | 提供するソースコード・設定・設計や試験の記録などの範囲を確認します。動作する対象との対応、構築・変更するための前提、更新を担う人も聞きます。 |
|---|---|
| 既製品・外部サービスを使う部分 | 製品本体の内部コードまで受け取るとは推定しません。自社向けに設定した内容、利用する手順、データの扱い、管理担当、利用終了や移行の条件など、今回必要な情報を聞きます。 |
| 小さく作って繰り返し更新する場合 | 節目ごとに、どの版の何を渡し、どの条件で確認するかを合わせます。管理ツールの記録も含め、最終時点で必要な説明や対応関係が読めるかを確認します。 |
資料を作らないと決める場合も、その資料が担う説明や確認をどこで行うかを考えます。逆に「念のため全ての資料を」と依頼する前には、誰が何に使うかを確かめてください。今回の確認・運用に必要な情報を欠かさず、使い道のない書式の数だけを増やさないためです。
今回合意した納入範囲は未確認です。ソースコードの提供、第三者の部品や素材、利用するサービスの条件、権利や変更の扱いは、案件の資料と関係担当に確認します。この記事から個別の納品義務や権利帰属を判断することはできません。
依頼には、中身・対応する版・渡す時点・確認する人を書く
同じ仕事を資料へつなぐ図も使い、今回必要な中身と、対応する版・渡す時点を具体化してください。
「操作マニュアル一式」だけでは、誰がどの操作を行うための資料か、更新後の内容か、いつ読めるかが伝わりません。下は同じ申込業務について、依頼内容を具体化するための案です。資料の形式を先に固定するより、使う人の目的と必要な中身から合わせます。
| 受付名簿を作る条件と、取消登録の操作手順 |
誰が何に使うか:申込担当が、取消を登録した後に当日の受付対象を確かめる 含めたい中身:取消の対象を間違えない確認、状態の変更、名簿の対象条件、誤操作した場合の相談先 形式を相談する案:読み手が参照できる資料と、合意した方法で更新できる元資料の範囲を相談する 渡す時点を相談する案:業務側が受入確認を行う前に確認用を受け取り、変更があれば最終版と差分を受け取る |
|---|
この案には、実際の対象の版・納入日・保管先・確認する担当と方法の回答がまだありません。下記は未確認の条件で、説明用に日付や担当者を作って埋めた例ではありません。
| 対応する版・渡す日 | 対応する版:未確認/納入日:未確認 |
|---|---|
| 保管先と、確認する役割 | 保管先・アクセス方法:未確認/確認する担当:未確認 |
| 合意した確認方法 | 未確認 |
更新されたときは、システムと資料の対応も確かめる
画面の項目や操作が変わったのに手順だけが古いと、受け取った資料を業務で使いにくくなります。対象のシステムの版と資料の版、何が変わったか、どれが最終の対象かを対応させます。確認用の案を受け取る時点と、修正を反映した物を受け取る時点も分けて相談してください。
NASAのソフトウェア調達ガイダンスは、その対象となる調達で、成果物の内容・形式・納入日・レビュー期間・受入手順を具体化することと、納入後の確認・管理を分けて示しています。ここではその区別を、依頼内容を考える参考にしています。日本の民間案件へNASAの規則や全成果物を一律に義務付ける説明ではありません。NASA:Acquisition Guidance(Ver C)
受け取ったこと、内容を確かめたこと、業務で使えたことを分ける
資料の送付連絡やファイルの存在だけでは、中身が依頼を満たすかも、必要な仕事を行えるかも分かりません。確認では、次の問いを同じ成果物と対象の版に結び付けます。
| 受領の確認:何が届いたか | 依頼した対象のファイルや資料があり、必要な人が開けるか。対象と版、足りない物、閲覧・利用に必要なアクセスを確かめます。 |
|---|---|
| 内容の確認:依頼した説明があるか | 取消する対象の確認、状態の変更、名簿の対象条件、相談先など、依頼した中身があるか。表記や手順の食い違い、未回答を質問します。 |
| 業務での確認:必要な仕事を行えるか | 許可された確認環境と合意した条件で、対象の申込みの取消を扱い、受付名簿の対象を確かめるなど、業務に対応した確認を行い、結果を残します。 |
担当者は、誰が内容を読み、誰が操作を確かめ、誰が結果から判断するかを分けて相談します。人数を一律に増やす意味ではなく、社内だけで判断できない内容があれば、適切な支援を依頼するためです。業務担当へ全てのコード品質の判定を任せたり、技術担当だけで業務の扱いを決めたりしないようにします。
図で見る問い:操作手順のファイルが届いたら、それだけで確認完了にしてよいでしょうか。「開けた」「必要な説明がある」「同じ条件で仕事を確かめた」の違いを見てください。
この解説図を原寸で見る図の読み方:受領欄の記入から、内容や業務の合格を推定しません。不足した説明や結果を対象の資料・版へ返し、確認先と次の対応へつなげます。この例ではいずれも実施していません。
足りない物や食い違いは、対象・箇所・困る仕事を示して返す
たとえば「取消の手順はあるが、誤って対象を変えたときの相談先がない」なら、対象の手順と箇所、業務上困る場面、求める説明を相手へ伝えます。修正版が届けば、修正した箇所と関係する操作を同じ前提で確かめます。「送ってもらった」「修正したと言われた」だけで判断を進めないようにしてください。
受入の操作を組み立てる方法や、残る課題と引継ぎを含めて開発を閉じる条件は、別の判断です。本稿は、まず何を納入対象にし、どの内容を確認するかを具体化する説明です。終結の相談へ進むときは、未解決の課題と引継ぎを分ける終結記録も参考にできます。
まとめ:成果物の名前を、使う仕事と確認する中身へ戻す
システム開発の成果物は、完成したシステム、要件や設計の資料、提供対象のプログラム・設定、試験の記録、移行・操作・運用の資料などです。必要な物は依頼の範囲と開発方法で変わるので、一覧を全部必須にせず、今回の仕事に何が必要かを選びます。
依頼では、使う人と目的、必要な中身、対象の版、形式と保管・アクセス、渡す時点、確認する人と方法を具体化してください。受領・内容の確認・業務で使える確認を分け、足りない条件は質問として残します。
会社・仕事・資料の抜粋は、説明用に作った架空例です。実際の顧客の納品物や稼働画面ではありません。 資料に書いた条件や手順は依頼する内容の案です。合意済みの仕様、受領済みの成果物、実施済みの試験結果ではありません。
仕事の流れから、顧客との接点まで。
一体で見直す、最初の一歩を。


