architect/_archive/2025-11-28-concept-v1/SYSTEM_HIERARCHY.md

ИЕРАРХИЯ СИСТЕМЫ: Структура workspace

Версия: 2.0.0
Дата: 2025-11-25
Статус: Фундамент

Вытекает из: META.md → Перспектива 2: Структура


ПРИНЦИПЫ

  1. Нижний уровень не противоречит верхнему
  2. Каждый уровень создаётся на основе предыдущих
  3. Концепция (У0) влияет на ВСЕ уровни напрямую — сквозная зависимость
  4. Роли привязаны к уровням

ИЕРАРХИЯ

═══════════════════════════════════════════════════════════════════════════════
УРОВЕНЬ 0: КОНЦЕПЦИЯ (+ Стандарты)
═══════════════════════════════════════════════════════════════════════════════

    ФУНДАМЕНТ
    ├── Универсальные принципы (не зависят ни от чего)
    ├── Стандарты (правила, термины)
    └── Определяет правила для ВСЕХ уровней ниже

    📁 architect/concept/
    📁 architect/standards/

           │
           │ определяет правила
           ├──────────────────────────────────────────────────────────┐
           ▼                                                          │
                                                                      │
═══════════════════════════════════════════════════════════════════════════════
УРОВЕНЬ 1: УПРАВЛЕНИЕ ПЛАТФОРМОЙ
═══════════════════════════════════════════════════════════════════════════════

    ПЛАТФОРМА
    ├── Развитие методологии
    ├── Паттерны и шаблоны
    └── На основе концепции (У0)

    📁 architect/patterns/
    📁 architect/templates/
    📁 platform-v1/

           │
           │ создаёт инструменты
           ├───────────────────┐                                      │
           ▼                   ▼                                      │
                                                                      │
═══════════════════════════════════════════════════════════════════════════════
УРОВЕНЬ 2: УПРАВЛЕНИЕ ПРОЕКТАМИ + КОМПОНЕНТЫ (параллельно)
═══════════════════════════════════════════════════════════════════════════════

    УПРАВЛЕНИЕ ПРОЕКТАМИ          КОМПОНЕНТЫ
    ┌────────────────────┐        ┌────────────────────┐
    │ • Ведение проектов │        │ • Модули           │
    │ • Документация     │        │ • Агенты           │
    │ • Задачи           │        │ • Интеграции       │
    │                    │        │                    │
    │ На основе:         │        │ На основе:         │
    │ • Концепции (У0)   │        │ • Концепции (У0)   │
    │ • Платформы (У1)   │        │ • Платформы (У1)   │
    └────────────────────┘        └────────────────────┘

    (процесс)                     📁 system/
                                  📁 templates/

           │                               │                          │
           │ создаёт приложения            │ используются в           │
           └───────────────┬───────────────┘                          │
                           ▼                                          │
                                                                      │
═══════════════════════════════════════════════════════════════════════════════
УРОВЕНЬ 3: ПРИЛОЖЕНИЯ
═══════════════════════════════════════════════════════════════════════════════

    ПРИЛОЖЕНИЕ ◄──────────────────────────────────────────────────────┘
    ┌─────────────────────────────────────────────────────────────────┐
    │                    на основе концепции (У0)                     │
    │                                                                 │
    │  ДОКУМЕНТЫ           AI-КОНТЕКСТ         КОД                    │
    │  ┌──────────────┐    ┌──────────────┐   ┌──────────────┐       │
    │  │ PROJECT.md   │    │ CLAUDE.md    │   │ Модули       │       │
    │  │ Спецификации │───▶│ Контекст     │──▶│ Страницы     │       │
    │  │ TODO.md      │    │ Инструкции   │   │ API          │       │
    │  │ CHANGELOG.md │    │              │   │ Тесты        │       │
    │  └──────────────┘    └──────────────┘   └──────────────┘       │
    │                                                                 │
    └─────────────────────────────────────────────────────────────────┘

    📁 projects/{name}/
    📁 infra/{name}/

