Как написать техническое задание для программиста 1с. Пример тз и тп на небольшую доработку. Узлы регулирования теплоснабжения

Наши специалисты помогли заказчику составить ТЗ техническое задание на модернизацию системы вентиляции .

Подробнее под катом..

Техническое задание

на модернизацию технологического оборудования вентиляционных систем корпуса лабораторий №451,452 корпуса 17 по адресу: г. Москва

1. Общие положения

1.1. Настоящее техническое задание предусматривает выполнение работ по модернизации технологического оборудования, систем управления и автоматики вентиляционных установок корпуса, лабораторий №451,452 корпуса 17.

1.2. Для выполнения работ разработать рабочую документацию разделов марок АОВ, ЭМ, ХС, АХС, АК, которую согласовать установленным порядком.

1.3. Работы выполнять с соблюдением требований нормативно-технической документации.

1.4. По окончании работ предъявить исполнительную документацию, выполненную в соответствии с требованиями ГОСТ и СНиП.

1.5. Сдать выполненную работу Заказчику.

1.6. Отдельные положения настоящего Технического Задания могут уточняться в процессе проведения работ по согласованию с Заказчиком.

2. Технические требования

2.1. Модернизация узлов регулирования тепло, холодоснабжения вентиляционных установок.

2.1.1. Узлы регулирования теплоснабжения.

Модернизации подлежат:

· узлы регулирования теплоснабжения первого подогрева вентиляционных установок К1, К2, К2а, К4 корпуса МИК-В, П2, П6 лаборатории №452, П1 лаборатории.

· узлы регулирования теплоснабжения второго подогрева вентиляционных установок К1, К2, К2а корпуса МИК-В.

Существующие узлы регулирования теплоснабжения подлежат демонтажу, при этом, часть оборудования узлов регулирования (циркуляционные насосы, запорная арматура), соответствующие по состоянию и техническим характеристикам, подлежит использованию в монтируемых узлах регулирования.

Состав оборудования монтируемых узлов регулирования, а также.используемое оборудование указано в приложении №1.

Провести гидравлические испытания контуров подогрева и калориферов вентиляционных установок с оформлением акта гидравлических испытаний.

Выполнить покраску трубопроводов и теплоизоляционные работы.

2.1.2.Узлы регулирования холодоснабжения вентиляционных установок.

Модернизации подлежат узлы холодоснабжения вентиляционных установок К1, К2, К2а, К4 корпуса МИК-В, П2, П6 лаборатории «452, П1 лаборатории №451.

Состав работ:

· замена терморегулирующих вентилей узлов регулирования холодоснабжения;

· демонтаж/монтаж вентилятора компрессорно-конденсаторного блока К1;

· демонтаж/монтаж фильтров-осушителей компрессорно-конденсаторных блоков К1, К2;

· демонтаж/монтаж испарителя вентиляционной установки К4;

· опрессовка в среде инертных газов, ваккумирование, заправка фреоном контуров холодоснабжения;

· восстановление теплоизоляции трубопроводов.

2.1.3. Узлы подпитки контуров увлажнения.

На узлах подпитки камер орошения кондиционеров К1, К2, К2а установить фильтры очистки холодной воды.

2.2. Шкафы управления и автоматики вентиляционных установок.

Подлежат демонтажу шкафы управления вентиляционными установками К1, К2, К2а, К4, РУ3, В1, В2, В3, В6, В7, В8 корпуса МИК-В, П2, П6, В1, В2, В3 лаборатории №451, П1, В1 лаборатории № 452.

Компоновка вновь устанавливаемых щитов управления:

ШУА К1 – шкаф управления и автоматики вентиляционной установкой и компрессорно-конденсаторным блоком (ККБ) кондиционера К1 (МИК-В);

ШУА К2 – шкаф управления и автоматики вентиляционной установкой и ККБ кондиционера К2 (МИК-В);

ШУА К2 – шкаф управления и автоматики вентиляционной установкой и ККБ кондиционера К2а (МИК-В);

ШУА К4 – шкаф управления и автоматики вентиляционной установкой и ККБ кондиционера К4 (МИК-В);

