Как определить первый этап разработки веб-сервиса
Вводные для разработки: один рабочий сценарий, границы данных, неуспешные пути и критерии приёмки. Как превратить список функций в проверяемый первый этап.
Список «форма, кабинет, уведомления, отчёты» ещё не описывает результат разработки. По нему трудно понять, что пользователь сможет завершить, какие данные изменятся и где проходит граница первого этапа.
Рабочее описание задачи начинается с одного законченного сценария. В нём указаны исходная ситуация, участники, результат и способ его проверки. Ниже — авторский пример для условного сервиса внутренних заявок. Он не связан с реальным клиентом и не задаёт сроки или стоимость проекта.
Сформулируйте результат действия
Вместо «нужен кабинет сотрудника» запишите: «Сотрудник создаёт заявку на оборудование, руководитель принимает решение, сотрудник видит итог». Затем уточните, что должно появиться в системе после каждого шага.
Для первого этапа можно предложить такие границы:
| Часть сценария | В первом этапе | Отдельное решение |
|---|---|---|
| Создание заявки | Выбор позиции и обоснование потребности | Сложные правила комплектации |
| Проверка | Решение назначенного руководителя с причиной отказа | Несколько последовательных согласующих |
| Результат | Зафиксированный статус и доступное сотруднику решение | Закупка и доставка оборудования |
| История | Кто и когда принял решение | Расширенная управленческая отчётность |
Таблицу можно прокручивать по горизонтали.
Это не универсальный минимум. Таблица нужна, чтобы участники согласовали границу: успешное решение по заявке в данном примере не означает выполнение закупки.
Разберите роли и данные
Для каждой записи спросите: кто её видит, кто меняет и кому разрешено принять окончательное решение? Название роли должно соответствовать действию. «Администратор» без перечня полномочий оставляет слишком много разных ожиданий.
В условном примере сотрудник читает свои заявки, руководитель — заявки закреплённой группы. Отдельно нужно решить, кто назначает руководителя и что происходит, если назначение изменилось. Этот вопрос лучше поднять до проектирования экранов.
Определите источник каждого значимого поля. Список оборудования может храниться в самом сервисе или поступать из другой системы. При втором варианте в описание включают владельца данных, доступный интерфейс и поведение при недоступности источника. Не пишите «интеграция есть», пока не понятен её контракт.
Для обсуждения используйте обезличенные примеры. Реальные имена, доступы и содержимое рабочих систем не нужны, чтобы показать путь пользователя.
Добавьте неуспешные пути
Описание задачи должно включать ожидаемый результат при ошибке. Для примера с заявками полезно разобрать следующие ситуации:
- сотрудник отправил форму без обязательного обоснования;
- руководитель открыл заявку, которую уже обработали;
- пользователь пытается открыть чужую запись;
- связь прервалась после отправки, и пользователь не знает, сохранена ли заявка;
- внешний справочник недоступен.
Для каждой ситуации укажите, что пользователь увидит и какое состояние должно остаться в системе. Вопрос «что считается успехом после повтора» точнее, чем требование «сделать надёжно». Если ответ зависит от внешнего API, вынесите эту зависимость в отдельный пункт.
Опишите приёмку наблюдаемым результатом
Критерий «кабинет готов» замените на воспроизводимую проверку: сотрудник создаёт условную заявку, назначенный руководитель принимает её, сотрудник видит это решение, другой сотрудник не получает доступ к записи.
Рядом укажите окружение и данные проверки. Демонстрация на тестовых данных подтверждает прохождение проверенного сценария. Она не устанавливает готовность реального входа, отправки сообщений или подключения внешней системы: для каждого такого действия нужно отдельное свидетельство.
Включите в приёмку способ управления интерфейсом. Критерий WCAG 2.1.1 предусматривает управление функциональностью через клавиатурный интерфейс с оговорённым исключением для функций, зависящих от траектории движения. Это описано в пояснении W3C к Keyboard. Для формы заявки практическая проверка — заполнить поля и отправить её с клавиатуры. Одна такая проверка не устанавливает полное соответствие WCAG.
Соберите короткий документ до оценки
В задании на первый этап достаточно зафиксировать связанный набор решений: проблему, основной сценарий, роли, источники данных, границы, неуспешные пути и критерии приёмки. Дополните его открытыми вопросами с ответственным за ответ. Если сведений пока нет, оставьте вопрос открытым.
Пример такого вопроса: «Есть ли у справочника оборудования разрешённый API, кто подтверждает правила чтения и какую актуальность данных нужно обеспечить?» Он показывает, почему часть оценки зависит от исследования.
Не пытайтесь заранее описать все будущие функции. Сначала проверьте, что выбранный этап заканчивается полезным результатом, а его границы понятны заказчику и разработчику. Тогда состав работ можно обсуждать по конкретным действиям и зависимостям.