Спецификация: документ с требованиями¶
Спецификация — это документ, в котором подробно и точно описаны характеристики, свойства, требования или параметры изделия, продукта, услуги, процесса или системы. Спецификация отвечает на вопросы: что именно должно быть сделано, из чего и как, по каким стандартам и с какими допусками. В широком смысле спецификация — это утверждённый перечень технических, функциональных или коммерческих условий, которым должен соответствовать объект.
¶Происхождение термина
Слово «спецификация» происходит от латинского specificatio — «определение, уточнение», от species — «вид, род». В русский язык термин вошёл в XVIII веке вместе с развитием промышленного производства и государственных заказов: для поставки материалов, вооружений и строительства требовались документы, точно фиксирующие объём и качество работ.
¶Где применяется
Спецификации используются практически во всех отраслях:
- Промышленность и производство — описание комплектующих, материалов, допусков, марок стали, сортамента.
- Строительство — ведомости объёмов работ, спецификации на материалы и оборудование для смет.
- Информационные технологии — требования к программному обеспечению, форматам данных, интерфейсам, протоколам.
- Пищевая и фармацевтическая промышленность — рецептуры, состав, нормы содержания веществ.
- Закупки и тендеры — техническое задание, перечень требований к поставляемому товару.
- Наука и образование — описание учебных программ, квалификационных требований.
¶Виды спецификаций
| Вид | Что описывает | Пример |
|---|---|---|
| Техническая | Параметры, материалы, допуски | Спецификация на подшипник: марка стали, размеры, класс точности |
| Функциональная | Поведение системы, требования к функциям | Спецификация программного модуля: входные данные, результат, ошибки |
| Коммерческая | Условия поставки, цена, сроки | Спецификация к контракту на поставку оборудования |
| Рецептурная | Состав и пропорции | Рецептура продукта, спецификация лекарственной формы |
| Материальная (ведомость) | Перечень материалов с количеством | Ведомость отделочных материалов для объекта |
¶Структура типичного документа
Хотя формат зависит от отрасли, большинство спецификаций содержат:
- Обозначение и наименование объекта — что именно описывается.
- Область применения — для каких изделий, процессов или систем действует документ.
- Нормативные ссылки — ГОСТы, отраслевые стандарты, международные стандарты (ISO, IEC).
- Требования — основная часть: параметры, характеристики, допуски, материалы, методы испытаний.
- Условия приёмки и контроля — как проверяется соответствие.
- Упаковка, маркировка, транспортирование — если применимо.
В России многие отраслевые спецификации унифицированы системой ГОСТ. Например, ГОСТ 2.106 устанавливает форму и правила оформления спецификаций в конструкторской документации, а ГОСТ 34.601 — набор этапов создания автоматизированных систем, где спецификация фиксирует состав системы.
¶Спецификация в разработке программного обеспечения
В IT спецификация — ключевой документ между постановкой задачи и реализацией. Типовой жизненный цикл выглядит так:
- Требования (requirements) — бизнес-задачи, которые нужно решить.
- Спецификация — формализованное описание: какие функции, интерфейсы, форматы данных, ограничения по производительности и безопасности.
- Реализация — программный код, написанный по спецификации.
- Тестирование — проверка соответствия реализации спецификации.
В аджайл-подходах спецификация часто разбивается на пользовательские истории и критерии приёмки, в классических водопадных моделях — оформляется как единый документ. Существуют отраслевые стандарты описания: OpenAPI (для REST-интерфейсов), IEEE 830 (рекомендации по написанию требований к программному обеспечению).
¶Требования к качественной спецификации
Хорошая спецификация должна быть:
- Однозначной — разные исполнители понимают её одинаково.
- Проверяемой — по каждому пункту можно провести контроль.
- Полной — без пробелов, которые приходится додумывать.
- Консистентной — без внутренних противоречий.
- Актуальной — соответствующей текущей редакции нормативов и изменённым требованиям.
¶Роль в контрактах и закупках
В гражданском праве и закупочной деятельности спецификация является приложением к договору и определяет предмет поставки. По российскому законодательству о контрактной системе (44-ФЗ) и закону о закупках для госкорпораций (223-ФЗ) техническое задание и спецификация — обязательные документы обоснования закупки. Расхождение поставщика с параметрами спецификации является основанием для отказа в приёмке товара.
¶Интересные факты
- В советское время единая система конструкторской документации (ЕСКД) сделала спецификации обязательным элементом любого изделия — от винтика до космического аппарата.
- Спецификации на электронные компоненты часто достигают сотен страниц: например, даташиты процессоров Intel или микроконтроллеров STM32 описывают каждый регистр и режим работы.
- В кулинарии «спецификация» используется как синоним рецептуры с точными граммовками — так работают сетевые рестораны, где блюдо должно быть одинаковым в любом филиале.
Источники:
- ГОСТ 2.106-2019. Единая система конструкторской документации. Формы документов
- ГОСТ 34.601-2007. Автоматизированные системы. Стадии создания
- IEEE 830-1998. IEEE Recommended Practice for Software Requirements Specifications
- 44-ФЗ «О контрактной системе в сфере закупок»
- OpenAPI Specification 3.1.0
- Словарь русского языка С. И. Ожегова