保守担当者の退職・引き継ぎ
担当者の退職や異動の前に、属人化した仕様をコードと照合して文書化し、後任が改修のたびに調査から入らずに済むようにします。
ソースコードしか残っていないシステムの仕様書をAIで作成します
PHP・Java・C#・VB・Accessなどで作られた業務システムが対象です。
移行を伴わない仕様書作成のみのご依頼にも対応しています。
※ 約25万行の基幹システムの移行で活用した、AIマイグレーションと同じ解析基盤を使います。
// Situation
担当者の退職や異動の前に、属人化した仕様をコードと照合して文書化し、後任が改修のたびに調査から入らずに済むようにします。
データの処理フローや操作権限の説明を求められたとき、古い設計書しかなくても現行のコードから作成し直せます。
システムの規模や構成を示す資料がないと各社が概算を出せないため、引き継ぎ資料として仕様書が先に必要になります。
現行の機能・データ構造・外部連携を可視化し、移行計画や見積もりの根拠資料にします。
// Deliverables
| 仕様書の種類 | 内容 | AIによる自動化レベル | 人による確認・補完内容 |
|---|---|---|---|
| 機能一覧 | 画面・バッチ・APIの棚卸しと、行数・画面数・テーブル数の実測値 | ほぼ自動 | 未使用機能の有無の確認 |
| データ項目定義 | テーブル・項目・型・制約と、区分値の一覧 | ほぼ自動 | 項目や区分値の業務上の意味の確認 |
| 呼び出し関係・CRUD | どの機能がどのデータを作成・参照・更新・削除するか | ほぼ自動 | 外部部品は呼び出しと受け渡す値まで記録 |
| 画面・帳票仕様 | 項目一覧、入力チェック、画面遷移、操作権限 | 大半は自動 | 実画面との照合、設定ファイル等に依存するロジックの確認 |
| 処理フロー | 条件分岐、計算式、データの更新順序、バッチの起動条件と異常時の挙動 | 大半は自動 | 例外的な分岐の背景、仕様か不具合かの判断 |
| 外部インターフェース | 送受信する項目と形式、連携先ごとの呼び出し契機 | 大半は自動 | 相手システム側の仕様や運用ルールの確認 |
「ほぼ自動」はコードとDB定義から網羅的に生成できる範囲、「大半は自動」はAIの生成後に実物照合や業務担当者様への確認を行う範囲です。
// Method
ソースコード、データベース定義、画面・帳票、ログをAIが照合し、全ファイルを機械的に解析して暫定仕様書を作成します。
コードから読み取れない区分値の意味や、仕様か不具合かの判断は、推測で補わず確認事項として一覧化し、業務担当者様との読み合わせで確定します。
記述の根拠になったコードの位置を併記し、日本の業務システムで一般的な設計書の語彙で書きます。保守の引き継ぎにもAIツールでの活用にも使えます。
// Comparison
小規模で社内のエンジニアが対応できるなら、汎用AIツールでの内製も可能です。当社のサービスは、大規模なシステムを業務意図の確認まで含めて任せたい場合に向いています。
| 方法 | 出力・成果物 | 業務意図の反映 | お客様側の作業 |
|---|---|---|---|
| 汎用AIツールの自社活用ChatGPT、GitHub Copilot、Claude Codeなど | 関数やファイル単位の解説。体系化には人手での再編が必要 | コード以上の意図は読み取れない | プロンプト設計、出力の検証、全体の体系化 |
| 従来型の解析ツールリバースエンジニアリングツール | 呼び出し関係、CRUD図、メトリクスなどの構造情報 | 反映されない | ツールの導入と出力の読み解き。文章の仕様書は別途作成 |
| 当社のAI仕様書作成AI解析とエンジニアのレビュー | 機能一覧から処理フローまでの体系的な仕様書と、確認事項の一覧 | 確認事項として抽出し、読み合わせで確定 | 確認事項へのご回答と、読み合わせへのご参加 |
// Process
STEP 01
期間:個別にご案内
STEP 02
期間:対象範囲に応じて
STEP 03
形式:ご指定に応じて
// Price
費用はコードの行数だけでなく、仕様書にどこまで詳細な業務ロジックを書くかで決まります。
| 粒度 | 含まれるもの | 費用の目安 |
|---|---|---|
| 概要レベル | 機能一覧、画面一覧、データ項目定義、構成図、規模の実測値 | 数十万円台から |
| 詳細レベル | 画面・API・バッチ単位の処理フロー、入力チェック、CRUD、確認事項の読み合わせ | 規模に応じて数百万円まで |
| 継続更新 | ソースコードの変更に合わせた仕様書の更新 | 個別にご案内 |
概算費用は、無料診断でソースコードの一部を簡易解析してご提示します。見積もりの内訳の考え方はコラム「マイグレーションの見積方法」をご覧ください。
// Security
無料診断の段階から、NDA(秘密保持契約)を締結してソースコードをお預かりします。
当社が管理するクラウドAI基盤のほか、お客様のクラウド環境(AWS・Azure)内の専用環境でも作業できます。
生成AIサービスの法人向け契約・API設定に基づき、お預かりしたコードやデータが学習に利用されない形で運用します。
解析に使うのはソースコードとデータベースの定義情報で、個人情報や取引データなどの実データがなくても仕様書を作成できます。
委託先に確認すべきセキュリティ要件は、コラム「ソースコードを生成AIに渡して大丈夫か」にまとめています。
// FAQ
移行はまだ決めていません。仕様書の作成だけを依頼できますか?
可能です。仕様書は特定のツールや移行ベンダーに依存しない形式で整えるため、保守の引き継ぎや相見積もりの資料にも使えます。将来の移行をご検討の場合は、移行の中で作成する方が効率的なこともあるため、無料診断の結果を見てご案内します。
どのような言語やフレームワークに対応していますか?
PHP(FuelPHP・CakePHP・Laravel)、Java(Struts・Seasar2・Spring)、C#・VB.NET、VB6、Access、Perlなどのオープン系に対応しています。メインフレーム系や独自言語は、実行環境への依存を確認したうえで対応方針をご案内します。
AIが作成した仕様書が正確かどうかは、どのように確かめるのですか?
ソースコード、データベース定義、実際の画面と照合し、エンジニアがレビューします。コードから判断できない点は確認事項として業務担当者様と確定し、仕様書には根拠となったコードの位置を併記します。
古い設計書が一部残っています。それも使えますか?
解析の参考にします。仕様はコードから作成しますが、古い設計書や改修履歴は当時の設計意図を知る手がかりになるため、部分的な資料でもご提供ください。
// Contact
どの程度の仕様書を作成できるかは、実際のコードを解析すると分かります。
移行もご検討中の場合はAIマイグレーションサービスをご覧ください。