カタログに基づくディープマージを実装
保存済みJSON設定にカタログに基づくディープマージを実装し、スキーマ変
更時のキー欠落によるクラッシュを防いだ。
2025

状況.
通知設定などのJSON設定を、既定値の上に利用者の保存値を重ねる形で保持
していた。元のマージは1階層だけだった。既定値に新しいキーを加える
と、それ以前の保存行にはキーがなく、クライアントがundefinedを読んで
落ちる。長く使っている利用者ほど影響を受ける問題だった。

課題. 以前からの利用者に設定の追加で支障が出ないよう、安全にスキーマ
を拡張する必要があった。

行動.
単層のマージを、既定値をカタログにしたディープマージへ置き換えた。存
在すべき全キーの正本として既定値を扱い、その上へ利用者の保存値を再帰
的に重ねる。保存された塊にあってもなくても、カタログ内のキーは必ず結
果に含まれる。既定値に追加すれば、入れ子も含め既存行すべての実効設定
へ自動で現れる。再保存を待たず既存データも直ちに恩恵を受けるよう、マ
イグレーションで導入した。

結果.
安心して設定を増やせるようになった。新しい設定の追加が未定義項目によ
るクラッシュを招かず、フロントエンドで読み取り箇所ごとに防御的な検査
を散らす必要もなくなった。1つの修正にとどまらず、保存済みJSON全般を
拡張するための、頼れる方式を他の部分にも提供した。

カテゴリー:
1バックエンド開発	/ja/categories/backend/	software.engineer.company	70
1データベース	/ja/categories/databases/	software.engineer.company	70
1PostgreSQL	/ja/categories/postgresql/	software.engineer.company	70
1データガバナンス	/ja/categories/data-governance/	software.engineer.company	70
1移行・モダナイゼーション	/ja/categories/migration/	software.engineer.company	70

サービス:
1バックエンド・API開発	/ja/services/backend-development/	software.engineer.company	70
1データベース設計・モデリング	/ja/services/database-design/	software.engineer.company	70
1データガバナンス・品質管理	/ja/services/data-governance/	software.engineer.company	70

hこのページのウェブ版	URL:https://software.engineer.company/ja/portfolio/implemented-a-catalogue-driven-deep-merge/	software.engineer.company	70
