旧システムの仕様書がない場合の可視化・文書化の進め方
長年運用してきたシステムに仕様書が存在せず、移行や改修に踏み出せないという相談は少なくありません。仕様を可視化・文書化する実務的な進め方を解説します。
「長年使ってきたシステムだが、仕様書が残っていない」「作った担当者が退職してしまい、何がどう動いているのか誰も把握していない」——システムの移行や刷新を検討する企業から、こうした相談が寄せられることがあります。仕様書がない状態は珍しいことではなく、特に長期間運用されてきた業務システムほど、その場その場の改修が積み重なり、全体像を説明できる資料が失われているケースが多く見られます。
とはいえ、仕様書がないからといって移行や改修をあきらめる必要はありません。この記事では、仕様書が存在しない旧システムの仕様を可視化し、文書として整理していくための実務的な進め方を解説します。
この記事の要点(30秒でわかるまとめ)
- 仕様書がない状態は「異常」ではなく、長期運用システムによく見られる現象
- 可視化の出発点は、実際のデータ・画面・ログからの逆引きが基本
- 現場担当者へのヒアリングと実データの突き合わせで精度を上げていく
- 完璧な仕様書を目指さず、移行・改修の目的に必要な範囲から文書化するのが現実的
仕様書がない状態がなぜ起きるのか
結論:仕様書が失われるのは管理不足というより、長期間の運用の中で改修が積み重なり、ドキュメントの更新が追いつかなくなることで起きる、構造的に避けにくい現象です。
初期構築時には仕様書が存在していても、その後の追加開発や緊急対応のたびに資料を更新する運用が定着していなければ、実態とドキュメントの差はどんどん広がっていきます。さらに開発会社側の担当者交代や、社内の担当者の異動・退職が重なると、システムの背景にある「なぜこの仕様になっているか」という経緯まで失われてしまいます。こうした引き継ぎの課題は、開発会社側の担当者が交代した場合にも同じ構造で起こり得ます。
可視化の第一歩:実データとシステムからの逆引き
結論:仕様書がない場合の可視化は、まず「今動いているものを観察する」ことから始めるのが最も確実な方法です。
具体的には、データベースのテーブル構造・画面の入力項目・出力される帳票やレポートを実際に確認し、そこから逆算して業務ロジックを推測していきます。画面上の項目名と実際のデータ項目が一致しないことも多く、このズレ自体が過去の改修の痕跡を示す重要な情報になります。移行プロジェクトにおける棚卸しの考え方はシステム乗り換え前の「棚卸し」実践法:使っている機能・いない機能の見える化で詳しく解説していますが、仕様の可視化もこの棚卸しと並行して進めると効率的です。
| 可視化の対象 | 確認する内容 |
|---|---|
| データベース構造 | テーブル・項目の意味、必須/任意の区別 |
| 画面・入力フォーム | 入力ルール、バリデーションの有無 |
| 出力物(帳票・レポート) | 計算ロジック、表示条件の分岐 |
| ログ・操作履歴 | 実際の利用パターン、例外的な使われ方 |
顧客・商品マスタなど基幹データの名寄せも並行して検討する
結論:仕様の可視化と合わせて、マスタデータの名寄せや重複整理を検討しておくと、後工程の移行作業が大きく楽になります。
長期運用システムでは、表記ゆれや重複登録が蓄積しているケースが多く、仕様を文書化する過程でこうした課題が見つかることもよくあります。旧システムの顧客・商品マスタの整理については旧システムの顧客・商品マスタデータの名寄せ手順で具体的な手順を紹介しています。
現場担当者へのヒアリングで実態を補完する
結論:システムの観察だけでは分からない「暗黙のルール」や「例外対応」は、現場担当者へのヒアリングで補う必要があります。
たとえば「この項目は入力しなくても画面上は通るが、実際には必ず埋めている」「このボタンは本来の用途とは違う使い方をしている」といった運用上の慣習は、システムを見るだけでは分かりません。ヒアリングでは、担当者の説明と実際のデータを突き合わせて検証しながら進めることが重要です。要件定義のヒアリングと同様のアプローチが、仕様の可視化においても有効です。
ヒアリング対象者が複数部門にまたがる場合の進め方
結論:仕様を把握している担当者が複数部門に分散している場合は、部門間の認識のズレそのものも記録しておくことが重要です。
同じ機能について部門ごとに異なる理解をしているケースは珍しくなく、このズレを放置したまま文書化を進めると、後工程でトラブルの原因になります。
文書化はどこまで詳細にすべきか
結論:仕様書は網羅的な完成を目指すのではなく、移行や改修という目的に必要な範囲から優先的に文書化していくのが現実的なアプローチです。
すべての機能を同じ精度で文書化しようとすると時間がかかりすぎ、プロジェクト自体が停滞してしまいます。利用頻度が高い機能や、業務上のリスクが大きい機能から優先的に整理し、使われていない機能については簡易的な記録で済ませるといった判断が必要です。文書化した仕様は、要件定義書との役割分担を意識して整理すると、その後の開発会社との連携もスムーズになります。
よくある質問(FAQ)
Q. 仕様書が全くない状態でも、システム移行は進められますか? A. はい、進められるケースが多いです。実データやシステムの挙動から逆算して仕様を可視化し、必要な範囲から文書化していくアプローチが現実的です。
Q. 可視化・文書化の作業は社内だけで対応できますか? A. 現場の業務知識が必要な部分は社内対応が向いていますが、データベース構造の分析や文書化の体系立てについては、開発会社の支援を受けた方が効率的に進むケースが多いです。
Q. 文書化にはどれくらいの期間がかかりますか? A. システムの規模や機能数によって大きく変わるため一概には言えませんが、優先度の高い機能から段階的に進めることで、全体の着手から一定の成果が見えるまでの期間を短縮できる可能性があります。
Q. 文書化した仕様書は、そのまま新システムの要件定義に使えますか? A. ベースとして活用できますが、旧システムの仕様をそのまま引き継ぐべきか、見直すべきかの判断を加える必要があるため、要件定義の工程で改めて整理することをおすすめします。
まとめ
仕様書がない旧システムの可視化は、実データやシステムの挙動からの逆引きと、現場担当者へのヒアリングを組み合わせて進めるのが基本です。完璧な仕様書を目指すのではなく、移行や改修の目的に必要な範囲から優先的に文書化していくことで、現実的な期間内にプロジェクトを前進させることができます。
Irwin&co株式会社はAI受託開発の一環として、仕様書が存在しない旧システムの可視化から移行・刷新までを一貫して支援しています。フォーム回答から要件定義書や見積書を即日自動生成できる仕組みも備えていますので、まずはお問い合わせから現在のシステムの状況をご相談ください。
執筆者プロフィール

アーウィン 海Irwin&co株式会社 代表取締役
生成AIを活用したシステム開発・コンサルティング・研修サービスを提供するIrwin&co株式会社を創業し、IT専任者のいない中小企業を中心に、業務システムの構築とSaaSからの移行を支援している。「SaaSの標準機能に業務を合わせるのではなく、業務に合わせたシステムを自社の資産として持つ」という考え方のもと、不動産をはじめとする業界で、生成AIを前提とした業務システムの設計・開発を数多く手がける。
