
V字モデルを"本当に"使えている現場は少ない

【V字モデルと本当に向き合っているか】
システム開発に関わる者なら、誰もが一度は目にしたことがある「V字モデル」。しかし、左側の「設計」と右側の「テスト」が、単なる対照図ではなく「運命共同体」であることを、ちゃんと理解できている現場はどれほどあるだろうか。
そんなことをいろいろな場面で感じます。
本題に入る前にすこし自己紹介させてください。
私は新卒でSIerに入社し、7年間社会のインフラと呼べる大型システムのWebサーバチームに所属していました。最後の1〜2年はプロジェクトのサブリーダーを担当し、改修規模約2万stepに対し、リリース後バグ0件を達成しました。その後転職、メーカーの社内SEとして5年目(※2026/4時点)となる品質に重きを置くシステムエンジニア(webアプリが得意)です。
SIerでは当たり前と思っていたウォーターフォール開発のセオリーを、世の中ではなんとなく捉えている方もたくさんいることを知り、今回noteを借りて、綴らせていただきたいと思います。
【基本設計:プロジェクトの成功はここで決まる】
基本設計を始める際にどこから始めているでしょうか。とりあえず画面設計から…となっていないでしょうか。ウォーターフォール開発における基本設計は今後何年、何か月にわたって進むプロジェクトの基軸です。ここをおろそかにすると設計段階では静かですが必ずテストフェーズで跳ね返ってきます。
当たり前のようでも大事なことを少し列挙します。
・段階を踏んで資料を落とし込んでいく
ウォーターフォール全体でもそうですし基本設計フェーズ内でもおなじことです。
例:ユーザ要望整理→ユースケースまとめ資料→画面遷移図→基本機能設計や画面定義書
・「テストしやすい」設計書構成とする
基本的に基本設計書フォルダと総合テストフォルダは写し鏡です。フォルダ階層は同じになります。また基本設計書1ファイルにおいてもテスト項目書1シートに落とし込みやすい章立てや構成にするべきです。
・テーブル定義書に「項目説明」や「とりうる値」まで明記できているか
結果DBから出力できるようなレベルのテーブル定義書はだれも開きません。実際のDBを閲覧したほうがはやいからです。面倒でもその項目がどういうものなのか、何に使われるのか、どういう値が入っているのかが書かれている資料にしなければいけません。
【詳細設計:基本設計からの落とし込み】
詳細設計フェーズは基本設計で作った設計書からの落とし込みになります。また結合テストがしやすい章立て、構成になっている必要があります。
・トランザクション一つずつの徹底整理
基本機能設計はユースケース単位等、大きい単位の機能記述に対して、ここでは画面遷移図の矢印一つ一つの設計になります。リクエストからレスポンスまでの起動プログラムを設計することで結合テストで検証すべきことが明確になります。
・項目定義の徹底
テーブル定義に紐づく項目定義書を疎かにしない。ここが整えば、結合テストの観点は自然と導き出されます。
【最後に】
ここまで読んでいただきありがとうございました。
「うちは予算が足りないから…」や「そんな教科書通りにいかない」と思った方もいるかもしれませんがここまで書いた内容は工数は膨れる内容ではなく、話の進め方の整理がメインです。
またコンサルらしいカタカナも使わず、実態に伴った泥臭い経験談に基づいています。
一部でも参考にしていただければと思います。
ちなみに組織によって当たり前も違うし、プロジェクト特有の経緯や目的、扱うシステムによっても大きく変わるため、あくまで参考程度に捉えていただければと思います。
全部を書くことはできないので説明しやすい部分のつまみ食いで記事にしました。次はテストフェーズでの品質の求め方や組織についても少し触れようと思います。