Артефакты требований
Что такое артефакты требований в системном анализе: внешние (для заказчика) и внутренние (для команды), процесс создания и критерии необходимости — артефакт полезен, если снижает риск, ускоряет работу или согласует стейкхолдеров.
Артефакты требований — это все, что создается аналитиком в процессе изучения, описания и документирования требований. Это рабочие инструменты, с помощью которых команда понимает, что нужно реализовать, как система должна работать, и почему именно так.
К таким артефактам относятся: Описание бизнес-процессов (BPMN, IDEF0); ФТ/НФТ; User story; Use cases; Глоссарий; ERD; UML - диаграммы (последовательности, действий, событий); API, описание контрактов.
Виды артефактов
Условно артефакты требований у системного аналитика делят на две группы:
- Внешние — для заказчика и пользователей. Нужны, чтобы все поняли, что делается и зачем. Некоторые виды:
- User Story — короткие и понятные описания функций.
- Use Case — сценарии взаимодействия с системой.
- SRS (Software Requirements Specification) — спецификация требований к ПО.
- ТЗ (Техническое задание) — часто по внутреннему стандарту компании.
- Внутренние — для команды разработки. Нужны, чтобы объяснить, как всё должно работать. Некоторые виды:
- Диаграммы (BPMN, UML, ER) — визуализация процессов, данных и архитектуры.
- Прототипы интерфейсов (Figma, Sketch, мокапы).
- Документ «Постановка задачи» — описание архитектуры, API, алгоритмов.
На практике в каждой компании есть свои стандарты документации: шаблоны, инструкции, готовые формы.
Процесс создания
Аналитик трансформирует высокоуровневые потребности стейкхолдеров в конкретные, детализированные требования (функциональные, нефункциональные). Также аналитик может выдвигать требования, основанные на лучших практиках, стандартах или собственном опыте (например, предложить требование по логированию определённых событий для упрощения поддержки).
При идеально организованных процессах разработки требования проходят ревью (этап валидации и верификации), в рамках которого устанавливается их соответствие критериям качества. Требования, не соответствующие критериям, должны отправляться на доработку.
Как не уйти в бюрократию
Артефакт нужен, если он:
снимает риск (неправильно поймут / дорого переделывать),
ускоряет (разработке/QA/поддержке проще),
согласует (стейкхолдеры перестают спорить).