{"canonical_url":"https://engineer.company/uk/portfolio/implemented-a-catalogue-driven-deep-merge/","content_markdown":"# Впровадила deep‑merge на основі каталогу\n\nВпровадила deep‑merge на основі каталогу для збережених JSON‑налаштувань, запобігши збоям через відсутні ключі в міру розвитку схеми.\n\n2025\n\n**Ситуація.** Платформа зберігає налаштування в JSON — параметри сповіщень тощо — як значення, які зберіг користувач, накладені поверх набору значень за замовчуванням. Початкове злиття працювало лише на одному рівні. Проблема спливає згодом: варто додати новий ключ до значень за замовчуванням, і в рядках, збережених до його появи, цього ключа просто немає. Далі якийсь клієнтський код читає це поле, отримує undefined і падає — і саме в тих користувачів, які з платформою найдовше.\n\n**Завдання.** Схему налаштувань треба було розвивати безпечно, щоб новий параметр ніколи нічого не ламав тим, хто зареєструвався ще до його появи.\n\n**Дія.** Однорівневе злиття замінено глибоким, яке спирається на значення за замовчуванням як на каталог. Ці значення вважаються еталонним переліком усіх ключів, що мають існувати; збережені значення користувача рекурсивно накладаються зверху, тож усе, що є в каталозі, гарантовано потрапляє в результат — байдуже, чи було воно в збереженому blob. Досить додати ключ до значень за замовчуванням — і він автоматично з'являється в підсумкових налаштуваннях кожного наявного рядка, разом із вкладеними ключами. Зміну впроваджено міграцією, тож наявні дані виграли від неї одразу, а не чекали, доки їх перезапишуть.\n\n**Результат.** Налаштування тепер можна розширювати без страху. Новий параметр уже не загрожує падінням клієнта через undefined‑поле, а фронтенду більше не потрібні захисні перевірки, розкидані по всіх місцях, де він читає налаштування. Крім того, решта платформи отримала надійний спосіб розширювати будь‑який збережений JSON‑blob — не одне виправлення, а цілий патерн.\n\n---\n\n- Роль: Інженер баз даних\n- Категорії: [Backend‑розробка](https://data.engineer.company/uk/categories/backend/), [Бази даних](https://data.engineer.company/uk/categories/databases/), [PostgreSQL](https://data.engineer.company/uk/categories/postgresql/), [Управління даними](https://data.engineer.company/uk/categories/data-governance/), [Міграції та модернізація](https://data.engineer.company/uk/categories/migration/)\n- Послуги: [Backend- та API‑розробка](https://data.engineer.company/uk/services/backend-development/), [Проєктування та моделювання баз даних](https://data.engineer.company/uk/services/database-design/), [Управління та якість даних](https://data.engineer.company/uk/services/data-governance/)\n\n\u003chttps://engineer.company/uk/portfolio/implemented-a-catalogue-driven-deep-merge/\u003e\n","date_modified":"2026-10-20T21:59:50Z","description":"Налаштування тепер можна розширювати без страху. Новий параметр уже не загрожує падінням клієнта через undefined-поле, а фронтенду більше не потрібні захисні…","formats":{"gemtext":"https://data.engineer.company/uk/portfolio/implemented-a-catalogue-driven-deep-merge/index.gmi","gopher":"https://data.engineer.company/uk/portfolio/implemented-a-catalogue-driven-deep-merge/gophermap","html":"https://data.engineer.company/uk/portfolio/implemented-a-catalogue-driven-deep-merge/","json":"https://data.engineer.company/uk/portfolio/implemented-a-catalogue-driven-deep-merge/index.json","markdown":"https://data.engineer.company/uk/portfolio/implemented-a-catalogue-driven-deep-merge/index.md","pdf":"https://data.engineer.company/uk/portfolio/implemented-a-catalogue-driven-deep-merge/index.pdf"},"kind":"page","language":"uk","title":"Впровадила deep-merge на основі каталогу","url":"https://data.engineer.company/uk/portfolio/implemented-a-catalogue-driven-deep-merge/","version":1}