С 2022 года проекты, реализуемые с участием государства, всё чаще требуют официальной технической документации по стандартам Минцифры. Это касается тендеров, импортозамещения, ИТ-грантов и программ поддержки. Но что такое «документация для Минцифры»? Почему её боятся? И как сделать всё правильно — с первого раза?
Разбираемся на практике.
📎 Что такое документация для Минцифры?
Это комплект документов, которые подтверждают реализацию ИТ-продукта по ГОСТу, наличие архитектуры, команды, ответственности, стадий разработки и эксплуатационной готовности.
Обычно речь идёт о ГОСТ 19 и ГОСТ 34, которые описывают структуру и содержание техдоков для информационных систем. Минцифра опирается на эти стандарты при оценке ИТ-проектов — особенно, если вы участвуете:
- в тендерах;
- в реестре российского ПО;
- в грантах или субсидиях;
- в программах Минцифры по импортозамещению.
📂 Какие документы чаще всего требуются?
Набор может отличаться в зависимости от цели, но в типовом комплект входят:
📘 Пояснительная записка (ПЗ)
Общее описание проекта, цели, состав команды, стейкхолдеры
🏗 Техническое задание (ТЗ)
Полное описание функциональности, требований, ограничений
🧱 Технический проект (ТП)
Архитектура, схемы, протоколы взаимодействия
⚙️ Программа и методика испытаний (ПМИ)
Что и как проверяется, как будет проводиться тестирование
📝 Руководство администратора/пользователя
Как эксплуатировать систему
✅ Акты приемки
Документы сдачи этапов, завершения работ
🔒 Информационная безопасность
Если проект подлежит сертификации или защите данных
💡 Пример из жизни
Кейс: разработка системы документооборота для госсектора.
Компания участвовала в тендере на внедрение СЭД (системы электронного документооборота) для министерства. В проект включались:
- Веб-интерфейс;
- Интеграции с ЕСИА, 1С;
- Модуль авторизации через Госуслуги;
- Хранение в защищённом контуре.
📌 Что запросила Минцифра на финальном этапе?
- Архитектурную схему (в формате ГОСТ);
- Полный комплект документации по ГОСТ 34.201-89;
- Отдельные пояснения по используемым компонентам;
- Руководства в редакторе Word с гиперссылками и нумерацией.
Компания обратилась к техническому писателю. За 3 недели был подготовлен полный комплект на 250+ страниц, пройдено согласование с архитекторами, и проект успешно сдан. Без документации — контракт бы не подписали.
🛠 Как готовить такую документацию?
1. Начинайте с аудита
- Уточните, какие именно ГОСТ-документы требуют.
- Посмотрите старые заявки и шаблоны Минцифры.
- Спросите у заказчика: «Какая документация будет достаточной на финале?»
2. Используйте ГОСТ-структуру
- ПЗ, ТЗ, ТП — всё должно быть по форме.
- Не забывайте про титульные листы, подписи, оглавление.
3. Документируйте на всех этапах
- Не ждите окончания проекта. Составляйте ТЗ, ПМИ и Руководства в процессе, иначе к дедлайну утонете в хаосе.
4. Автоматизируйте
- Используйте шаблоны в Word и Confluence;
- Подключите схемы из Draw.io / Lucidchart;
- Храните версии в Git или Notion.
🧨 Ошибки, из-за которых отклоняют документацию
🚫 «Описано не по ГОСТу» — структура не совпадает, нет нужных разделов.
🚫 «Нечитаемый PDF» — плохо оформленный скан или экспорт.
🚫 «Отсутствуют методики проверки» — особенно часто забывают ПМИ.
🚫 «Нет связи между документами» — в ТЗ и Руководстве — разный набор функций.
🚫 «Нет упоминаний о безопасности» — даже если проект простой, регулятору нужно это видеть.
🤝 Когда привлекать технического писателя?
🕓 На старте — чтобы написать ТЗ и задать правильную структуру.
🧭 В середине — если пошла путаница и «каждый пишет свою версию».
🚨 На финише — когда горят сроки, а документации нет (а нужна завтра).
💼 Кто пишет такую документацию?
- Не копирайтер
- Не разработчик
- Не аналитик
Это отдельная профессия — технический писатель, который разбирается в: - ГОСТах,
- технических стандартах,
- форматировании и Word/Confluence,
- архитектуре ИТ-систем.
✅ Чеклист: вы готовы к Минцифре, если…
- У вас есть ПЗ, ТЗ, ТП, ПМИ и Руководства
- Они соответствуют ГОСТ 34/19
- В документах есть схемы, ссылки, гиперссылки
- Все термины согласованы с командой
- Документы читаемые и оформлены по требованиям заказчика
📣 Вывод
Документация для Минцифры — это не формальность, а часть успеха проекта. Грамотно оформленные документы могут:
- ускорить согласование,
- укрепить доверие заказчика,
- защитить исполнителя от претензий,
- повысить шансы на победу в тендере.
Если вы не уверены — лучше привлечь эксперта. Как показывает практика, вложение в технического писателя = страховка проекта.
Что думаете? Сталкивались с оформлением документации для госорганов? Делитесь опытом в комментариях! 🚀