ШУВ– шкаф управления вытяжными установками РУ3, В1, В2, В3, В6, В7, В8 (МИК-В);

ШУА П2,П6 – шкаф управления и автоматики вентиляционными установками и компрессорно-конденсаторными блоками П2, П6 (лаборатория №452);

ШУВ– шкаф управления вытяжными установками В1, В2, В3 (лаборатория №452);

ШУА П1,В1 – шкаф управления и автоматики вентиляционными установками П1, В1 (лаборатория №451).

Модернизированные шкафы управления должны обеспечивать:

· выбор, с лицевой панели шкафа, режима управления вентиляционными установками (ручной/автоматический);

· световую сигнализацию штатных и аварийных режимов работы технологического оборудования вентиляционных установок (работа/авария);

· отключения вентиляционных установок при возникновении пожара;

· автоматическое срабатывание защит и блокировку работы оборудования при возникновении аварийных ситуаций.

Преобразователи частоты для управления электродвигателями вентиляторов и насосов подлежат дальнейшему использованию.

2.3. Система автоматизации и диспетчеризации

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

2.3.1. Система автоматики.

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

Локальная автоматика вентиляционных систем должна предусматривать:

· регулирование температуры приточного воздуха на выходе вентиляционной установки или, при необходимости, температуры вытяжного воздуха из обслуживаемого помещения;

· регулирование влажности приточного воздуха;

· остановку вентиляторов и закрытие воздушных клапанов при срабатывании пожарной сигнализации;

· отключение увлажнения воздуха кондиционера при остановке его вентилятора;

· открытие и закрытие воздушного клапана соответственно при пуске и остановке вентилятора;

· автоматический прогрев калориферов перед запуском систем в зимнем режиме;

· защита от замораживания калориферов по воздуху и по воде (отключение вентилятора, закрытие воздушной заслонки, открытие на 100% клапана подогрева);

· отключение вентилятора при отсутствии перепада давления;

· контроль загрязненности фильтров установок.

Дистанционное воздействие на локальную автоматику с АРМ определяется в следующем объеме:

· изменение уставок регуляторов температуры и влажности;

· включение/отключение установок.

Существующее периферийное оборудование системы автоматики подлежит поверке, очистке и дальнейшему использованию в следующем порядке:

· датчики температуры и влажности вентиляционных установок подлежат поверке;

· датчики реле перепада давления подлежат проверке, очистке;

· термостаты защиты калориферов вентиляционных установок от замораживания подлежат замене.

· приводы регулирующих клапанов узлов регулирования подлежат замене в соответствие с п.2.1.1.

· приводы воздушных клапанов подлежат проверке и дальнейшему использованию;

Для управления рециркуляцией кондиционера К1 заменить двухпозиционные приводы воздушных клапанов на клапана с управляющим сигналом 0..10В.

2.3.2. Система диспетчеризации.

В состав системы диспетчеризации включить следующие компоненты:

· комплекс измерительных устройств, исполнительных механизмов и средств автоматизации на базе программно-технических средств «Honeywell »;

· многофункциональная кабельная система;

· комплекс программно-технических средств диспетчерского пункта.

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

· графическое изображение установок с датчиками температуры и влажности, термостатами от замораживания, реле дифференциального давления, регулирующими клапанами, увлажнителями воздуха, воздушными клапанами;

· номера установок;

· показания датчиков температуры, влажности;

· показания датчиков реле дифференциального давления;

· показания положения регулирующих клапанов 0..100%;

· режим «работа/останов» вентиляторов;

· режим «работа/ останов» насосов;

· положение воздушных клапанов «открыт/закрыт»;

· остановка систем при срабатывании пожарной сигнализации;

· остановка систем при возникновении угрозы замораживания калорифера;

· остановка установки при отсутствии перепада давления на вентиляторе;

· отключение увлажнителя воздуха при остановке вентилятора кондиционера;

· работа систем по заданному временному графику или без него;

· сигнализация аварий и нештатных ситуаций в случае возникновения неисправности оборудования, а также - выхода значений технологических параметров за пределы заданных диапазонов;

