# ДОМЕННАЯ МОДЕЛЬ СИСТЕМЫ SFERA

## 🎯 ОСНОВНЫЕ ДОМЕННЫЕ СУЩНОСТИ

### 1. ТИПЫ ОРГАНИЗАЦИЙ (OrganizationType)

На основе анализа Prisma schema и GraphQL типов выявлены 4 основных типа организаций:

```typescript
enum OrganizationType {
  FULFILLMENT  // Фулфилмент-центры
  SELLER       // Селлеры (продавцы на маркетплейсах)
  WHOLESALE    // Поставщики (оптовики)
  LOGIST       // Логистические компании
}
```

#### **FULFILLMENT (Фулфилмент-центры)**

- **Роль**: Обработка и хранение товаров
- **Основные функции**:
  - Прием товаров от селлеров/поставщиков
  - Обработка и упаковка
  - Отправка на маркетплейсы
  - Управление расходниками двух типов
- **Доступ к данным**: Полный доступ к своим операциям
- **Партнеры**: Селлеры, поставщики, логисты

#### **SELLER (Селлеры)**

- **Роль**: Продавцы на маркетплейсах
- **Основные функции**:
  - Создание поставок товаров
  - Определение рецептур продуктов
  - Заказ услуг фулфилмента
  - Интеграция с WB/Ozon API
- **Ограничения**: Нет доступа к чужим данным
- **Партнеры**: Фулфилменты, поставщики

#### **WHOLESALE (Поставщики)**

- **Роль**: Поставщики товаров и расходников
- **Основные функции**:
  - Управление каталогом товаров
  - Обработка заказов поставок
  - Подтверждение/отклонение заказов
  - Отгрузка товаров
- **Статусы заказов**: PENDING → SUPPLIER_APPROVED → SHIPPED
- **Партнеры**: Фулфилменты, селлеры

#### **LOGIST (Логистические компании)**

- **Роль**: Доставка товаров
- **Основные функции**:
  - Создание логистических маршрутов
  - Расчет стоимости доставки
  - Подтверждение заказов на доставку
  - Исполнение доставки
- **Ценообразование**: Под/над 1м³
- **Партнеры**: Все типы организаций

## 🔄 ОСНОВНЫЕ БИЗНЕС-ПРОЦЕССЫ

### СИСТЕМА ПАРТНЕРСТВА

```mermaid
graph TD
    A[Организация] --> B[Поиск партнеров]
    B --> C[Отправка заявки]
    C --> D[Ожидание ответа]
    D --> E[Принятие/Отклонение]
    E --> F[Автоматическое создание складских записей]
```

### WORKFLOW ПОСТАВОК (8 статусов)

```
PENDING → SUPPLIER_APPROVED → LOGISTICS_CONFIRMED → SHIPPED → DELIVERED
    ↓         ↓                    ↓                ↓        ↓
CANCELLED  CANCELLED          CANCELLED        CANCELLED  COMPLETED
```

## 📊 КЛЮЧЕВЫЕ ДОМЕННЫЕ ОБЪЕКТЫ

### SUPPLY (Расходники)

**Два типа расходников в системе:**

- `FULFILLMENT_CONSUMABLES` - расходники фулфилмента (для операций)
- `SELLER_CONSUMABLES` - расходники селлеров (на хранении)

### SUPPLY ORDER (Заказы поставок)

**Многоуровневая структура:**

- Organization (заказчик)
- Partner (поставщик)
- Fulfillment Center (получатель)
- Logistics Partner (доставка)
- Routes (маршруты)
- Items (товары/расходники)

### PRODUCT RECIPE (Рецептура продукта)

**Состав продукта для селлеров:**

- Services (услуги фулфилмента)
- Fulfillment Consumables (расходники фулфилмента)
- Seller Consumables (расходники селлера)
- Marketplace Card ID (связь с маркетплейсом)

## 🔗 РЕФЕРАЛЬНАЯ СИСТЕМА

### Источники рефералов:

- `REFERRAL_LINK` - прямые ссылки
- `AUTO_BUSINESS` - автоматическое партнерство

### Типы транзакций:

- `REGISTRATION` - регистрация
- `AUTO_PARTNERSHIP` - автоматическое партнерство
- `FIRST_ORDER` - первый заказ
- `MONTHLY_BONUS` - ежемесячный бонус

## 🌐 ИНТЕГРАЦИИ С МАРКЕТПЛЕЙСАМИ

### Поддерживаемые платформы:

- **Wildberries**: полная интеграция API
- **Ozon**: базовая интеграция API

### Данные интеграций:

- Статистика продаж
- Реклама и кампании
- Остатки на складах
- Заявки на возврат

---

_Создано на основе анализа кода: Prisma schema, GraphQL typedefs, resolvers_  
_Дата: 2025-08-21_