Версия: 5.0.1
Дата: 2026-02-17
Тип системы: Обеспечивающая
Уровень: У0 (Концепция)
Extends: ../theory/SYSTEMS.md, ../theory/SYSTEM_TYPES.md
Этот документ расширяет концепции из:
- theory/SYSTEMS.md — Общая теория систем (уровни абстракции, типы систем)
- theory/SYSTEM_TYPES.md — 6 типов систем по назначению
Платформа описана как Обеспечивающая система с 5 подсистемами, следуя классификации из теории систем.
ПЛАТФОРМА — Обеспечивающая система, которая поддерживает работу
проектов через 5 подсистем:
МЕТОДОЛОГИЯ + АГЕНТЫ + РЕСУРСЫ + ИНФРАСТРУКТУРА + ДАННЫЕ
Тип системы: Обеспечивающая (не имеет собственной цели, обслуживает другие)
КОД и ДАННЫЕ лежат в двух пространствах с ОДИНАКОВОЙ ИЕРАРХИЕЙ
$WORKSPACE (git) $DATASPACE (S3)
├── architect/ ├── architect/
├── system/ ├── system/
└── projects/ └── projects/
├── pirotehnika/ ├── pirotehnika/
│ ├── config/ │ ├── prices/
│ ├── integrations/ │ ├── images/
│ └── services/ │ └── exports/
└── lideravto/ └── lideravto/
| Где | Что хранится | Управление |
|---|---|---|
| $WORKSPACE | Код, документация, конфиги | git |
| $DATASPACE | Данные, изображения, бэкапы | S3 |
Подробнее: RESOURCES.md, ../standards/CODE_DATA_SEPARATION.md
Приложения на существующих средствах.
ИНСТРУМЕНТЫ: ПРОЕКТЫ:
├── Claude Code ├── IT-проекты (сайты, API)
├── OpenCart ├── Бизнес-процессы
├── Drupal └── Интеграции
├── Streamlit
└── ...
Фокус: Автоматизация IT-задач через AI-агентов.
Свой конструктор приложений. Платформа создаёт инструменты.
ПЛАТФОРМА: СОЗДАЁТ:
├── Конструктор ├── Сайты
├── Шаблоны ├── Приложения
├── Паттерны ├── Интеграции
└── Генераторы └── Автоматизации
Фокус: Low-code/no-code для типовых задач.
Управление всеми типами проектов жизни, не только IT.
СФЕРЫ ЖИЗНИ: ИНСТРУМЕНТЫ:
├── Личные ├── IT (сайты, API)
│ ├── Здоровье ├── Маркетинг
│ ├── Развитие ├── HR
│ ├── Финансы ├── Психология
│ └── Работа ├── Финансы
│ └── ...
├── Социальные
│ ├── Сообщества
│ └── Благотворительность
│
└── Бизнес
├── Торговля
├── Услуги
└── Продукты
Фокус: Платформа — система управления всей жизнью.
├── Workspace = код, Hub = данные
├── Система описывается через 9 вопросов
├── 5 уровней абстракции (У0→У4)
├── Каждый тип системы — свой набор вопросов
└── DRY, KISS, Bootstrap
Обеспечить эффективную работу с проектами:
├── Сохранять знания между сессиями
├── Предоставлять методологию
├── Автоматизировать рутину
└── Масштабировать на новые проекты
ПЛАТФОРМА (Обеспечивающая)
│
├── ПОДСИСТЕМА 1: МЕТОДОЛОГИЯ (Информационная)
│ └── architect/
│
├── ПОДСИСТЕМА 2: АГЕНТЫ (Агенты)
│ └── system/agents/
│
├── ПОДСИСТЕМА 3: РЕСУРСЫ (Обеспечивающая)
│ └── library/connectors/, functions/
│
├── ПОДСИСТЕМА 4: ИНФРАСТРУКТУРА (Обеспечивающая)
│ └── infra/
│
└── ПОДСИСТЕМА 5: ДАННЫЕ (Информационная)
└── $DATASPACE (S3)
│
▼
═══════════════════════════════════════════
ОБСЛУЖИВАЕТ:
═══════════════════════════════════════════
│
├── БИЗНЕС 1: Пиротехника (Целевая)
│ └── projects/pirotehnika/
│
├── БИЗНЕС 2: Лидер Авто (Целевая)
│ └── projects/lideravto/
│
└── БИЗНЕС N: ...
Согласно theory/SYSTEMS.md, система полностью описывается через ответы на 9 вопросов. Платформа как Обеспечивающая система состоит из 5 подсистем, каждая со своим типом:
Тип: Информационная
Папка: architect/
Функция: КАК думать, описывать и строить системы
| Вопрос | Ответ |
|---|---|
| ЗАЧЕМ? | Единые правила для всех проектов |
| ЧТО? | Теория, концепции, стандарты, паттерны, шаблоны |
| КТО? | Архитектор (создаёт), все агенты (используют) |
| ГДЕ? | architect/ |
| КОГДА? | Обновляется редко, LOCKED = стабильно |
Структура:
architect/
├── theory/ ← У0: Теория (LOCKED v3.1.0)
│ ├── MERKABA.md — Геометрическая модель
│ ├── QUESTIONS.md — 9 вопросов
│ ├── SYSTEMS.md — Теория систем
│ ├── SYSTEM_TYPES.md — 6 типов систем
│ └── ASPECTS.md — 9 аспектов
│
├── concept/ ← У0: Концепция платформы
│ ├── PLATFORM.md — Этот документ
│ ├── ARCHITECTURE.md — Техническая архитектура
│ ├── ROLES.md — Система ролей
│ └── PROJECTOR.md — Методология проектов (LOCKED)
│
├── standards/ ← У1: Стандарты
│ ├── PRINCIPLES.md — Принципы работы агентов
│ ├── PROTOCOL.md — Протокол взаимодействия
│ ├── types/ — Стандарты типов систем
│ ├── roles/ — Стандарты ролей
│ ├── structure/ — Структура файлов
│ ├── formats/ — Форматы документов
│ ├── functions/ — Функции
│ └── processes/ — Процессы
│
├── patterns/ ← У2: Паттерны
├── templates/ ← У3: Шаблоны
└── decisions/ ← ADR (Architecture Decision Records)
Уровни абстракции:
| Уровень | Папка | Что содержит | Стабильность |
|---|---|---|---|
| У0 | theory/, concept/ | Идеи, ценности | Годы |
| У1 | standards/ | Правила | Месяцы |
| У2 | patterns/ | Типовые решения | Растёт |
| У3 | templates/ | Заготовки | Обновляется |
Тип: Агент (множество агентов)
Папка: system/
Функция: КТО выполняет работу
| Вопрос | Ответ |
|---|---|
| ЗАЧЕМ? | Автоматизация работы с проектами |
| ЧТО? | AI-контексты для разных задач |
| КАК? | Загружаются по требованию |
| ЧЕМ? | Claude Code, *.ai.md файлы |
| ГДЕ? | system/ |
| КОГДА? | Активируются при обращении |
Агенты:
| Агент | Файл | Роль | Уровень |
|---|---|---|---|
| Терминал | CLAUDE.md (корневой) | Интерфейс с Оператором | Системный |
| Архитектор | architect.ai.md | Методология | Системный |
| Проектор | projector.ai.md | Управление проектами | Системный |
| Кодер v1 | coder-v1.ai.md | Стандартный код | Исполнитель |
| Кодер v2 | coder-v2.ai.md | AI-генерация (TEA) | Исполнитель |
| Инфра | infra.ai.md | Серверы, деплой | Исполнитель |
| Аналитик | analyst.ai.md | Анализ данных | Исполнитель |
| Интегратор | integrator.ai.md | Внешние API | Исполнитель |
Иерархия агентов:
ОПЕРАТОР (человек)
│
▼
ТЕРМИНАЛ (интерфейс)
│
├──→ АРХИТЕКТОР → методология
│
└──→ ПРОЕКТОР → управление
│
├──→ КОДЕР v1/v2 → код
├──→ ИНФРА → серверы
├──→ АНАЛИТИК → данные
└──→ ИНТЕГРАТОР → API
Подробнее: AGENTS.md — Архитектура агентов
Тип: Обеспечивающая
Папка: library/connectors/, library/functions/
Функция: ЧЕМ работаем с внешним миром
| Вопрос | Ответ |
|---|---|
| ЗАЧЕМ? | Переиспользуемый код для работы с внешними системами |
| ЧТО? | Коннекторы (API/Data/Device), функции (parsers/formatters) |
| КТО? | Платформа (создаёт), проекты (используют через Client) |
| ГДЕ? | library/connectors/, library/functions/ |
| КОГДА? | При обращении к внешним ресурсам |
Терминология:
| Термин | Назначение | Примеры |
|---|---|---|
| Connector API | Доступ к внешнему API/сервису | ozon, telegram, 1c |
| Connector Data | Доступ к хранилищу данных | postgres, redis, nocodb |
| Connector Device | Работа с физическим устройством | printer, scanner |
| Function | Обработка данных | parsers/xlsx, formatters/money |
Структура:
system/
├── connectors/ ← Внешние сервисы (API)
│ ├── marketplaces/ ← ozon, wildberries, yandex_market
│ ├── messengers/ ← telegram, whatsapp
│ ├── accounting/ ← 1c, moysklad
│ └── delivery/ ← cdek, pochta
│
├── drivers/ ← Устройства
│ ├── printers/ ← receipt, label
│ └── scanners/ ← barcode
│
├── adapters/ ← Форматы данных
│ ├── spreadsheets/ ← xlsx, csv
│ ├── documents/ ← pdf
│ └── data/ ← json, xml
│
└── stores/ ← Хранилища
├── sql/ ← postgres, mysql
├── nosql/ ← redis, mongodb
└── object/ ← s3
Подробнее: RESOURCES.md
Тип: Обеспечивающая
Папка: infra/
Функция: ГДЕ всё работает
| Вопрос | Ответ |
|---|---|
| ЧТО? | Серверы, хранилища, сервисы |
| КТО? | Инфра-агент (управляет), проекты (используют) |
| КАК? | SSH, Docker, Nginx, systemd |
| ЧЕМ? | Linux, PostgreSQL, S3 |
| ГДЕ? | infra/ |
| КОГДА? | 24/7, обслуживание по необходимости |
| СКОЛЬКО? | Uptime >99%, бэкапы ежедневно |
Компоненты:
- Серверы (@.server)
- Хранилища (@.storage)
- Сервисы (@*.service)
Подробнее: infra/STRUCTURE.md
Тип: Информационная
Расположение: $DATASPACE (S3 mount)
Функция: ЧТО хранится (данные, не код)
| Вопрос | Ответ |
|---|---|
| ЗАЧЕМ? | Отделить данные от кода, зеркальная структура |
| ЧТО? | Прайсы, изображения, экспорты, бэкапы |
| КТО? | Проекты (создают), агенты (обрабатывают) |
| ГДЕ? | $DATASPACE = $DATASPACE (S3 mount) |
| КОГДА? | При работе с данными |
Структура DATASPACE (зеркало WORKSPACE):
$DATASPACE/
├── projects/ ← Данные бизнес-проектов
│ ├── pirotehnika/
│ │ ├── prices/ ← Прайсы поставщиков (xlsx)
│ │ ├── images/ ← Фото товаров
│ │ ├── products/ ← Данные 1С (JSON)
│ │ ├── exports/ ← Выгрузки
│ │ └── _inbox/ ← Входящие файлы
│ │
│ └── lideravto/
│ └── ...
│
├── backup/ ← Бэкапы (beget-infra bucket)
│ ├── critical/ ← CLAUDE.md, settings
│ ├── postgres/ ← Дампы БД
│ ├── git/ ← Git bundles
│ └── restic/ ← Restic repository
│
└── archive/ ← Архивные данные
Принцип зеркальности:
| $WORKSPACE | $DATASPACE |
|---|---|
| projects/pirotehnika/config/ | projects/pirotehnika/prices/ |
| projects/pirotehnika/services/ | projects/pirotehnika/exports/ |
| .py, .md, .yaml | .xlsx, .jpg, .pdf |
Подробнее: ../standards/CODE_DATA_SEPARATION.md
Платформа обслуживает бизнес-проекты, но они не часть платформы.
| Термин | Уровень | Назначение | Примеры |
|---|---|---|---|
| Config | Проект | Настройки для платформенных ресурсов | config/ozon.yaml |
| Client | В коде | Инициализированный экземпляр ресурса | OzonClient(config) |
| Integration | Проект | Бизнес-процесс из нескольких ресурсов | integrations/ozon-1c-sync/ |
| Service | Проект | Работающее приложение | services/@ozon.api/ |
| Script | Проект | Разовая задача | scripts/import.py |
projects/{business}/ ← В WORKSPACE (код)
├── CLAUDE.md — Контекст для Claude
├── PROJECT.md — Описание проекта
│
├── config/ ← Конфигурации ресурсов
│ ├── ozon.yaml — Настройки Ozon connector
│ ├── telegram.yaml — Настройки Telegram connector
│ └── db.yaml — Настройки PostgreSQL store
│
├── integrations/ ← Бизнес-процессы
│ ├── ozon-1c-sync/ — Синхронизация Ozon ↔ 1С
│ └── auto-delivery/ — Автоотправка заказов
│
├── services/ ← Приложения
│ ├── @ozon.api/ — API для OZON
│ ├── @pim.service/ — PIM система
│ └── @bot.app/ — Telegram бот
│
├── scripts/ ← Разовые задачи
│ └── import_prices.py
│
└── _shared/ ← Документация к данным
├── CLAUDE.md — Описание данных
└── nocodb/scripts/ — Скрипты для NocoDB
$DATASPACE/projects/{business}/ ← В DATASPACE (данные)
├── prices/ — Прайсы xlsx
├── images/ — Фото товаров
├── products/ — Данные 1С
├── exports/ — Выгрузки
└── _inbox/ — Входящие файлы
$WORKSPACE/projects/
├── pirotehnika/ ← БИЗНЕС: Пиротехника (active)
│ ├── config/ — Конфигурации (ozon, telegram, db)
│ ├── integrations/ — Интеграции
│ ├── services/ — @ozon.api, @pim.service
│ └── _shared/ — Документация, скрипты NocoDB
│
└── lideravto/ ← БИЗНЕС: Лидер Авто (development)
└── modules/ — Модули
$DATASPACE/projects/
├── pirotehnika/ ← Данные Пиротехника
│ ├── prices/, images/, products/, exports/
│ └── _inbox/
│
└── lideravto/ ← Данные Лидер Авто
┌─────────────────────────────────────────────────────────────────────────┐
│ ПЛАТФОРМА │
│ │
│ ┌──────────────┐ читает ┌──────────────┐ использует │
│ │ МЕТОДОЛОГИЯ │◄────────────►│ АГЕНТЫ │◄────────────┐ │
│ │ architect/ │ стандарты │system/agents/│ │ │
│ └──────────────┘ └──────────────┘ │ │
│ │ │
│ ┌──────────────┐ предоставляет ┌──────────────┐ │ │
│ │ РЕСУРСЫ │────────────────►│ ИНФРАСТРУКТУРА│ │ │
│ │ connectors/ │ доступ к │ infra/ │ │ │
│ │ drivers/ │ серверам └──────┬───────┘ │ │
│ │ adapters/ │ │ │ │
│ │ stores/ │ │ хранит │ │
│ └──────┬───────┘ ▼ │ │
│ │ ┌──────────────┐ │ │
│ │ использует │ ДАННЫЕ │ │ │
│ └───────────────────────►│ $DATASPACE │ │ │
│ └──────┬───────┘ │ │
└─────────────────────────────────────────┼──────────────────┼───────────┘
│ │
│ обслуживает │
▼ ▼
┌─────────────────────────────────────────────────────────────────────────┐
│ БИЗНЕС-ПРОЕКТЫ │
│ │
│ $WORKSPACE/projects/ $DATASPACE/projects/ │
│ ┌──────────────────┐ ┌──────────────────┐ │
│ │ ПИРОТЕХНИКА │ │ ПИРОТЕХНИКА │ │
│ │ config/ │◄────────────►│ prices/ │ │
│ │ integrations/ │ зеркально │ images/ │ │
│ │ services/ │ │ exports/ │ │
│ └──────────────────┘ └──────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
На основе theory/SYSTEM_TYPES.md:
| Тип | Где в платформе | Вопросов | Начать с |
|---|---|---|---|
| Обеспечивающая | Платформа, Инфраструктура | 7 | ЧТО? |
| Информационная | Методология, Данные | 5 | ЧТО? |
| Агент | Агенты | 6 | ЗАЧЕМ? |
| Целевая | Бизнес-проекты | 9 | ПОЧЕМУ? |
| Процесс | Деплой, сборка | 8 | ПОЧЕМУ? |
| Структура | Файловая система, серверы | 4 | ЧТО? |
ПРОЕКТ
│
├── БИЗНЕС (Целевая система)
│ │
│ ├── САЙТ (Целевая + Техническая)
│ │ └── {domain}
│ │
│ ├── ИНТЕГРАЦИЯ (Обеспечивающая)
│ │ └── @service-{name}
│ │
│ └── ДАННЫЕ (Информационная)
│ └── {name}
│
├── ИНФРАСТРУКТУРА (Обеспечивающая)
│ │
│ ├── СЕРВЕР
│ │ └── @infra-{name}
│ │
│ ├── ХРАНИЛИЩЕ
│ │ └── infra-{name}
│ │
│ ├── УДАЛЁННЫЙ
│ │ └── @remote-{name}
│ │
│ └── СЕРВИС
│ └── @service-{name}
│
└── СИСТЕМНЫЙ (Обеспечивающая)
│
├── МЕТОДОЛОГИЯ
│ └── architect/
│
└── АГЕНТЫ
└── system/
| Элемент | Формат | Пример |
|---|---|---|
| Проект | имя/ |
pirotehnika/ |
| Общие данные | _имя/ |
_shared/ |
| Модуль | @имя.тип/ |
@ozon.api/ |
| Постфикс | Тип | Пример |
|---|---|---|
| (домен) | Сайт | @pirotehnika.spb.ru/ |
.api |
API/Интеграция | @ozon.api/ |
.service |
Сервис | @pim.service/ |
.server |
Сервер | @dev-pro.server/ |
.storage |
Хранилище | @beget-s3.storage/ |
.bot |
Бот | @telegram.bot/ |
.app |
Приложение | @market.app/ |
| Тип | Цель | Примеры |
|---|---|---|
personal |
Для себя | health/, learning/ |
social |
Для других | community/ |
business |
Заработок | pirotehnika/, lider/ |
platform |
Инфраструктура | infra/, architect/ |
Подробнее: architect/standards/types/PROJECT_TYPES.md
Версия: 5.0.1