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

Структура Workspace

Версия: 1.0.0
Дата: 2025-11-26

Главный принцип

Workspace = код, Hub = данные

В рабочем пространстве хранится только код и документация. Все данные — в облачном хабе (S3).

Главные проекты

Три независимых бизнеса на одном уровне:

Проект Описание
Пиротехника Продажа фейерверков
Лидер Автозапчасти
Seller1 Отдельный бизнес

Это параллельные направления, не иерархия.

Структура Workspace

/opt/claude-workspace/
│
├── pirotehnika/              Главный проект 1
│   ├── pim/                  Подпроект (каталог товаров)
│   ├── marketplace/          Подпроект (интеграция Ozon)
│   └── shop/                 Подпроект (магазин OpenCart)
│
├── lider/                    Главный проект 2
│   └── ...                   Подпроекты
│
├── seller1/                  Главный проект 3
│   └── ...                   Подпроекты
│
├── infra/                    Инфраструктура (общая)
│   ├── servers/              Серверы
│   ├── storage/              Хранилища
│   └── apis/                 Внешние API
│
├── system/                   AI-агенты
└── architect/                Архитектура и теория

Структура Hub (данные)

Зеркалирует workspace:

s3://hub/
│
├── pirotehnika/
│   ├── _shared/              Общие данные домена
│   │   ├── products/         Справочник товаров
│   │   ├── certificates/     Сертификаты
│   │   └── images/           Изображения
│   ├── pim/                  Данные подпроекта
│   ├── marketplace/          Данные подпроекта
│   └── shop/                 Данные подпроекта
│
├── lider/
│   ├── _shared/
│   └── ...
│
├── seller1/
│   ├── _shared/
│   └── ...
│
└── _platform/                Системные данные

Файл index.yaml

Каждая папка содержит index.yaml с:

  1. Идентификация — id, type, name, status
  2. Родитель — parent (путь к родителю)
  3. Дети — children (список подпапок)
  4. Зависимости — depends_on (от чего зависит)
  5. Предоставляет — provides_to (кому что даёт)
  6. Путь в хабе — hub (где данные)

Типы объектов

Тип Описание Примеры
root Корень workspace /
business Главный бизнес-проект pirotehnika, lider, seller1
project Подпроект с кодом pim, marketplace, shop
server Физический сервер dev-prod-rf, dev-pro
storage Хранилище данных s3-beget, yandex-disk
api Внешний сервис ozon, dadata
system Системный компонент system, architect

Связи

Вертикальные (иерархия)

Родитель — дети:
- pirotehnika → pim, marketplace, shop

Горизонтальные (зависимости)

Любой проект может зависеть от любого:
- pirotehnika/marketplace берёт данные из pirotehnika/pim
- lider/проект может брать данные из pirotehnika/pim

Правила доступа к данным

Данные Доступ
Свои данные Полный (читать, писать)
Данные родителя (_shared) Полный
Данные соседа Только читать
Данные другого главного проекта Только читать

Владение данными

Один проект владеет данными, остальные читают:

Данные Владелец Читатели
pirotehnika/_shared/products pirotehnika/pim marketplace, shop, lider/*
pirotehnika/marketplace/orders marketplace —

Навигация

Найти где развёрнут проект:
index.yaml проекта → depends_on → server

Найти все проекты на сервере:
index.yaml сервера → provides_to

Найти общие данные:
Подняться к родителю → _shared в хабе

Найти кто использует данные:
index.yaml владельца → provides_to

Версия: 1.0.0