Системная документация
Описания отражают всё самое важное о системе, то есть всё, что отвечает на предметы интересов проектных ролей, которые решено удовлетворять при создании системы. Создание непротиворечивого описания повышает вероятность воплощения успешной целевой системы в физическом мире.
Системное моделирование осуществляется посредством мышления письмом, в котором участвуют специальные инструменты в виде моделеров. Например, такими моделерами могут быть ручка с бумагой, Word, стена с липкими листочками и фломастером, а более продвинутые моделеры – это Coda[1], CAD (сomputer-aided design - компьютерная поддержка проектирования)[2] и т.п.
Рабочим продуктом системного моделирования с использованием моделеров является документация. Документация в итоге становится внешней памятью для команды (экзокортексом)[3]. Форматом документации[4] может быть текст, аутлайны, таблицы, компьютерные модели и т.п.
Наш курс – это тоже моделер в виде таблиц или верхнеуровневых моделей, в которых увязываются между собой важные понятия системного мышления. С помощью курса как тренажера вы можете тренироваться в мастерстве владения необходимыми понятиями для такого верхнеуровневого моделирования (не полностью относящегося к предметной области). К верхнеуровневому моделированию относим обозначение[5] всех важных систем и подсистем, а также их взаимосвязь. Кроме того, для понимания верхнеуровневых моделей потребуется, как минимум, разобраться в связи метода описания и предметов интересов, в разнице «черного» и «прозрачного» ящиков, а также расширить кругозор относительно названий и содержания основных документов по основным областям интересов[6].
В дальнейшем вы можете использовать любой табличный редактор (например, Coda) для того, чтобы описывать на верхнем уровне свой проект и системы, которые в нем задействованы. Однако для предметного моделирования и создания соответствующих документов для ролевых интересов необходимо использовать прикладные теории и инструменты[7]. Например, CAD, 1C, PDM (Product Data Management)[8], CRM (customer relationship management)[9] и множество других.
В рамках нашего курса вы узнаете о том, какие типы документов могут быть и на какие предметы интересов они отвечают, как они связаны между собой и какими методами описаний создаются. Однако, в рамках курса[10] вы не будете изучать и создавать конкретные документы с моделями и описаниями. Например, мы будем говорить о документах, которые описывают целевую аудиторию или проектные роли, также будем говорить о концепции использования и архитектуре, но для разработки конкретных экземпляров данных документов вам будет необходимо изучить соответствующие прикладные практики (методы описаний).
Обычно в команде проекта или предприятия существуют специалисты по прикладным методам (маркетологи, архитекторы, продакт-оунеры и т.п.), которые специализируются на разработке определенных документов с описаниями различных предметов интересов. Задача нашего курса — понять, что на все эти документы можно смотреть одинаковым образом[11] и увидеть их взаимосвязь, а для этого необходимо для начала овладеть системным языком. То есть знать соответствующие понятия системного моделирования.
Для верхнеуровневого моделирования, в котором описываются все важные системы и подсистемы, а также их взаимосвязь. ↩︎
Для более детального (предметного, прикладного) проектирования, в том числе создания конструкторской и технологической документации. ↩︎
С одной стороны, моделер — тоже экзокортекс, но и результат моделирования считается экзокортексом. Это такая аналогия с мозгом, который проводит размышления, а потом появляется результат, который также содержится в мозге. Но мы будем считать, что документация – это не биологический мозг, а бумажные или компьютерные модели, к которым может иметь доступ не только их разработчик. ↩︎
Содержание документации – это описания, и они определяются предметами интересов проектных ролей к системе. ↩︎
Название и краткое описание (например, функцию, устройство и т.п.). ↩︎
Например, необходимо знать, что за документы «Концепция использования» и «Концепция системы», а также чем они отличаются от «Бухгалтерского баланса» или от «Описания целевой аудитории». ↩︎
Их требуется изучать отдельно. Например, для составления документа бухгалтерский баланс (как ответ на предмет интересов – налоги) потребуется изучать теорию бухгалтерского учета и освоить инструмент (например, 1С). ↩︎
Система управления данными об изделии или система версионирования продукта. ↩︎
CRM содержит базы данных, описывающие клиентуру как целую систему в физическом мире, а части клиентуры — это отдельные клиенты. ↩︎
И даже в рамках курса системного мышления. ↩︎
Например, видеть роли, которые их создают, и понимать с помощью каких методов. Или обращать внимание на проектные роли, которым будет адресоваться созданная документация. ↩︎