← Назад к блогу

Практика системного анализа · 5 минут

Переименовать поле JSON: как проверить план совместного выпуска

Проверьте план переименования поля JSON матрицей старых и новых клиентов. Сверьте переходный ответ, равенство значений, условие удаления и откат.

Аналитическая мастерскаяRead this article in English

В спецификации решили заменить поле state на status. LLM предложила обновить сервер, затем клиентов и удалить старое имя. Между этими шагами существуют пользователи с разными версиями приложения. Именно промежуточное состояние нужно проверить до согласования плана.

Пример учебный: все версии и входы вымышлены. Вопрос сформулирован из задачи совместимости интеграций, не процитирован из чата. Клиент C1 читает только state, клиент C2 только status. При отсутствии своего поля каждый явно отклоняет ответ. Значение draft допустимо для обоих; спор о смысле статуса в этом примере отсутствует.

Построить матрицу читателей и ответов

Сервер W1 отправляет только state. Переходный W2 отправляет оба поля с одинаковым значением. Конечный W3 отправляет только status. Состояние на входе у всех вариантов одно: draft.

Ответ сервераC1 читает stateC2 читает status
W1: только state=draftПринятОтказ: status отсутствует
W2: оба поля равны draftПринятПринят
W3: только status=draftОтказ: state отсутствуетПринят

В матрице шесть комбинаций, четыре принимаются и две отклоняются. Это результат заданных учебных читателей, а не универсальная гарантия совместимости JSON-клиентов. Реальный потребитель может запрещать лишние поля; тогда переходный W2 нужно проверить на его контракте отдельно.

План с прямым переходом W1 → W3 ломает C1. Если сначала выпустить C2 при W1, ломается уже C2. W2 создаёт общее допустимое состояние для согласованных здесь клиентов. Но удалить state можно только после подтверждения, что среди всех затронутых потребителей больше нет C1, включая фоновые интеграции.

Проверить согласованность двух имён

Добавьте ответ с state=draft и status=approved. Каждая версия клиента способна прочитать своё поле и получить разный смысл одного объекта. Поэтому приёмка W2 включает равенство значений по одной версии объекта. Сам факт наличия двух полей не достаточен.

LLM можно поручить матрицу комбинаций, порядок этапов, условия остановки и доказательства для удаления старого поля. Попросите её не заменять сведения об установленных клиентах догадкой «все уже обновились». Исполнитель плана должен подтвердить состав потребителей, а не только зелёный тест нового клиента.

Человек проверяет шесть комбинаций на одинаковом draft и отдельно конфликт двух значений. В отчёте фиксируются версия схемы, тело ответа, версия читателя и результат. Отдельная проверка показывает, что переходный ответ формируется из одной версии объекта: чтение двух значений в разные моменты может дать искусственный конфликт.

Откат тоже имеет условие совместимости. После появления C2 возврат к W1 непригоден для этого клиента. В учебной схеме совместимой точкой остаётся W2, а не произвольная предыдущая версия. История переименования связана с поиском потребителей enum и сверкой версий требования, но здесь проверяются именно промежуточные сочетания читателя и производителя.

Вопросы о переименовании поля

Сколько комбинаций проверяется в матрице?

Шесть: три версии ответа и два заданных клиента.

Почему W2 подходит обоим клиентам?

Оба нужных поля присутствуют и содержат одно значение draft по одному состоянию объекта.

Гарантирует ли это совместимость любого клиента?

Нет. Здесь клиенты допускают лишние поля; реальные ограничения надо проверять отдельно.

Когда разрешено удалить state?

После подтверждения отсутствия потребителей C1, а не просто после выпуска C2.

Можно ли откатиться к W1 после появления C2?

Нет для данного C2: W1 не содержит обязательного для него status.

Автор: Иннокентий Бодров, автор Аналитической мастерской.