Технологии9 мин чтения

Техническое задание на интеграцию парка защищённых устройств: что обязательно прописать

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

Ноутбук с чек-листом технического задания на столе рядом с рядом защищённых терминалов, трекеров и планшета

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

Поэтому за такой проект разумно браться с командой, которая берётся за реализацию такого проекта под ключ — от уточнения ТЗ до запуска интеграции: разработка под ключ у 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-карта и тариф напрямую влияют на архитектуру: если тариф ограничивает трафик, протокол и частоту передачи телеметрии придётся проектировать с учётом экономии данных, а не исходя из идеальных условий. В ТЗ стоит указать хотя бы ориентировочный лимит трафика на устройство в месяц — это дешевле исправить на этапе проектирования, чем после того, как счёт за связь превысит ожидания.

Что происходит, если ТЗ написано поверхностно — на что это влияет в итоге?

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

Главное

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

Готовы подобрать технику?

Начните с задачи: где работает команда, сколько часов без розетки, какая нужна связь. Остальное разберём в каталоге.

Подобрать технику