Документация на программное обеспечение автоматизированных систем. Требования к оформлению

УДК 681.3.06:002 гРУппа Т55

ОТРАСЛЕВОЙ СТАНДАРТ

ОСТ 1 02575-86
ДОКУМЕНТАЦИЯ НА ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ на г^странших

АВТОМАТИЗИРОВАННЫХ СИСТЕМ

Введен впервые
Требования к оформлению

ОКСТУ 0019

№ изм.
№ мзв.
Распоряжением Министерства от . 18 марта 1986 г. Ns 298-06
срок действия установлен с ■ 1 января 1987 г.
Д. Настоящий стандарт устанавливает требования к оформлению .документации на программное обеспечение систем автоматизированного проектирования (САПР)-, - автоматизированных систем, научных исследований (АСНИ) и систем' обработки-■дан- ' ных (СОД) экспериментов (в дальнейшем изложении - автоматизированных систем), •. . разрабатываемых в отрасли и представляемых в отраслевой фонд алгоритмов и прог- ' ■ рамм (ОФАП). . ' . ‘ ■■ : '
: Ч ї /УІР/Лб
•' З.- :' -— •

5428

1 Ин8. М° дубликата ..
1 Инв. № подлинника

■ . , с - -
■ \ ' f-' ’.'Л
Издание официальное 8376161 .от 26.03.86, L Перепечатка воспрещена

ОСТ 1 02575-86 Стр. 2
Определения терминов, применяемых в стандарте, - по ГОСТ 19781-83, ГОСТ 19.004-80 и ГОСТ 19.101-77, 'і
2. Программные средства (ПС) автоматизированных систем разрабатывают на основе утвержденных технических заданий (ТЗ), Оформление ТЗ - по ГОСТ 19.201-78.
3. ПС, подлежащие включению в ОФАП, представляют в организацию-фондо- держатель, ведущую специализированный раздел ОФАП, в комплекте с программами на машинных носителях и документацией.
4. Представляемая в ОФАП документация на ПС подразделяется на програм­мную и сопроводительную.
Виды программных документов, их содержание - по ГОСТ 19.101-77.
К сопроводительной документации относятся представляемые в ОФАП доку- менты, содержащие информационные, экспертные и финансовые сведения.
5. Программная документация, представляемая в ОФАП, подразделяется на документацию разработки, эксплуатационную документацию и документацию для сопровождения.
К документации разработки относится ТЗ.
Виды эксплуатационных документов установлены ГОСТ 19.101-77. Докумен­тация для сопровождения состоит из документов - "Текст программы" и "Описание программы*.
6. В целях реализации принципа развития автоматизированных систем ПС строят по модульному принципу.
Под модульным принципом понимается разделение ПС на функционально самое- тоягельные части, обеспечивающие заменяемость, модификацию, удаление и допол­нение отдельных частей.
7. В зависимости от структурной сложности, определяющей особенности доку- , менгирования, ПС подразделяются на виды и категории, приведенные в табл. 1.
Т аблица 1

Ns изм.
Ns иза.

00
Я

Вид ПС
Категория ПС
Определение

Компонент
Подпрограмма
Программное средство, определяющее алго­ритм, записанный в воспринимаемой вычисли­тельной машиной форме, пригодной для вклю­чения его как части, в программы или подпрограммы
Инв. № дубликата
1 Инв. Ns подлинника

Вид ПС
Категория ПС
Определение
Компонент
Компонент-программа
Программное средство, определяющее алго­ритм, записанный в воспринимаемой вычисли­тельной машиной форме, пригодной для при­менения самостоятельно или в составе комп­лекса
Комплекс
Библиотека подпрограмм
Постоянно хранящаяся на запоминающих уст­ройствах ЭВМ совокупность подпрограмм, оформленных по единым правилам разработки, идентификации, обращения, задания информа­ции об аргументах, результатах обеспечиваю­щих автоматизацию включения подпрограмм в вызывающие их ПС

Комплекс программ
Совокупность взаимосвязанных программ и библиотек, использование которых в опре­деленной технологией последовательности приводит к решению одной или нескольких задач

Пакет программ (ПП) со специализированным входным языком (СВЯ)
Программное средство, состоящее из совокуп­ности библиотек,-комплексов программ и средств перевода задания, составленного на специализированном языке, в готовую для использования или непосредственно выполняе­мую программу

Инв. К? дубликата

Ns изм.

Инв. N° подлинника
5428

Ns изв.

V • • • . •
. Таблица 2

. Код вида
.доку­мента
Наименование документа
Содержание документа
Категория ПС
Примечание
ОСТ 1 02575-86 Стр. 4

Подпро­грамма
Компонент- программа
Библиоте- ка-под- *■ программ
Комплекс программ
ПП с свя
Прочие

