architect/_archive/2025-11-30-architect-cleanup/GLOSSARY.md

ГЛОССАРИЙ: Терминология платформы

Версия: 1.0.0
Дата: 2025-11-25
Статус: Принято

НАЗНАЧЕНИЕ

Единый источник правды для терминологии. Все документы и агенты используют эти термины.

Правило: Если термин не в глоссарии — не использовать или добавить сюда.

ИЕРАРХИЯ ТЕРМИНОВ

ПЛАТФОРМА (Platform) ─── вся система AUTONOMOUS
    │
    ├── ВНУТРЕННЕЕ (Internal) ─── компоненты платформы
    │       │
    │       ├── Ядро (Core)
    │       ├── Модуль (Module)
    │       ├── Агент (Agent)
    │       ├── Механизм (Mechanism)
    │       └── Задача (Task)
    │
    └── ВНЕШНЕЕ (External) ─── что платформа создаёт
            │
            ├── Продукт (Product)
            ├── Сервис (Service)
            ├── Проект (Project)
            └── Заказ (Order)

РАЗДЕЛ 1: ПЛАТФОРМА

Платформа (Platform)

Определение: Вся система AUTONOMOUS целиком.

Синонимы: Система, AUTONOMOUS

НЕ путать с: Продуктом, Проектом

Пример:

✓ "Платформа AUTONOMOUS управляет продуктами"
✗ "Проект AUTONOMOUS" (неверно — это платформа)

РАЗДЕЛ 2: ВНУТРЕННЕЕ (компоненты платформы)

Ядро (Core)

Определение: Фундаментальные компоненты платформы, без которых она не работает.

Включает:
- Meta-Model (модель данных)
- State System (хранение состояния)
- Agent Runtime (среда исполнения)

Пример:

✓ "Ядро платформы включает State System"
✗ "Ядро проекта" (у проектов нет ядра — есть код)

Модуль (Module)

Определение: Самостоятельная часть ядра или платформы с чёткими границами.

Характеристики:
- Имеет свой интерфейс
- Может работать независимо
- Заменяем

Пример:

✓ "Модуль State отвечает за персистентность"
✓ "Модуль интеграций подключает API"

Агент (Agent)

Определение: AI-исполнитель, который выполняет задачи автономно или полуавтономно.

Типы агентов:
- Base Agent — базовый прототип
- Code Agent — пишет код
- Infra Agent — управляет инфраструктурой
- API Agent — работает с интеграциями
- Commerce Agent — управляет торговлей
- Orchestrator — координирует других агентов

Пример:

✓ "Code Agent написал модуль экспорта"
✓ "Orchestrator распределил задачи между агентами"

Механизм (Mechanism)

Определение: Процесс, алгоритм или логика внутри платформы.

Синонимы: Процесс, Алгоритм, Логика

Пример:

✓ "Механизм роутинга распределяет задачи"
✓ "Механизм восстановления откатывает ошибки"

Задача (Task)

Определение: Единица работы внутри платформы.

Контекст: Используется для внутренних работ над платформой.

Идентификатор: T{фаза}.{номер} — например T1.1, T2.3

НЕ путать с: Заказом (внешний запрос)

Пример:

✓ "Задача T1.1: Создать Meta-Model"
✓ "Задача T3.2: Реализовать Infra Agent"
✗ "Задача: создать интернет-магазин" (это Заказ)

Спринт (Sprint)

Определение: Период работы над задачами (обычно 1 неделя).

Пример:

✓ "Спринт 1: задачи T1.1-T1.3"

РАЗДЕЛ 3: ВНЕШНЕЕ (что платформа создаёт)

Продукт (Product)

Определение: Готовое решение, созданное платформой для конечных пользователей.

Характеристики:
- Имеет пользователей
- Приносит ценность
- Работает автономно

Примеры:
- marketplace (MVP управления маркетплейсами)
- pim-drupal (система управления товарами)
- интернет-магазин

Пример использования:

✓ "Продукт marketplace запущен в production"
✓ "Продукт pim-drupal в разработке"
✗ "Проект marketplace" (проект — это процесс, продукт — результат)

Сервис (Service)

Определение: Работающая система, предоставляющая функциональность через интерфейс.

Характеристики:
- Доступен по API или UI
- Работает непрерывно
- Обслуживает запросы

Пример:

✓ "Сервис интеграции с Ozon"
✓ "Сервис аналитики"

Проект (Project)

Определение: Процесс создания или изменения продукта.

Характеристики:
- Имеет начало и конец
- Имеет цель
- Результат — продукт или изменение

НЕ путать с:
- Продуктом (проект создаёт продукт)
- Задачей (задача — внутренняя работа)

Пример:

✓ "Проект создания нового интернет-магазина"
✓ "Проект миграции на новую версию"
✗ "Проект AUTONOMOUS" (это платформа, не проект)

Заказ (Order)

Определение: Входящий запрос на создание продукта или выполнение работы.

Жизненный цикл: Заказ → Проект → Продукт

Пример:

✓ "Получен заказ на создание CRM"
✓ "Заказ: интегрировать WB"

Артефакт (Artifact)

Определение: Конкретный результат работы — файл, код, документ, конфигурация.

Область: Используется и внутри, и снаружи.

Пример:

✓ "Артефакт: файл schema.yaml"
✓ "Артефакты проекта: код, тесты, документация"

РАЗДЕЛ 4: ДОПОЛНИТЕЛЬНЫЕ ТЕРМИНЫ

Домен (Domain)

Определение: Предметная область со своей спецификой.

Примеры доменов:
- Software Engineering
- E-commerce
- Infrastructure
- Data Engineering

Интеграция (Integration)

Определение: Связь между платформой и внешней системой.

Пример:

✓ "Интеграция с Ozon API"
✓ "Интеграция с 1С"

Оператор (Operator)

Определение: Человек, управляющий платформой.

Роли:
- Контролирует агентов
- Одобряет критичные действия
- Создаёт заказы

РАЗДЕЛ 5: ЗАПРЕЩЁННЫЕ КОНСТРУКЦИИ

Неправильно Правильно Почему
"Проект AUTONOMOUS" "Платформа AUTONOMOUS" AUTONOMOUS — это платформа
"Подпроект P1.1" "Задача T1.1" Внутренние работы = задачи
"Проект marketplace" "Продукт marketplace" marketplace — готовый продукт
"Создать проект" (для внутр.) "Создать задачу" Проект — внешнее
"Проект интеграции" "Задача интеграции" или "Интеграция" Интеграция — не проект

РАЗДЕЛ 6: ШАБЛОНЫ ИМЕНОВАНИЯ

Идентификаторы

Сущность Формат Пример
Задача T{фаза}.{номер} T1.1, T3.4
Агент {Name}Agent CodeAgent, InfraAgent
Модуль {name}_module state_module, api_module
Продукт {name} (lowercase) marketplace, pim-drupal
Спринт Sprint {N} Sprint 1, Sprint 5

Папки

Область Паттерн Пример
Внутреннее autonomous/{component}/ autonomous/core/, autonomous/agents/
Внешнее products/{name}/ products/marketplace/

ИСТОРИЯ ИЗМЕНЕНИЙ

Версия Дата Изменения
1.0.0 2025-11-25 Первая версия глоссария

Версия: 1.0.0
Статус: Принято — обязательно к использованию