РОЛИ

Уровень Роль Ответственность
У0 Задаётся один раз, редко меняется
У1 АРХИТЕКТОР Развивает платформу, создаёт паттерны
У2 ПРОЕКТОР Ведёт проекты, пишет документы
У2 ИНТЕГРАТОР Создаёт компоненты, агенты
У3 КОДЕР Пишет код приложений
У3 ИНФРА Управляет серверами

ФАЙЛОВАЯ СТРУКТУРА

/opt/claude-workspace/
│
├── architect/                    ← У0: КОНЦЕПЦИЯ (+ Стандарты)
│   ├── concept/                  ← Принципы
│   │   ├── META.md               ← Корень
│   │   ├── PHILOSOPHY.md
│   │   ├── SKELETON.md
│   │   ├── TAXONOMY.md
│   │   ├── GLOSSARY.md
│   │   └── SYSTEM_HIERARCHY.md   ← Этот документ
│   │
│   ├── standards/                ← Стандарты
│   │   ├── FILESYSTEM.md
│   │   ├── NAMING.md
│   │   └── VERSIONING.md
│   │
│   ├── patterns/                 ← У1: Паттерны (Упр. платформой)
│   └── templates/                ← У1: Шаблоны (Упр. платформой)
│
├── platform-v1/                  ← У1: УПРАВЛЕНИЕ ПЛАТФОРМОЙ
│   ├── design/
│   ├── docs/
│   └── procedures/
│
├── system/                       ← У2: КОМПОНЕНТЫ
│   ├── agents/                   ← AI-агенты
│   ├── modules/                  ← Модули
│   └── integrations/             ← Интеграции
│
├── projects/                     ← У3: ПРИЛОЖЕНИЯ
│   └── {name}/
│       ├── CLAUDE.md             ← AI контекст
│       ├── index.yaml            ← Метаданные
│       ├── design/               ← Проектирование
│       ├── management/           ← Управление
│       └── solution/             ← Код
│
└── infra/                        ← У3: ИНФРАСТРУКТУРА
    └── {name}/
        └── config.yaml

ЗАВИСИМОСТИ

КОНЦЕПЦИЯ (У0)
     │
     │ определяет правила для ВСЕХ
     ├─────────────────────────────────────────────┐
     │                                             │
     ▼                                             │
УПРАВЛЕНИЕ ПЛАТФОРМОЙ (У1)                         │
     │                                             │
     │ создаёт инструменты                         │
     ├────────────────────┐                        │
     │                    │                        │
     ▼                    ▼                        │
УПРАВЛЕНИЕ            КОМПОНЕНТЫ (У2)              │
ПРОЕКТАМИ (У2)        │                            │
     │                │                            │
     │ ведёт проекты  │ используются               │
     │                │                            │
     └────────┬───────┘                            │
              │                                    │
              ▼                                    │
         ПРИЛОЖЕНИЯ (У3) ◄─────────────────────────┘
              │
              │ на основе концепции (сквозная связь)

ПРАВИЛА ССЫЛОК

Откуда Куда Можно?
У3 У2, У1, У0
У2 У1, У0
У1 У0
У0 У1, У2, У3
У1 У2, У3
У2 У3

Правило: Ссылаться можно только на свой или верхний уровень.

Исключение: Концепция (У0) влияет на все уровни напрямую (сквозная зависимость).


КАСКАДНЫЕ ИЗМЕНЕНИЯ

При изменении уровня N — проверить все уровни N+1 и ниже.

Изменился Проверить
У0 Концепция У1, У2, У3
У1 Платформа У2, У3
У2 Компоненты У3
У2 Упр. проектами У3
У3 Приложение

ИСТОРИЯ

Версия Дата Изменения
2.0.0 2025-11-25 Новая иерархия: 4 уровня с явными зависимостями
1.1.0 2025-11-25 Добавлены "Вытекает из:"
1.0.0 2025-11-25 Первая версия

Статус: Принято — основа для всей системы