Критерії приймання

Що це таке

Критерії приймання визначають умови, за яких можна прийняти
конкретну зміну. Вони описують те, що можна спостерігати за певних
обставин. «Надіслати підтвердження запису» називає функцію. «Після
запису на вільний час підтвердження показує той самий номер і час
початку, що й запис у системі» дає змогу перевірити частину
поведінки. Команда може самостійно вибрати спосіб створення
підтвердження.

Посібник уряду Великої Британії з цифрових послуг описує критерії
для історії користувача як перелік результатів, за якими можна
пересвідчитися, що послуга виконала своє завдання. Історія пояснює,
кому й навіщо потрібна послуга. Критерії роблять домовленість
конкретною для обговорення, реалізації та перевірки. Вони можуть
охоплювати поведінку при збої, доступність або умови експлуатації,
якщо це впливає на приймання зміни. Для різних умов потрібні різні
докази.

Специфікація може встановлювати вимоги для багатьох змін. Тестовий
випадок описує конкретну перевірку, яка дає докази виконання одного
чи кількох критеріїв. Визначення Готовності у Scrum описує вимоги до
якості роботи в Інкременті. Критерії приймання стосуються окремої
зміни. Наприклад, керування з клавіатури може бути загальною
вимогою, а можливість вибрати час у новому календарі та пізніше
відкрити запис з клавіатури може бути умовою саме цієї зміни.

Чому це важливо

Чіткі критерії виявляють різні очікування, доки змінювати план
легко. Для відповідального за послугу запис може вважатися успішним,
щойно створено запис у системі. Відвідувач, можливо, чекатиме листа.
Службі підтримки може знадобитися номер для пошуку, якщо лист
загубиться. Це різні результати. Завчасно домовтеся, коли показувати
підтвердження і як діяти, якщо постачальник пошти не виконав
відправлення.

Критерії вказують, що саме спостерігати. Одна людина може перевірити
сторінку підтвердження, інша контрольовано перервати відправлення.
Обидві знають, що вважати результатом. Для перевірки доступності
може знадобитися пройти весь шлях з клавіатури на додаток до
автоматизованого тесту. Обмеження часу відповіді потребує відомого
середовища та визначеного навантаження. Вислів «система має бути
швидкою» допускає несумісні тлумачення.

Стандарти й законодавчі вимоги діють незалежно від того, чи наведено
їх в історії. Якщо команда інакше муситиме здогадуватися, поясніть,
як загальна вимога застосовується до нового елемента. Для незвичного
календаря можна перелічити доступні з клавіатури дії та послатися на
спільний стандарт. Критерій залишиться коротким і придатним до
перевірки.

Як це виглядає на практиці

Уявімо сервіс запису на прийом із повідомленням про підтвердження. У
чернетці написано «можна записатися на прийом, система надсилає
лист». Розгляньмо разом із власником послуги, розробником і
тестувальником три конкретні спроби. Це умовні приклади. Остаточні
умови має затвердити команда відповідної послуги.

  * Якщо на 14:00 у вказаному часовому поясі є вільне місце,
створюється один підтверджений запис. Номер, дата й час на сторінці
підтвердження збігаються із записом у системі.

  * Якщо на час оброблення запиту місце вже зайняте, система
повідомляє про це й дає змогу повернутися до переліку вільних годин.
Другий запис на зайнятий час не створюється.

  * Якщо повідомлення не вдалося доставити після підтвердження,
запис залишається чинним. Номер досі видно на сторінці, а збій може
побачити відповідальний за подальші дії.

У прикладах є початкова ситуація, дія та результат, який можна
перевірити. У Gherkin така структура виражається словами «Дано»,
«Якщо» й «Тоді». Вона може полегшити читання та зв’язати приклади з
автоматизованими тестами. Для простої зміни достатньо короткого
переліку. В обох формах укажіть, звідки береться номер для
порівняння і хто може спостерігати результат. Вихід листа з черги не
доводить його отримання.

Першу спробу виконайте через справжню сторінку. У другій керуйте
порядком запитів. У третій спричиніть збій уже після завершення
транзакції запису. Зафіксуйте умови і спостереження, щоб інша людина
відтворила перевірку. У нашій заяві про доступність є споріднений
приклад. Вона описує перевірки з клавіатури, розрізняючи
спостережені результати та питання, які ще треба дослідити.

Де виникають проблеми

Нечіткі слова відкладають рішення. «Помилка обробляється належно» не
пояснює, що бачить і може зробити людина. Укажіть стан,
повідомлення, доступну дію та наслідок, якого слід уникнути. Знімок
екрана з попередженням про зайнятий час не показує, чи сформувався
другий запис. Потрібна ще перевірка даних.

Критерій може передчасно закріпити технічний вибір. «Використати
нову чергу» може бути вдалим архітектурним рішенням, але не пояснює,
що буде під час затримки підтвердження. Запишіть причини технічного
вибору в належному місці, а в критерії опишіть поведінку, яку можна
спостерігати. Якщо зовнішня інтеграція вимагає певного протоколу,
зазначте джерело й межу дії вимоги.

Список також може розростися до опису цілого випуску. Поділіть
роботу за результатами, залишивши важливий випадок відмови разом із
відповідним шляхом. Домовтеся про спільні обмеження й
відповідального за перевірку. Якщо новий тест виявить пропущену
умову, запишіть причину зміни критерію і повторіть потрібні
перевірки. Тоді буде видно, яку домовленість фактично перевірено.

Що почитати далі

  * Посібник уряду Великої Британії про історії користувачів і
критерії приймання

  * Довідник Gherkin про сценарії та приклади

  * Визначення Готовності в Посібнику зі Scrum

  * Настанови W3C з перевірки роботи з клавіатури

hЦя сторінка у вебі	URL:https://engineer.company/uk/glossary/acceptance-criteria/	engineer.company	70