· регистрация аварий и нештатных ситуаций в журнале сообщений;

· журнал регистрации параметров на текущее время с указанием наименования контролируемых параметров, единиц измерения, номера контроллера и канала ввода/вывода.

2.3.3. Электропитание системы автоматизации и диспетчеризации должно осуществляться от сети переменного тока напряжением 380/220 В, частотой 50 Гц с использованием источников бесперебойного питания на аккумуляторных батареях и обеспечиваться как питание электроприемников первой категории

С точки зрения ГОСТов*, в которых регламентирована деятельность по разработке программного обеспечения и автоматизированных систем (АС) – это основной документ, определяющий требования и порядок развития или модернизации (далее – создания) автоматизированной системы, в соответствии с которым проводится разработка АС и ее приемка при вводе в действие.

• *ГОСТ 19.201-78 Единая система программной документации. Техническое задание. Требования к содержанию и оформлению;
• ГОСТ 34.602-89 Информационная технология. Комплекс стандартов на автоматизированные системы. Техническое задание на создание автоматизированной системы.

К сожалению, в ГОСТе не дано более четкого определения, поэтому, учитывая интересы взаимодействующих сторон – интегратора и заказчика, правильнее будет дать более точное определение. Техническое задание, являясь основным документом на проектирование автоматизированной системы, устанавливает основные характеристики и назначение АС, определяет необходимые этапы создания документации и ее состав, а также является частичным обоснованием .

Зачем нужно техническое задание

Основные проблемы в проекте возникают из-за некорректно сформулированных или незакрепленных требований проекта. Основные требования к результату должны быть описаны в техническом задании, которое формируется техническими специалистами исполнителя, а не заказчиком.

Таким образом, напрашиваются дополнения к уже сформулированному выше определению. Хочется добавить, что этот документ, содержащий требования, должен быть сформулирован на понятном для заказчика языке. Привязок к особенностям технической реализации АС не делается. Т.е. на этапе ТЗ в принципе неважно, на какой платформе будут реализовываться эти требования. Выяснением и формулированием требований, а также оформлением технического задания должен заниматься бизнес-аналитик, и никак не программист (хотя при совмещении ролей такой вариант возможен), потому что именно аналитик говорит с заказчиком на языке его бизнеса.

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

Кто разрабатывает техническое задание

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

Типовые ошибки при разработке технического задания

Документ базируется на ГОСТ 34.602-89, дающий формализованную структуру, но не имеющий четких требований к изложению разделов и пунктов. Эта особенность стандарта - его сила и его слабость. Свобода изложения может привести к тому, что требования разделов (особенно функциональные):

• Излагаются не системно, без привязки к какой-либо структуре (модули системы, бизнес-процессы);
• Дублируются;
• Относятся к различным уровням детализации.

Допущение ошибок при составлении технического задания приводит к увеличению стоимости и продолжительности проекта. Основная задача технического задания – оформить требования заказчика в понятном и возможном к реализации формате.

Реализация требований заказчика невозможна без правильно составленного технического задания. Даже при наличии высокой компетенции сотрудников, возможно возникновение ошибок. Чаще всего встречаются следующие:

• Излишняя детализация;
• Требования, противоречащие друг другу;
• Неточные формулировки.

Многие заказчики грешат требованием к излишне детализированному описанию процесса работы системы, однако основное внимание следует сфокусировать на результате, а не на том, как должна выглядеть система.

Требования не должны быть противоречивыми. Также желательно избегать расплывчатых, неконкретных формулировок. При разработке ТЗ определяются базовые требования и назначение проекта, его функционал.

Как избежать ошибок при составлении ТЗ

Главное правило: больше конкретики. При составлении требований необходимо использовать ссылки на ГОСТ, нормативные документы заказчика, что позволит избежать двойного толкования или недопонимания между заказчиком и исполнителем.

При разработке ТЗ необходимо применять сухой, научный стиль изложения, избегать применения сравнений. Использовать следует терминологию отрасли, сферы, в которой ведется разработка проекта.

Руководствоваться нужно следующими правилами:

