Липаев в.В. Документирование сложных программных средств Содержание

Липаев В.В. 1

ДОКУМЕНТИРОВАНИЕ СЛОЖНЫХ ПРОГРАММНЫХ СРЕДСТВ 1

Содержание 2

1. ДОКУМЕНТАЦИЯ В ЖИЗНЕННОМ ЦИКЛЕ СЛОЖНЫХ ПРОГРАММНЫХ СРЕДСТВ 4

1.1. Проблемы организации документирования сложных программных средств 4

1.2. Формирование требований к документации сложных программных средств 16

1.3. Планирование документирования проектов сложных программных средств 23

1.4. Управление специалистами при документировании программных средств 30

1.5. Документооборот в жизненном цикле проектов программных средств 41

2. СТАНДАРТИЗАЦИЯ ДОКУМЕНТИРОВАНИЯ ПРОЦЕССОВ И ПРОДУКТОВ СЛОЖНЫХ ПРОГРАММНЫХ СРЕДСТВ 48

2.1. Стандарты, регламентирующие документирование проектов сложных программных средств 48

2.2. Стандарты, регламентирующие эксплуатационную документацию программных средств 57

2.3. Документирование сертификации технологических систем и программных продуктов 76

3. СТРУКТУРА И СОДЕРЖАНИЕ – ШАБЛОНЫ ДОКУМЕНТОВ СЛОЖНЫХ ПРОГРАММНЫХ СРЕДСТВ 86

3.1. Документы предварительных требований, спецификаций и ресурсов для разработки программного средства 86

3.1.1. Интервью заказчиков и пользователей о проблемах и целях создания программного продукта: 86

3.1.2. Результаты обследования и описание системы и целей разработки комплекса программ: 87

3.1.3. Технико-экономическое обоснование проекта программного средства: 88

3.1.4. Концепция и основные предложения по созданию базовой версии программного средства: 89

3.1.5. Предварительный укрупненный план проектирования и разработки базовой версии программного средства: 90

3.1.6. Системный проект, общее описание программного средства и среды разработки для согласования между заказчиком и разработчиком (п. 3.1.3; п. 3.1.4; п. 3.1.5): 91

3.1.7. Техническое задание на предварительное (детальное) проектирование программного средства (п. 3.1.6): 92

3.2. Документы процессов проектирования и выбора характеристик качества программного средства 94

3.2.1. Стандарты, и ограничения на процессы проектирования программного средства: 94

3.2.2. Спецификация требований к системе и к комплексу программ: 94

3.2.3. Предварительное описание и контроль согласованности требований компонентов проекта программного средства: 95

3.2.4. Описание функционирования программного средства, взаимодействия с объектами внешней среды и человеко-машинного диалога: 96

3.2.5. Описание алгоритмов компонентов (модулей) программного средства: 96

3.2.6. Описание информационного обеспечения программного средства и системы управления базами данных: 97

3.2.7. Требования к характеристикам качества проекта программного средства: 98

3.2.8. Пояснительная записка к предварительному или детальному проекту программного средства: 100

3.2.9. Описание концепции технологии автоматизированного проектирования программного средства: 101

3.2.10. План и поддерживающее его Руководство по документированию проекта жизненного цикла программного средства: 102

3.2.11. Ведомость предварительного или детального проекта программного средства (п. 3.2.7; п. 3.2.8; п. 3.2.9; п. 3.2.10): 103

3.3. Документы процессов разработки и программирования компонентов программных средств 103

3.3.1. План разработки компонентов программного средства: 103

3.3.2. План обеспечения качества компонентов программного средства: 104

3.3.3. Стандарты кодирования компонентов программного средства: 104

3.3.4. Руководство по программированию компонентов проекта комплекса программ: 105

3.3.5. Документация на разработанный функциональный программный компонент или модуль программного средства (п. 3.3.2; п. 3.3.3; п. 3.3.4): 105

3.4. Документы верификации и тестирования компонентов программных средств 106

3.4.1. Состав базовых документов, регламентирующих верификацию и тестирование программных компонентов: 106

3.4.2. Исходные данные для верификации программных компонентов: 106

3.4.3. Результаты верификации корректности взаимодействия компонентов в составе программного средства: 107

3.4.4. Исходные данные для тестирования компонентов: 108

3.4.5. Организация, подготовка тестирования а обеспечение качества компонентов: 108

3.4.6. Сценарии тестирования и спецификации тестов для каждого компонента: 109

3.4.7. План тестирования программного компонента: 110

3.4.8. Отчет о результатах верификации и тестирования компонентов (п. 3.4.3; п. 3.4.5; п. 3.4.6; п. 3.4.7): 110

3.4.9. Методика комплексирования функциональных компонентов: 111

3.4.10. Оценка реализации комплексирования функциональных компонентов комплексов программ (п. 3.4.9): 113

3.5. Документы квалификационного тестирования, испытаний и оценивания качества программных средств 114

3.5.1. Методика генерации тестов имитирующих внешнюю среду и обработку результатов квалификационного тестирования: 114

3.5.2. Методика применения проблемно-ориентированной системы квалификационного тестирования и испытаний комплексов программ: 116

3.5.3. Методика, содержание и сценарии квалификационного тестирования и испытаний программных средств: 117

3.5.4. Программа испытаний комплекса программ: 119

3.5.5. Методики проведения испытаний комплекса программ по отдельным характеристикам качества: 120

3.5.6. Протоколы по результатам испытаний функциональных компонентов и/или комплекса программ: 121

3.5.7. Итоговый отчет результатов разработки программного средства (п. 3.5.1; п. 3.5.2; п. 3.5.3; п. 3.5.4; п. 3.5.5; п. 3.5.6): 122

3.5.8. Акт завершения работ по проекту программного средства (п. 3.5.7): 122

3.5.9. Акт приемки программного средства в промышленную эксплуатацию: 123

3.6. Документы сопровождения и конфигурационного управления версиями программного средства 124

3.7. Документы процессов эксплуатации программных средств 130