К статье
Практический материал

Другое · 6 мин

Техническое задание для программиста 1С: как писать и оформлять

Практическая инструкция по написанию технического задания для разработчика 1С: разделы ТЗ, описание бизнес-процесса, приёмка и типичные ошибки.

Техническое задание для разработчика 1С должно переводить пожелания заказчика на язык объектов конфигурации: справочники, документы, регистры, отчёты и процессы обмена. Без такого перевода программист либо уточняет детали по ходу работы, либо реализует функцию так, как понимает сам, что ведёт к доработкам.

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

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

Цель и состав базового технического задания

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

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

Порядок составления ТЗ
  1. 1
    Опишите текущий бизнес-процесс своими словами
  2. 2
    Переведите шаги на объекты 1С: справочники, документы, регистры
  3. 3
    Укажите условия, вводные данные и ожидаемый результат
  4. 4
    Согласуйте критерии приёмки с заказчиком

Как описывать бизнес-процесс и объекты 1С

Описывайте процесс последовательно: кто инициирует действие, какие документы создаёт, какие реквизиты заполняет, какие проверки должны пройти перед проведением. Чем точнее описан порядок действий, тем меньше пространства для различных толкований.

Сценарий: новый документ

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

Сценарий: изменение существующего отчёта

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

Для каждого изменения формулируйте приемочные критерии: например, «после нажатия кнопки система создаёт документ X и заполняет реквизит Y значением из справочника Z». Без таких формулировок приёмка становится субъективной.

Требования к интерфейсу, отчётам и обмену данными

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

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

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

Приёмка, тестирование и границы ответственности

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

Контрольные точки

Как проверить результат

Открытая форма и заполненные реквизиты
Норма

Данные сохраняются и отображаются согласно ТЗ

Тревожный признак

Поля пустые, значения не совпадают с ожидаемыми

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

Типичные ошибки при написании ТЗ и ограничения самостоятельной работы

Самая частая ошибка — описание только пожеланий без привязки к объектам конфигурации. Фраза «сделать удобный отчёт» не содержит достаточной информации для программиста и приводит к многократным доработкам.

Типичные ошибки
01
Описание только пожеланий без привязки к объектам конфигурации
02
Отсутствие условий срабатывания и критериев приёмки
03
Изменение требований в процессе разработки без обновления ТЗ

Вторая ошибка — изменение требований в процессе разработки без обновления ТЗ. Это размывает границы уже выполненной работы и усложняет оплату.

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

Когда стоит привлечь аналитика или ведущего разработчика

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

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

Итог

Что важно запомнить

ТЗ пишется на языке объектов 1С, содержит условия и критерии приёмки, а изменения вносятся только на копии базы.

Нужно ли всегда писать ТЗ перед заказом доработки в 1С?

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

Кто должен составлять ТЗ: заказчик или программист?

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

Что делать, если в процессе разработки появились новые требования?

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

Можно ли доверять ТЗ, составленному только словами заказчика?

Нет, если в нём нет привязки к справочникам, документам и регистрам 1С. Перед началом работы такие формулировки уточняют и переформулируют в терминах конфигурации.