外部の開発会社に頼んでいたWebアプリの開発が止まり、担当者とも連絡がつかなくなりました。手元に残っているのは、以前メールで受け取ったソースコードの圧縮ファイル1つと、サーバーのログイン情報のメモだけです。別の開発会社に見てもらおうにも、何を渡せばよいのか、見積を頼むときに何を伝えればよいのかが分かりません。圧縮ファイルを開いてみても、見慣れないファイル名が並ぶだけです。こんなことはないでしょうか。
この記事では、検証用に自分で作ったダミーのWebアプリ(見積依頼を記録する小さな業務アプリ)の圧縮ファイルを、受け取った直後の状態で開き、道具で数え、1枚の診断書にまとめるところまでを実際にやりました。打ったコマンド、出力、診断書そのものを画面で載せています。確かめたのは2026年11月17日の1回分で、今回の題材(画面5枚・ファイル20件)に限った結果です。
この記事で分かること
結論から言うと、受け取った直後の圧縮ファイルは、機械で数えられる範囲(ファイル数・部品の版・直書き・無いもの)だけで1枚の診断書にできます。今回の題材では道具の実行は1秒未満でしたが、動くかどうかと、今も業務で使われているかは数えても分からず、人に聞く欄として残しました。
- 圧縮ファイルを受け取った直後に、道具で数えられること(ファイル数・行数・言語・部品・更新日・直書き・DBの有無)
- 発注側が読める1枚の診断書の項目と、実際に埋めた記入例
- 診断書から、別の開発会社に頼む内容と、作った側・旧サーバーに聞くことを分ける方法
1. 検証したこと
最初に、何をどこまで確かめたのかを書きます。
題材は、この記事のために自分で作ったダミーです。実在の会社や人のコードではありません。Node.jsで書かれた見積依頼のメモ帳で、ログイン、一覧、登録、詳細、取引先の5画面があります。説明書(README)はなく、設定とダミーのパスワードが1つのファイルに直接書かれ、使っていないファイルが5つ混ざり、部品は2017年から2018年に公開された版で固定され、テストはなく、データベースの作り方の記録もありません。現実の引き継ぎでよく見る状態に寄せて作りました。
環境は、macOS 27.2.1、Node.js v22.22.0、npm 11.3.0です。使った道具は、macOSに最初から入っているもの(shasum、unzip、find、wc、stat、grep、sed)と、npmのnpm viewだけです。有料のサービスや、外から取ってきた実行ファイルは使っていません。
手順は次の6つです。
| 手順 | やったこと | 使った道具 |
|---|---|---|
| 1 | 圧縮ファイルの指紋(ハッシュ)を控える | shasum |
| 2 | 新しい空のフォルダに開き、ファイルを数える | unzip、find |
| 3 | 言語ごとの数と行数、更新日の並びを見る | wc、stat |
| 4 | 設定・DB・テスト・説明書の有無を探す | ls、grep |
| 5 | 使っている部品と、その版の公開日を調べる | grep、npm view |
| 6 | 1枚の診断書にまとめる | 手作業 |
かかった時間は、道具を動かす部分の実測で、手順2から4をまとめて実行して0.06秒でした。手順5のnpm viewは9部品で数秒です。ただし、出力を読んで診断書に書く時間は、今回は計っていません。作った本人が検証しているため、現実の引き継ぎ(中身を初めて見る人)と同じ時間にはなりません。この記事では「半日でできる」とは言えません。分かったのは「機械に数えさせる部分は、ほぼ待ち時間が無い」ということだけです。
うまくいかなかった所もあります。ファイルの更新日を圧縮前の時刻のまま保てているかは、受け取る側からは確かめられません(後述)。また、診断書の「判定」欄の3つの条件は、このあと動かして確かめる記事(引き継いだアプリが手元で動くまで)で初めて裏付けが取れるものです。今回の診断書の時点では、動くかどうかは未確認です。
2. 圧縮ファイルを受け取ったら、最初に何を数えればよいのか
最初に数えるのは、ファイル数・種類ごとの数・行数と文字数・更新日の並びの4つです。
まず、開く前に圧縮ファイルの指紋を控えます。同じファイルかどうかを後で確かめるためです。次に、新しい空のフォルダに開いて、ファイルを数えます。

