Лекция 11. ГОСТ 34 в современной разработке, часть 2

• Лекция курса технической документации в проектах.  

• Костя Валеев из Ростелеком проводит вторую часть разговора о ГОСТ 34 в современной разработке.  

• Вопросы можно задавать в комментариях к видео и в телеграм-чате.  

• Обсуждение предварительных документов и стандартов.  

• Обзор технического задания и стандартов по базам данных.  

• Стандарты по разработке автоматизированных систем.  

• ГОСТ 34 включает один стандарт на техническое задание.  

• В ГОСТ 34 много документов, которые нужно разрабатывать на разных стадиях разработки.  

• Сложность структуры документов и их связанность.  

• Костя предлагает инфографику для понимания структуры документов.  

• Обзор документов технического проекта: эскизного и технического.  

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

• Стандарт ГОСТ 34 небольшой, без подробностей.  

• Разработан отдельный документ РД-50 для детального толкования стандарта.  

• РД-50 признан не действующим с 2019 года, что создает неопределенность.  

• Рекомендация посетить сайт ГОСТ 34 для новостей и обсуждений.  

• Конкурс на обновление стандартов, но радикальных изменений не произошло.  

• Призыв к участию в общественном обсуждении обновления ГОСТ 34.  

• Эскизный проект включает ведомость и пояснительную записку.  

• Технический проект содержит больше документов и деталей.  

• Рабочая документация разрабатывается на основе технического проекта.  

• Пояснительная записка кратко объясняет технический проект.  

• Документ не упоминает все документы проекта, что делает его кусочным описанием системы.  

• В некоторых разделах ГОСТ 34 можно ссылаться на другие документы проекта, что позволяет избежать дублирования информации.  

• Автоматизированная система включает комплекс технических средств и программное обеспечение.  

• Программное обеспечение имеет свои термины, описанные в ГОСТ 19.  

• Автоматизированная система состоит из компонентов и подсистем, но эти термины не всегда четко определены в ГОСТ 34.  

• Компонент — это физический элемент архитектуры системы.  

• Подсистема — это виртуальная группировка функций системы, собранных по тематическому принципу.  

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

• Функциональная подсистема состоит из отдельных функций.  

• Функция решает конкретную задачу, а подсистема - комплекс задач.  

• Функции могут быть реализованы как процедуры или алгоритмы.  

• Программное обеспечение и аппаратное обеспечение вместе составляют компонент.  

• Компонент может реализовывать несколько подсистем.  

• Пояснительные записки описывают основные технические решения и структуру системы.  

• Описывает бизнес-роли и зоны ответственности.  

• Рекомендуется использовать стандарты и хорошие практики.  

• Включает диаграммы и нотации для описания системы.  

• Описывают разработку новых технических средств и сооружений.  

• Включают технические задания на разработку и строительство.  

• Ведомость технического проекта и ведомость покупных изделий.  

• Перечисляют входные и выходные сигналы и данные.  

• Входные сигналы могут быть аналоговыми или цифровыми.  

• Выходные сигналы включают физические или электронные документы.  

• Описывают изменения в здании и сооружениях.  

• Включают перечень необходимых изменений.  

• Используются для уточнения и планирования строительства.  

• Пояснительная записка аналогична эскизному проекту.  

• Рекомендуется давать краткий обзор системы, но не включать все детали из других документов.  

• Автоматизированные функции описывают бизнес-процессы и юс-кейсы.  

• Включает исходные данные, цели процессов и их этапы.  

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

• Важно описывать процессную составляющую системы.  

• Описывает цели бизнес-процессов.  

• Включает список задач и мапинг входных и выходных данных.  

• Рекомендуется объединить в один документ для логичности.  

• Информационное обеспечение включает информацию и базу данных.  

• База данных может быть машинной или внемашинной.  

• Включает термины массив информации и набор данных.  

• Описывает логическую и физическую структуру базы данных.  

• Включает входящие потоки данных и правила синхронизации.  

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

• Описывает справочники и их параметры.  

• Можно объединить с описанием информационной базы.  

• Современные стандарты, такие как ER-диаграммы и UML, могут использоваться для описания модели данных.  

• Включает соглашения по неймингу компонентов и баз данных.  

• Помогает расшифровать непонятные названия и адресации.  

• Помогает в разработке и поддержке автоматизированной системы.  

• Включает аппаратное обеспечение, серверы, компьютеры, сетевое оборудование и датчики.  

• Описывает общую структуру и параметры оборудования.  

• Можно сослаться на отдельный документ с описанием схемы.  

• Алгоритм описывает автоматическую историю, проектная процедура — бизнес-процесс с участием людей.  

• Алгоритм включает действия, данные и формулы для расчетов погрешностей.  

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

• Включает схемы организационной структуры и матрицы ответственности.  

• Описывает изменения в структуре, например, появление новых ролей.  

• План расположения описывает чертежи и размещение оборудования.  

• Включает стоимость разработки и работ.  

• Описывает план графика и стоимость этапов.  

• Локальная проектная оценка надежности системы оценивает требования к надежности и быстродействию.  

• Описывает интерфейсы пользовательских документов.  

• Включает скриншоты или макеты интерфейсов.  

• ГОСТ требует соответствия скриншотов и чертежей.  

• Обсуждение стандартов на диаграммы и их типов.  

• Проблемы с рисованием макетов в рамках таких стандартов.  

• Рекомендации по использованию осей X и Y для чертежей.  

• Важность проектирования и прототипов на этапе разработки.  

• Рекомендации по описанию чертежей словами.  

• Обзор рабочей документации и её связи с техническим проектом.  

• Понятие техноной рабочей документации.  

• Объединение технического проекта и рабочей документации.  

• Примеры документов и их взаимосвязь.  

• Описание схемы автоматизации и её отличия от других схем.  

• Применение схемы автоматизации в инженерных проектах.  

• Рекомендации по использованию схемы автоматизации в информационных системах.  

• Проблемы с разрозненностью документов по ГОСТ 34.  

• Рекомендации по структурированию документации.  

• Сравнение с современными стандартами и подходами.  

• Использование современных подходов и нотаций в документации.  

• Проблемы с пониманием и использованием ГОСТ 34.  

• Рекомендации по переиспользованию современных подходов в документации по ГОСТ 34.  

• Обсуждение вопросов документирования проектов.  

• Проблемы с использованием ГОСТ 34 для внутренних нужд.  

• Рекомендации по созданию гибридного стандарта на основе ГОСТ 34 и других стандартов.  

• Рекомендуется использовать современные стандарты, чтобы избежать путаницы.  

• ГОСТ 4 не дает достаточного количества рекомендаций для избежания ошибок.  

• Важно понимать, какие документы полезны для разработки системы.  

• ГОСТ 4 комплексно рассматривает систему с точки зрения софта, железа и людей.  

• Разделение на автоматическое и полуручное человеческое обработку информации актуально.  

• Важно оставить функциональные и структурные компоненты для раннего проектирования.  

• ГОСТ 34 имеет хорошие идеи, но их нужно более понятно раскрыть.  

• Важно наполнить стандарт рекомендациями и нотациями.  

• Текущее обновление ГОСТ 34 не включает глобальное переосмысление.  

• Архитектура программного обеспечения описывается в пояснительной записке.  

• Важно использовать ГОСТ 19 для описания компонентов.  

• Пояснительная записка и описание ПО являются основными документами для архитектуры проекта.  

• Обсуждение возможности проведения дополнительной лекции по эксплуатационной документации.  

• Призыв к слушателям оставить комментарии и предложения.  

• Благодарность за участие и приглашение задавать вопросы в чате.