• Формирование ТЗ – это совместная работа исполнителя и заказчика;
• Риски исполнителя должны быть минимизированы и не должны превышать аналогичные для заказчика (иначе это приведет к увеличению стоимости проекта);
• Требования формируются объективными, использование субъективного виденья заказчика не рекомендуется;
• Не допускается использование терминов, принятых в широком деловом общении, но противоречащих принятым в отрасли и стандарте;
• Основное внимание уделяется описанию результатов, требуемых заказчиком. Например, заказчику необходимо получать отчет о движении товара в соответствующих аналитических разрезах, тогда в ТЗ должны быть подробно описаны параметры отчета (строки, аналитика, период, за который составляется отчет) и источники данных для его формирования. Самое главное здесь – не допустить расширенного толкования технического задания, иначе, если вы не указали период или источник данных, конечный результат может сильно отличаться от требований заказчика, а доработка потребует дополнительных средств и времени.

Разработка, например, «правильного» ТЗ программисту 1С, подразумевает полное погружение в тему, знание всех ее аспектов и тонкостей. ТЗ должно давать ответ не только на вопрос «что должен сделать программист», но в первую очередь – «какие задачи должна решать система 1С:Предприятие после выполнения работ». Требования должны быть сформулированы подробно, но без лишней информации. Это уменьшит вероятность появления неточностей и ошибок. Именно поэтому привести универсальный пример технического задания 1С не представляется возможным – каждый случай ТЗ на разработку 1С уникален.

Если пройтись по зарубежным сайтам с запросом «product requirements document», то можно найти креативные и убедительные статьи про то, что техническое задание (ТЗ, PRD) умерло. Отчасти с этим нужно согласиться - при разработке продукта с нуля прототипирование выглядит гораздо интереснее и эффективнее, чем тома записей заказчика, порой ну очень непрофессиональные. Однако, если речь идёт о доработке базовой системы, то дело принимает совершенно другой оборот. Мы сталкиваемся и с доработкой, и с заказной разработкой, поэтому на ТЗ собаку съели, если повар нам не врёт. В общем, сегодня - о тех самых классических технических заданиях, которые пишутся на доработку купленного и установленного программного обеспечения. Короче, о наболевшем.

Грани взаимодействия

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

Требования - желаемое поведение системы, описанное заказчиком или холдером процесса, подлежащее реализации. Как правило, требования формируются на основании опыта работы, представления правильного поведения программы. Это ключевая информация для разработчика (вендора), однако именно на этапе сбора требований возникает самое большое число коллизий, ошибок, излишних запросов и проч.

Ресурсы - люди, машины, инвентарь, среда разработки, время и деньги, которые должны использоваться в процессе реализации требований. Ресурсы требуют чёткого планирования и оценки на этапе согласования технического задания. Грамотная расстановка приоритетов со стороны заказчика и распределение трудовых ресурсов со стороны вендора позволяют избежать срыва сроков и минимизировать иные риски.

Возможности - если кратко, то это то, что реально может сделать вендор (исполнитель). Рассмотрим на примере нашей RegionSoft CRM . Клиент покупает систему и составляет техническое задание на доработку: нужно создать интеграцию с сайтом и привязку событий в CRM к номеру заказа интернет-магазина. Это реально исполнимое требование, у нас есть ресурс и возможность сделать это. А ещё нужно разработать и прикрутить к CRM CMS, систему управления контентом сайта. Теоретически мы это можем, но у нас нет возможности это сделать дёшево, а у клиента нет возможности заплатить нам столько, чтобы мы перекинули на задачу человеческие и временные ресурсы. В итоге от этого требования заказчик отказывается - да и CMS ему не особо нужна, всё и так хорошо. Но о «жадности» ТЗ- позже.

Ограничения - набор препятствий, которые делают выполнение задач из ТЗ затруднительным или невозможным: бюджет, стек технологий, лицензионные проблемы, законодательные запреты, аппаратные конфигурации и проч.

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

Сбор и анализ требований