画面の数字は、次のように読みました。
| 見たもの | 出力 | 読み取れること |
|---|---|---|
| ファイル数 | 20件 | 小さなアプリ。数日あれば全体を読める量 |
| 拡張子の内訳 | js 10、ejs 6、json 1、css 1、bak 1、sample 1 | JavaScriptと、画面を作るEJS。.bakは控えのコピー |
| 行数の合計 | 112行(16ファイル) | 画面のファイルは各1行にまとまっている |
| 更新日が最も新しいもの | 設定ファイル(2022-09-05) | 最後に手が入ったのは設定の変更 |
ここで1つ、読み間違えやすい所がありました。画面ファイルの行数がすべて「1」になっているため、行数だけを見ると全体が112行の極小のアプリに見えます。実際は、画面の6ファイルは1行に詰めて書かれていて、文字数で数えると合計3,019文字ありました。行数だけで規模を決めず、文字数も並べるのが安全です。wc -cで数えます。
更新日の並びも読めます。設定ファイルが2022年9月5日、本体の一覧処理と通知処理が2022年1月18日、あとは2021年の日付です。つまり、2022年9月以降は誰も触っていないと読めます。ただし、更新日は圧縮のしかたや受け渡しの経路で変わることがあり、受け取った側は事実として確かめられません。今回の診断書でも「更新日の並び」と書いて、「最後に直した日」とは書いていません。版の履歴(.git)が同梱されていれば誰がいつ何を変えたかが読めますが、今回は含まれていませんでした。
3. 説明書やDBが同梱されているかは、どう確かめるのか
「ある」ものを読む前に、「あるはずなのに無い」ものをlsとgrepで探して確かめます。
次に、「あるはずなのに無いもの」を探します。引き継ぎの詰まりは、あるものより、無いものから起きやすいためです。

