Руководтсво Рациональная работа. Стажировка по упражнению 6.2. Ход выполнения и вопросы

:pushpin:Задание:

Возьмите один из физических объектов вашей предметной области, и опишите его разбиение на части. Если выбранные вами ранее объекты недостаточно сложны – подберите какой-то другой индивидуальный объект, устройство которого вам немного знакомо. Постарайтесь сделать дерево глубиной хотя бы в три уровня.

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

:memo:Выполнение

Для выполнения описания дерева выбрал метод Разбиения. В тренажере предлагается выполнить модель в виде таблицы. Я выполнил модель разбиения в виде таблицы и пернес в тренажер.

  • Застрял на стажировке 6.2 [[Курс. Рациональная работа]] (Aisystant): инвестировано уже 3 помидорки на одно упражнение.
    • Начал делать упражнение по декомпозиции “часть - целое” индивидуальных объектов сначала в таблице для того, чтобы потом перенести в онлайн тренажер руководства
    • Сделал часть работы, потом нужно было чуть сдвинуть одну ветку (схлопнуть или наоборот расширить) и понял, что это крайне неудобно. По крайней мере в том инструменте которым пользуюсь я: Ексель или обсидиан
    • Перенес всю ветку в текст аутлайном. Аутлайном гораздо удобнее редактировать: можно переносить целые ветки разбиений в секунды. Хотя наглядность по уровням лучше в табличной форме
    • После того как перенес в аутлайн расписал довольно подробно разбиение практически всех конструктивных частей индивидуального объекта “Путепровод автодорожный 400 метров через железную дорогу на участке ул. Святого Александра на ПК8050 - ПК8054”. Но потом оглядевшись понял, что наверное я все таки смешал функции и модули. Тут нужна подсказка Анны @annlub902gmail-com

Дерево композиции “часть-целое” методом разбиение табличным моделированием:

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

Дерево композиции “часть-целое” методом разбиение моделированием аутлайном:

  • Путепровод автодорожный 400 метров через железную дорогу на участке ул. Святого Александра на ПК8050 - ПК8054
    • Мостовое полотно
      • Проезжая часть для автомобилей из асфальтобетона
        • Выравнивающее основание ж.б.
          • Арматурная сетка периодического профиля А300 по ГОСТ
          • Бетон B20 F300 W200
        • Покрытие проезжей части из щебеночно мастичного асфальтобетона по ГОСТ
          • Заполнители природные
            • Щебень фракции 5 - 10 мм
            • Песок
          • Минеральный порошок
          • Вяжущее битум
      • Прохожая части для пешеходов, велосипедистов и маломобильных
        • Слой асфальтобетона тип Тип Б толщиной 50 мм
        • Слой асфальтобетона тип Тип Б толщиной 40 мм
      • Элементы благоустройства
        • Ограждение безопасности типа трансбарьер
        • Перильное ограждение
        • Наружное освещение мостового сооружения
          • Наружное освещение проезжей части
          • Наружное освещение прохожей части
        • Шумозащитные экраны
      • Тех средства организации дорожного движения
        • Разметка и знаки для автомобилей
        • Разметка и знаки для пешеходов
        • Разметка и знаки для маломобильных
        • Разметка и знаки для велосипедистов
    • Пролетное строение
    • Кабельные каналы и технологические эстакады для инженерных сетей обслуживания путепровода
    • Кабельные каналы и технологические эстакады для пропуска транзита инженерных сетей
    • Опоры пролетного строения путепровода
      • Опоры крайние
        • Опора крайняя 1
          • Фундаментная часть опоры 1
            • Грунтовый массив свайного основания опоры 1
            • Свайное основание опоры 1
            • Ростверк свайного основания опоры 1
          • Стойка (или стена) опоры 1
          • Насадка опоры 1
          • Шкафная стенка опоры 1
        • Опора крайняя 4
          • Фундаментная часть опоры 4
            • Грунтовый массив свайного основания опоры 4
            • Свайное основание опоры 4
            • Ростверк свайного основания опоры 4
          • Стойка опоры 4
          • Насадка опоры 4
          • Шкафная стенка опоры 4
      • Опоры промежуточные
        • Опора промежуточная 2
          • Фундаментная часть опоры 2
            • Грунтовый массив свайного основания опоры 2
            • Свайное основание опоры 2
            • Ростверк свайного основания опоры 2
          • Стойка опоры 2
          • Насадка опоры 2
        • Опора промежуточная 3
          • Фундаментная часть опоры 3
            • Грунтовый массив свайного основания опоры 3
            • Свайное основание опоры 3
            • Ростверк свайного основания опоры 3
          • Стойка опоры 3
          • Насадка опоры 3
    • Сопряжение с автодорогой
      • Участок сопряжения с земляным полотном и проезжей частью автодороги №1 на ПК8050
      • Участок сопряжения с земляным полотном и проезжей частью автодороги №2 на ПК8050

