DDD Model definition - image sources

.github/workflows/pull_request.yml

@@ -8,11 +8,11 @@ jobs:
     runs-on: ubuntu-22.04
 
     steps:
-    - uses: actions/checkout@v1
+    - uses: actions/checkout@v4
       with:
         fetch-depth: 0
     - name: Set up Python
-      uses: actions/setup-python@v1
+      uses: actions/setup-python@v5
       with:
         python-version: 3.10.13
     - name: Install dependencies

.github/workflows/simple.yml

@@ -10,11 +10,11 @@ jobs:
     runs-on: ubuntu-22.04
 
     steps:
-    - uses: actions/checkout@v1
+    - uses: actions/checkout@v4
       with:
         fetch-depth: 0
     - name: Set up Python
-      uses: actions/setup-python@v1
+      uses: actions/setup-python@v5
       with:
         python-version: 3.10.13
     - name: Install dependencies

README.rst

@@ -212,7 +212,7 @@ Sphinx-doc предоставляет и тегирование/индексир
 #. Если не установлен Python, то `установите его <https://docs.python.org/3/installing/index.html>`__.
 #. Установите зависимости. Для этого, из корневой директории проекта выполните команду: ``pip install -r requirements.freeze.txt``
 #. Отредактируйте файл conf.py, подробности смотрите в `документации <https://www.sphinx-doc.org/en/master/usage/configuration.html>`__.
-#. Произведите сборку: ``make html`` или ``sphinx-build -D language=ru -b html . _build`` или ``docker build -t sphinx_image . && docker run -v $(pwd):/sphinxtechnicalwriting sphinx_image make html``
+#. Произведите сборку: ``make html`` или ``sphinx-build -D language=ru -b html . _build`` или ``docker build -t sphinx_image . && docker run -v $(pwd):/sphinxtechnicalwriting sphinx_image sphinx-build -D language=ru -b html . _build``
 #. Локальный запуск: ``python -m http.server``
 #. Подробнее `здесь <https://www.sphinx-doc.org/en/master/usage/quickstart.html>`__.
 

stanislav.bolsun/it/ddd/domain-model/system-complexity.rst

@@ -0,0 +1,30 @@
+:canonical-base-url: https://dckms.github.io/system-architecture
+
+.. index:: Domain Model
+   :name: stanislav3316-system-complexity
+
+
+=============================
+Сложность как свойство систем
+=============================
+
+.. sectionauthor:: Stanislav Bolsun
+
+Предельная сложность для понимания
+----------------------------------
+
+    💬 Одним из важнейших интеллектуальных процессов человека и проектировщика в особенности является понимание. Понимание конструкционно по своей природе. Это значит, что в процессе понимания мы соединяем различные частицы информации друг с другом при помощи особых связей, как если бы мы достраивали конструкцию. Мы соединяем те куски информации, что подходят друг к другу ближе по смыслу и углубляют понимание. Соединяем то, что вытекает одно из другого как причина и следствие. Стягивая связями подобные информационные отрывки друг с другом, мы получаем конструкцию, имеющую тот или иной смысл для нас. Смысл и является продуктом понимания.
+
+    Так как понимание является в своей сути соединением элементов, то затруднение в понимании сложных систем связано обычно с объёмом элементов и связей, которые нужно удерживать в фокусе внимания или, говоря образно, необходимо «запихнуть в одну голову».
+
+        💬 "У меня когда-то был разговор с одним очень известным человеком (не буду называть фамилию), который во время аварийной ситуации вручную вывел [атомный] реактор из закритического состояния. Много времени прошло, это уже пожилой человек с орденами и медалями. Я спрашиваю: «Как?» Он ответил: «Я моделировал в голове, что происходит с реактором». Так вот, сейчас нет человека, который может смоделировать в голове, что происходит в сложной системе. Технические системы по степени своей сложности вышли за пределы интуиции инженеров-конструкторов. [П. Г. Шедровицкий, 2018]"
+
+        -- "Пётр Щедровицкий, философ, методолог, общественный деятель"
+
+    Вероятно для каждого отдельного человека существует некоторая предельная сложность, которую он способен воспринять или удержать в моменте, конструируя собственную овнутрённую, то есть находящуюся только в его уме, модель системы. У всех этот предел разный, но у любого проектирующего с повышением сложности системы с некоторого момента начинает не хватать когнитивных способностей справиться с ней. Обычно так и говорят: не вмещается в голову. При этом в современном мире наблюдаем отчётливый тренд на повышение сложности систем. Напрашивается вывод: инструменты управления сложностью лучше внедрять с самого начала проектирования.
+
+    ...
+
+    -- "Управление знаниями в продукте", https://ashapiro.ru/articles/system-episteme
+
+.. seealso:: Согласно закономерности `Магического числа семь плюс-минус два <https://en.wikipedia.org/wiki/The_Magical_Number_Seven,_Plus_or_Minus_Two>`__, обнаруженной американским учёным-психологом Джорджем Миллером, кратковременная человеческая память, как правило, не может запомнить и повторить более 7 ± 2 элементов.