architect/concept/PLATFORM.md

ПЛАТФОРМА: СИСТЕМА СИСТЕМ

Версия: 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


ПОКОЛЕНИЯ ПЛАТФОРМЫ

Gen 1: Текущее состояние (2024-2025)

Приложения на существующих средствах.

ИНСТРУМЕНТЫ:          ПРОЕКТЫ:
├── Claude Code        ├── IT-проекты (сайты, API)
├── OpenCart           ├── Бизнес-процессы
├── Drupal             └── Интеграции
├── Streamlit
└── ...

Фокус: Автоматизация IT-задач через AI-агентов.

Gen 2: Конструктор приложений (2025-2026)

Свой конструктор приложений. Платформа создаёт инструменты.

ПЛАТФОРМА:            СОЗДАЁТ:
├── Конструктор       ├── Сайты
├── Шаблоны           ├── Приложения
├── Паттерны          ├── Интеграции
└── Генераторы        └── Автоматизации

Фокус: Low-code/no-code для типовых задач.

Gen 3: Универсальное управление проектами (2026+)

Управление всеми типами проектов жизни, не только 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: ...

5 ПОДСИСТЕМ ПЛАТФОРМЫ

Согласно theory/SYSTEMS.md, система полностью описывается через ответы на 9 вопросов. Платформа как Обеспечивающая система состоит из 5 подсистем, каждая со своим типом:

ПОДСИСТЕМА 1: МЕТОДОЛОГИЯ

Тип: Информационная
Папка: 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/ Заготовки Обновляется

ПОДСИСТЕМА 2: АГЕНТЫ

Тип: Агент (множество агентов)
Папка: 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 — Архитектура агентов


ПОДСИСТЕМА 3: РЕСУРСЫ

Тип: Обеспечивающая
Папка: 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


ПОДСИСТЕМА 4: ИНФРАСТРУКТУРА

Тип: Обеспечивающая
Папка: infra/
Функция: ГДЕ всё работает

Вопрос Ответ
ЧТО? Серверы, хранилища, сервисы
КТО? Инфра-агент (управляет), проекты (используют)
КАК? SSH, Docker, Nginx, systemd
ЧЕМ? Linux, PostgreSQL, S3
ГДЕ? infra/
КОГДА? 24/7, обслуживание по необходимости
СКОЛЬКО? Uptime >99%, бэкапы ежедневно

Компоненты:
- Серверы (@.server)
- Хранилища (@
.storage)
- Сервисы (@*.service)

Подробнее: infra/STRUCTURE.md


ПОДСИСТЕМА 5: ДАННЫЕ

Тип: Информационная
Расположение: $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


ССЫЛКИ

Концепция

Теория

Стандарты

Workspace


ИСТОРИЯ


Версия: 5.0.1