見つかったこと、見つからなかったことを表にします。
| 探したもの | 結果 | 意味すること |
|---|---|---|
| 説明書(README) | なし | 起動方法・設定の意味は、コードから読み取る |
| DBファイル(data) | なし | データは圧縮ファイルに入っていない |
| DBの作り方(CREATE TABLE) | 見つからない | 表の構造は、コード内のSQL文から推定する |
| package-lock.json | なし | 部品の正確な版が記録されていない(後述) |
| node_modules(部品の本体) | なし | 部品は入れ直す必要がある |
| .git(変更の履歴) | なし | 誰がいつ何を変えたかは追えない |
| テスト | 試し書きが1つ(old/test_new.js)のみ | 直したあとの確認手段が無い |
設定ファイルには、パスワードや鍵にあたる項目が4件ありました(セッション用の鍵、管理画面のパスワード、メール送信のパスワード、チャット通知の鍵)。検索の段階で、値は伏せ字に置き換えて表示しています(画面の***)。診断書に値は書きません。理由はFAQにも書いたとおり、診断書自体が回覧されて新しい漏れ道になるのを避けるためです。この題材の値はすべてダミーですが、実際の案件では、同じ扱いにしてください。
DBの保存場所が、設定ファイルに絶対パス(/var/www/html/mitsumori/data/app.db)で書かれていることも分かりました。つまり、本番のサーバーにそのDBがあるはずで、それは圧縮ファイルの外にあります。この1行が、のちの「手元で動かす」段階の最大の詰まりになります。
外へ出る通信も数えました。コードの中のホスト名やURLを探すと、メール送信(SMTP)が1件、チャット通知が1件です。「このアプリは、どこに連絡を出すか」が数えられると、本番の鍵を使ったまま手元で動かしたときに、実際のお客様へ通知が出てしまう危険にも気づけます。
SQL文は、コードから8本を拾えました。そこから読み取れる表は、依頼(requests)と取引先(customers)の2つです。DBの作り方の記録がなくても、コード内のSELECT、INSERT、UPDATEの文から、表と列の名前を推定できます。ただし推定は推定です。型や制約(空にしてよいか、重複してよいか)は、コードからは分かりません。
4. 部品の古さは、何を見て判断するのか
入っている版の公開日と、確認時点の最新版との差の2つを見ます。
package.jsonには、使っている部品(ライブラリ)の一覧があります。この一覧と版から、それぞれの部品の版が、いつ公開されたものかを調べました。
| 部品 | 入っている版 | その版の公開日 | 確認時点の最新版 | 備考 |
|---|---|---|---|---|
| express | 4.16.4 | 2018-10-11 | 5.3.0 | 画面の土台 |
| body-parser | 1.18.3 | 2018-05-14 | 2.4.0 | 入力の受け取り |
| ejs | 2.6.1 | 2018-05-05 | 7.0.2 | 画面の部品 |
| express-session | 1.15.6 | 2017-09-26 | 1.19.0 | ログイン状態 |
| lodash | 4.17.11 | 2018-09-12 | 4.18.1 | 道具箱 |
| moment | 2.22.2 | 2018-06-01 | 2.31.0 | 日付の整形 |
| nodemailer | 4.6.8 | 2018-08-15 | 10.6.0 | メール送信 |
| request | 2.88.0 | 2018-08-10 | 2.88.2 | 通信。非推奨の表示あり |
| sqlite3 | 4.0.4 | 2018-11-10 | 6.0.1 | DBの接続 |
公開日と最新版は、npm view <部品> timeの出力にもとづきます(2026年11月17日に確認。npmの公式資料では、npm viewはパッケージの情報を表示するコマンドとされています)。入っている版は2017年9月から2018年11月の公開です。9部品のうちrequestは、npmの登録簿に非推奨の表示が付いていました。
古さは「いつの版か」だけでは判断できません。最新版との差がいくつ離れているかも、診断書に載せておくと、別の開発会社が作業量を見積もる材料になります。なお、古い部品の問題を一覧で調べる方法は、別の検証で実際に動かして確認しているため、ここでは件数を出しません。
もう1つ、ロックファイル(package-lock.json)が無い意味を書いておきます。npmの公式資料によると、ロックファイルは、npmが作った部品の木の正確な形を記録し、あとの導入で同じ木を作れるようにするものとされています。これが無い圧縮ファイルは、部品を今日入れ直すと、直接の部品の版はpackage.jsonの指定どおりでも、その下で使われる部品の版は今日の登録簿から決まります。つまり「当時動いていた部品の組み合わせ」を完全には再現できません。今回の題材は直接の部品が1つずつ版を固定していたので、ここが再現されますが、その下の部品は固定されていません。
5. 診断書には、何を書けばよいのか
規模・言語と部品・DB・最後に手が入った所・直書き・外へ出る通信・同梱されていないもの・使っていないファイルの8項目と、判定を1つ書きます。
ここまでの出力を、発注する側が読める形に並べ直したのが診断書です。

