Daniel Spravtsev
_

Документация после разработки: что заказчик должен получить

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

Данила Справцев
Данила Справцев

Основатель студии, в коммерческой разработке с 2016 года · Обновлено 17 ноября 2026

Какие документы разработчик передает заказчику

Пакет должен отвечать на ваши рабочие вопросы. Начните с описания системы: из каких частей она состоит и как части связаны между собой. Рядом инструкция по развертыванию: как поднять проект на чистом сервере из репозитория, то есть хранилища кода. Отдельно нужны инструкция администратора и инструкция для сотрудников, которые работают в продукте каждый день. Добавьте описание интеграций: с какими внешними сервисами продукт обменивается данными и по каким ключам. И перечень доступов с пометкой, какой аккаунт кому принадлежит.

Что должно быть в документации проекта

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

Техническая документация на сайт: что проверить при приемке

Код лежит в репозитории, где у вас права владельца. Проверьте домен, сертификат безопасности, аккаунты платежей, рассылок и аналитики: они оформлены на вашу организацию, и вы входите в них сами. Сторонние компоненты идут с лицензиями, часть лицензий требует оплаты на ваше имя. Заведите список ключей и паролей с пометкой, где каждый используется. Права на сервер и на все перечисленное закреплены за вами в договоре.

Как организовать передачу документации заказчику

Назначьте встречу, где разработчик показывает систему на вашем сервере. Запись экрана и конспект пригодятся новому администратору. Пройдите по сценариям, важным для бизнеса: заказ, оплата, уведомление, выгрузка отчетов. К передаче приложите перечень документов и доступов с подписями обеих сторон. Спросите, как устроена поддержка после запуска: кто реагирует на сбой, куда писать, что входит в регламент. Мы администрируем сервер клиента по договору поддержки, аккаунты и доступы остаются у клиента. Смету по вашему проекту считает калькулятор на нашем сайте, заявку оставляют там же.

Проверьте себя

  • Есть описание системы: части и связи между ними
  • Инструкция по развертыванию проверена на чистом сервере
  • Вы владелец репозитория и сами выдаете доступ разработчику
  • Домен, сертификат, платежи и аналитика оформлены на вас
  • Ключи и пароли собраны в одном месте с пометками о применении
  • Инструкция для сотрудников написана их языком
  • Перечень документов и доступов подписан обеими сторонами
  • Понятно, куда писать при сбое и кто отвечает

Частые вопросы

Обязан ли разработчик передавать исходный код?

Это зависит от договора, поэтому пропишите передачу кода и доступов до старта работ. Мы отдаем клиенту код и все аккаунты.

В каком виде нужна документация?

Подойдет текстовый файл или вики в вашем репозитории. Содержание важнее формата: шаги, адреса, имена доступов. Скриншоты помогают там, где интерфейс сложный.

Что делать, если документации нет совсем?

Закажите восстановление: подрядчик читает код и описывает систему. Это отдельная работа, ее результат проверяют тестовым развертыванием.

Нужна ли документация небольшому проекту?

Нужны хотя бы инструкция по развертыванию и список доступов. Без них любая доработка начинается с раскопок в коде.

Кто хранит документацию после передачи?

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

Время принимать решение - Готовы обсудить проект?

Опишите задачу в двух словах — соберу из этого письмо и открою его в вашей почте. Отправите сами, когда прочитаете.

Сначала прикинуть стоимость →

Сопровождение после запуска: техподдержка, исправление ошибок, резервные копии, мониторинг. Подробнее о тарифах

Приложу вашу смету:

Письмо откроется в вашем почтовом клиенте — вы увидите текст до отправки и сможете приложить файлы. Сайт ничего не сохраняет и никуда не передаёт. Можно и просто написать на daniel@spravtsev.pro.