Это очень важный внутрикорпоративный процесс, в ходе которого выясняется, чего хотят от программы (здесь и далее возьмём CRM, но методы работают и с другими типами софта) потенциальные пользователи. Если вы обратитесь к крупному вендору типа SAP или системному интегратору, то с высокой долей вероятности вам предложат воспользоваться услугами бизнес-консультанта (он же персональный менеджер, он же аккаунт-менеджер, он же «теперь ваш представитель в нашей компании»). На самом деле, в большинстве случаев это обычный вышколенный продажник, у которого две задачи: накрутить стоимость проекта и не дать вам сорваться с крючка.

Он находится здесь уже целый час и даже не притронулся к белой маркерной доске. Он не настоящий системный аналитик

Лучше, чем вы и ваши сотрудники, вашу компанию не знает никто. А значит, сбор и анализ требований - исключительно ваша задача, в которой вендор может помочь и направить, но ни в коем случае не вмешаться в процесс. Расспросите разработчика о подобных внедрениях, уточните, на что обратить внимание и приступайте. Кстати, неплохим помощником может быть ваш сотрудник, который хорошо разбирается в профильной теме и примерно представляет архитектуру ПО и знаком с процессом разработки - он может выступить в роли аналитика и внутреннего эксперта, замкнуть на себе процесс создания ТЗ и общения с вендором.

Есть очень простая схема сбора требований.

1. Создайте рабочую группу из руководителей и опытных специалистов подразделений, которые будут пользоваться CRM. Расскажите о решении, которое предполагается выбрать, предоставьте доступ к демо-версии.
2. Члены рабочей группы должны передать информацию сотрудникам и запросить у них пожелания к новой программе в абсолютно свободной форме. Если кто-то из сотрудников никогда не сталкивался с подобным софтом и не готов говорить в аспекте будущего использования, нужно попросить его описать свои периодические задачи, это универсальный подход.
3. Затем каждое подразделение устанавливает, чего нет в CRM или чему она не соответствует, и агрегирует информацию.
4. Рабочая группа анализирует собранные требования, проверяет и исключает пересечения. Например, нередко отдел продаж и отдел маркетинга заказывают один и тот же отчёт, но в требованиях могут по-разному называться поля и сущности, хотя данные за ними стоят одинаковые. Соответственно, нужно придти к единой форме.
5. Рабочая группа формирует список требований и расставляет приоритеты. На этом этапе можно подключить вендора, поскольку он отвечает за ресурсы. Например, можно попросить создать пользовательский отчёт для RegionSoft CRM, а можно заказать интеграцию с сайтом. Это совершенно разные по срокам задачи, здесь очень важен приоритет.

После того, как требования собраны, проанализированы и согласованы с сотрудниками и руководством, можно приступать к созданию технического задания. Вы можете попросить форму у вендора или составить его самостоятельно - в любом случае есть несколько железных правил, соблюдение которых избавит от головной боли и вас, и вашего поставщика CRM.

Анатомия технического задания

Если говорить о процессе создания технического задания, то существует несколько этапов. Их последовательное прохождение и приводит заказчика к желаемой доработке. Вот они.

• Выявление - определение требований, поиск проблем, которые необходимо решить.
• Анализ - разбор требований, выделение ключевых потребностей, обобщение.
• Адаптация - оценка требований в контексте возможностей CRM и существующих бизнес-процессов.
• Документирование - формальное и подробное описание требований, согласование ТЗ.
• Общение с вендором (разработчиком) - итеративное взаимодействие с вендором по поводу доработок согласно составленному ТЗ.
• Реализация - работа вендора над созданием необходимой функциональности. Лучше, если вендор будет постоянно на связи с заказчиком - так продукт на выходе будет наиболее точно соответствовать видению клиента.
• Тестирование - проверка функциональности сотрудниками вендора, внутренними экспертами клиента и конечными пользователями с целью установления соответствия доработки и ТЗ, работоспособности системы с изменениями.

Вообще, техническое задание может быть создано на основе требований нескольких уровней, которые могут пересекаться и сотрудничать при создании проекта или не взаимодействовать вовсе.