:yellow_circle:Сейчас я веду паспорт проекта в обсидиане:

  • используя системную схему проекта по областям внимания основных альф
  • с последующим формированием контрольных событий проекта (чек-листа) и синтезом (уместно ли тут так говорить?) из модулей (артефакты) с помощью плагина датавью с выводом в таблички

:world_map:Системная схема проекта

:triangular_flag:Контрольные события из Альф и Подальф

:clipboard:Артефакты

:red_question_mark:Вопросы

Аутлайн для меня очень удобен моделирования описания функционального разбиения “часть - целое”. А вот синтез из модулей/конструктивов уже будет с помощью плагина датавью сводом в табличной форме.

Вопрос у меня тут такой:

  • Насколько в будущем будет удобно моделировать проекты в обсидиане для наведения и удержания внимания на модели проекта и собственного понимания, чтобы потом нарезать задачи команде или есть смысл делать как-то пусть даже не так удобно мне лично, но в каких-то инстументах максимально доступных для команды?
  • А какие есть инструменты под эти задачи: декомпозиции “часть-целое” ЦС на подсистемы с последующим модульным синтезом? В ексель наверное это делать можно, внесение корректировок в большие системные схемы наерное крайне затруднительно…

Предлагаю попробовать под Ваши задачи, но не настаиваю на сём.

Главное

М.б. Вам зайдёт LaTeX? Пробовали?

Пояснение

LaTeX — это не замена Obsidian для ежедневной работы. Это следующий шаг, который решает именно те проблемы (гибкость редактирования + наглядность), которые, кмк, Вы описали выше…

Если только я верно понял, Вам нужен финальный, качественный и легко поддерживаемый графический документ (?)

Обоснование

Проблема

Пусть есть проблема "неудобство редактирования иерархических структур («дерево часть-целое»).

Тогда:

  • таблицы Excel и их аналоги — наглядны, но крайне негибки. Перемещение ветки — это боль.

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

LaTeX, кмк, решает эту дилемму, потому что он разделяет содержание (структуру) и представление (внешний вид). Вы описываете логику вложенности, а LaTeX “заботится” о том, чтобы красиво и правильно это нарисовать. Если Вы меняете логику в коде — рисунок перестраивается автоматически.


“Чиста канкретный кейс” (ЧКС) —

Дисклеймер: ЧКС неверифицированный, порождён А2Тцкай-влажными и LLMски-силиконовыми фантазиями.

Приводится в качестве “наглядного пособия” — исключительно как иллюстрация.

Визуализация декомпозиции путепровода

Рискну решить вымышленную задачу, создав наглядную и легко редактируемую схему дерева «часть-целое» для путепровода.

“Передаю слово” LLM:

(текущая редакция текста покритикована AI — точность ответа 9 из 10)

Мы будем использовать LaTeX и специальный пакет для рисования деревьев под названием forest. Он идеально подходит для этой задачи, так как его синтаксис сам похож на дерево.

