分岐した配車・作業指示・巡回製品のコピーを一本に戻す

ある配車製品は数年のうちに、互いにずれていく複数のコピーに分かれていました。開発を止めずに、コンポーネントごとに正となるコードを一つに戻し、再び分かれないための変更手順を整えました。

要点: ある配車製品が互いにずれていく複数のコピーに分かれ、一方を直して別の方を出荷することが繰り返されていました。開発を止めずに、コンポーネントごとに正となるコードを一つに戻し、再び分かれないための変更手順を整えました。

概要

製品は Web 配車コンソール、Android アプリ、作業指示バックエンド、巡回バックエンドで構成されます。統合は 2026-08-04 に完了し、その間も日々の開発は止まりませんでした。

課題・提供内容・成果の三列:互いにずれた複数のコピー、コンポーネントごとに一つの正のコードと変更手順、以後の変更はすべて追跡可能。

課題

時間とともに、各コンポーネントに複数のコピーができていました。変更は手作業でコピー間に移され、ビルドが誤ったソースを使うこともあり、同じ種類の不具合が繰り返し発生しました。バックアップはプロジェクトフォルダーの丸ごとコピーで、どれが正しいのか誰にも分かりませんでした。第三者から届いたソースのアーカイブがそのまま展開され、別の開発ラインになっていました。

提供したもの

  • コンポーネントごとに一つの正のコード。削除したコピーの履歴はアーカイブし、必要なら取り出せます。
  • 外部コードと正のコードのファイル単位の比較。実際の変更だけを取り込み、書式の差分は統一しました。
  • 変更手順:まず影響範囲を評価し、不具合修正は再現テストから始め、受け入れ確認が通ってからコミットします。既存の問題は登録され、小さくなる方向にしか変えられません。
  • 暗号化や破損したファイルがコードに混入しないよう、コミット前に自動でチェックします。

成果

各コンポーネントには正となるバージョンが一つだけになり、ビルドが誤ったソースを使うことはなくなりました。以後の変更にはすべて書面の影響範囲記録があり、問題が起きたときは原因となった変更までたどれます。

限界

統合前後の不具合率は計測しておらず、それについては主張しません。顧客名、製品ブランド、デプロイの詳細は記載していません。

よくあるご質問

一つの大きなリポジトリにまとめなかったのはなぜですか?

各コンポーネントにはすでに独自の履歴とリリースサイクルがありました。コンポーネントごとに一つのリポジトリとすることで、履歴を完全に残し、進行中の作業への影響も最小限にできました。

古いコードの問題は一度に片付けたのですか?

段階的に進めています。既存の問題は台帳に登録し、各項目は小さくなる方向にしか変えられません。新しいコードは基準を満たす必要があります。納品を止めずに、問題の総量は減る一方です。

再び二つ目のコピーが生まれないようにするには?

外部から届いたコードは正のコードと比較し、実際の変更だけを取り込みます。ある時点を残すときはタグを付け、ディレクトリごとのコピーはしません。