仕様書のないシステムを解析するときに見ていること｜現状調査の手順と報告書の中身

「仕様書がないシステムを調べてほしい、と頼んだら何をしてもらえるのか」「調査に30万円以上かかるのはなぜか」。システムの入れ替えや保守の引き継ぎの前に行う現状調査は、発注する側から中身が見えにくい作業です。

この記事では、仕様書のない業務システムを解析するとき、開発会社が実際に何を見て、どんな手順で進め、何を報告書にまとめるのかを具体的に解説します。

解析の4つの観点

どれか1つだけでは、正しい姿は分かりません。コードにはあるのに誰も使っていない機能や、コードにはないのに手作業で補っている業務が、突き合わせることで見えてきます。

解析の手順

1. 全体の地図を作るサーバー構成、言語とフレームワーク、ファイル数・行数、画面と帳票の数、外部との接点を数える
2. 入口と出口を押さえる画面・取り込みファイル（入口）と、帳票・出力ファイル・他システムへの送信（出口）を一覧にする
3. データの流れを追う入口から出口まで、どのテーブルを経由し、どこで計算・更新されるかを図にする
4. 業務ルールを抜き出す金額の計算、締めの処理、ステータスの変化、権限の判定などを、業務の言葉で一覧にする
5. 利用状況と照らし合わせるログや聞き取りで、実際に使われている機能を確かめる
6. リスクを洗い出すサポートの切れた部品、セキュリティの穴、特定の人しか知らない運用、データの不整合を挙げる
7. 選択肢を整理する保守を続ける・部分的に直す・作り直すの選択肢を、費用感と期間で比べる

報告書に入れる内容

当社が作る報告書の見本（架空のシステムで作成したもの）を、資料ダウンロードのページで公開しています。

関連記事仕様書がないシステムを改修・移行するには｜現状調査（リバースエンジニアリング）の進め方と期間・費用の目安、調査後の選択肢

関連記事システムのブラックボックス化の原因と解消方法

調査を依頼するときに用意するもの

• ソースコード：サーバー上のファイルでも、開発会社から受け取ったものでもよい
• サーバー・データベースへのアクセス：読み取り専用の権限で十分なことが多い
• 残っている資料：古い仕様書、操作マニュアル、見積書、メールのやり取りなど、断片でも役立つ
• 業務の担当者の時間：1〜2回、1時間程度の聞き取り

ソースコードが手元にない場合は、まず入手の方法から一緒に考えます。契約書で著作権や引き渡しの取り決めを確認することもあります。

関連記事システム開発の著作権は誰のもの？ソースコードの権利帰属と契約の注意点

よくある質問

まとめ

仕様書のないシステムの解析では、ソースコード・データベース・ログ・利用者の話の4つを突き合わせ、全体の地図から業務ルールの一覧、リスク、選択肢までを報告書にまとめます。この報告書があれば、保守を引き継ぐ場合も、作り直す場合も、根拠をもって次の一歩を決められます。