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

Чаще всего ТЗ на интеграцию парка устройств пишет тот, кто хорошо знает бизнес-процесс, но не всегда держит в голове конкретику оборудования: сколько трекеров и терминалов в парке, какие у них прошивки, по какому протоколу они отдают данные и что должно происходить, если связь на объекте пропадает на полчаса. Если эти детали не прописаны заранее, их достраивает подрядчик — по своему опыту, который не всегда совпадает с реальностью конкретного парка.
Поэтому за такой проект разумно браться с командой, которая берётся за реализацию такого проекта под ключ — от уточнения ТЗ до запуска интеграции: разработка под ключ у YuSMP Group подразумевает, что подрядчик либо сам дорабатывает документ на старте, либо прямо указывает, каких данных не хватает, прежде чем приступать к разработке — вместо того чтобы достраивать пробелы молча в процессе работы.
Дальше — какие разделы ТЗ на интеграцию парка устройств обязательны именно из-за специфики оборудования, а не ПО, какие ошибки чаще всего стоят компании лишнего круга согласований после старта проекта и как подготовиться к передаче документа подрядчику.
Зачем парку защищённых устройств отдельное ТЗ, а не типовой шаблон
Почему шаблон ТЗ для обычного ИТ-проекта здесь не работает? Типовые гайды по написанию ТЗ — на внедрение CRM, 1С или другого корпоративного ПО — хорошо закрывают бизнес-слой: цели проекта, заинтересованных лиц, границы и фазы, сроки. Это правильные разделы, но они написаны в расчёте на интеграцию программных систем, у которых уже есть API с обеих сторон.
У парка защищённых устройств появляется ещё один слой — физический. Десятки или сотни единиц техники с собственными версиями прошивки, работающих в поле, а не в офисе, где связь не гарантирована, а часть парка может оказаться устаревшей техникой без современного SDK. Типовой шаблон не задаёт вопросов про этот слой — значит, эти вопросы просто выпадают из ТЗ, а всплывают уже в разработке: когда выясняется, что терминал на устаревшей прошивке не поддерживает нужный протокол, или что на складе есть зона без LTE-покрытия, которую никто не упомянул на старте.
Обязательные разделы ТЗ на интеграцию парка устройств
Общую структуру документа можно и нужно опирать на стандарт — например, на ГОСТ 34.602-2020, который устанавливает требования к содержанию технического задания на автоматизированную систему. Но для парка оборудования пять разделов ниже обязательны отдельно от стандартной рамки: без них подрядчик физически не может спроектировать интеграцию, а не просто пишет код по неполным вводным.
Описание устройств парка
В ТЗ должен быть полный перечень: модели, количество по каждой модели, версии прошивок, год выпуска или партии закупки. Отдельно стоит пометить устройства, которые работают на устаревших платформах — Windows CE или Windows Embedded Handheld: они почти наверняка не поддерживают современные протоколы и SDK, и для них потребуется либо отдельный адаптер, либо явное решение о замене в рамках проекта.
Протоколы и каналы передачи данных
Формулировка «устройство передаёт данные по интернету» для ТЗ бесполезна. Нужен конкретный протокол по каждому классу устройств: CAN — для телематики автопарка, NMEA — для GNSS и RTK-приёмников, Bluetooth — для связи ТСД с планшетом диспетчера, LTE или Wi-Fi — для выгрузки накопленных данных в корпоративную систему. От этого напрямую зависит архитектура шлюза, который подрядчик будет проектировать.
Поведение при нестабильной связи и офлайн-режим
В поле потеря связи — не исключительная ситуация, а рабочий режим, который нужно спроектировать заранее, а не обрабатывать как сбой по факту. ТЗ фиксирует: сколько данных устройство должно буферизовать локально, по какой логике происходит повторная отправка при восстановлении связи, какой тайм-аут считается нормальным, а какой — поводом для алерта диспетчеру.
Формат и частота передачи телеметрии
Формат данных — JSON, CSV или проприетарный протокол производителя устройства — и частота передачи напрямую определяют нагрузку на бэкенд и объём трафика через SIM-карту. В ТЗ стоит явно указать обязательные поля телеметрии и то, передаются ли данные по расписанию (раз в N секунд) или по событию — это разные архитектурные решения, и подрядчик не должен выбирать между ними сам.
Критерии приёмки интеграции
Критерий приёмки обязан быть измеримым: не «интеграция работает стабильно», а, например, «не менее 98% устройств парка передают данные без ручного вмешательства в течение контрольной недели» или «все сценарии из согласованного тестового списка пройдены с зафиксированным результатом». Без таких формулировок спор о том, выполнен проект или нет, решается мнением, а не фактом.

