Требовать от подрядчика надо пять документов: инструкции пользователя по задачам, руководство администратора, схему развёртывания и восстановления, описание интеграций и обменов, журнал изменений. Всё остальное, что обычно предлагают в качестве документации, — либо пересказ интерфейса, либо материал, который устареет раньше, чем его прочитают.
Комплект существует ради двух конкретных ситуаций, и обе выглядят одинаково буднично. Первая: увольняется человек, который единственный знает, как в системе делается закрытие месяца. Вторая: вы расстаётесь с подрядчиком — по своей воле, по его или потому что он просто перестал отвечать. Пока ни одна из них не наступила, документация кажется формальностью; в день, когда наступает, она стоит ровно столько, сколько стоит простой процесса.
Модельный пример: проект внедрения на 1 200 000 ₽, три роли пользователей, две интеграции, 19 регулярных задач в системе. Дальше — состав комплекта с часами и ценой, список того, чего требовать не надо, получасовая проверка пригодности и формулировки для договора поддержки.
Пять документов и что в каждом
У каждого документа в комплекте есть свой вопрос и свой читатель. Если вопрос сформулировать нельзя, документ не нужен. Признак негодного — в третьей колонке: это то, по чему за минуту видно, что текст написан для отчётности, а не для использования.
| Документ | На какой вопрос отвечает | Признак негодного |
|---|---|---|
| Инструкции пользователя по задачам | Как мне сделать свою работу в системе от начала до результата | Оглавление повторяет меню системы, а не список задач сотрудника |
| Руководство администратора | Что делать при новом сотруднике, увольнении, смене прав, остановке обмена | Нет ни одной конструкции «если произошло — сделать» |
| Схема развёртывания и восстановления | Из чего состоит система, где что стоит и как поднять её с нуля | Не названы версии, внешние сервисы и место хранения резервных копий |
| Описание интеграций и обменов | Что, куда, когда и каким ключом передаётся и что происходит при отказе | Описано только штатное поведение, поведение при сбое отсутствует |
| Журнал изменений | Что и когда меняли в системе после запуска и по чьей заявке | Ведётся у подрядчика в его задачнике, а не в вашем комплекте |
Единица инструкции — задача, а не экран. «Принять товар по накладной» — задача; «Справочник контрагентов» — экран. Одна страница на задачу, нумерованные шаги, в конце — как понять, что получилось правильно. Девятнадцать таких страниц закрывают работу трёх ролей полностью, и это заметно дешевле, чем один том на двести страниц, который никто не откроет. Про то, что имеет смысл снять видео вместо текста и во сколько это обходится, есть отдельный разбор.
Схема из пяти горизонтальных блоков, у каждого подпись документа, часы и стоимость. Сверху вниз: «Инструкции по задачам, 14 ч, 42 000 ₽» — стрелка к фигуре с подписью «сотрудник»; «Руководство администратора, 7 ч, 21 000 ₽» — стрелка к «администратор доступов»; «Схема развёртывания, 5 ч, 15 000 ₽» — стрелка к «внешний инженер»; «Описание обменов, 8 ч, 24 000 ₽» — стрелка к «новый подрядчик»; «Журнал изменений, 2 ч, 6 000 ₽» — стрелка к «руководитель». Справа общий итог в рамке: «36 часов, 108 000 ₽, 9 % бюджета». Чертёжный стиль, подписи по-русски.
Чего требовать не надо
Избыточная документация опаснее её отсутствия: за неё платят, её никто не читает, и она создаёт ложное ощущение, что знание сохранено. Четыре позиции, которые регулярно попадают в требования и почти никогда не окупаются.
- «Описание функциональности» на 150–200 страниц. Пересказ интерфейса словами. Устаревает после первой же доработки и не отвечает ни на один вопрос, который возникает в работе.
- Снимок каждого экрана. Экраны меняются чаще всего остального: через полгода половина картинок врёт, а исправлять их никто не станет. Снимки уместны в инструкции по задаче, где их три-четыре на страницу, а не в отдельном альбоме.
- Полный комплект по ГОСТ 34 на проекте до трёх миллионов. Он написан для другого масштаба и другой процедуры приёмки. Если ваш заказчик — не государственная организация, требующая его по закону, вы платите за форму, а не за содержание.
- Описание кода и внутренней архитектуры «для нас». Читать его в компании всё равно некому, а тому, кто будет поддерживать систему после смены подрядчика, нужны схема развёртывания и описание обменов — про это есть разбор передачи системы в эксплуатацию.
В конце проекта её собирают в последнюю неделю, по памяти и в спешке, — и получается тот самый том, который никто не открывает. Работающий порядок другой: инструкция по задаче пишется на том же этапе, где сдаётся сама задача, и входит в перечень результатов этапа. Тогда её пишет инженер, который только что этот кусок сделал, а не тот, кто через два месяца пытается вспомнить, зачем там третья галочка.
Проверка за полчаса: три задачи чужими руками
Читать документацию бесполезно: она всегда выглядит убедительно. Единственная работающая проверка — посадить за неё человека, который в проекте не участвовал, и посмотреть, дойдёт ли он до результата. Процедура занимает полчаса на задачу и проводится до подписания акта, а не после.
- 1Выбрать три задачи
Самые частые, из разных ролей: одна продажная, одна складская, одна учётная. Не самые сложные — самые массовые, потому что именно их будут делать новички.
- 2Найти постороннего сотрудника
Человек из компании, который не участвовал в проекте и не видел системы. Учётная запись — чистая, с правами его будущей роли, а не администратора.
- 3Дать инструкцию и уйти
Он работает молча, вопросы задавать нельзя. Наблюдатель ничего не подсказывает, а только отмечает места остановок: где человек перечитал абзац дважды, где полез искать другое окно, где сдался.
- 4Посчитать остановки
До трёх остановок на задачу — документ принимается. Больше — возвращается на доработку с перечнем мест, а не с общей формулировкой «непонятно написано». Обычно правки занимают час-полтора на задачу.
Вся проверка на три задачи — это 3 часа сотрудника по полной ставке 700 ₽/час и 3 часа наблюдателя по 1 800 ₽/час, то есть 7 500 ₽. Это 6,9 % стоимости комплекта и единственный способ узнать про него правду до того, как подрядчик перестанет отвечать на письма. Тот же приём, применённый к схеме развёртывания, требует уже не сотрудника, а инженера — эту процедуру мы разбирали в материале про сдачу системы.
Цена пропущенной проверки считается по тому, во что обходится восстановление знания задним числом. Когда подрядчик ушёл, а комплекта нет, новому исполнителю приходится разбирать чужую систему по журналам и настройкам: 26 часов инженера по 3 000 ₽/час — 78 000 ₽, плюс 11 часов вашего руководителя на ответы и уточнения по 1 800 ₽/час — ещё 19 800 ₽. Итого 97 800 ₽ и около трёх недель, в течение которых доработки стоят. Это 91 % стоимости комплекта, но платится второй раз и даёт результат хуже: восстановленное описание всегда беднее написанного автором. Документация — примерно половина от 183 600 ₽, в которые обходится полная передача системы, которой не было.
Три столбца, ось в рублях. Столбец 1, самый низкий — «Проверка тремя задачами: 3 ч сотрудника по 700 ₽ и 3 ч наблюдателя по 1 800 ₽ — 7 500 ₽». Столбец 2 — «Комплект из пяти документов: 36 ч инженера — 108 000 ₽», с пометкой «9 % бюджета проекта 1 200 000 ₽». Столбец 3, чуть ниже второго, с другой штриховкой — «Восстановление знания после ухода подрядчика: 26 ч инженера 78 000 ₽ плюс 11 ч руководителя 19 800 ₽ — 97 800 ₽ и три недели». Под третьим столбцом подпись: «платится второй раз и даёт худший результат». Чертёжный стиль, подписи по-русски.
Кто обновляет комплект и где он лежит
Документ, который никто не обязан обновлять, начинает врать через полгода — обычно после третьей доработки. Ответственность делится на две половины, и обе надо назвать по имени. Со стороны подрядчика это пункт договора поддержки, со стороны заказчика — конкретный человек, а не отдел.
- 1В договор поддержки: любое изменение конфигурации закрывается обновлением затронутого документа в течение 5 рабочих дней после установки. Формулировка короткая и проверяемая — в отличие от «подрядчик поддерживает документацию в актуальном состоянии».
- 2В приёмку месяца: акт не подписывается без обновлённого журнала изменений за этот месяц. Это единственный рычаг, который работает без напоминаний; про остальной состав регламента есть разбор того, что входит в поддержку.
- 3Внутри компании: назначенный владелец комплекта с именем и фамилией. Его работа — принимать обновления и проверять, что версия сменилась, а не писать тексты. Это 1–2 часа в месяц.
- 4Раз в год: сверка комплекта с реальностью на тех же трёх задачах. Если за год ничего не менялось, проверка занимает полчаса; если менялось — вы узнаете об этом раньше, чем новый сотрудник.
Место хранения решает не меньше, чем содержание. Комплект лежит там же, где договоры и реестр доступов, — в папке «Система <название>» на корпоративном диске, к которому доступ есть у руководителя, а не у одного сотрудника. В имени каждого файла — дата версии. Ни почтовый ящик, ни чат, ни личный диск инженера местом хранения не считаются: через год комплект в них не находят. Про то, как устроено хранение чувствительной части — ключей и паролей, — есть отдельный материал.
Абстрактный нарисованный документ, не скриншот продукта. Лист «Карточка системы» с четырьмя блоками. Блок 1 «Документы»: пять строк с именами файлов и датами версий, например «Инструкции по задачам, версия 12.06.2026». Блок 2 «Владелец комплекта»: строка с местом под имя и подпись «1–2 часа в месяц». Блок 3 «Реестр доступов»: ссылка-стрелка вбок. Блок 4 «Журнал изменений»: три последние строки с датами и пометкой «акт месяца без него не подписывается». Слева от карточки — три перечёркнутых прямоугольника с подписями «почта», «чат», «личный диск». Чертёжный стиль, подписи по-русски.
Когда комплект можно сократить
Пять документов — норма для проекта с интеграциями и несколькими ролями. Есть три случая, где комплект честно урезается, и один, где его вообще нет смысла требовать.
- Проект до 250 000 ₽ с одной ролью и без интеграций. Хватает двух документов: инструкции по задачам и описания обмена, если он один. Это 8–10 часов и 24 000–30 000 ₽ вместо 108 000 ₽.
- Коробочное решение без доработок. Документация вендора уже есть, и переписывать её не нужно. От подрядчика требуется только описание вашей настройки: справочники, права, интеграции — 4–6 часов.
- Временный процесс на три-шесть месяцев. Сезонная схема, разовая кампания, обмен на период переезда. Достаточно журнала изменений и одной страницы «как это выключить».
- Система, которую вы сами будете переписывать в ближайший год. Здесь нужны только описание обменов и схема развёртывания: инструкции пользователя устареют вместе с интерфейсом, и платить за них — тратить деньги дважды.
И честное ограничение. Комплект документов не заменяет ни обучения, ни человека, который в системе разбирается: он сокращает вход нового сотрудника с полутора-двух недель до трёх-четырёх дней, но не до нуля. Про то, из чего складывается сам вход и почему его нельзя оставлять на наставника без материалов, есть разбор онбординга. Документация — это страховка на случай ухода людей, а не замена им.
