ТЗ или проектная документация: в чём разница и что когда нужно

Слова «техническое задание» и «проектная документация» часто используют как синонимы, и это порождает путаницу. На деле это разные документы, которые появляются на разных этапах и отвечают на разные вопросы. Понимать разницу полезно, чтобы не заказать лишнее и не забыть нужное.

Что такое техническое задание

Техническое задание отвечает на вопрос «что нужно сделать». Оно появляется в самом начале, до того как написана первая строчка кода или начерчена первая схема. В нём фиксируют, какую задачу решает система, какие функции у неё должны быть, как она себя ведёт, с чем интегрируется и по каким критериям её примут. ТЗ это точка отсчёта и общий договор между заказчиком и исполнителем о конечном результате.

Что такое проектная документация

Проектная документация отвечает на вопрос «как это будет устроено». Она появляется позже, когда от требований переходят к решениям. Здесь описывают архитектуру системы, структуру данных, конкретные технические решения, схемы взаимодействия компонентов. Если ТЗ это про цель, то проектная документация это про способ её достичь. По ней уже можно вести разработку и понимать, почему система устроена именно так, а не иначе.

Отдельно стоит эксплуатационная документация. Она отвечает на вопрос «как этим пользоваться и это обслуживать»: руководства пользователя и администратора, инструкции по установке и настройке. Её готовят ближе к завершению проекта, и именно она помогает системе жить после сдачи, когда команды разработки рядом уже нет.

Зачем нужен каждый документ

Логика простая. Сначала договариваемся, что делаем, это ТЗ. Потом проектируем, как это устроить, это проектная документация. Затем описываем, как этим пользоваться, это эксплуатационные документы. Пропуск любого звена бьёт по проекту по-своему. Без ТЗ команда делает не то. Без проектной документации систему невозможно грамотно развивать и передавать между специалистами. Без эксплуатационной ваши сотрудники остаются один на один с системой, в которой никто толком не разбирается.

Какой комплект нужен вам

Объём документации разумно соотносить с масштабом и назначением проекта. Небольшому коммерческому сервису может хватить внятного ТЗ и короткого руководства пользователя, раздувать бумаги ради бумаг тут ни к чему. А вот сложная система, тем более для государственного заказчика, требует полного комплекта по ГОСТ, и это не прихоть, а условие приёмки и дальнейшей эксплуатации.

Для государственных проектов документация вообще часть правил игры. Комплект по стандартам серий 34 и 19 нужен, чтобы систему можно было принять, поставить на учёт и обслуживать по регламентам. Здесь экономия на документах превращается в невозможность сдать работу.

Если вы не уверены, что именно вам нужно, разумнее начать с разговора, а не с заказа всего сразу. Мы в KXtech сначала смотрим на задачу и тип проекта, а потом предлагаем ровно тот комплект документов, который действительно потребуется: для коммерческого продукта без лишнего, для государственного по всем стандартам.

Как понять, что документ хороший

Независимо от того, ТЗ это или проектная документация, качество проверяется одинаково просто. Хороший документ однозначен: по каждому пункту понятно, выполнен он или нет, и его нельзя истолковать двояко. Он актуален и меняется вместе с проектом, а не остаётся в версии полугодовой давности, пока система уехала далеко вперёд. И он написан для того, кто им будет пользоваться: разработчику нужны технические детали, пользователю понятные инструкции, и смешивать их в одну кашу не стоит. Если документ отвечает этим трём условиям, он работает на проект. Если же его согласовали для галочки и больше не открывали, толку от него немного, сколько бы страниц в нём ни было. Мы в KXtech относимся к документации как к инструменту, а не к формальности, и держим её в актуальном состоянии на всём протяжении проекта.