Уровень бизнеса - самый глобальный уровень, на котором решаются сложные и приоритетные задачи. К этому уровню можно отнести интеграции, доработки и моделирование бизнес-процессов, разработку новых функциональных модулей. Как правило, это ресурсоёмкая разработка, с серьёзными консультациями и тесной совместной работой с заказчиком. Например, в своё время в RegionSoft CRM такой заказной доработкой были складской учёт, касса и производство. Постепенно изменения вошли в релиз, а позже позволили создать новый продукт для оптовых, розничных магазинов и гипермаркетов - RegionSoft Retail .

Уровень пользователя или группы пользователей. На этом уровне реализуются задачи по доработке существующего интерфейса. Например, пользователь может захотеть, чтобы при наведении курсора на клиента появлялось окошко со номером и статусом последнего заказа или существовал кастомный отчёт с особой группировкой данных. Доработки на этом уровне занимают меньше времени, но их может быть много - например, несколько требований от отдела маркетинга, логистики и технической поддержки.

Уровень функциональности. Зачастую его трудно отделить от предыдущего, здесь работает формальный критерий - доработка не на уровне отображения чего-либо в интерфейсе, а на уровне доработки логики системы. Сюда можно отнести требования к различного рода сортировкам, интеграциям с чатом, возможностям телефонии.

Уровень сервиса - на самом деле, требования этого уровня должны первыми попадать в новые сборки с фиксами. Это задачи по скорости отклика системы, работе под высокой нагрузкой, безопасности. В идеальном варианте у вендора не должно быть таких доработок - корпоративный софт не должен тормозить, терять данные, схлопывать формы и раздавать права доступа одного уровня. Но если требование появилось, и оно не связано с персональной паранойей заказчика или проблемами на стороне аппаратного обеспечения, стоит уделить ему повышенное внимание.

Уровень технологии - последний в списке, но по важности и сложности опережающий остальные. Это могут быть требования клиента, связанные с платформой, операционной системой или устройствами. Например, запрос сборки под MacOS. Очень здорово, если такие требования постепенно перерастут в релизы, но иметь их фиксы обязательно. Именно из запросов клиентов на этом уровне мы сделали сборку RegionSoft CRM под MacOS и добавили удалённый доступ по технологии TRM как временное решение редкого, но существующего запроса мобильной версии.

Анатомия технического задания проста, во всяком случае в виде скелета. Обязательные части технического задания помогают заказчику сосредоточиться на проблеме и сформулировать задачу правильно, а исполнителю - понять, что же от него хотят. Кстати, о понимании. Конечно, в начале поста мы немного слукавили, отрицая бизнес-консультантов как класс. Дело вот в чём: каждый вендор работает на рынке по несколько лет (мы сейчас не о CRM-однодневках), а то и десятков лет, а значит имеет набор кейсов практически по каждой отрасли. Соответственно, и инженеры, и программисты, и продажники знакомы со спецификой внедрения в каждом типе компании. Но опять-таки, важно ориентироваться именно на свой бизнес.

Для кого? В этом разделе нужно описать, кто будет конечным пользователем доработки, какие задачи и с какой периодичность планируется решать.

Приведу пример. В одной компании внедряли CRM, предполагалась работа на довольно большом массиве данных (несколько десятков миллионов записей в месяц, несколько сотен тысяч записей в день). Начальник отдела продаж запросил отчёт по выгрузке этих записей с периодичностью «ежедневно». Естественно, что такой отчёт при одновременной работе сотни пользователей нагружал систему - были найдены решения по оптимизации процесса. Уже в ходе работы выяснилось, что продажник перестраховался и отчёт нужен ему только по итогам месяца, и то его можно запускать по расписанию ночью. Стоит ли говорить, что время и деньги были потрачены зря.

Зачем? Обоснование необходимости доработки и его место в бизнес-процессе. Этот пункт больше нужен самому заказчику, но и вендору нелишне знать, какие ещё процессы будут затронуты. Иногда это помогает найти альтернативное решение.

