Версия: 2.0.0
Дата: 2025-11-25
Статус: Фундамент
Вытекает из: ../theory/01_LAWS.md (Закон 1: Дуальность)
Этот документ — корень методологии нашей системы. Он применяет универсальный Закон Дуальности из теории систем: любую систему можно рассматривать с двух перспектив, и обе необходимы для полного понимания.
ТЕОРИЯ СИСТЕМ (THEORY_OF_SYSTEMS.md)
│
│ Закон 1: Дуальность
│ Закон 2: Иерархичность
│ Закон 3: Каскадность
│ ...
│
└──► META.md (этот документ)
│
│ Применение Закона 1 к нашей системе
│
└──► Остальные документы concept/
┌─────────────────────────────────────────────────────────────────────────┐
│ │
│ ЛЮБАЯ СИСТЕМА │
│ │ │
│ ┌───────────────┴───────────────┐ │
│ │ │ │
│ ▼ ▼ │
│ │
│ ┌─────────────────────────┐ ┌─────────────────────────┐ │
│ │ │ │ │ │
│ │ ПЕРСПЕКТИВА 1 │ │ ПЕРСПЕКТИВА 2 │ │
│ │ МЕТОДОЛОГИЯ │ │ СТРУКТУРА │ │
│ │ │ │ │ │
│ │ КАК строить? │ │ ЧТО получается? │ │
│ │ (процесс создания) │ │ (результат) │ │
│ │ │ │ │ │
│ └─────────────────────────┘ └─────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
Вопрос: Как строить систему?
Ответ: Через уровни абстракции — от общего к частному.
УРОВНИ АБСТРАКЦИИ (методология)
════════════════════════════════════════════════════════
У0: КОНЦЕПЦИЯ ← Идеи, принципы
│ Не зависит от технологий
│ Не меняется
▼
У1: СТАНДАРТЫ ← Правила, термины
│ Редко меняется
▼
У2: ПАТТЕРНЫ ← Решения типовых задач
│ Растёт со временем
▼
У3: ШАБЛОНЫ ← Готовые заготовки
│ Активно используется
▼
У4: РЕАЛИЗАЦИЯ ← Код, конфиги, данные
Постоянно меняется
Применение: Когда создаём что-то новое — идём сверху вниз.
Документы:
- PHILOSOPHY.md — принципы построения
- SKELETON.md — 8 вопросов полноты
- GLOSSARY.md — термины
Вопрос: Что получается в результате?
Ответ: Иерархия с явными зависимостями — каждый уровень создаётся на основе предыдущих.
УРОВНИ СТРУКТУРЫ (результат)
════════════════════════════════════════════════════════════════════════
У0: КОНЦЕПЦИЯ (+ Стандарты)
│
│ определяет правила для всех уровней ниже
│ architect/concept/, architect/standards/
│
├────────────────────────────────────────────────────────────┐
│ │
▼ │
У1: УПРАВЛЕНИЕ ПЛАТФОРМОЙ │
│ на основе концепции │
│ architect/, platform-v1/ │
│ │
├───────────────────┐ │
│ │ │
▼ ▼ │
У2: УПРАВЛЕНИЕ У2: КОМПОНЕНТЫ │
ПРОЕКТАМИ созданы по концепции │
│ на основе данных из У1 │
│ (модули, агенты, интеграции) │
│ system/, templates/ │
│ │
│ создано У1, на основе У0 │
│ │
▼ │
У3: ПРИЛОЖЕНИЯ ◄─────────────────────────────────────────────────┘
созданы по концепции (У0)
управлением проектами (У2)
с использованием компонентов (У2)
projects/, infra/
Ключевое: Концепция (У0) влияет на ВСЕ уровни напрямую — сквозная зависимость.
Применение: Когда ищем где что лежит — смотрим структуру.
Документы:
- SYSTEM_HIERARCHY.md — иерархия компонентов
- TAXONOMY.md — классификация проектов
- FILESYSTEM.md — правила файлов (в standards/)
МЕТОДОЛОГИЯ определяет СТРУКТУРА организует
КАК создавать ГДЕ хранить
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
У0 Концепция ───────────► architect/concept/
У1 Стандарты ───────────► architect/standards/
У2 Паттерны ───────────► architect/patterns/
У3 Шаблоны ───────────► platform/templates/
У4 Реализация ───────────► projects/*/solution/
Правило: Методология (П1) определяет что создавать, Структура (П2) определяет где размещать.
Эта система документации — сама является системой. Применяем обе перспективы:
У0 Концепция: META.md, PHILOSOPHY.md
У1 Стандарты: GLOSSARY.md, FILESYSTEM.md
У2 Паттерны: (будут добавлены)
У3 Шаблоны: project.yaml.tmpl
У4 Реализация: Конкретные проекты
У0 Концепция: architect/concept/, architect/standards/
У1 Упр. платформой: architect/, platform-v1/
У2 Упр. проектами: (процесс)
У2 Компоненты: system/, templates/
У3 Приложения: projects/, infra/
| Задача | Перспектива | Смотреть |
|---|---|---|
| Создать новый документ | П1 Методология | Какой уровень абстракции? |
| Найти документ | П2 Структура | В какой папке? |
| Понять зависимости | П1 Методология | Что от чего зависит? |
| Организовать файлы | П2 Структура | Куда положить? |
| Изменить принципы | П1 Методология | Каскадные изменения вниз |
| Добавить проект | П2 Структура | projects/{name}/ |
Применяем Закон 3 из теории систем:
╔═══════════════════════════════════════════════════════════════════════╗
║ ║
║ КАСКАДНОСТЬ: Каждый уровень ║
║ ║
║ 1. ВКЛЮЧАЕТ всё от предыдущего (наследование) ║
║ 2. ДОБАВЛЯЕТ своё (расширение) ║
║ 3. НЕ ПРОТИВОРЕЧИТ предыдущему ║
║ ║
╚═══════════════════════════════════════════════════════════════════════╝
Поэтому каждый документ указывает "Вытекает из:" — явная трассируемость.
concept/
│
├── THEORY_OF_SYSTEMS.md ← ТЕОРИЯ (над всем)
│ │
│ └── 6 универсальных законов систем
│
├── META.md ← Этот документ (применение Закона 1)
│ │
│ ├── Две перспективы (Дуальность)
│ └── Связывает всё остальное
│
├── PHILOSOPHY.md ← Принципы (Закон 2: Иерархичность)
│ │
│ └── DRY, KISS, YAGNI, иерархия, рекурсия
│
├── SKELETON.md ← 8 вопросов (Закон 5: Полнота описания)
│ │
│ └── ЗАЧЕМ, ЧТО, КАК, КТО, ЧЕМ, ГДЕ, КОГДА, СКОЛЬКО
│
├── TAXONOMY.md ← 8 срезов классификации
│ │
│ └── Домен, Функция, Цикл, Сложность, Среда, Акторы, Результат, Метод
│
├── UNIVERSAL_SYSTEM.md ← 8 аналитических срезов (Закон 6: Срезы)
│ │
│ └── Структура, Функции, Процессы, Роли, Технологии, Данные, Время, Место
│
├── GLOSSARY.md ← Термины и определения
│ │
│ └── Единый словарь системы
│
├── SYSTEM_HIERARCHY.md ← Структура workspace (Перспектива 2)
│ │
│ └── У0 → У1 → У2 → У3
│
└── BOOTSTRAP.md ← Процесс развёртывания (Перспектива 1)
│
└── 21 шаг создания системы
| Версия | Дата | Изменения |
|---|---|---|
| 2.0.0 | 2025-11-25 | Добавлена связь с THEORY_OF_SYSTEMS.md, каскадность |
| 1.1.0 | 2025-11-25 | Исправлена Перспектива 2: 4 уровня с зависимостями |
| 1.0.0 | 2025-11-25 | Первая версия |
Статус: Фундамент — применение теории систем к нашей системе