Главная

О нас

Продукты

Проекты

Материалы

Карьера

Контакты

Как оформить «Описание программы» по ГОСТ 19.402-78 (ЕСПД)

Описание программы по ГОСТ 19.402-78 — это документ, который помогает системно зафиксировать архитектуру программного обеспечения и упростить сопровождение проектов. Он нужен, чтобы структурировать модули, интерфейсы и связи между ними, обеспечивая прозрачность и прослеживаемость решений. В статье разберём, как оформить «Описание программы» по ЕСПД, какие разделы включает стандарт и как этот документ помогает бизнесу и разработке работать устойчиво.

Описание программы по ГОСТ 19.402-78 — это структурированный документ ЕСПД, который помогает формализовать архитектуру программного обеспечения. В статье разберём, как правильно оформить описание, какие разделы включает документ, приведём пример структуры и покажем, как он связан с архитектурными подходами HLD и LLD.

Назначение описания программы

Документ «Описание программы» по ГОСТ 19.402-78 используется для фиксации состава, логической структуры и взаимодействий компонентов программного обеспечения. Он необходим для:

оформления архитектурного описания в составе технического проекта (в т.ч. по ГОСТ 34);
включения в регламентированную документацию ЕСПД;
подготовки к сертификации, передаче на сопровождение или масштабированию системы.

Описание программы – это документ, который описывает иерархию, внутренние связи и архитектурные зависимости программных компонентов. Он занимает промежуточное место между проектированием и реализацией и помогает:

формализовать архитектурную декомпозицию;
описать взаимодействие между модулями и подсистемами;
создаёт основу для декомпозиции задач, тестирования, сопровождения и передачи проекта.

Документ особенно важен в проектах, где требуется нормативная фиксация архитектуры: при подготовке технических проектов, РД и документов для сертификации по ГОСТ или ISO.

Когда и зачем писать

Документ готовится после проектирования архитектуры (HLD, High-Level Design) и перед началом низкоуровневой разработки (LLD, Low-Level Design). Он раскрывает техническое задание (ТЗ) или SRS и связывает бизнес-требования с конкретной структурой программных модулей, создавая основу для:

планирования задач;
проектирования интерфейсов;
подготовки отчётных и приёмочных материалов.

Что включает описание

В соответствии с ГОСТ 19.402-78 структура документа «Описание программы» включает следующие основные разделы и элементы:

Введение

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

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

Назначение программы

Назначение программы как элемента автоматизированной системы или как самостоятельного программного средства
Уточнение задач, решаемых программой
При наличии — место программы в составе программного комплекса

Структура программы

Раздел описывает состав программы, включая подсистемы, модули и компоненты (подпрограммы, процедуры, сервисы и т. д.), иерархию элементов, их связи и зависимости. В оригинале по ГОСТу – "описание логической структуры".

Назначение и функции компонентов

Для каждого модуля и его составных частей приводятся:

Наименование;
Назначение – какую задачу решает;
Реализуемые функции – какие операции выполняет;
Взаимодействия и зависимости (связи) – с какими другими модулями взаимодействует.

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

Допускается включение особенностей реализации:

используемые языки программирования;
сторонние библиотеки и зависимости;
специфика компиляции и сборки;
шаблоны проектирования и архитектурные приёмы.

Приложения: Диаграммы и визуализация

Архитектурные схемы включают DFD (Data Flow Diagrams), UML-диаграммы и схемы развёртывания, показывающие технические средства и взаимодействие компонентов;
API и внешние интерфейсы;
Примеры кода, шаблоны, словари;
Состав компонентов (SBOM).

Используются для повышения понятности и согласованности, особенно при передаче проекта внешним командам или аудиторам.

Приложения: Дополнительные элементы (опционально)

Сведения о связи с внешними системами, API.
Перечень сторонних компонентов, лицензий (SBOM).
Дополнительные схемы, словари, фрагменты кода.

Связь с другими документами

Описание структуры:

Не дублирует BRD или Vision, а конкретизирует архитектуру, создавая мост между ТЗ (ГОСТ 34.602), SRS (IEEE 830) и LLD.
Конкретизирует ТЗ (ГОСТ 34.602) — в части архитектурных требований.
Уточняет SRS (System Requirements Specification) — добавляя детализацию архитектуры.
Может быть частью Технического проекта (ТП) — оформляется в разделе архитектуры.
Является основой для LLD и РД — даёт структуру, на основе которой пишется реализация.

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

Что это даёт бизнесу

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

Что дальше

Хотите оформить «Описание программы» по ГОСТ 19.402-78 (ЕСПД) или подготовить документацию для сертификации и сопровождения? Мы подготовим шаблоны, проверим структуру и поможем оформить документ, соответствующий требованиям ГОСТ и архитектурным стандартам.

Свяжитесь с нами – поможем сделать документацию не формальностью, а инструментом устойчивого управления проектом.