Răsfoiți Sursa

Добавление куба выживания

SVI 2 săptămâni în urmă
părinte
comite
ea452c17e3
1 a modificat fișierele cu 92 adăugiri și 1 ștergeri
  1. 92 1
      doc/cube-survival.md

+ 92 - 1
doc/cube-survival.md

@@ -1,2 +1,93 @@
-# Куб выживания
+# 📐 Куб выживания (The Survival Cube)
 
+«Куб выживания» — это первый и главный графический артефакт **AfRel**. Он служит для стратегического позиционирования: показывает, где система находится сейчас и куда она должна прийти с точки зрения ресурсных ограничений.
+
+## Назначение
+
+Куб выживания — это трёхмерная система координат для описания состояния системы и её целей.
+
+Он позволяет:
+
+* Зафиксировать текущее состояние системы в измеримых величинах.
+* Определить целевое состояние как вектор (или траекторию) движения.
+* Визуализировать стратегию выживания: сжатие, расширение, улучшение качества или их комбинации.
+
+## Оси координат
+
+### X: Количество (Scale, Volume)
+
+* число обслуживаемых сущностей (пользователи, сервисы, запросы, контракты).
+* Единицы: штуки, **RPS**, строки кода, количество модулей.
+* Может быть сжатием (уменьшение X) или расширением (увеличение X).
+
+### Y: Качество (Quality, Density)
+
+* эффективность на единицу количества.
+* Единицы: `latency` (мс),  `throughput` (**RPS**),  `availability` (%),  `error rate` (%),  `MTBF` .
+* Повышение Y = улучшение свойств, понижение Y = деградация.
+
+### Z: Ресурсы/Деньги (Resources/Money)
+
+* стоимость достижения цели или поддержания состояния.
+* Единицы: доллары, человеко-часы, затраты на облако, **ROI**.
+* Отрицательный Z (убыток, инвестиции) допустим, но требует плана возврата.
+
+## Точки и векторы
+
+* Текущая точка A=(X_cur, Y_cur, Z_cur) — состояние до начала работ.
+* Целевая точка B=(X_targ, Y_targ, Z_targ) — желаемое состояние.
+* Вектор AB — стратегия движения.
+
+Примеры векторов:
+
+* Сжатие с качеством:
+  + ΔX<0, (меньше количество)
+  + ΔY>0, (выше качество)
+  + ΔZ<0 (в моменте тратим ресурсы, чтобы сжать и улучшить).
+* Экстенсивное расширение:
+  + ΔX>0, (количество растёт)
+  + ΔY<0, (качество падает)
+  + ΔZ<0 (в моменте растём количеством с ускорением).
+* Инвестиции в качество при стабильном масштабе:
+  + ΔX=0, (количество прежнее)
+  + ΔY>0, (качество растёт)
+  + ΔZ<0 (улучшаем, тратя ресурсы в моменте).
+
+1. Недопустимые и опасные области
+    X < 0 в абсолютном значении невозможно (не бывает отрицательного числа сервисов).
+    Однако относительное изменение ΔXΔX может быть отрицательным (сжатие).
+
+    Z < 0 (убыток) допустимо временно, но требует явного плана возврата к Z≥0Z≥0.
+
+    X = 0 означает отсутствие сущностей (например, процесс не обслуживает ни одного клиента) — допустимо как временное состояние (миграция, ночной простой), но постоянное X = 0 означает смерть процесса.
+
+    Падение Y ниже минимально допустимого SLA — нежизнеспособное состояние.
+
+2. Графическое представление
+    Куб с подписанными осями X, Y, Z.
+
+    Точка A (текущее состояние) — красный маркер.
+
+    Точка B (целевое состояние) — зелёный маркер.
+
+    Вектор / траектория — стрелка или ломаная линия (если путь не прямой).
+
+    Пояснительная записка к каждому кубу обязательна (ссылается на артефакт 1b).
+
+3. Пример (для цели 1b — сжатие с качеством)
+    Текущая точка A:
+    X=10X=10 сервисов, Y=200Y=200 мс (latency), Z=500kZ=500k $/год (затраты).
+
+    Целевая точка B:
+    X=3X=3 сервиса, Y=100Y=100 мс, Z=350kZ=350k $/год.
+
+    Вектор:
+    ΔX=−7ΔX=−7, ΔY=−100ΔY=−100 мс, ΔZ=−150kΔZ=−150k $/год (экономия).
+
+На кубе это изображается как диагональ вниз-влево-вперёд (если Z — вертикальная ось, направленная вверх для улучшения, то экономия — движение вниз по Z).
+7. Связь с артефактами YAML
+    Поля targ.x, targ.y, targ.z артефакта 1b содержат числовые значения current и target.
+
+    Раздел check позволяет верифицировать, достигнуты ли целевые координаты.
+
+    Куб выживания не заменяет YAML, а визуализирует его.