12
13
31
32
33
34
. Спецификация
Текст программы
Описание про­граммы
Описание приме­нения
Руководство сис­темного програм­миста
Руководство
. программиста
Руководство оператора
По ГОСТ 19.202-79
По ГОСТ 19.401-78
По ГОСТ 19.402-78
По ГОСТ 19.502-78
По ГОСТ 19.503-79
По ГОСТ 19.504-79
По ГОСТ 19.505-79
Go р
1 О ' • 0 0 ©
СО
(>
®
®
•
(12, 13, 33, 34, Р1)
О
о
•
®
®
•
(12, 13, 32, 33, Р1)
О
о
•
®
®
•
(12, 13, 32, 33, 34, Р1)
О
о
о
• ®
0
■ • (12, 13, 33, 34, 35, Р1)
•
О
о
•
0
0
•
о
о о
В скобках указаны коды вида документов, сведе­ния из которых рекомен­дуется включать, если необходимость отдельного существования этих доку­ментов не определяется ТЗ

Инв. № дубликата

Инв. Ne подлинника
5428
Ne изм.

Ne изв.

Код вида доку­мента
Наименование документа
Содержание документа
Категория ПС
Примечание

Подпро­грамма
. Компонент- программа
Библиоте- ка-под- программ
Комплекс программ
ПП с свя
Прочие

35
Описание языка
По ГОСТ 19.506-79
—
—
-
-
о
О
—
Р1
Тестовые задачи
Инструкция по работе с конт­рольными приме рами, описание исходных дан­ных и резуль­татов их обра­ботки

О
О
о
о
Документ обязателен при наличии документа *Про- грамма и методика испы­таний*’
51
Программа и ме­тодика испытаний
По ГОСТ
19.301-79
—
—
о
о
о
о
Обязателен для межве­домственных (ведомст­венных) приемочных ис­пытаний
90-99
Каталог, глос­сарий, справоч­ное руководство
Дополни тельные сведения для удобства поль­зования доку­ментацией

о
о
о
о

ОСТ І 02575-86 Стр. 6
Условные обозначения: ф - документ обязательный ф - документ обязательный для компонентов, имею- щих самостоятельное применение
(^) - документ обязательный, если его содержание не отражено в эксплуатационных документах. Документ представляется в ОФАП по согласо- ванию
О - необходимость составления документа опреде- ляегся ТЗ
— - документ не составляют.
10. Конкретный состав разрабатываемой и представляемой в ОФАП програм- мной документации определяют в соответствии с табл, 2 и в зависимости от осо­бенностей и назначения ПС, требований нормативных документов к ПС данного наз- начения (например, на САПР и АСУ - технологические с учетом ОСТ 1.42137-82), условий эксплуатации ПС и их сопровождения устанавливают по согласованию с ОФАП в ТЗ.
>

11. Оформление программных документов - по ГОСТ 19.105-78 и ГОСТ 19.106-78.
12. Титульная часть программных документов состоит иэ листа утверждения и титульного листа. Оформление их производится в соответствии с ГОСТ 19.104-78 с учетом правил, установленных в организациях-разработчиках.
13. Титульный лист составляют на каждый программный документ. Лист ут­верждения допускается выпускать только на спецификацию.
14. Обозначение программ и программных документов - поГОСТ 19,103-77 и ГОСТ 23501.119-83 (для программного обеспечения САПР). Код организации- разработчика - по общесоюзному классификатору предприятий, организаций и уч­реждений.
15. Сопроводительная документация содержит следующие документы:
• копию акта межведомственных (ведомственных) приемочных испытаний ПС;
• акт о проведении опытной эксплуатации ПС;
• акт экспертизы материала, подготовленного к публикации;
• информационную каргу Государственного фонда алгоритмов и программ (ГОСФАП);
• справку о фактических затратах на разработку ПС;
• справку об устранении недостатков, отмеченных в акте межведомственных (ведомственных) испытаний ПС;
• акт о. внедрении ПС.
•
ОСТ 1 02575-86 Стр. 7
16. Акт межведомственных (ведомственных) приемочных испытаний ПС под- гверждаег работоспособность ПС и их соответствие ТЗ, содержит рекомендации по устранению выявленных недостатков ПС и включению их в ГОСФАП. Оформление акта межведомственных (ведомственных) приемочных испытаний приведено в реко­мендуемом приложении 2.
- 17. Акт о проведении опытной эксплуатации ПС содержит сведения о выпои-
ненных работах на этапе опытной эксплуатации и обнаруженных в ПС ошибках и недостатках. Оформление акта б проведении опытной эксплуатации ПС приведено в рекомендуемом приложении 3.
18. Акт экспертизы материала, подготовленного к публикации, содержит све- дения о возможности публикации сведений о ПС. Акт оформляется цо правилам, установленным на предприятии-разработчике.
19. Информационная карга ГОСФАП содержит информацию о ПС и организации- разработчике. Оформление информационной карты - по ОСТ 1.42201-84.
20. Справка о фактических затратах на разработку ПС содержит сведения о фактической трудоемкости и стоимости разработки ПС. Оформление справки о фактических затратах на разработку ПС приведено в рекомендуемом приложении 4.
21. Справка об устранении недостатков, отмеченных в акте межведомствен- ных (ведомственных) испытаний ПС, подтверждает устранение недостатков по за­мечаниям приемочной комиссии. Оформление справки об устранении недостатков ■ приведено в рекомендуемом приложении 5.
22. Акт о внедрении ПС - документ, подтверждающий практическое исполь- зование ПС в одной или нескольких организациях и содержащий сведения об объеме выполненных работ на этапе внедрения и фактическом или предполагаемом эконо- мическом эффекте, полученном от внедрения. Оформление акта о внедрении ПС приведено в рекомендуемом приложении 6.
23. Состав сопроводительной документации определяют по табл. 3 в зависи­мости от уровня планирования разработки ПС.
Та блица 3
Сопроводительный документ
Разработка ПС

по плану Министерства (ведомства) или выше­стоящей организации
по плану предприятия
вне плана
Копия акта межведомственных (ведомствен­ных) приемочных испытаний
Акт о проведении опытной эксплуатации
•
©
О

ОСТ 1 02575-86 Стр. 8
Продолжение табл. 3

Сопроводительный документ
Разработка ПС

по плану Министерства (ведомства) или выше­стоящей организации
по плану предприятия
вне вплана

Акт экспертизы материала, подготовлен- ного к публикации
Информационная карта ГОСФАП
Справка.о фактических затратах на раз­работку ПС
Справка об устранении недостатков
•
• о
Предоставляют при нали­чии недостатков, отме­ченных в акте приемочных испытаний
•
Q