Что должно делать? Самый информативный блок - в нём описываются требования, ожидания от системы. И вот тут случаются тем самые перлы, чудеса и коллизии, которые впору отправлять на башорг, и которые ну очень усложняют жизнь. Причина одна - пользователь не знает, чего он хочет, что нужно сделать. Есть ещё маленькая подпричина - пользователь не может сформулировать требования. И тут задача разработчика (рабочей группы, аналитика, если он есть) помочь сформулировать потребность верно, выбрать целесообразное требование, вписать задачу в контекст работы системы. В этом же блоке нужно упомянуть ожидаемый результат.

Параметры технического задания - сроки, этапы реализации, ответственные от всех сторон, необходимые контакты и проч. Фактически это совокупность важных формальных вещей, делающих документ техническим заданием. Техническое задание обязательно должно быть согласовано и подписано сторонами во избежание многочисленных изменений по ходу разработки (они всё равно будут, но в меньшем объёме).

В идеальном варианте техническое задание составляется при активном участии вендора, и его итог представляет собой примерно такую структуру:

1. Описание требования каждого механизма и каждой функциональности
2. Описание реализации данной функциональности
3. Стоимость работ по каждому из этапов в отдельности
4. Общая стоимость работ по данному техническому заданию
5. Сроки исполнения работ с разбивкой по этапам и указанием очерёдности
6. Описание условий установки и тестирования доработки
7. Оговорки об исчерпывающем характере технического задания и иные условия

10 правил, написанных слезами разработчика

Техническое задание на доработку должно быть ТЗ на доработку , а не 300-страничным описанием CRM, которая необходима клиенту. Перед составлением требований следует внимательно ознакомиться с интерфейсом системы, её возможностями, документацией - скорее всего, большая часть «хотелок» уже есть в базовой поставке. Вторым шагом я бы рекомендовал обратить внимание на встроенные инструменты доработки (дизайнеры отчётов, конфигураторы и проч.) - возможно, нужные изменения сможет внести штатный программист (во многих компаниях они есть).

Техническое задание не должно быть жадным. Нередко бизнес переоценивает свои возможности или желает получить «всё и сразу». Такой подход не оправдан ни с точки зрения денег, ни с точки зрения бизнеса. Вендор, как правило, существует не пару недель (в случае RegionSoft - 15 лет), и к нему можно обратиться и через некоторое время, когда вы уже реально поймёте, чего в CRM не хватает.

Яркий пример избыточности буквально из вчерашнего дня: клиент купил ERP одной известной российской компании, думая, что раз работает бухгалтерский учёт, то и ERP этого вендора будет хороша. ERP оказалась не то чтобы не очень сама по себе, но очень не подходящей бизнесу. А вот RegionSoft CRM со складским учётом и производством подходит. Есть решение: забыть про ERP, поплакать, интегрировать учёт 1С с новой CRM и радоваться удобной реализации. Но вбуханных денег жалко! И клиент требует интегрировать CRM с ERP. Мы и не такое делали, но зачем такая трата, зачем две относительно схожих системы?

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

Например, RegionSoft CRM - десктопная программа, у нас нет клиента для браузера. Просить нас создать web-приложение для одной компании бессмысленно, это крупная разработка, она сейчас ведётся и не является возможной доработкой для одной компании. Нет, конечно, всё имеет свою цену, но опять же - в общем случае требование невыполнимое.

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

Техническое задание должно быть подробным. Нужно указать все значимые детали будущего проекта: от периодичности использования программы до пожеланий по интерфейсу. Чем подробнее будут изложен требования, тем проще и быстрее пройдут реализация и тестирование. Особо стоит уделить внимание деталям, если вы работаете в специфичной отрасли (медицина, страхование, банки) - подробное изложение нюансов взаимодействия бизнеса и программы обеспечит понимание задачи вендором и быструю адаптацию системы к вашей компании.

Обязательно обратите внимание на форматы чисел, названия полей, наличие или отсутствие выпадающих списков, поведение кнопок и хинтов, типы данных. Если заказчик использует собственные формулы, которые необходимо заложить в логику работы CRM (например, расчёт дилерских бонусов ), эти формулы должны быть прописаны с полной расшифровкой их обозначений и логики расчёта.

Да, корпоративный софт выглядит примерно так, и в нём много важных мелочей

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

