Как выглядит качественное требование?

Признаки качественного требования в системном анализе

Качественное требование — это основа успешной разработки. Давайте разберём критерии, которые отличают хорошее требование от плохого.

Основные характеристики качественного требования

1. Ясность и однозначность:

• Формулируется так, чтобы разные люди интерпретировали его одинаково
• Исключает двусмысленность и противоречия
• Хороший пример: "Система должна отправлять email подтверждение в течение 5 минут после регистрации"
• Плохой пример: "Система должна быстро отправлять письма"

2. Проверяемость (Testability):

• Можно объективно определить, выполнено ли требование
• Содержит измеримые критерии
• Должны быть конкретные метрики: сроки, объёмы, параметры
• Пример: "Время отклика должно быть менее 2 секунд для 95% запросов"

3. Трассируемость (Traceability):

• Связано с бизнес-целями и задачами
• Можно отследить от требования через дизайн к тестам
• Имеет идентификатор (REQ-001, US-42)
• Указывает источник требования (заказчик, нормативный акт)

4. Полнота:

• Содержит всю необходимую информацию для реализации
• Не оставляет пробелов, которые нужно заполнять предположениями
• Включает пограничные случаи и исключения
• Пример: "При ошибке сети система должна повторить попытку 3 раза с интервалом 10 секунд"

5. Согласованность:

• Не противоречит другим требованиям
• Совместимо с архитектурой и технологией
• Реализуемо в рамках проекта
• Хорошо интегрируется с существующей системой

Структура качественного требования

Заголовок/Идентификатор:

• Уникальный номер: REQ-001
• Краткое описание функционала

Описание:

• Что система должна делать
• Контекст использования
• Причины необходимости

Критерии приёмки (Acceptance Criteria):

• Сценарий 1: Когда пользователь делает X, система должна Y
• Сценарий 2: Когда условие Z выполнено, результат должен быть W
• Примеры данных для тестирования

Приоритет:

• Critical (обязательно для MVP)
• High (важно, но можно отложить)
• Medium (желательно)
• Low (nice-to-have)

Зависимости:

• Какие другие требования нужны перед этим
• Связанные компоненты

Ограничения:

• Производительность, масштабируемость
• Безопасность, конфиденциальность
• Совместимость, интеграция

Реальный пример качественного требования

REQ-002: Аутентификация по двухфакторной схеме

Описание: При входе в систему пользователю требуется ввести пароль 
и одноразовый код из мобильного приложения.

Критерии приёмки:
- GIVEN пользователь ввёл правильный пароль
- WHEN система отправит код на его номер телефона
- THEN пользователь должен ввести код в течение 5 минут
- AND если код неправильный, попытка блокируется на 1 минуту
- AND после 3 неправильных попыток требуется восстановление доступа

Приоритет: Critical
Допуск: только для входа в личный кабинет
Зависит от: REQ-001 (базовая аутентификация)

Антипаттерны — чего избегать

• ❌ "Система должна быть удобной" — не проверяемо
• ❌ "Сделать на JavaScript" — это решение, не требование
• ❌ "Оптимизировать по скорости" — не измеримо
• ❌ "Интегрироваться с CRM" — недостаточно конкретно
• ❌ "Как в системе X" — требует объяснения что именно

Инструменты и форматы

BDD (Behavior-Driven Development):

Feature: Добавление товара в корзину
  Scenario: Пользователь добавляет товар
    Given товар доступен
    When пользователь нажимает "Добавить в корзину"
    Then корзина должна содержать этот товар

User Stories + Acceptance Criteria:

As a пользователь
I want отправлять сообщения
So that я могу общаться с друзьями

Acceptance Criteria:
- Сообщение должно сохраняться в БД
- Получатель видит уведомление в течение 3 секунд

Процесс улучшения требований

1. Написание черновика — первоначальная формулировка
2. Уточнение с заказчиком — валидация понимания
3. Техническая проверка — команда разработки оценивает реализуемость
4. Документирование — оформление в соответствии со стандартом
5. Одобрение — sign-off от всех сторон
6. Мониторинг — отслеживание изменений и уточнений

Качественные требования экономят время разработки, снижают количество багов и переделок, улучшают сотрудничество между командами.