Как писать ТЗ по ГОСТ 34?

Итак вы столкнулись с задачи написания технического задания, в большинстве случаев в формате ГОСТ 34, но вообще не имеете понятия с чего начать.    Для начала поделюсь основными положениями и опытом чтобы развеять страх:  1. ГОСТ лишь регламентирует структуру и состав документации - это не значит, что нет необходимости плодить 100500 документов ради того, чтобы все соблюсти как закон.  2. ГОСТы были созданы для ооочень широкого использования вплоть до огромных систем в составе огромного количества техники, поэтому если в раздел логически не подходит и вообще отсутствует в вашем продукте то и выдумывать ничего не надо.  3. Есть ГОСТ 34.601 в котором содержатся этапы создания системы, для ТЗ нам нужен 34.602-2020, поэтому смотрите на нумерацию внимательно, да и после тире - год редакции тоже важен.    Итак 34.602 содержит главу 4 по которой в составе ТЗ должно быть:  1. Общие сведения: перечень сокращений и документов, полное наименование системы, сокращенное, номер договора на основе которого ведутся работы (если есть), предприятия Исполнителя и Заказчика,  сроки, источник финансирования. Добавлю что в перечне документов можно указать сколько угодно ГОСТов, а в конце ТЗ обязательно сделать перечень необходимой документации к проекту - так при приемке не возникнет доп требований.  2. Цели создания системы: ее назначение и достигаемые показатели, как количественные так и качественные показатели  3. Характеристика объекта автоматизации: краткие сведения о системе которая есть и кратко функционал новый, так сказать точки А и Б  4. Требования к системе - это самый обширный пункт в котором аккумулируются требования по реализации проекта, собирается вообще все: бизнес, системные, функциональные, нефункциональные требования… Все это можно уточнить в ходе реализации проекта, для этого составляется ЧТЗ, бизнес, системные постановки и фиксируются отдельно. Тут главная задача не наломать дров и прописать сомнительных обязательств которые потом не выполнишь.  Основных подпунктов 3:  4.1 требования к системе в целом: ее структура, роли, архитектура, интеграции, параметры, безопасность.. даже про квалификацию обслуживающего персонала - сюда  4.2 требования к функциям: сам перечень функционала, в идеале формулировать что то на подобии user story по которой понятны цели функции: кто, что и зачем  4.3 требования к видам обеспечения: стек, софт, технические виды обеспечения    Если возникнут вопросы по содержанию писать в посте очень много, поэтому стучитесь в тг: @Snowliner я скину справку    Дальше пункты которые я бы охарактеризовал как договор, разумеется тут больше работы по фиксации рисков  5. Состав и содержание работ: перечень этапов и сроки выполнения.  6. Порядок контроля и приёмки системы: виды, состав, объёмы, методы испытания.  7. Требования к составу и содержанию работ: перечень мероприятий к вводу системы в действие, консистентность базы данных, необходимые изменения, условия функционирования, порядок обучения персонала.  8. Требования к документированию. Согласованные исполнителем и с заказчиком перечень документов.  9. Источники разработки. Материалы, на основе которых разрабатывалось ТЗ.  10. Приложения    Повторю, что пунктов может быть меньше, перечень в ГОСТ и выше лишь для того чтобы удостовериться что ни о чем не забыли.  Подводные камни по опыту:  1. Описывается функционал который оказывается потом реализовать невозможно из за факторов на которые исполнитель не в силе повлиять  2. Работаете в неопределенности или по scrum, и техписатель (документация) не успевает за проектом - вам нужен docops и подход docs as code  3. Agile противоречит работе с документацией но никак ее не отменяет, помните об этом с самого начала проекта а не в конце  Удачи!