📜 Техническое задание (ТЗ)

Зачем нужно ТЗ, типовая структура, как писать требования и избегать типичных ошибок.

Шпаргалки · Документы · #documents #tz #requirements

Назначение

ТЗ фиксирует что нужно сделать и по каким критериям это принимается. Это договорённость между заказчиком и исполнителем: основа для разработки, тестирования и приёмки.

Типовая структура

Раздел Содержание
1. Общие сведения наименование, заказчик, исполнитель, основание, сроки, термины
2. Назначение и цели зачем создаётся, какие результаты и показатели ожидаются
3. Описание текущего состояния как устроен процесс или система сейчас (AS-IS)
4. Границы проекта что входит и что не входит
5. Требования к системе функциональные, нефункциональные, к интерфейсу, данным, интеграциям
6. Роли пользователей права и сценарии
7. Требования к безопасности аутентификация, защита данных, аудит, нормативы
8. Требования к документации какие документы поставляются
9. Порядок приёмки виды испытаний, критерии, акты
10. Этапы и сроки план работ, результаты этапов
11. Условия эксплуатации и сопровождения гарантия, поддержка, обучение
12. Приложения макеты, схемы, словарь терминов

Как писать требования

  • Нумерация (3.2.1) и идентификаторы (ФТ-014), чтобы ссылаться из тестов.
  • Слова «должна» для обязательного, «может» для необязательного.
  • Измеримые значения: время отклика, объёмы, число одновременных пользователей, доступность (99,9%).
  • Один пункт одно требование.
  • Запрещены «удобный», «быстрый», «современный», «и т. д.», «при необходимости».

Пример

Было Стало
«Система должна быстро искать» «ФТ-021. Система должна возвращать результаты поиска за время не более 2 с при 200 одновременных запросах.»

Критерии приёмки

К каждому ключевому требованию проверочное условие: сценарий, данные, ожидаемый результат. Без них приёмка превращается в спор.

Ошибки

Решение вместо потребности (указана технология без причины), нет границ, нет критериев, противоречия между разделами, нет версий и истории изменений.

Нормативные основы

Для автоматизированных систем в РФ см. ГОСТ 34 (ТЗ на АС), для программ ГОСТ 19.201 (ТЗ на программу). Подробнее в соседних шпаргалках.