Реестр допущений интеграции: какие «очевидные» правила стоит записать
Разработчик уверен, что ответ всегда короткий, дизайнер считает таймер точным, а поддержка ожидает сохранения истории после обновления страницы. Эти ожидания могут никогда не обсуждаться. В проекте интеграции с SimAggregator заведите небольшой реестр допущений, чтобы неизвестное не превращалось в незаметное требование.
Каждую запись формулируйте проверяемо: что предполагается, на каком источнике основано, где используется и что случится, если это неверно. Отличайте документированное правило от наблюдения одного теста и от собственного решения интерфейса. У записи должны быть владелец и условие повторной проверки.
Например, «страница останется открытой до результата» является допущением вашей реализации. Проверить его можно закрытием вкладки и восстановлением локального контекста. Для этого не нужно приписывать внешней платформе гарантию сохранения состояния вашего приложения.
Перед выпуском смотрите прежде всего на допущения, влияющие на оплату, повторные действия и доступ пользователя к результату. Низкорисковые вопросы можно отложить с явной пометкой. Реестр полезен, когда помогает выбрать следующий тест; длинный список без владельцев быстро становится ещё одним забытым документом.