Цель — получить графическую схему, которую так же легко редактировать, как текстовый аутлайн.

Шаг 1: Описываем структуру в коде LaTeX

Представим, что вместо списка с маркерами мы описываем структуру в квадратных скобках. Каждая открывающая скобка — это начало новой ветки.

Вот как будет выглядеть фрагмент нашей декомпозиции, записанный для LaTeX:

% Это "шапка" документа, ее достаточно написать один раз
\documentclass{article}
\usepackage[utf8]{inputenc} % Поддержка русского языка
\usepackage[T2A]{fontenc}
\usepackage[russian]{babel}
\usepackage{geometry} % Для управления полями страницы
\geometry{a4paper, margin=1in}

\usepackage{forest} % Подключаем тот самый пакет для рисования деревьев

\begin{document}

% А вот и наша схема. Каждая вложенная скобка [] -- это дочерний элемент.
\begin{forest}
  for tree={
    grow=east,            % Дерево будет расти слева направо
    forked edges,         % Аккуратные "вилочные" соединения
    edge={-latex},        % Стрелочки на концах линий
    l sep=20pt,           % Расстояние между уровнями
    s sep=10pt,           % Расстояние между братьями
    text width=5cm,       % Ширина блока для текста
    anchor=west,          % Выравнивание
  }
  [Путепровод автодорожный...
    [Мостовое полотно
      [Проезжая часть для автомобилей...
        [Выравнивающее основание ж.б.]
        [Покрытие из асфальтобетона...]
      ]
      [Прохожая часть для пешеходов...]
      [Элементы благоустройства
        [Ограждение безопасности]
        [Наружное освещение]
      ]
    ]
    [Опоры пролетного строения
      [Опоры крайние
        [Опора крайняя 1
            [Фундаментная часть]
            [Стойка опоры]
        ]
        [Опора крайняя 4]
      ]
      [Опоры промежуточные
        [Опора промежуточная 2]
        [Опора промежуточная 3]
      ]
    ]
    [Сопряжение с автодорогой]
  ]
\end{forest}

\end{document}

Шаг 2: Результат

После “компиляции” этого кода (это один клик в любом редакторе LaTeX) мы получим не текст, а вот такую идеально выровненную графическую схему:

                                         +--------------------------+
                               +---------+ Выравнивающее основание  |
                               |         +--------------------------+
                  +------------+
+-----------------+ Проезжая   |         +--------------------------+
| Мостовое        | часть...   +---------+ Покрытие из асфальтобетона|
| полотно         +------------+         +--------------------------+
|                 |
|                 +------------+
+-----------------+ Прохожая   |
|                 | часть...   |
|                 +------------+
|                 |
|                 +------------+         +--------------------------+
|                 | Элементы   +---------+ Ограждение безопасности  |
|                 | благоустр. |         +--------------------------+
|                 +------------+
|                              |         +--------------------------+
|                              +---------+ Наружное освещение       |
|                                        +--------------------------+
|
+--------------------------------+
| Путепровод                     |
| автодорожный...                |
+--------------------------------+
|
|                 +------------+         +--------------------------+
|                 | Опоры      +---------+ Опора крайняя 1          |
|                 | крайние    |         +--------------------------+
|                 +------------+
|                              |         +--------------------------+
|                              +---------+ Опора крайняя 4          |
|                                        +--------------------------+
+-----------------+
| Опоры           +------------+         +--------------------------+
| пролетного      | Опоры      +---------+ Опора промежуточная 2    |
| строения        | промежут.  |         +--------------------------+
|                 +------------+
|                              |         +--------------------------+
|                              +---------+ Опора промежуточная 3    |
|                                        +--------------------------+
+-----------------+
|
+-----------------+
| Сопряжение с    |
| автодорогой     |
+-----------------+

(Это ASCII-арт для иллюстрации, реальный результат в PDF будет выглядеть как качественная векторная графика).

Шаг 3: В чём существенное преимущество?