項目は8つ、判定が1つです。ひな形として、そのまま使える形で書き出します。
| 項目 | 何を書くか | 今回の記入例 |
|---|---|---|
| 規模 | ファイル数、行数、文字数 | 20件、112行、画面は3,019文字 |
| 言語・部品 | 言語、直接使う部品の数、版の公開日の範囲 | JavaScript、部品9、2017年9月から2018年11月 |
| DB | 種類、同梱の有無、作り方の記録の有無 | SQLite、同梱なし、記録なし |
| 最後に手が入った所 | 更新日の並び(手がかりとして) | 設定が2022-09-05 |
| 直書きされた秘密 | 件数と置き場所(値は書かない) | 4件、設定ファイル |
| 外へ出る通信 | 種類と件数 | メール1、チャット通知1 |
| 同梱されていないもの | 説明書・テスト・ロックファイル・DB・サーバー情報 | すべて無し |
| 使っていないファイル | 名前と、ほかからの参照の数 | 5件、参照0 |
使っていないファイルは、名前だけでは判断しません。今回は、それぞれの名前(list_old、utils_copy、test_new、jquery)を全ファイルから検索して、どこからも呼ばれていないことを確かめました。old/app.js.bakは、app.jsと画面を出す番号(ポート)が違うだけの控えでした。名前が「old」「copy」「bak」でも、実際は使われている例もあるため、参照を数えます。
判定欄の書き方も例を示します。「引き継ぎは可能。ただし動かす前に、作った側または旧サーバーから次の3つが要る」と書き、3つを具体的に並べました。①DBの写し(またはDBを作り直してよいという判断)、②設定ファイルの値が今も有効かの確認、③動いていた時のNodeの版、です。判定を「可能」か「不可能」の二択にせず、「何があれば可能か」まで書くのが、読む側に親切です。
③のNodeの版については、Node.jsの公式の版の一覧で、確認時点でv22が「LTS」の状態でした。今回の部品は2018年ごろの公開で、当時使われていたNodeは、おそらくもっと古い版です。当時の版が分かれば、再現のための選択肢が絞れます。ただし、今回の診断書の時点で「当時の版」は圧縮ファイルから読み取れていません(enginesの指定もありません)。
6. 診断書の結果から、誰に何を頼めばよいのか
機械で数えた結果は別の開発会社に、数えられなかった項目は作った側や旧サーバーの管理者に頼みます。
診断書の使い道は、頼む相手と頼む内容を分けることです。
| 診断書で分かったこと | 頼む相手 | 頼むこと |
|---|---|---|
| DBファイルが無い | 旧サーバーの契約名義人、ホスティング会社 | DBの写しを出してもらう。取り出せない場合は、その旨を書面で |
| 設定の値が有効か不明 | 作った側、サービスの契約者(メール、チャット) | 値が今も有効か、誰の契約か |
| 当時のNodeの版が不明 | 作った側、または旧サーバーの管理者 | サーバー上でnode -vの出力を1行 |
| 部品が古い | 別の開発会社 | 版を上げる作業の見積。範囲の指定付き |
| テストが無い | 別の開発会社 | 直す前に、動作確認の手順書を作る作業を見積に入れる |
| 使っていないファイル5件 | 別の開発会社 | 消さず、一覧のまま渡す。消す判断は動作確認の後 |
先に押さえる資産の確認表は、開発会社の公開記事にもあります(ソースコード、本番サーバー、ドメイン、DB、外部連携、契約書などを並べる形)。それらの記事と今回の診断書の違いは、機械で数えられる部分を、出力つきで先に埋めることにあります。確認表は「あるか」を聞きます。診断書は「中身を数えた結果」を載せます。
診断書に「未確認」の行をわざと残すことも大切です。今回の診断書も、「動くか」は未確認と書いています。確かめていないことを確かめたように書くと、別の開発会社が最初の見積で前提を誤ります。
7. うまくいかなかったこと・未検証のこと
今回の検証で、確かめられなかったこと、判断に迷ったことを書いておきます。
- 更新日が正しいかは、受け取った側からは確かめられません。診断書では「手がかり」と書きました。
- 行数だけで規模を見ると誤ることは、画面ファイルで実際に起きました。文字数も並べて直しました。
- 部品の中に既知の弱点があるかは、この記事では調べていません。件数と読み方は、別の検証(npm auditを動かした記事)にまとめています。
- 実際に動くかは、この記事では確かめていません。圧縮ファイルを手元で動かす検証は、別の記事で行っています。
- 実際の現場での所要時間は、未検証です。今回の検証は、構造を知っている作成者が、ダミーを相手にやったものです。
- 契約や著作権(ソースコードの権利が誰にあるか)は、今回の診断書に載せていません。契約書の文面の確認が必要で、この記事では扱っていません。
もう1つ、検証を進める中で気づいたことがあります。診断書に載せた項目のうち、機械で数えられるのは、ファイル数・行数・部品の版・直書きの件数・使っていないファイルの数です。数えられないのは、「それが今も業務で使われているか」と「データの中身」です。この2つは、利用者に聞くか、本番のデータを見ない限り分かりません。診断書の末尾に「次に人に聞くこと」の欄を作ると、数えられた範囲と、聞かなければ分からない範囲の境目がはっきりします。
8. 発注する側が渡す資料の一覧
最後に、別の開発会社へ診断を頼むときに、発注側が最初に渡す資料を一覧にします。今回の題材を動かすのに実際に要ったものから逆算しています。
| 渡す資料 | 今回の題材での要否 | 渡せないときの代わり |
|---|---|---|
| ソースコードの圧縮ファイル(受け取った日がわかる形で) | 必須 | 作った側へ最新版の提出を依頼 |
| 本番のDBの写し | 動かすのに必須 | 表の構造だけでも(コードから推定できるが、型は不明) |
| 設定ファイルの本番の値 | 動かすのに必要。ただし診断の段階では渡さない | 診断の間は、ダミーの値で動かす |
| サーバーのログイン情報 | 診断の段階では不要 | 本番に触る作業の段階で、新しい担当者用の権限を作る |
| 動いていた時のNodeと部品の版 | あると再現が早い | サーバーでnode -vとnpm lsを実行してもらう |
| 契約書、請求書 | ソースコードの扱いの確認に必要 | 契約の相手と日付だけでも |
診断書の段階で、本番のパスワードや鍵を渡す必要はありません。診断書の項目は、どれも値を知らなくても埋められるからです。
まとめ
受け取った直後の圧縮ファイルは、機械に数えさせるだけで、規模、言語、部品の古さ、直書きの有無、無いものの一覧まで分かりました。今回の題材では、20ファイルの棚卸しに道具の実行時間は1秒もかかっていません。一方、動くか、今も使われているか、データの中身はどうかは、数えただけでは分かりませんでした。診断書は、数えられたことと、人に聞くことの境目を書く紙です。
圧縮ファイルの扱いや診断書の書き方で迷ったときは、その圧縮ファイルを見ながら、一緒に項目を埋めていく進め方もあります。
よくある質問
圧縮ファイルの中の更新日は、最後に直した日と考えてよいですか。
今回の題材では、更新日の並びから設定ファイルが最後に触られた日が分かりました。ただし更新日は圧縮や受け渡しの方法で書き換わることがあるため、今回の確認では、更新日を事実としてではなく手がかりとして扱いました。版を管理する記録(.git)が同梱されていなければ、誰がいつ何を変えたかは確かめられません。
診断書にパスワードや鍵の値は書いてよいですか。
書きません。今回の診断書は、直書きの有無と件数、置いてあるファイル名と行番号までにしました。値を書いた診断書は、メールや共有フォルダで回った時点で、新しい漏れ道になります。確認のために値を見る必要があるときは、技術者が画面上で見て、有効かどうかだけを答える形にします。
ファイルの行数が少ないと、小さなシステムだと言えますか。
今回の題材では、画面のファイルが1行にまとめて書かれていたため、行数では実態より小さく見えました。行数と文字数の両方を見て、さらに、画面の数・DBの表の数・外へ出る通信の数も数えるのが安全です。規模は1つの数字では決まりません。
診断書を作るのに、プログラミングの知識は要りますか。
手順の道具は、ファイルを数える・文字を探すといった基本のものです。ただし出力の意味を読むには経験が要ります。今回は、発注側が診断書の各行を読み、不明な行を技術者に聞けるところまでを目標にしました。作る作業を発注側が全部やる必要はありません。
参照元・出典
- npm Docs: package-lock.json(ロックファイルの役割)(確認日: 2026-11-17)
- npm Docs: npm audit(既知の脆弱性の報告)(確認日: 2026-11-17)
- Node.js Releases(版ごとの状態の一覧)(確認日: 2026-11-17)
- OWASP Top 10:2021 A06 Vulnerable and Outdated Components(確認日: 2026-11-17)
- システム開発の引継ぎ|他社システムの開発会社を変える前に押さえる資産と、頼める調査(AI革命)(確認日: 2026-11-17)
- npm Docs: npm view(公開日などの取得)(確認日: 2026-11-17)
FREE CONSULTATION
「うちの場合はどうか」から
記事の考え方を、そのままご自身の事業に当ててみたい方へ。アイデア段階でも、機能リストがある段階でも構いません。 2営業日以内に、担当者からメールでご返信します。営業のお電話はしません。相談は無料です。
運営:株式会社miitaso(会社概要)
RELATED