開発会社選び・協業読了約15分

引き継ぎソースコードの最初の棚卸し|圧縮ファイルを診断書にした記録

圧縮ファイルは道具で数えれば診断書にできます。動くかは数えても分かりません。

記事の概要図

外部の開発会社に頼んでいた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
61枚の診断書にまとめる手作業

かかった時間は、道具を動かす部分の実測で、手順2から4をまとめて実行して0.06秒でした。手順5のnpm viewは9部品で数秒です。ただし、出力を読んで診断書に書く時間は、今回は計っていません。作った本人が検証しているため、現実の引き継ぎ(中身を初めて見る人)と同じ時間にはなりません。この記事では「半日でできる」とは言えません。分かったのは「機械に数えさせる部分は、ほぼ待ち時間が無い」ということだけです。

うまくいかなかった所もあります。ファイルの更新日を圧縮前の時刻のまま保てているかは、受け取る側からは確かめられません(後述)。また、診断書の「判定」欄の3つの条件は、このあと動かして確かめる記事(引き継いだアプリが手元で動くまで)で初めて裏付けが取れるものです。今回の診断書の時点では、動くかどうかは未確認です。

棚卸しの流れ。圧縮ファイルを開き、数え、探し、古さを調べ、診断書にまとめる

2. 圧縮ファイルを受け取ったら、最初に何を数えればよいのか

最初に数えるのは、ファイル数・種類ごとの数・行数と文字数・更新日の並びの4つです。

まず、開く前に圧縮ファイルの指紋を控えます。同じファイルかどうかを後で確かめるためです。次に、新しい空のフォルダに開いて、ファイルを数えます。

圧縮ファイルを開いてファイル数・種類・行数・更新日を数えた画面

画面の数字は、次のように読みました。

ファイル数20件小さなアプリ。数日あれば全体を読める量
拡張子の内訳js 10、ejs 6、json 1、css 1、bak 1、sample 1JavaScriptと、画面を作る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で探して確かめます。

次に、「あるはずなのに無いもの」を探します。引き継ぎの詰まりは、あるものより、無いものから起きやすいためです。

説明書・DB・ロックファイル・テストの有無と、設定ファイルの直書きを探した画面

見つかったこと、見つからなかったことを表にします。

説明書(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には、使っている部品(ライブラリ)の一覧があります。この一覧と版から、それぞれの部品の版が、いつ公開されたものかを調べました。

express4.16.42018-10-115.3.0画面の土台
body-parser1.18.32018-05-142.4.0入力の受け取り
ejs2.6.12018-05-057.0.2画面の部品
express-session1.15.62017-09-261.19.0ログイン状態
lodash4.17.112018-09-124.18.1道具箱
moment2.22.22018-06-012.31.0日付の整形
nodemailer4.6.82018-08-1510.6.0メール送信
request2.88.02018-08-102.88.2通信。非推奨の表示あり
sqlite34.0.42018-11-106.0.1DBの接続

公開日と最新版は、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つ書きます。

ここまでの出力を、発注する側が読める形に並べ直したのが診断書です。

今回の題材の診断書(1枚)。規模・言語・DB・更新日・直書き・外部通信・無いもの・使っていないファイル・判定

項目は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つの数字では決まりません。

診断書を作るのに、プログラミングの知識は要りますか。

手順の道具は、ファイルを数える・文字を探すといった基本のものです。ただし出力の意味を読むには経験が要ります。今回は、発注側が診断書の各行を読み、不明な行を技術者に聞けるところまでを目標にしました。作る作業を発注側が全部やる必要はありません。

参照元・出典

FREE CONSULTATION

「うちの場合はどうか」から

記事の考え方を、そのままご自身の事業に当ててみたい方へ。アイデア段階でも、機能リストがある段階でも構いません。 2営業日以内に、担当者からメールでご返信します。営業のお電話はしません。相談は無料です。

運営:株式会社miitaso(会社概要)

RELATED