Как определить первый этап разработки веб-сервиса

Вводные для разработки: один рабочий сценарий, границы данных, неуспешные пути и критерии приёмки. Как превратить список функций в проверяемый первый этап.

Список «форма, кабинет, уведомления, отчёты» ещё не описывает результат разработки. По нему трудно понять, что пользователь сможет завершить, какие данные изменятся и где проходит граница первого этапа.

Рабочее описание задачи начинается с одного законченного сценария. В нём указаны исходная ситуация, участники, результат и способ его проверки. Ниже — авторский пример для условного сервиса внутренних заявок. Он не связан с реальным клиентом и не задаёт сроки или стоимость проекта.

Сформулируйте результат действия

Вместо «нужен кабинет сотрудника» запишите: «Сотрудник создаёт заявку на оборудование, руководитель принимает решение, сотрудник видит итог». Затем уточните, что должно появиться в системе после каждого шага.

Для первого этапа можно предложить такие границы:

Часть сценария В первом этапе Отдельное решение
Создание заявки Выбор позиции и обоснование потребности Сложные правила комплектации
Проверка Решение назначенного руководителя с причиной отказа Несколько последовательных согласующих
Результат Зафиксированный статус и доступное сотруднику решение Закупка и доставка оборудования
История Кто и когда принял решение Расширенная управленческая отчётность

Таблицу можно прокручивать по горизонтали.

Это не универсальный минимум. Таблица нужна, чтобы участники согласовали границу: успешное решение по заявке в данном примере не означает выполнение закупки.

Разберите роли и данные

Для каждой записи спросите: кто её видит, кто меняет и кому разрешено принять окончательное решение? Название роли должно соответствовать действию. «Администратор» без перечня полномочий оставляет слишком много разных ожиданий.

В условном примере сотрудник читает свои заявки, руководитель — заявки закреплённой группы. Отдельно нужно решить, кто назначает руководителя и что происходит, если назначение изменилось. Этот вопрос лучше поднять до проектирования экранов.

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

Для обсуждения используйте обезличенные примеры. Реальные имена, доступы и содержимое рабочих систем не нужны, чтобы показать путь пользователя.

Добавьте неуспешные пути

Описание задачи должно включать ожидаемый результат при ошибке. Для примера с заявками полезно разобрать следующие ситуации:

  • сотрудник отправил форму без обязательного обоснования;
  • руководитель открыл заявку, которую уже обработали;
  • пользователь пытается открыть чужую запись;
  • связь прервалась после отправки, и пользователь не знает, сохранена ли заявка;
  • внешний справочник недоступен.

Для каждой ситуации укажите, что пользователь увидит и какое состояние должно остаться в системе. Вопрос «что считается успехом после повтора» точнее, чем требование «сделать надёжно». Если ответ зависит от внешнего API, вынесите эту зависимость в отдельный пункт.

Опишите приёмку наблюдаемым результатом

Критерий «кабинет готов» замените на воспроизводимую проверку: сотрудник создаёт условную заявку, назначенный руководитель принимает её, сотрудник видит это решение, другой сотрудник не получает доступ к записи.

Рядом укажите окружение и данные проверки. Демонстрация на тестовых данных подтверждает прохождение проверенного сценария. Она не устанавливает готовность реального входа, отправки сообщений или подключения внешней системы: для каждого такого действия нужно отдельное свидетельство.

Включите в приёмку способ управления интерфейсом. Критерий WCAG 2.1.1 предусматривает управление функциональностью через клавиатурный интерфейс с оговорённым исключением для функций, зависящих от траектории движения. Это описано в пояснении W3C к Keyboard. Для формы заявки практическая проверка — заполнить поля и отправить её с клавиатуры. Одна такая проверка не устанавливает полное соответствие WCAG.

Соберите короткий документ до оценки

В задании на первый этап достаточно зафиксировать связанный набор решений: проблему, основной сценарий, роли, источники данных, границы, неуспешные пути и критерии приёмки. Дополните его открытыми вопросами с ответственным за ответ. Если сведений пока нет, оставьте вопрос открытым.

Пример такого вопроса: «Есть ли у справочника оборудования разрешённый API, кто подтверждает правила чтения и какую актуальность данных нужно обеспечить?» Он показывает, почему часть оценки зависит от исследования.

Не пытайтесь заранее описать все будущие функции. Сначала проверьте, что выбранный этап заканчивается полезным результатом, а его границы понятны заказчику и разработчику. Тогда состав работ можно обсуждать по конкретным действиям и зависимостям.

Что входит в разбор и проектирование

Ещё по теме