В этом году ты можешь снова загадать одно желание. Только, прошу, не трать его на то, что даже я не смогу выполнить, типа понятных бизнес-требований!

Техническое задание должно быть написано на человеческом языке. И это важно, нет, ВАЖНО. Выделю две ситуации, когда проблемы с языком приводят к затягиванию реализации проекта.

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

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

   Техническое задание должно уметь смотреть в будущее. Ну не совсем оно, а люди, стоящие за ним. Если известно, что в скором времени будут происходить изменения в бизнес-процессах, это нужно обязательно учитывать, чтобы не платить за доработку дважды.

   Техническое задание не должно быть бюрократичным. Если вы хоть раз составляли этот документ, то наверняка ощущали, как тяжело избежать соблазна скатиться в бюрократию, наворотить вводных слов, строгих оборотов и описать каждый пункт как статью Уголовного кодекса (желательно с наказанием всем за нарушение). Бюрократические формулировки маскируют неполное понимание целей создания ТЗ. Ответственность вендора прописана в договоре, там же написан бюджет. Не стоит переносить эти моменты в техническое задание.

   Техническое задание должно быть техническим заданием. Звучит парадоксально, но часто вместо ТЗ мы читаем письма, жалобы, договоры, заново написанную инструкцию к CRM или протокол совещания. Конечно, работать по такому документу невозможно. Для того, чтобы не уйти от формы и содержания, воспользуйтесь старой школьной уловкой: рассмотрите термин по словам. Техническое - значит, диктует доработку, технику, направлено на решение задачи посредством изменения ПО. Вот о задаче в контексте ПО и нужно говорить. Задание - значит, постановка вопроса, проблемы, без советов, подсказок и предварительных оценок. Просто формулировка задачи.

   Заповеди закончились, теперь отповедь

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

   Техническое задание нужно писать быстро , даже если перед вами стоит задача автоматизации процессов сотового оператора или крупного гипермаркета. Это связано с тем, что технологии развиваются с огромной скоростью и даже та система, которую вы внедряете, за полгода-год может пережить мажорный релиз (а иногда и два), получить новую функциональность. Возможно, придётся пересмотреть необходимость доработок и начать процесс заново.

   

   
   Наконец он нашёл время закончить ТЗ. Но, увы, вокруг не осталось разработчиков, чтобы его реализовать.

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

   Оценить бюджет и избежать неприятных сюрпризов - едва ли не совместная задача номер один. Не стоит дёргать вендора и требовать от него примерной оценки работ (ну хоть приблизительно, навскидку, на глазок, а как у других, ну в проектах такого типа, а по опыту, ну так, в пределах погрешности). Полная оценка бюджета возможна только после прочтения, анализа и окончательного утверждения технического задания. Если ваш разработчик поступает иначе - готовьтесь к тому, что доработка обойдётся минимум в два раза дороже.

   Исходите из объективной необходимости изменений и расширений - выше я писал, что разработчик не исчезает и готов внести изменения и дополнения по вашим требованиям в любой момент. Поэтому не пытайтесь создать CRM/ERP мечты сразу, не требуйте от вендора кнопку «Всё работает, пока я пью кофе» - поработайте в системе, определите критичные для вас замечания и приступайте к сбору требований и составлению ТЗ.

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

   Весь декабрь мы даём скидки на RegionSoft CRM и весь софт собственной разработки. С 1 по 15 декабря - 15% и крутые условия рассрочки и аренды. У нас не бывает -70% и -90%, потому что мы держим экономически обоснованную цену на лицензии, а не берём её с потолка.

   Ну а если вам нужна CRM-система (с доработкой или без), то заходите на наш сайт , там много о CRM, её преимуществах и прочем корпоративном софте.

   И да, мы всегда ищем партнёров, которые готовы продавать CRM и другие продукты, дорабатывать и продавать CRM, продавать софт и обучать пользователей. Разделение доходов честное и выгодное партнёру. Покажем, расскажем, научим. Пишите на [email protected]

   Слайды, слайды. Комиксы взяты с http://www.modernanalyst.com/ и из Pinterest. Если есть лучший перевод - будем рады его внести в пост.