Теперь вернемся к вопросам:

  1. Проблема с таблицами? — Представим, что нужно сделать «Опоры» частью «Мостового полотна». В Excel нам пришлось бы вырезать и вставлять десятки ячеек, рискуя нарушить всю структуру. В LaTeX — Вы просто вырезаете и вставляете блок текста [Опоры пролетного строения [...]] внутрь скобок [Мостовое полотно [...]]. Всё. Диаграмма перерисуется сама автоматически.

  2. Проблема с аутлайном? — Мы получаем и лёгкость редактирования текста, и отличную наглядность полноценной схемы. Мы работаем с кодом, который так же удобен, как и аутлайн в Obsidian, но на выходе получаем профессиональную диаграмму, а не просто список с отступами.


Ответы на Ваши вопросы с учетом LaTeX, если я правильно понял исходный посыл статьи.

  1. Насколько в будущем будет удобно моделировать проекты в обсидиане… или есть смысл делать… в каких-то инстументах максимально доступных для команды?

Obsidian/Markdown — хорош для ежедневной работы, ведения заметок, набросков (как ваш аутлайн). Его главное преимущество — низкий порог входа и скорость.

LaTeX — это инструмент для финализации и формализации. Когда Ваша модель устоялась и Вам нужно создать из нее формальный документ (отчет, часть проектной документации, статью), Вы переносите структуру в LaTeX и получаете, возможно, лучший (?) результат.

Рабочий процесс мог бы выглядеть так:

  1. Вы ведете ежедневные заметки, набрасываете и меняете структуру в Obsidian (я так понял, что Вы так и делаете).

  2. Когда нужно зафиксировать версию модели или поделиться ей в виде формального документа, Вы копируете аутлайн и быстро адаптируете его под синтаксис forest в LaTeX.

  3. Вы делитесь с командой не кодом LaTeX, а итоговым PDF-файлом, который понятен абсолютно всем.

  1. А какие есть инструменты под эти задачи: декомпозиции “часть-целое” ЦС на подсистемы с последующим модульным синтезом?
  • Для быстрой декомпозиции и совместной работы: возможно, Вам пригодятся:
    • Miro (?),
    • XMind (?),
    • Coggle (?).
      • Это онлайн-доски и ментальные карты. Они визуальны и интерактивны, но могут быть менее строгими и формальными.
  • Для формального инженерного моделирования:

    • SysML/UML-редакторы типа:
      • Cameo Systems Modeler (?),
      • Enterprise Architect (?).
        • Это тяжелая артиллерия для системной инженерии. Порог входа очень высокий.
  • Компромисс (Возможно, Ваш случай?) — текстовые инструменты для описания диаграмм. LaTeX с пакетом forest/TikZ — в этой категории для академического и инженерного мира. Аналоги для программистов — Graphviz (DOT language), PlantUML, Mermaid.js (кстати, Mermaid поддерживается в Obsidian!). Они позволяют описывать диаграммы текстом и получать картинку.

2 лайка

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

Про Майн карты вряд ли. Пользовался MindJet одно время. Но опять таки не самый доступный и распространенный инструмент.
Но как вариант, да.

Да, согласен. “А2Тцки сложно” :innocent: — см. мой текст “глазами” LLM. Суть: от читателя требуются некоторые усилия.

Но я, в некотором смысле, верю в разум людей. И надеюсь, что Вы сдюжете. Или найдёте нечто менее сложное под себя…

В качестве универсального инструмента для работы со структурированным текстом (маркированные списки), чек-листы, задачи с произвольным жизненным циклом, могу порекомендовать редактор emacs с режимом org-mode (документация с описанием возможностей режима 300+ страниц текста).
На нем можно настроить автоматизацию, PIM, скрипты, макросы.
Но это требует хорошего инвестирования времени в изучение:

  • самого редактора,
  • режима работы,
  • и быстрой печати (опционально).
    Надо сильно проникнуться и захотеть обуздать этот софт.
    Зато результатом можно будет пользоваться до конца жизни.