КОНЦЕПЦИЯ ПЛАТФОРМЫ
Версия: 2.0.0
Дата: 2025-11-30
Уровень: У0 (Идея)
Статус: LOCKED после утверждения
1. ЧТО ЭТО (Определение)
╔═══════════════════════════════════════════════════════════════════════════════╗
║ ║
║ ПЛАТФОРМА — саморазвивающаяся система разработки, ║
║ где AI-агенты создают и улучшают саму платформу, ║
║ а также разрабатывают бизнес-приложения. ║
║ ║
║ Главное свойство: САМА СЕБЯ РАЗРАБАТЫВАЕТ И РАЗВИВАЕТ ║
║ ║
╚═══════════════════════════════════════════════════════════════════════════════╝
Bootstrap-природа
Платформа — первый проект платформы.
┌─────────────────────────────────────────────────────────────────┐
│ │
│ Платформа → создаёт агентов │
│ ↓ │
│ Агенты → улучшают платформу │
│ ↓ │
│ Улучшенная платформа → создаёт лучших агентов │
│ ↓ │
│ ...рекурсия... │
│ │
└─────────────────────────────────────────────────────────────────┘
2. ЗАЧЕМ (Цель)
Проблемы которые решает платформа
| Проблема |
Решение |
| Проекты ведутся хаотично |
Единая методология |
| Знания теряются |
Стандарты и документация |
| Код не переиспользуется |
Общие компоненты (@shared) |
| AI используется случайно |
AI-агенты как часть системы |
| Данные разбросаны |
Workspace + Hub |
| Нет прозрачности |
index.yaml + статусы |
Три уровня автоматизации
ЭТАП 1: ВРУЧНУЮ
│ Человек делает, AI помогает
│
▼
ЭТАП 2: ПОЛУАВТОМАТИЧЕСКИ
│ Человек запускает, AI делает, человек проверяет
│
▼
ЭТАП 3: АВТОМАТИЧЕСКИ
AI делает сам, человек контролирует
3. СОСТАВ (Структура)
3.1 Высокоуровневая структура
ПЛАТФОРМА
│
├── @PLATFORM (Ядро)
│ ├── architect/ методология, теория, стандарты
│ ├── system/ агенты исполнения
│ └── infra/ инфраструктура платформы
│
├── @SHARED (Общее)
│ ├── lib-*/ библиотеки
│ ├── service-*/ общие сервисы
│ └── schemas/ общие схемы данных
│
├── {DOMAIN} (Домены/Бизнесы)
│ ├── pirotehnika/ домен пиротехники
│ ├── lider/ домен автозапчастей
│ └── seller1/ домен seller1
│
└── HUB (Данные приложений)
└── S3 хранилище
3.2 Структура файловой системы
/opt/claude-workspace/ WORKSPACE
│
├── CLAUDE.md точка входа
├── index.yaml граф всего
│
├── architect/ @PLATFORM: МЕТОДОЛОГИЯ
│ ├── CONCEPT.md ← этот документ (У0)
│ ├── theory/ теория систем
│ ├── standards/ правила (У1)
│ ├── patterns/ паттерны (У2)
│ └── templates/ шаблоны (У3)
│
├── system/ @PLATFORM: АГЕНТЫ
│ ├── terminal.ai.md интерфейс
│ ├── architect.ai.md методология
│ ├── projector.ai.md проекты
│ ├── coder-v1.ai.md стандартный код
│ ├── coder-v2.ai.md AI-генерация
│ ├── integrator.ai.md API
│ └── infra.ai.md серверы
│
├── infra/ @PLATFORM: ИНФРАСТРУКТУРА
│ ├── @infra-dev-pro/ сервер DEV-PRO
│ ├── @infra-dev-prod-rf/ сервер DEV-PROD-RF
│ └── @infra-beget/ shared hosting
│
├── shared/ @SHARED: ОБЩИЕ КОМПОНЕНТЫ
│ ├── lib-python/ Python библиотеки
│ ├── lib-integrations/ интеграции (Ozon, 1C, etc)
│ └── schemas/ общие схемы
│
├── pirotehnika/ ДОМЕН: Пиротехника
│ ├── index.yaml метаданные домена
│ ├── _data/ рабочие данные домена
│ ├── shop/ приложение: магазин
│ ├── pim/ приложение: каталог
│ └── ozon/ приложение: маркетплейс
│
├── lider/ ДОМЕН: Лидер Авто
│ └── main/ приложение
│
├── seller1/ ДОМЕН: Seller1
│
└── hub → /mnt/beget-s3/ симлинк на HUB
4. ДАННЫЕ (Workspace vs Hub)
4.1 Главный принцип
╔═══════════════════════════════════════════════════════════════════════════════╗
║ ║
║ WORKSPACE = код + данные для РАБОТЫ приложений ║
║ HUB = данные РЕЗУЛЬТАТОВ работы приложений ║
║ ║
╚═══════════════════════════════════════════════════════════════════════════════╝
4.2 Что где хранится
┌─────────────────────────────────────────────────────────────────────────────┐
│ WORKSPACE (Git) │
│ │
│ ЧТО ХРАНИТСЯ: │
│ ├── Исходный код (src/) │
│ ├── Конфигурации (config/) │
│ ├── Схемы данных (schemas/) │
│ ├── Рабочие данные для работы приложения (data/) │
│ │ ├── справочники │
│ │ ├── шаблоны │
│ │ └── кеши │
│ ├── Документация (docs/) │
│ └── Тесты (tests/) │
│ │
│ СВОЙСТВА: │
│ • Версионируется в Git │
│ • Восстановимо из Git │
│ • Нужно для ЗАПУСКА приложения │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
│
│ только РЕЗУЛЬТАТЫ
▼
┌─────────────────────────────────────────────────────────────────────────────┐
│ HUB (S3) │
│ │
│ ЧТО ХРАНИТСЯ: │
│ ├── Экспорты и отчёты (exports/) │
│ ├── Медиафайлы (media/) │
│ │ ├── изображения товаров │
│ │ ├── документы пользователей │
│ │ └── видео │
│ ├── Бэкапы БД (backups/) │
│ └── Архивы (archive/) │
│ │
│ НЕ ХРАНИТСЯ: │
│ ✗ Код │
│ ✗ Конфигурации │
│ ✗ Рабочие файлы для работы приложения │
│ │
│ СВОЙСТВА: │
│ • НЕ версионируется │
│ • НЕВОССТАНОВИМО (уникальные данные) │
│ • Результат РАБОТЫ приложения │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
4.3 Структура Hub
hub/ (→ /mnt/beget-s3/)
│
├── pirotehnika/ данные домена
│ ├── _shared/ общие данные домена
│ │ ├── media/ изображения товаров
│ │ └── certificates/ сертификаты
│ ├── shop/ данные приложения shop
│ │ ├── exports/ экспорты
│ │ └── backups/ бэкапы
│ ├── pim/ данные приложения pim
│ └── ozon/ данные приложения ozon
│
├── lider/
│ └── ...
│
├── seller1/
│ └── ...
│
└── _platform/ системные данные платформы
└── archive/ архив версий
4.4 Температура данных
| Температура |
Описание |
Где живёт |
| Горячие |
Используются постоянно |
Workspace |
| Тёплые |
Используются иногда |
Workspace или Hub |
| Холодные |
Хранятся "на всякий случай" |
Hub |
| Замороженные |
Архив, история |
Hub |
4.5 Принцип восстановимости
┌─────────────────────────────────────────────────────────────────┐
│ │
│ Workspace восстановим из Git + Hub │
│ Hub НЕВОССТАНОВИМ (уникальные данные) │
│ │
│ Потеря Workspace = часы на восстановление │
│ Потеря Hub = КАТАСТРОФА │
│ │
└─────────────────────────────────────────────────────────────────┘
5. ПРОЕКТЫ (Иерархия)
5.1 Типы проектов
| Префикс/Тип |
Описание |
Примеры |
@platform |
Ядро платформы |
architect, system |
@shared |
Общие компоненты |
lib-python, schemas |
@infra |
Инфраструктура |
@infra-dev-pro |
@service |
Общий сервис |
@service-auth |
| (домен) |
Бизнес-домен |
pirotehnika, lider |
| (приложение) |
Приложение в домене |
shop, pim |
| (модуль) |
Часть приложения |
catalog, cart |
5.2 Иерархия уровней
УРОВЕНЬ 0: @PLATFORM
│ Ядро платформы (architect, system)
│
├── УРОВЕНЬ 1: @SHARED + ДОМЕНЫ
│ │ Общие компоненты + бизнес-домены
│ │
│ ├── УРОВЕНЬ 2: ПРИЛОЖЕНИЯ
│ │ │ Приложения внутри доменов
│ │ │
│ │ └── УРОВЕНЬ 3: МОДУЛИ
│ │ Модули внутри приложений
5.3 Типы связей между проектами
ФИЗИЧЕСКАЯ СТРУКТУРА (дерево):
─────────────────────────────
children вложенные проекты
parent родительский проект
ЛОГИЧЕСКИЕ СВЯЗИ (граф):
─────────────────────────────
depends_on использует (зависимость)
provides_to предоставляет данные/сервисы
extends расширяет (наследование)
part_of является частью (модуль)
5.4 index.yaml каждого проекта
# Пример: pirotehnika/shop/index.yaml
id: pirotehnika-shop
type: application
name: "Магазин пиротехники"
status: active
# Физическая иерархия
parent: pirotehnika
children:
- themes
- modules
# Логические связи
depends_on:
- "@shared/lib-integrations"
- "pirotehnika/pim"
provides_to:
- "pirotehnika/ozon"
# Данные
hub: "hub/pirotehnika/shop/"
# Инфраструктура
infrastructure:
server: "@infra-beget"
domain: "pirotehnika.spb.ru"
5.5 Правила доступа к данным
| Данные |
Доступ |
| Свои данные |
Полный (чтение + запись) |
| Данные родителя (_shared) |
Полный |
| Данные соседа в домене |
Только чтение |
| Данные другого домена |
Только чтение |
6. АГЕНТЫ (Роли)
6.1 Схема взаимодействия
ОПЕРАТОР (человек)
│
▼
┌──────────┐
│ ТЕРМИНАЛ │ ← интерфейс, маршрутизация
└────┬─────┘
│
├───────────┬───────────┬───────────┬───────────┐
│ │ │ │ │
▼ ▼ ▼ ▼ ▼
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
│АРХИТЕКТ │ │ПРОЕКТОР │ │ КОДЕР │ │ИНТЕГРАТ │ │ ИНФРА │
└─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘
6.2 Роли агентов
| Агент |
Файл |
Зона ответственности |
| ТЕРМИНАЛ |
terminal.ai.md |
Интерфейс, понимание контекста, маршрутизация |
| АРХИТЕКТОР |
architect.ai.md |
Методология, стандарты, развитие платформы |
| ПРОЕКТОР |
projector.ai.md |
Управление проектами, планирование |
| КОДЕР v1 |
coder-v1.ai.md |
Стандартный код (фреймворки) |
| КОДЕР v2 |
coder-v2.ai.md |
AI-генерация кода (ЦИФРА) |
| ИНТЕГРАТОР |
integrator.ai.md |
Внешние API (Ozon, 1C, etc) |
| ИНФРА |
infra.ai.md |
Серверы, деплой, мониторинг |
6.3 Что делает каждый агент
ТЕРМИНАЛ
├── Принимает команды оператора
├── Понимает контекст (проект, задача)
├── Направляет к нужному агенту
└── Форматирует ответы
АРХИТЕКТОР
├── Развивает методологию
├── Пишет стандарты и паттерны
├── Создаёт/улучшает агентов
└── НЕ трогает код проектов
ПРОЕКТОР
├── Создаёт проекты по шаблонам
├── Управляет задачами
├── Отслеживает статусы
└── Планирует работы
КОДЕР v1
├── Пишет код приложений
├── Знает фреймворки (Streamlit, Drupal, OpenCart)
├── Работает по спецификациям
└── Создаёт компоненты
КОДЕР v2 (ЦИФРА)
├── Генерирует код по описанию
├── Понимает бизнес-логику
├── AI-powered разработка
└── Создаёт из концепции
ИНТЕГРАТОР
├── Настраивает внешние API
├── Ozon, 1C, доставка, платежи
├── MCP серверы
└── Управляет подключениями
ИНФРА
├── Управляет серверами
├── Деплой приложений
├── Настройка окружений
└── Мониторинг и бэкапы
7. УРОВНИ АБСТРАКЦИИ
У-1: ТЕОРИЯ architect/theory/
│ Универсальные законы систем
│ (что такое система, свойства, уровни)
│
▼
У0: КОНЦЕПЦИЯ architect/CONCEPT.md ← ЭТОТ ДОКУМЕНТ
│ Что такое платформа, зачем, как устроена
│
▼
У1: СТАНДАРТЫ architect/standards/
│ Правила которым следуют все
│ (именование, структура, процессы)
│
▼
У2: ПАТТЕРНЫ architect/patterns/
│ Решения типовых проблем
│ (когда применять, как делать)
│
▼
У3: ШАБЛОНЫ architect/templates/
│ Готовые заготовки
│ (project.yaml.tmpl, README.tmpl)
│
▼
У4: РЕАЛИЗАЦИЯ {domain}/{app}/
Конкретный код проектов
Принцип каскадности
Нижний уровень НЕ ПРОТИВОРЕЧИТ верхнему.
Стандарт не может противоречить концепции.
Паттерн не может противоречить стандарту.
Код не может противоречить паттерну.
8. ПРИНЦИПЫ
8.1 Разработка
| Принцип |
Описание |
| DRY |
Одна истина — одно место |
| KISS |
Минимум сложности |
| YAGNI |
Не делай лишнего |
| Bootstrap |
Платформа создаёт себя |
8.2 Инфраструктура
| Принцип |
Описание |
| Горячее/Холодное |
Сервер для работы, Hub для хранения |
| Эфемерность |
Сервер — временная сущность |
| Восстановимость |
Всё восстановимо из Hub + Git |
| Автоматизация |
Если делаешь второй раз — автоматизируй |
8.3 Данные
| Принцип |
Описание |
| Workspace = работа |
Код + данные для работы приложения |
| Hub = результаты |
Только результаты работы приложений |
| Владение |
Один проект владеет, остальные читают |
| Движение к холоду |
Данные → от горячего к холодному |
9. АВТОМАТИЗАЦИЯ (ACJM)
A = AUTOSEARCH — Умный поиск по workspace
C = CASCADING — Каскадные обновления (изменил стандарт → обновились проекты)
J = JOURNALING — Автоматическое журналирование действий
M = AUTOMATION — Автоматизация рутины (бэкапы, деплой, отчёты)
10. ТЕКУЩЕЕ СОСТОЯНИЕ
Домены (бизнесы)
| Домен |
Статус |
Приложения |
| pirotehnika |
active |
shop, pim, ozon |
| lider |
development |
main |
| seller1 |
planning |
— |
Компоненты платформы
| Компонент |
Статус |
| Теория (theory/) |
✅ v2.1.0 |
| Концепция (CONCEPT.md) |
✅ v2.0.0 |
| Стандарты (standards/) |
⏳ в работе |
| Паттерны (patterns/) |
⏳ TODO |
| Шаблоны (templates/) |
⏳ TODO |
| Агенты (system/) |
⏳ в работе |
11. ГЛОССАРИЙ
| Термин |
Определение |
| Платформа |
Саморазвивающаяся система разработки |
| Система |
Элементы + Связи → Эмерджентность |
| Агент |
AI-роль (*.ai.md) |
| Домен |
Бизнес-область (pirotehnika, lider) |
| Приложение |
Программа внутри домена |
| Модуль |
Часть приложения (один деплой) |
| Workspace |
Рабочая директория (код + рабочие данные) |
| Hub |
Хранилище результатов работы (S3) |
| Bootstrap |
Система создающая саму себя |
| Каскадность |
Нижние уровни не противоречат верхним |
12. СВЯЗАННЫЕ ДОКУМЕНТЫ
| Уровень |
Путь |
Назначение |
| У-1 |
architect/theory/ |
Теория систем |
| У0 |
architect/CONCEPT.md |
Этот документ |
| У1 |
architect/standards/ |
Правила |
| У2 |
architect/patterns/ |
Паттерны |
| У3 |
architect/templates/ |
Шаблоны |
Версия: 2.0.0
Статус: Ожидает утверждения