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

LLM для аналитика · 6 минут

Сверка требований между версиями: как отличить изменение текста от изменения поведения

Сверять версии требований нужно по поведению системы, а не только по добавленным словам.

Сверять версии требований нужно по поведению системы, а не только по добавленным словам. LLM полезна для подготовки таблицы различий, если каждая строка ссылается на обе версии, показывает последствия и сохраняет неоднозначности. Отсутствие правила в новом документе не всегда означает его согласованную отмену.

В учебном примере лимит экспорта вырос со 100 до 1000 строк, а доступ появился у новой роли. Оба изменения занимают несколько символов, но требуют разных проверок.

Вход: две короткие версии

Версия A, дата 1 ноября:

РазделТекст
A1Экспорт доступен только администратору.
A2За один запрос выгружается не более 100 строк.
A3Файл формируется в CSV в UTF-8.
A4В журнал записывается пользователь, запустивший экспорт.

Версия B, дата 10 ноября:

РазделТекст
B1Экспорт доступен администратору и аналитику.
B2За один запрос выгружается не более 1000 строк.
B3Файл формируется в CSV в UTF-8.
B4В журнал записываются пользователь и время запуска экспорта.

Документы описывают один и тот же сценарий. Перед анализом зафиксируйте их статус: в примере B — предложенная редакция, ещё не принятая владельцем. Более поздняя дата сама по себе не делает её действующей.

Таблица изменений и влияния

IDОснованияРазличиеЧто проверить
C01A1, B1Добавлена роль аналитикаСерверная авторизация и доступ к строкам отчёта для новой роли
C02A2, B2Лимит вырос со 100 до 1000Границы, нагрузка, память и длительность экспорта
C03A3, B3Формат и кодировка не изменилисьНе удалять существующую проверку CSV/UTF-8
C04A4, B4К аудиту добавлено время запускаФормат времени, часовой пояс, источник часов и права чтения журнала

Слово «аналитик» в B1 меняет границу доступа. Недостаточно показать кнопку новой роли: проверьте прямой вызов API и область данных. Иначе расширение возможностей интерфейса может скрыть расширение доступа к чужим отчётам.

Рост лимита в десять раз не доказывает десятикратного роста затрат. Однако он создаёт повод проверить ресурсы на согласованном профиле данных. Чтобы оценить влияние на время и память, нужны замеры на этом профиле.

Набор проверок после согласования B

Для C01: администратор может экспортировать; аналитик может экспортировать в пределах своих прав; читатель без этих ролей получает отказ. Последняя проверка — сохранение границы доступа, а не новая роль из документа.

Для C02: запросы на 999 и 1000 строк проходят ограничение, на 1001 — не проходят. Проверки 99 и 100 можно сохранить как регрессионные, если они отражают реальные используемые объёмы. Точное поведение превышения лимита требует решения: ошибка, обрезка или пагинация не определены B2.

Для C03: содержимое с кириллицей остаётся читаемым в UTF-8. Для C04 сначала закройте вопрос о времени; проверка «поле непустое» не докажет корректную временную метку.

Что делать с исчезнувшими пунктами

Предположим, в следующей версии B4 отсутствует целиком. В таблице нужно написать «правило аудита отсутствует в новой версии; намерение отмены неизвестно». Не заменяйте это на «аудит больше не нужен». Попросите владельца подтвердить удаление или восстановить пропущенное требование.

Такой же подход нужен при переименовании разделов: сопоставляйте смысл, затем цитаты и ID. Один большой раздел может разделиться на три, сохранив прежнее поведение. Линейный diff этого не объяснит.

Что согласовать перед переходом на версию B

В таблице три изменения поведения и одно сохранённое требование. Прежде чем принять B, уточните реакцию на превышение лимита и формат времени в журнале. У каждой строки есть обе ссылки, поэтому решение можно вернуть к конкретному пункту документа.

Передайте владельцу обе версии и таблицу C01–C04. После согласования внесите ответы в журнал решений и обновите связи требований с тестами. Особое внимание уделите отказу для роли без доступа: B расширяет круг пользователей, но не отменяет авторизацию.

Вопросы по разбору

Чем смысловая сверка отличается от текстового diff?

Текстовый diff покажет замену 100 на 1000. Смысловая сверка свяжет её с границами экспорта, нагрузкой и поведением при превышении.

Поздняя дата делает версию B действующей?

Нет. В примере B предложена, но не принята. Дату и статус документа нужно хранить раздельно.

Исчезновение пункта отменяет требование?

Намерение отмены неизвестно. Зафиксируйте пропуск и запросите решение владельца, особенно для аудита и прав доступа.

Какие тесты нужны для нового лимита?

Проверьте 999, 1000 и 1001 строку. Отдельно уточните реакцию на превышение: B2 задаёт лимит, но не описывает обработку ошибки.

Что передать вместе с таблицей C01–C04?

Обе версии документов, их статусы, ссылки на разделы и открытые вопросы. После принятия B обновите связанные проверки.

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