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 | Основания | Различие | Что проверить |
|---|---|---|---|
| C01 | A1, B1 | Добавлена роль аналитика | Серверная авторизация и доступ к строкам отчёта для новой роли |
| C02 | A2, B2 | Лимит вырос со 100 до 1000 | Границы, нагрузка, память и длительность экспорта |
| C03 | A3, B3 | Формат и кодировка не изменились | Не удалять существующую проверку CSV/UTF-8 |
| C04 | A4, 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 обновите связанные проверки.
Автор: Иннокентий Бодров, автор Аналитической мастерской.