Этапы проекта интеграции и что в ТЗ на каждом — таблица
Таблица показывает, какой этап проекта отвечает за какую часть ТЗ и чем грозит пропуск этого пункта на старте.
| Этап | Что происходит | Что фиксирует ТЗ | Риск, если не прописано |
|---|---|---|---|
| Инвентаризация парка | Сверка реального состава устройств с учётными данными | Список моделей, прошивок, легаси-устройств | Часть парка «всплывает» уже в разработке и требует доработки архитектуры |
| Пилотная группа | Интеграция проверяется на 5-10 устройствах в реальных условиях | Протоколы, офлайн-сценарии, формат данных | Проблемы связи и формата выявляются только на всём парке, а не на пилоте |
| Основная интеграция | Подключение остального парка к корпоративной системе | Сроки по партиям, план отката при сбое | Массовое подключение без плана отката останавливает работу всего парка разом |
| Приёмка и поддержка | Проверка результата, передача на сопровождение | Измеримые критерии приёмки, SLA поддержки | Спор о завершённости проекта решается не фактом, а мнением сторон |
Частые провалы ТЗ на интеграцию парка устройств
- Список устройств без прошивок и года выпуска. Подрядчик узнаёт о легаси-терминалах на этапе разработки, когда менять архитектуру уже дороже.
- Не описан офлайн-режим. Проектировщик закладывает поведение «по умолчанию», которое не совпадает с реальными условиями объекта — и данные теряются при первом же перебое связи.
- Забыты SIM-карты и тариф связи. Протокол и частота передачи данных спроектированы без учёта лимита трафика — и счёт за связь оказывается выше, чем закладывал бюджет.
- Не указано, кто и как принимает результат. Без согласованных критериев и тестового сценария «готово» определяется на словах, и спор о завершении проекта затягивается на недели.
- Протокол описан обобщённо. Формулировка «данные передаются по интернету» вместо конкретного протокола заставляет подрядчика делать архитектурные допущения, которые потом приходится переделывать.
Чек-лист перед передачей ТЗ подрядчику
- Полный реестр устройств парка — модели, количество, прошивки, легаси-единицы отдельным списком.
- Протокол и канал связи для каждого класса устройств — без общих формулировок.
- Допустимый сценарий потери связи — сколько буферизовать, как повторять отправку.
- Формат и частота передачи телеметрии — обязательные поля, расписание или событие.
- Лимит трафика и условия тарифа связи по SIM-картам, если устройства работают через LTE.
- Измеримые критерии приёмки и согласованный список тестовых сценариев.
- Ответственные с обеих сторон за приёмку и за эскалацию при сбоях.
- Сроки по этапам — пилотная группа отдельно от основной интеграции.
Частые вопросы
Нужно ли описывать в ТЗ конкретные модели устройств, если парк будет расширяться?
Да, и это не противоречит будущему расширению. ТЗ фиксирует состояние парка на момент старта проекта — конкретные модели, количество, прошивки, — а не запрещает добавлять устройства позже. Для расширения достаточно отдельного раздела с требованиями к совместимости новых единиц: какой протокол и формат данных должно поддерживать любое устройство, которое добавится в парк после запуска интеграции. Без этого раздела каждая новая модель превращается в отдельный мини-проект согласования.
Как прописать офлайн-режим, если точно неизвестно, насколько нестабильна связь на объекте?
Если точных данных по качеству связи нет, в ТЗ фиксируется не конкретная цифра, а худший сценарий, который компания готова допустить: например, устройство должно буферизовать данные локально не менее 24 часов и докачивать их при восстановлении связи без потери порядка событий. Это снимает проблему неопределённости: подрядчик проектирует под заданный предел, а не угадывает реальные условия объекта. Уточнить фактическое качество связи можно отдельным пилотным замером до начала основной разработки.
Кто должен писать ТЗ на интеграцию — заказчик сам или подрядчик?
Чаще всего — совместно, и это нормальная практика, а не признак слабого ТЗ. Заказчик лучше знает свой парк устройств, бизнес-процесс и ограничения по бюджету и срокам; подрядчик — технические детали протоколов, форматов и архитектурные риски, которые заказчик может не увидеть заранее. Подрядчик, который берёт проект под ключ, обычно сам приходит с чек-листом недостающих данных на этапе коммерческого предложения, а не молча достраивает пробелы в процессе разработки.
Что делать, если часть парка — устаревшие устройства без документации на прошивку?
Для таких устройств — чаще всего это терминалы на Windows CE или Windows Embedded Handheld — в ТЗ указывается сам факт отсутствия документации и срок их вывода из эксплуатации, если он уже определён. Это не повод исключать их из проекта, а повод заложить в архитектуру промежуточный слой-адаптер, который приводит данные устаревшего устройства к единому формату, пока парк постепенно не перейдёт на современные модели. Попытка интегрировать legacy-устройство напрямую, без адаптера, обычно обходится дороже самого адаптера.
Как сформулировать критерии приёмки, чтобы не спорить с подрядчиком на финише проекта?
Критерий приёмки должен быть измеримым числом или пройденным тестовым сценарием, а не общей формулировкой вроде «интеграция работает стабильно». Например: не менее 98% устройств парка передают данные без ручного вмешательства в течение контрольной недели, задержка между событием на устройстве и записью в системе не превышает заданного порога, все тестовые сценарии из согласованного списка пройдены с зафиксированным результатом. Такая формулировка проверяется фактом, а не мнением сторон.
Нужно ли в ТЗ отдельно прописывать SIM-карты и тариф связи для трекеров/модемов?
Да, если устройства передают данные через LTE. SIM-карта и тариф напрямую влияют на архитектуру: если тариф ограничивает трафик, протокол и частоту передачи телеметрии придётся проектировать с учётом экономии данных, а не исходя из идеальных условий. В ТЗ стоит указать хотя бы ориентировочный лимит трафика на устройство в месяц — это дешевле исправить на этапе проектирования, чем после того, как счёт за связь превысит ожидания.
Что происходит, если ТЗ написано поверхностно — на что это влияет в итоге?
Поверхностное ТЗ не останавливает проект — его всё равно запускают, но пробелы заполняются уже в процессе разработки, за дополнительное время и часто за дополнительные деньги. Подрядчик либо делает паузу и уточняет детали по каждому неописанному случаю, либо принимает решение сам — и тогда результат может не совпасть с тем, что представлял себе заказчик. В обоих случаях поверхностное ТЗ обходится дороже тщательно составленного — просто эта стоимость размазана по ходу проекта, а не видна в момент его старта.
Главное
ТЗ на интеграцию парка защищённых устройств не сводится к типовому шаблону для внедрения ПО — ему нужен отдельный слой про само оборудование: модели и прошивки, протоколы и каналы связи, поведение при офлайне, формат телеметрии и измеримые критерии приёмки. Пропуск любого из этих пунктов не останавливает проект — он просто переносит стоимость уточнения на этап разработки, когда исправлять дороже. Чем точнее эти пять разделов прописаны на старте, тем меньше у подрядчика остаётся пространства для догадок — и тем меньше поводов для спора на финише проекта.


