feat(fulfillment-supplies): миграция формы создания поставок расходников на v2 систему
- Обновлена форма создания поставок расходников фулфилмента для использования v2 GraphQL API - Заменена мутация CREATE_SUPPLY_ORDER на CREATE_FULFILLMENT_CONSUMABLE_SUPPLY - Обновлена структура input данных под новый формат v2 - Сделано поле логистики опциональным - Добавлено поле notes для комментариев к поставке - Обновлены refetchQueries на новые v2 запросы - Исправлены TypeScript ошибки в интерфейсах - Удалена дублирующая страница consumables-v2 - Сохранен оригинальный богатый UI интерфейс формы (819 строк) - Подтверждена работа с новой таблицей FulfillmentConsumableSupplyOrder Технические изменения: - src/components/fulfillment-supplies/create-fulfillment-consumables-supply-v2.tsx - основная форма - src/components/fulfillment-supplies/fulfillment-supplies-layout.tsx - обновлена навигация - Добавлены недостающие поля quantity и ordered в интерфейсы продуктов - Исправлены импорты и зависимости Результат: форма полностью интегрирована с v2 системой поставок, которая использует отдельные таблицы для каждого типа поставок согласно новой архитектуре. 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Veronika Smirnova
600
docs/development/DATABASE_SCHEMA_V2.md
Normal file
600
docs/development/DATABASE_SCHEMA_V2.md
Normal file
@ -0,0 +1,600 @@
|
||||
# 🗄️ СХЕМА БАЗЫ ДАННЫХ SFERA v2.0 - СИСТЕМА ПОСТАВОК
|
||||
|
||||
> **⚠️ ВАЖНО:** Этот документ описывает НОВЫЕ таблицы для системы поставок v2.0. Существующие таблицы остаются без изменений для обратной совместимости.
|
||||
|
||||
## 📦 НОВЫЕ ТАБЛИЦЫ ПОСТАВОК НА ФУЛФИЛМЕНТ
|
||||
|
||||
### 1️⃣ **FulfillmentConsumableSupplyOrder - Поставки расходников ФФ**
|
||||
|
||||
```prisma
|
||||
model FulfillmentConsumableSupplyOrder {
|
||||
// === БАЗОВЫЕ ПОЛЯ ===
|
||||
id String @id @default(cuid())
|
||||
status SupplyOrderStatusV2 @default(PENDING)
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
|
||||
// === ДАННЫЕ ФФ (создатель) ===
|
||||
fulfillmentCenterId String // кто заказывает (FK: Organization)
|
||||
requestedDeliveryDate DateTime // когда нужно
|
||||
resalePricePerUnit Decimal? @db.Decimal(10, 2) // цена продажи селлерам
|
||||
minStockLevel Int? // минимальный остаток
|
||||
notes String? // заметки ФФ
|
||||
|
||||
// === ДАННЫЕ ПОСТАВЩИКА ===
|
||||
supplierId String? // кто поставляет (FK: Organization)
|
||||
supplierApprovedAt DateTime? // когда одобрил
|
||||
packagesCount Int? // количество грузомест
|
||||
estimatedVolume Decimal? @db.Decimal(8, 3) // объем груза в м³
|
||||
supplierContractId String? // номер договора
|
||||
supplierNotes String? // заметки поставщика
|
||||
|
||||
// === ДАННЫЕ ЛОГИСТИКИ ===
|
||||
logisticsPartnerId String? // кто везет (FK: Organization)
|
||||
estimatedDeliveryDate DateTime? // план доставки
|
||||
routeId String? // маршрут (FK: LogisticsRoute)
|
||||
logisticsCost Decimal? @db.Decimal(10, 2) // стоимость доставки
|
||||
logisticsNotes String? // заметки логистики
|
||||
|
||||
// === ДАННЫЕ ОТГРУЗКИ ===
|
||||
shippedAt DateTime? // факт отгрузки
|
||||
trackingNumber String? // номер отслеживания
|
||||
|
||||
// === ДАННЫЕ ПРИЕМКИ ===
|
||||
receivedAt DateTime? // факт приемки
|
||||
receivedById String? // кто принял (FK: User)
|
||||
actualQuantity Int? // принято количество
|
||||
defectQuantity Int? // брак
|
||||
receiptNotes String? // заметки приемки
|
||||
|
||||
// === СВЯЗИ ===
|
||||
fulfillmentCenter Organization @relation("FFSupplyOrdersFulfillment", fields: [fulfillmentCenterId], references: [id])
|
||||
supplier Organization? @relation("FFSupplyOrdersSupplier", fields: [supplierId], references: [id])
|
||||
logisticsPartner Organization? @relation("FFSupplyOrdersLogistics", fields: [logisticsPartnerId], references: [id])
|
||||
receivedBy User? @relation("FFSupplyOrdersReceiver", fields: [receivedById], references: [id])
|
||||
items FulfillmentConsumableSupplyItem[]
|
||||
|
||||
@@map("fulfillment_consumable_supply_orders")
|
||||
}
|
||||
|
||||
model FulfillmentConsumableSupplyItem {
|
||||
id String @id @default(cuid())
|
||||
supplyOrderId String // связь с поставкой
|
||||
productId String // какой расходник (FK: Product)
|
||||
|
||||
// === КОЛИЧЕСТВА ===
|
||||
requestedQuantity Int // запросили
|
||||
approvedQuantity Int? // поставщик одобрил
|
||||
shippedQuantity Int? // отгрузили
|
||||
receivedQuantity Int? // приняли
|
||||
defectQuantity Int? @default(0) // брак
|
||||
|
||||
// === ЦЕНЫ ===
|
||||
unitPrice Decimal @db.Decimal(10, 2) // цена за единицу от поставщика
|
||||
totalPrice Decimal @db.Decimal(12, 2) // общая стоимость
|
||||
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
|
||||
// === СВЯЗИ ===
|
||||
supplyOrder FulfillmentConsumableSupplyOrder @relation(fields: [supplyOrderId], references: [id], onDelete: Cascade)
|
||||
product Product @relation("FFSupplyItems", fields: [productId], references: [id])
|
||||
|
||||
@@unique([supplyOrderId, productId])
|
||||
@@map("fulfillment_consumable_supply_items")
|
||||
}
|
||||
```
|
||||
|
||||
### 2️⃣ **SellerConsumableSupplyOrder - Поставки расходников селлеров**
|
||||
|
||||
```prisma
|
||||
model SellerConsumableSupplyOrder {
|
||||
// === БАЗОВЫЕ ПОЛЯ ===
|
||||
id String @id @default(cuid())
|
||||
status SupplyOrderStatusV2 @default(PENDING)
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
|
||||
// === ДАННЫЕ СЕЛЛЕРА (создатель) ===
|
||||
sellerId String // кто заказывает (FK: Organization)
|
||||
fulfillmentCenterId String // где будет храниться (FK: Organization)
|
||||
requestedDeliveryDate DateTime // когда нужно
|
||||
notes String? // заметки селлера
|
||||
|
||||
// === ДАННЫЕ ПОСТАВЩИКА ===
|
||||
supplierId String? // кто поставляет (FK: Organization)
|
||||
supplierApprovedAt DateTime? // когда одобрил
|
||||
packagesCount Int? // количество грузомест
|
||||
estimatedVolume Decimal? @db.Decimal(8, 3) // объем груза в м³
|
||||
supplierContractId String? // номер договора
|
||||
supplierNotes String? // заметки поставщика
|
||||
|
||||
// === ДАННЫЕ ЛОГИСТИКИ ===
|
||||
logisticsPartnerId String? // кто везет (FK: Organization)
|
||||
estimatedDeliveryDate DateTime? // план доставки
|
||||
routeId String? // маршрут (FK: LogisticsRoute)
|
||||
logisticsCost Decimal? @db.Decimal(10, 2) // стоимость доставки
|
||||
logisticsNotes String? // заметки логистики
|
||||
|
||||
// === ДАННЫЕ ОТГРУЗКИ ===
|
||||
shippedAt DateTime? // факт отгрузки
|
||||
trackingNumber String? // номер отслеживания
|
||||
|
||||
// === ДАННЫЕ ПРИЕМКИ ===
|
||||
receivedAt DateTime? // факт приемки ФФ
|
||||
receivedById String? // кто принял (FK: User)
|
||||
actualQuantity Int? // принято количество
|
||||
defectQuantity Int? // брак
|
||||
receiptNotes String? // заметки приемки
|
||||
|
||||
// === УНИКАЛЬНЫЕ ПОЛЯ ДЛЯ РАСХОДНИКОВ СЕЛЛЕРОВ ===
|
||||
storageTermMonths Int? // срок хранения в месяцах
|
||||
accessRights SellerConsumableAccessRights @default(SELLER_ONLY)
|
||||
storageCostPerMonth Decimal? @db.Decimal(8, 2) // стоимость хранения за месяц
|
||||
|
||||
// === СВЯЗИ ===
|
||||
seller Organization @relation("SellerSupplyOrdersSeller", fields: [sellerId], references: [id])
|
||||
fulfillmentCenter Organization @relation("SellerSupplyOrdersFulfillment", fields: [fulfillmentCenterId], references: [id])
|
||||
supplier Organization? @relation("SellerSupplyOrdersSupplier", fields: [supplierId], references: [id])
|
||||
logisticsPartner Organization? @relation("SellerSupplyOrdersLogistics", fields: [logisticsPartnerId], references: [id])
|
||||
receivedBy User? @relation("SellerSupplyOrdersReceiver", fields: [receivedById], references: [id])
|
||||
items SellerConsumableSupplyItem[]
|
||||
|
||||
@@map("seller_consumable_supply_orders")
|
||||
}
|
||||
|
||||
model SellerConsumableSupplyItem {
|
||||
id String @id @default(cuid())
|
||||
supplyOrderId String // связь с поставкой
|
||||
productId String // какой расходник селлера (FK: Product)
|
||||
|
||||
// === КОЛИЧЕСТВА ===
|
||||
requestedQuantity Int // запросили
|
||||
approvedQuantity Int? // поставщик одобрил
|
||||
shippedQuantity Int? // отгрузили
|
||||
receivedQuantity Int? // приняли
|
||||
defectQuantity Int? @default(0) // брак
|
||||
|
||||
// === ЦЕНЫ (видит только селлер) ===
|
||||
unitPrice Decimal @db.Decimal(10, 2) // цена за единицу от поставщика
|
||||
totalPrice Decimal @db.Decimal(12, 2) // общая стоимость
|
||||
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
|
||||
// === СВЯЗИ ===
|
||||
supplyOrder SellerConsumableSupplyOrder @relation(fields: [supplyOrderId], references: [id], onDelete: Cascade)
|
||||
product Product @relation("SellerSupplyItems", fields: [productId], references: [id])
|
||||
|
||||
@@unique([supplyOrderId, productId])
|
||||
@@map("seller_consumable_supply_items")
|
||||
}
|
||||
```
|
||||
|
||||
### 3️⃣ **GoodsSupplyOrder - Товарные поставки**
|
||||
|
||||
```prisma
|
||||
model GoodsSupplyOrder {
|
||||
// === БАЗОВЫЕ ПОЛЯ ===
|
||||
id String @id @default(cuid())
|
||||
status SupplyOrderStatusV2 @default(PENDING)
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
|
||||
// === ДАННЫЕ СЕЛЛЕРА (создатель) ===
|
||||
sellerId String // кто заказывает (FK: Organization)
|
||||
fulfillmentCenterId String // куда доставить (FK: Organization)
|
||||
requestedDeliveryDate DateTime // когда нужно
|
||||
notes String? // заметки селлера
|
||||
|
||||
// === ДАННЫЕ ПОСТАВЩИКА ===
|
||||
supplierId String? // кто поставляет (FK: Organization)
|
||||
supplierApprovedAt DateTime? // когда одобрил
|
||||
packagesCount Int? // количество грузомест
|
||||
estimatedVolume Decimal? @db.Decimal(8, 3) // объем груза в м³
|
||||
supplierContractId String? // номер договора
|
||||
supplierNotes String? // заметки поставщика
|
||||
|
||||
// === ДАННЫЕ ЛОГИСТИКИ ===
|
||||
logisticsPartnerId String? // кто везет (FK: Organization)
|
||||
estimatedDeliveryDate DateTime? // план доставки
|
||||
routeId String? // маршрут (FK: LogisticsRoute)
|
||||
logisticsCost Decimal? @db.Decimal(10, 2) // стоимость доставки
|
||||
logisticsNotes String? // заметки логистики
|
||||
|
||||
// === ДАННЫЕ ОТГРУЗКИ ===
|
||||
shippedAt DateTime? // факт отгрузки
|
||||
trackingNumber String? // номер отслеживания
|
||||
|
||||
// === ДАННЫЕ ПРИЕМКИ ===
|
||||
receivedAt DateTime? // факт приемки
|
||||
receivedById String? // кто принял (FK: User)
|
||||
actualQuantity Int? // принято количество
|
||||
defectQuantity Int? // брак
|
||||
receiptNotes String? // заметки приемки
|
||||
|
||||
// === УНИКАЛЬНЫЕ ПОЛЯ ДЛЯ ТОВАРОВ ===
|
||||
hasRecipes Boolean @default(false) // есть ли рецептуры
|
||||
totalServicesValue Decimal? @db.Decimal(12, 2) // общая стоимость услуг ФФ
|
||||
|
||||
// === СВЯЗИ ===
|
||||
seller Organization @relation("GoodsSupplyOrdersSeller", fields: [sellerId], references: [id])
|
||||
fulfillmentCenter Organization @relation("GoodsSupplyOrdersFulfillment", fields: [fulfillmentCenterId], references: [id])
|
||||
supplier Organization? @relation("GoodsSupplyOrdersSupplier", fields: [supplierId], references: [id])
|
||||
logisticsPartner Organization? @relation("GoodsSupplyOrdersLogistics", fields: [logisticsPartnerId], references: [id])
|
||||
receivedBy User? @relation("GoodsSupplyOrdersReceiver", fields: [receivedById], references: [id])
|
||||
items GoodsSupplyItem[]
|
||||
|
||||
@@map("goods_supply_orders")
|
||||
}
|
||||
|
||||
model GoodsSupplyItem {
|
||||
id String @id @default(cuid())
|
||||
supplyOrderId String // связь с поставкой
|
||||
productId String // какой товар (FK: Product)
|
||||
|
||||
// === КОЛИЧЕСТВА ===
|
||||
requestedQuantity Int // запросили
|
||||
approvedQuantity Int? // поставщик одобрил
|
||||
shippedQuantity Int? // отгрузили
|
||||
receivedQuantity Int? // приняли
|
||||
defectQuantity Int? @default(0) // брак
|
||||
|
||||
// === ЦЕНЫ (видит только селлер) ===
|
||||
unitPrice Decimal @db.Decimal(10, 2) // цена за единицу от поставщика
|
||||
totalPrice Decimal @db.Decimal(12, 2) // общая стоимость
|
||||
|
||||
// === РЕЦЕПТУРА (JSON) ===
|
||||
recipe Json? // полная рецептура в JSON
|
||||
/*
|
||||
recipe structure:
|
||||
{
|
||||
services: string[] // ID услуг ФФ
|
||||
fulfillmentConsumables: string[] // ID расходников ФФ
|
||||
sellerConsumables: string[] // ID расходников селлера
|
||||
marketplaceCardId?: string // карточка товара
|
||||
}
|
||||
*/
|
||||
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
|
||||
// === СВЯЗИ ===
|
||||
supplyOrder GoodsSupplyOrder @relation(fields: [supplyOrderId], references: [id], onDelete: Cascade)
|
||||
product Product @relation("GoodsSupplyItems", fields: [productId], references: [id])
|
||||
|
||||
@@unique([supplyOrderId, productId])
|
||||
@@map("goods_supply_items")
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🛒 ТАБЛИЦЫ ПОСТАВОК НА МАРКЕТПЛЕЙСЫ
|
||||
|
||||
### 4️⃣ **OzonSupplyOrder - Поставки на Ozon**
|
||||
|
||||
```prisma
|
||||
model OzonSupplyOrder {
|
||||
// === БАЗОВЫЕ ПОЛЯ ===
|
||||
id String @id @default(cuid())
|
||||
status MarketplaceSupplyStatus @default(PLANNED)
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
|
||||
// === ДАННЫЕ ФФ (создатель) ===
|
||||
fulfillmentCenterId String // кто отгружает (FK: Organization)
|
||||
plannedShipmentDate DateTime // план отгрузки
|
||||
notes String? // заметки ФФ
|
||||
|
||||
// === СПЕЦИФИЧНЫЕ ПОЛЯ OZON ===
|
||||
ozonWarehouseId String // склад Ozon
|
||||
ozonSupplyId String? // ID поставки в системе Ozon
|
||||
ozonPostingNumber String? // номер отправления Ozon
|
||||
|
||||
// === ДАННЫЕ ОТГРУЗКИ ===
|
||||
preparedAt DateTime? // готово к отгрузке
|
||||
shippedAt DateTime? // отгружено
|
||||
trackingNumber String? // номер отслеживания
|
||||
|
||||
// === ДАННЫЕ ПРИЕМКИ МАРКЕТПЛЕЙСОМ ===
|
||||
acceptedAt DateTime? // принято Ozon
|
||||
acceptedQuantity Int? // принято количество
|
||||
rejectedQuantity Int? // отклонено
|
||||
rejectionReason String? // причина отклонения
|
||||
|
||||
// === СВЯЗИ ===
|
||||
fulfillmentCenter Organization @relation("OzonSupplyOrders", fields: [fulfillmentCenterId], references: [id])
|
||||
items OzonSupplyItem[]
|
||||
|
||||
@@map("ozon_supply_orders")
|
||||
}
|
||||
|
||||
model OzonSupplyItem {
|
||||
id String @id @default(cuid())
|
||||
supplyOrderId String // связь с поставкой
|
||||
productId String // какой готовый продукт (FK: Product)
|
||||
|
||||
// === КОЛИЧЕСТВА ===
|
||||
plannedQuantity Int // планируется отгрузить
|
||||
preparedQuantity Int? // подготовлено
|
||||
shippedQuantity Int? // отгружено
|
||||
acceptedQuantity Int? // принято Ozon
|
||||
rejectedQuantity Int? @default(0) // отклонено
|
||||
|
||||
// === OZON СПЕЦИФИЧНЫЕ ПОЛЯ ===
|
||||
ozonProductId String? // ID товара в Ozon
|
||||
ozonSku String? // SKU в Ozon
|
||||
ozonBarcode String? // штрихкод
|
||||
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
|
||||
// === СВЯЗИ ===
|
||||
supplyOrder OzonSupplyOrder @relation(fields: [supplyOrderId], references: [id], onDelete: Cascade)
|
||||
product Product @relation("OzonSupplyItems", fields: [productId], references: [id])
|
||||
|
||||
@@unique([supplyOrderId, productId])
|
||||
@@map("ozon_supply_items")
|
||||
}
|
||||
```
|
||||
|
||||
### 5️⃣ **WildberriesSupplyOrder - Поставки на Wildberries**
|
||||
|
||||
```prisma
|
||||
model WildberriesSupplyOrder {
|
||||
// === БАЗОВЫЕ ПОЛЯ ===
|
||||
id String @id @default(cuid())
|
||||
status MarketplaceSupplyStatus @default(PLANNED)
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
|
||||
// === ДАННЫЕ ФФ (создатель) ===
|
||||
fulfillmentCenterId String // кто отгружает (FK: Organization)
|
||||
plannedShipmentDate DateTime // план отгрузки
|
||||
notes String? // заметки ФФ
|
||||
|
||||
// === СПЕЦИФИЧНЫЕ ПОЛЯ WILDBERRIES ===
|
||||
wbWarehouseId String // склад WB
|
||||
wbSupplyId String? // ID поставки в системе WB
|
||||
wbStickerId String? // ID стикера WB
|
||||
|
||||
// === ДАННЫЕ ОТГРУЗКИ ===
|
||||
preparedAt DateTime? // готово к отгрузке
|
||||
shippedAt DateTime? // отгружено
|
||||
trackingNumber String? // номер отслеживания
|
||||
|
||||
// === ДАННЫЕ ПРИЕМКИ МАРКЕТПЛЕЙСОМ ===
|
||||
acceptedAt DateTime? // принято WB
|
||||
acceptedQuantity Int? // принято количество
|
||||
rejectedQuantity Int? // отклонено
|
||||
rejectionReason String? // причина отклонения
|
||||
|
||||
// === СВЯЗИ ===
|
||||
fulfillmentCenter Organization @relation("WildberriesSupplyOrders", fields: [fulfillmentCenterId], references: [id])
|
||||
items WildberriesSupplyItem[]
|
||||
|
||||
@@map("wildberries_supply_orders")
|
||||
}
|
||||
|
||||
model WildberriesSupplyItem {
|
||||
id String @id @default(cuid())
|
||||
supplyOrderId String // связь с поставкой
|
||||
productId String // какой готовый продукт (FK: Product)
|
||||
|
||||
// === КОЛИЧЕСТВА ===
|
||||
plannedQuantity Int // планируется отгрузить
|
||||
preparedQuantity Int? // подготовлено
|
||||
shippedQuantity Int? // отгружено
|
||||
acceptedQuantity Int? // принято WB
|
||||
rejectedQuantity Int? @default(0) // отклонено
|
||||
|
||||
// === WB СПЕЦИФИЧНЫЕ ПОЛЯ ===
|
||||
wbNmId String? // Номенклатура WB
|
||||
wbSku String? // SKU в WB
|
||||
wbBarcode String? // штрихкод
|
||||
wbSize String? // размер для WB
|
||||
|
||||
createdAt DateTime @default(now())
|
||||
updatedAt DateTime @updatedAt
|
||||
|
||||
// === СВЯЗИ ===
|
||||
supplyOrder WildberriesSupplyOrder @relation(fields: [supplyOrderId], references: [id], onDelete: Cascade)
|
||||
product Product @relation("WBSupplyItems", fields: [productId], references: [id])
|
||||
|
||||
@@unique([supplyOrderId, productId])
|
||||
@@map("wildberries_supply_items")
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 НОВЫЕ ENUMS
|
||||
|
||||
### **SupplyOrderStatusV2 - Статусы поставок НА фулфилмент**
|
||||
|
||||
```prisma
|
||||
enum SupplyOrderStatusV2 {
|
||||
PENDING // Ожидает одобрения поставщика
|
||||
SUPPLIER_APPROVED // Одобрено поставщиком
|
||||
LOGISTICS_CONFIRMED // Логистика подтверждена
|
||||
SHIPPED // Отгружено поставщиком
|
||||
IN_TRANSIT // В пути
|
||||
DELIVERED // Доставлено и принято
|
||||
CANCELLED // Отменено
|
||||
}
|
||||
```
|
||||
|
||||
### **MarketplaceSupplyStatus - Статусы поставок НА маркетплейсы**
|
||||
|
||||
```prisma
|
||||
enum MarketplaceSupplyStatus {
|
||||
PLANNED // Запланирована
|
||||
PREPARED // Подготовлена к отгрузке
|
||||
SHIPPED_TO_MARKETPLACE // Отгружена на маркетплейс
|
||||
ACCEPTED_BY_MARKETPLACE // Принята маркетплейсом
|
||||
CANCELLED // Отменена
|
||||
}
|
||||
```
|
||||
|
||||
### **SellerConsumableAccessRights - Права доступа к расходникам селлеров**
|
||||
|
||||
```prisma
|
||||
enum SellerConsumableAccessRights {
|
||||
SELLER_ONLY // Только селлер может использовать
|
||||
SHARED_WITH_FF // ФФ тоже может использовать (с разрешения)
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 ОБНОВЛЕНИЯ СУЩЕСТВУЮЩИХ ТАБЛИЦ
|
||||
|
||||
### **Product - Добавление новых связей**
|
||||
|
||||
```prisma
|
||||
model Product {
|
||||
// ... существующие поля остаются без изменений
|
||||
|
||||
// === НОВЫЕ СВЯЗИ С ПОСТАВКАМИ V2 ===
|
||||
fulfillmentSupplyItems FulfillmentConsumableSupplyItem[] @relation("FFSupplyItems")
|
||||
sellerSupplyItems SellerConsumableSupplyItem[] @relation("SellerSupplyItems")
|
||||
goodsSupplyItems GoodsSupplyItem[] @relation("GoodsSupplyItems")
|
||||
ozonSupplyItems OzonSupplyItem[] @relation("OzonSupplyItems")
|
||||
wildberriesSupplyItems WildberriesSupplyItem[] @relation("WBSupplyItems")
|
||||
|
||||
// ... остальные поля остаются без изменений
|
||||
}
|
||||
```
|
||||
|
||||
### **Organization - Добавление новых связей**
|
||||
|
||||
```prisma
|
||||
model Organization {
|
||||
// ... существующие поля остаются без изменений
|
||||
|
||||
// === НОВЫЕ СВЯЗИ С ПОСТАВКАМИ V2 ===
|
||||
// Поставки расходников ФФ
|
||||
fulfillmentSupplyOrdersAsFulfillment FulfillmentConsumableSupplyOrder[] @relation("FFSupplyOrdersFulfillment")
|
||||
fulfillmentSupplyOrdersAsSupplier FulfillmentConsumableSupplyOrder[] @relation("FFSupplyOrdersSupplier")
|
||||
fulfillmentSupplyOrdersAsLogistics FulfillmentConsumableSupplyOrder[] @relation("FFSupplyOrdersLogistics")
|
||||
|
||||
// Поставки расходников селлеров
|
||||
sellerSupplyOrdersAsSeller SellerConsumableSupplyOrder[] @relation("SellerSupplyOrdersSeller")
|
||||
sellerSupplyOrdersAsFulfillment SellerConsumableSupplyOrder[] @relation("SellerSupplyOrdersFulfillment")
|
||||
sellerSupplyOrdersAsSupplier SellerConsumableSupplyOrder[] @relation("SellerSupplyOrdersSupplier")
|
||||
sellerSupplyOrdersAsLogistics SellerConsumableSupplyOrder[] @relation("SellerSupplyOrdersLogistics")
|
||||
|
||||
// Товарные поставки
|
||||
goodsSupplyOrdersAsSeller GoodsSupplyOrder[] @relation("GoodsSupplyOrdersSeller")
|
||||
goodsSupplyOrdersAsFulfillment GoodsSupplyOrder[] @relation("GoodsSupplyOrdersFulfillment")
|
||||
goodsSupplyOrdersAsSupplier GoodsSupplyOrder[] @relation("GoodsSupplyOrdersSupplier")
|
||||
goodsSupplyOrdersAsLogistics GoodsSupplyOrder[] @relation("GoodsSupplyOrdersLogistics")
|
||||
|
||||
// Поставки на маркетплейсы
|
||||
ozonSupplyOrders OzonSupplyOrder[] @relation("OzonSupplyOrders")
|
||||
wildberriesSupplyOrders WildberriesSupplyOrder[] @relation("WildberriesSupplyOrders")
|
||||
|
||||
// ... остальные поля остаются без изменений
|
||||
}
|
||||
```
|
||||
|
||||
### **User - Добавление новых связей**
|
||||
|
||||
```prisma
|
||||
model User {
|
||||
// ... существующие поля остаются без изменений
|
||||
|
||||
// === НОВЫЕ СВЯЗИ С ПРИЕМКОЙ ПОСТАВОК V2 ===
|
||||
fulfillmentSupplyOrdersReceived FulfillmentConsumableSupplyOrder[] @relation("FFSupplyOrdersReceiver")
|
||||
sellerSupplyOrdersReceived SellerConsumableSupplyOrder[] @relation("SellerSupplyOrdersReceiver")
|
||||
goodsSupplyOrdersReceived GoodsSupplyOrder[] @relation("GoodsSupplyOrdersReceiver")
|
||||
|
||||
// ... остальные поля остаются без изменений
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔍 ИНДЕКСЫ ДЛЯ ПРОИЗВОДИТЕЛЬНОСТИ
|
||||
|
||||
```prisma
|
||||
// Индексы для быстрого поиска поставок по статусу и организации
|
||||
@@index([fulfillmentCenterId, status])
|
||||
@@index([sellerId, status])
|
||||
@@index([supplierId, status])
|
||||
@@index([logisticsPartnerId, status])
|
||||
|
||||
// Индексы для поиска по датам
|
||||
@@index([createdAt])
|
||||
@@index([requestedDeliveryDate])
|
||||
@@index([estimatedDeliveryDate])
|
||||
|
||||
// Индексы для отслеживания
|
||||
@@index([trackingNumber])
|
||||
@@index([supplierContractId])
|
||||
|
||||
// Маркетплейс-специфичные индексы
|
||||
@@index([ozonSupplyId])
|
||||
@@index([ozonProductId])
|
||||
@@index([wbSupplyId])
|
||||
@@index([wbNmId])
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📋 ПЛАН МИГРАЦИИ
|
||||
|
||||
### **Phase 1: Создание новых таблиц**
|
||||
```sql
|
||||
-- Создание таблиц параллельно с существующими
|
||||
CREATE TABLE fulfillment_consumable_supply_orders (...);
|
||||
CREATE TABLE fulfillment_consumable_supply_items (...);
|
||||
-- и т.д.
|
||||
```
|
||||
|
||||
### **Phase 2: Новые enum значения**
|
||||
```sql
|
||||
-- Добавление новых enum без затрагивания старых
|
||||
CREATE TYPE "SupplyOrderStatusV2" AS ENUM (...);
|
||||
CREATE TYPE "MarketplaceSupplyStatus" AS ENUM (...);
|
||||
```
|
||||
|
||||
### **Phase 3: Обновление связей (без удаления старых)**
|
||||
```sql
|
||||
-- Добавление новых foreign key связей
|
||||
ALTER TABLE "Product" ADD COLUMN ...;
|
||||
ALTER TABLE "Organization" ADD COLUMN ...;
|
||||
```
|
||||
|
||||
### **Phase 4: Данные миграции (только с одобрения)**
|
||||
```sql
|
||||
-- Миграция данных из старых таблиц в новые
|
||||
-- ТОЛЬКО после полного тестирования новой системы
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ ВАЖНЫЕ ПРИНЦИПЫ
|
||||
|
||||
### ✅ **ОБРАТНАЯ СОВМЕСТИМОСТЬ**
|
||||
- Все существующие таблицы остаются без изменений
|
||||
- Новые таблицы создаются параллельно
|
||||
- Старая система продолжает работать
|
||||
|
||||
### 🔒 **БЕЗОПАСНОСТЬ ДАННЫХ**
|
||||
- Каждый тип поставки изолирован в отдельной таблице
|
||||
- Связи защищены foreign key constraints
|
||||
- Каскадное удаление только для зависимых записей
|
||||
|
||||
### 📈 **МАСШТАБИРУЕМОСТЬ**
|
||||
- Легко добавлять новые типы поставок
|
||||
- Оптимизированные индексы для каждого use case
|
||||
- Независимые схемы для разных процессов
|
||||
|
||||
### 🛡️ **ЦЕЛОСТНОСТЬ ДАННЫХ**
|
||||
- Строгие ограничения на связи между таблицами
|
||||
- Валидация через enum значения
|
||||
- Уникальные индексы предотвращают дублирование
|
||||
|
||||
**Следующий шаг:** Создание Prisma миграций для FulfillmentConsumableSupplyOrder
|
||||
817
docs/development/SUPPLY_SYSTEM_IMPLEMENTATION_PLAN.md
Normal file
817
docs/development/SUPPLY_SYSTEM_IMPLEMENTATION_PLAN.md
Normal file
@ -0,0 +1,817 @@
|
||||
# 🛡️ ДЕТАЛЬНЫЙ БЕЗОПАСНЫЙ ПЛАН РЕАЛИЗАЦИИ СИСТЕМЫ ПОСТАВОК v2.0
|
||||
|
||||
> **🎯 ЦЕЛЬ:** Поэтапная миграция на новую архитектуру системы поставок без нарушения работы существующей системы
|
||||
|
||||
## 🔒 ПРИНЦИПЫ БЕЗОПАСНОЙ РЕАЛИЗАЦИИ
|
||||
|
||||
### ✅ **ЗОЛОТЫЕ ПРАВИЛА:**
|
||||
1. **НИКОГДА НЕ ЛОМАТЬ СУЩЕСТВУЮЩИЙ ФУНКЦИОНАЛ** - старая система работает на 100%
|
||||
2. **КАЖДЫЙ ЭТАП ИМЕЕТ ТОЧКУ ОТКАТА** - можно вернуться к предыдущему состоянию
|
||||
3. **ТЕСТИРОВАНИЕ ПЕРЕД ПРОДАКШЕНОМ** - каждое изменение проверяется отдельно
|
||||
4. **МОДУЛЬНОСТЬ** - изменения изолированы друг от друга
|
||||
5. **ОДОБРЕНИЕ ПОЛЬЗОВАТЕЛЯ** - удаление старого кода ТОЛЬКО с разрешения
|
||||
6. **МОНИТОРИНГ** - отслеживание работы на каждом этапе
|
||||
|
||||
### 🛠️ **ИНСТРУМЕНТЫ БЕЗОПАСНОСТИ:**
|
||||
- **Feature Flags** - включение/отключение новой функциональности
|
||||
- **Database Migrations** - обратимые изменения схемы БД
|
||||
- **Parallel Testing** - новая система тестируется параллельно со старой
|
||||
- **Gradual Rollout** - постепенное включение для пользователей
|
||||
- **Automated Rollback** - автоматический откат при критических ошибках
|
||||
|
||||
---
|
||||
|
||||
## 📋 PHASE 1: FULFILLMENT CONSUMABLE SUPPLY ORDERS
|
||||
|
||||
> **Сроки:** 2-3 недели
|
||||
> **Риск:** НИЗКИЙ (новая функциональность параллельно со старой)
|
||||
|
||||
### 🎯 **ЦЕЛЬ PHASE 1:**
|
||||
Создать полностью рабочую систему для поставок расходников фулфилмента, которая работает параллельно со старой системой.
|
||||
|
||||
---
|
||||
|
||||
## 📊 STEP 1.1: ПОДГОТОВКА ИНФРАСТРУКТУРЫ
|
||||
|
||||
### **Задачи:**
|
||||
1. ✅ Создание feature flag системы
|
||||
2. ✅ Настройка параллельного тестирования
|
||||
3. ✅ Подготовка инструментов мониторинга
|
||||
|
||||
### **1.1.1 Feature Flags**
|
||||
```typescript
|
||||
// /src/lib/featureFlags.ts
|
||||
export const FEATURE_FLAGS = {
|
||||
FULFILLMENT_CONSUMABLE_SUPPLY_V2: process.env.FULFILLMENT_CONSUMABLE_V2 === 'true',
|
||||
ENABLE_PARALLEL_TESTING: process.env.PARALLEL_TESTING === 'true',
|
||||
} as const
|
||||
|
||||
export function isFeatureEnabled(flag: keyof typeof FEATURE_FLAGS): boolean {
|
||||
return FEATURE_FLAGS[flag] || false
|
||||
}
|
||||
```
|
||||
|
||||
### **1.1.2 Мониторинг**
|
||||
```typescript
|
||||
// /src/lib/monitoring/supplySystemMonitor.ts
|
||||
export class SupplySystemMonitor {
|
||||
static logMigrationEvent(event: string, data: any) {
|
||||
console.log(`[SUPPLY_V2_MIGRATION] ${event}:`, data)
|
||||
// Отправка в систему мониторинга
|
||||
}
|
||||
|
||||
static logError(error: Error, context: string) {
|
||||
console.error(`[SUPPLY_V2_ERROR] ${context}:`, error)
|
||||
// Алерты в систему мониторинга
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### **1.1.3 Тестовая база данных**
|
||||
```bash
|
||||
# Создание отдельной БД для тестирования миграций
|
||||
npm run db:create:test-migration
|
||||
npm run db:migrate:test
|
||||
```
|
||||
|
||||
### **⚠️ ТОЧКА ПРОВЕРКИ 1.1:**
|
||||
- [ ] Feature flags работают
|
||||
- [ ] Мониторинг настроен
|
||||
- [ ] Тестовая БД создана
|
||||
- [ ] **ОТКАТ:** Отключить feature flags
|
||||
|
||||
**🔒 ROLLBACK PLAN 1.1:**
|
||||
```bash
|
||||
# Отключение feature flags
|
||||
export FULFILLMENT_CONSUMABLE_V2=false
|
||||
# Остановка мониторинга новых метрик
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🗄️ STEP 1.2: СОЗДАНИЕ СХЕМЫ БАЗЫ ДАННЫХ
|
||||
|
||||
### **Задачи:**
|
||||
1. ✅ Создание новых Prisma моделей
|
||||
2. ✅ Генерация и проверка миграций
|
||||
3. ✅ Применение миграций в test окружении
|
||||
|
||||
### **1.2.1 Prisma Schema Update**
|
||||
```prisma
|
||||
// Добавление в /prisma/schema.prisma
|
||||
model FulfillmentConsumableSupplyOrder {
|
||||
// ... полная схема из DATABASE_SCHEMA_V2.md
|
||||
}
|
||||
|
||||
model FulfillmentConsumableSupplyItem {
|
||||
// ... полная схема из DATABASE_SCHEMA_V2.md
|
||||
}
|
||||
|
||||
enum SupplyOrderStatusV2 {
|
||||
PENDING
|
||||
SUPPLIER_APPROVED
|
||||
LOGISTICS_CONFIRMED
|
||||
SHIPPED
|
||||
IN_TRANSIT
|
||||
DELIVERED
|
||||
CANCELLED
|
||||
}
|
||||
```
|
||||
|
||||
### **1.2.2 Создание миграции**
|
||||
```bash
|
||||
# Генерация миграции
|
||||
npx prisma migrate dev --name "add_fulfillment_consumable_supply_v2"
|
||||
|
||||
# Проверка SQL миграции ПЕРЕД применением
|
||||
cat prisma/migrations/xxx_add_fulfillment_consumable_supply_v2/migration.sql
|
||||
```
|
||||
|
||||
### **1.2.3 Тестирование миграции**
|
||||
```bash
|
||||
# Применение в тестовой БД
|
||||
npx prisma migrate deploy --schema=./prisma/schema.test.prisma
|
||||
|
||||
# Проверка создания таблиц
|
||||
npx prisma studio --schema=./prisma/schema.test.prisma
|
||||
```
|
||||
|
||||
### **⚠️ ТОЧКА ПРОВЕРКИ 1.2:**
|
||||
- [ ] Миграция создана успешно
|
||||
- [ ] SQL миграции проверен вручную
|
||||
- [ ] Таблицы созданы в тестовой БД
|
||||
- [ ] Все связи (FK) работают корректно
|
||||
- [ ] **ОТКАТ:** Revert migration
|
||||
|
||||
**🔒 ROLLBACK PLAN 1.2:**
|
||||
```bash
|
||||
# Откат миграции
|
||||
npx prisma migrate reset --force --skip-seed
|
||||
# ИЛИ ручной DROP TABLE если нужно
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚡ STEP 1.3: GRAPHQL API
|
||||
|
||||
### **Задачи:**
|
||||
1. ✅ Создание GraphQL типов
|
||||
2. ✅ Создание resolvers с feature flag
|
||||
3. ✅ Тестирование API отдельно
|
||||
|
||||
### **1.3.1 GraphQL Types**
|
||||
```typescript
|
||||
// /src/graphql/typedefs.ts - ДОБАВИТЬ К СУЩЕСТВУЮЩИМ
|
||||
const fulfillmentConsumableTypes = `
|
||||
type FulfillmentConsumableSupplyOrder {
|
||||
id: ID!
|
||||
status: SupplyOrderStatusV2!
|
||||
fulfillmentCenterId: ID!
|
||||
supplierId: ID
|
||||
requestedDeliveryDate: DateTime!
|
||||
resalePricePerUnit: Float
|
||||
# ... все остальные поля
|
||||
items: [FulfillmentConsumableSupplyItem!]!
|
||||
}
|
||||
|
||||
type FulfillmentConsumableSupplyItem {
|
||||
id: ID!
|
||||
productId: ID!
|
||||
requestedQuantity: Int!
|
||||
unitPrice: Float!
|
||||
totalPrice: Float!
|
||||
product: Product!
|
||||
}
|
||||
|
||||
enum SupplyOrderStatusV2 {
|
||||
PENDING
|
||||
SUPPLIER_APPROVED
|
||||
LOGISTICS_CONFIRMED
|
||||
SHIPPED
|
||||
IN_TRANSIT
|
||||
DELIVERED
|
||||
CANCELLED
|
||||
}
|
||||
|
||||
input CreateFulfillmentConsumableSupplyInput {
|
||||
supplierId: ID!
|
||||
requestedDeliveryDate: DateTime!
|
||||
items: [FulfillmentConsumableSupplyItemInput!]!
|
||||
notes: String
|
||||
}
|
||||
|
||||
input FulfillmentConsumableSupplyItemInput {
|
||||
productId: ID!
|
||||
requestedQuantity: Int!
|
||||
}
|
||||
|
||||
type CreateFulfillmentConsumableSupplyResult {
|
||||
success: Boolean!
|
||||
message: String!
|
||||
supplyOrder: FulfillmentConsumableSupplyOrder
|
||||
}
|
||||
|
||||
extend type Query {
|
||||
# Новые запросы с feature flag
|
||||
myFulfillmentConsumableSupplies: [FulfillmentConsumableSupplyOrder!]!
|
||||
fulfillmentConsumableSupply(id: ID!): FulfillmentConsumableSupplyOrder
|
||||
}
|
||||
|
||||
extend type Mutation {
|
||||
# Новые мутации с feature flag
|
||||
createFulfillmentConsumableSupply(
|
||||
input: CreateFulfillmentConsumableSupplyInput!
|
||||
): CreateFulfillmentConsumableSupplyResult!
|
||||
}
|
||||
`
|
||||
```
|
||||
|
||||
### **1.3.2 Resolvers с Feature Flags**
|
||||
```typescript
|
||||
// /src/graphql/resolvers.ts - ДОБАВИТЬ К СУЩЕСТВУЮЩИМ
|
||||
const fulfillmentConsumableResolvers = {
|
||||
Query: {
|
||||
myFulfillmentConsumableSupplies: async (_: unknown, __: unknown, context: Context) => {
|
||||
// 🚨 FEATURE FLAG ПРОВЕРКА
|
||||
if (!isFeatureEnabled('FULFILLMENT_CONSUMABLE_SUPPLY_V2')) {
|
||||
throw new GraphQLError('Feature not enabled')
|
||||
}
|
||||
|
||||
SupplySystemMonitor.logMigrationEvent('API_CALL', {
|
||||
operation: 'myFulfillmentConsumableSupplies',
|
||||
userId: context.user?.id
|
||||
})
|
||||
|
||||
try {
|
||||
// Полная реализация с системой безопасности
|
||||
// ... код реализации
|
||||
} catch (error) {
|
||||
SupplySystemMonitor.logError(error, 'myFulfillmentConsumableSupplies')
|
||||
throw error
|
||||
}
|
||||
},
|
||||
|
||||
fulfillmentConsumableSupply: async (_: unknown, args: { id: string }, context: Context) => {
|
||||
if (!isFeatureEnabled('FULFILLMENT_CONSUMABLE_SUPPLY_V2')) {
|
||||
throw new GraphQLError('Feature not enabled')
|
||||
}
|
||||
// ... реализация
|
||||
}
|
||||
},
|
||||
|
||||
Mutation: {
|
||||
createFulfillmentConsumableSupply: async (_: unknown, args: any, context: Context) => {
|
||||
if (!isFeatureEnabled('FULFILLMENT_CONSUMABLE_SUPPLY_V2')) {
|
||||
return { success: false, message: 'Feature not enabled' }
|
||||
}
|
||||
|
||||
SupplySystemMonitor.logMigrationEvent('CREATE_SUPPLY', {
|
||||
supplierId: args.input.supplierId,
|
||||
itemsCount: args.input.items.length,
|
||||
userId: context.user?.id
|
||||
})
|
||||
|
||||
try {
|
||||
// Полная реализация создания поставки
|
||||
// ... код реализации
|
||||
|
||||
return { success: true, message: 'Supply created', supplyOrder: result }
|
||||
} catch (error) {
|
||||
SupplySystemMonitor.logError(error, 'createFulfillmentConsumableSupply')
|
||||
return { success: false, message: error.message }
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### **1.3.3 API Testing**
|
||||
```typescript
|
||||
// /tests/api/fulfillmentConsumableSupply.test.ts
|
||||
describe('FulfillmentConsumableSupply API', () => {
|
||||
beforeAll(() => {
|
||||
// Включаем feature flag для тестов
|
||||
process.env.FULFILLMENT_CONSUMABLE_V2 = 'true'
|
||||
})
|
||||
|
||||
test('should create supply order', async () => {
|
||||
const mutation = `
|
||||
mutation CreateFulfillmentConsumableSupply($input: CreateFulfillmentConsumableSupplyInput!) {
|
||||
createFulfillmentConsumableSupply(input: $input) {
|
||||
success
|
||||
message
|
||||
supplyOrder {
|
||||
id
|
||||
status
|
||||
}
|
||||
}
|
||||
}
|
||||
`
|
||||
// ... тестирование
|
||||
})
|
||||
|
||||
test('should not work when feature disabled', async () => {
|
||||
process.env.FULFILLMENT_CONSUMABLE_V2 = 'false'
|
||||
// Проверка что API недоступно
|
||||
})
|
||||
})
|
||||
```
|
||||
|
||||
### **⚠️ ТОЧКА ПРОВЕРКИ 1.3:**
|
||||
- [ ] GraphQL типы корректны
|
||||
- [ ] Resolvers работают с feature flag
|
||||
- [ ] API тесты проходят
|
||||
- [ ] Feature flag блокирует доступ когда выключен
|
||||
- [ ] **ОТКАТ:** Отключить feature flag
|
||||
|
||||
**🔒 ROLLBACK PLAN 1.3:**
|
||||
```bash
|
||||
# Отключение API через feature flag
|
||||
export FULFILLMENT_CONSUMABLE_V2=false
|
||||
# API станет недоступно мгновенно
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎨 STEP 1.4: FRONTEND ИНТЕРФЕЙС
|
||||
|
||||
### **Задачи:**
|
||||
1. ✅ Создание формы создания поставки
|
||||
2. ✅ Создание страницы просмотра поставок
|
||||
3. ✅ Интеграция с существующим интерфейсом
|
||||
|
||||
### **1.4.1 Feature Flag в Frontend**
|
||||
```typescript
|
||||
// /src/lib/featureFlags.client.ts
|
||||
export function useFeatureFlag(flag: string) {
|
||||
return process.env.NEXT_PUBLIC_FULFILLMENT_CONSUMABLE_V2 === 'true'
|
||||
}
|
||||
```
|
||||
|
||||
### **1.4.2 Форма создания (с feature flag)**
|
||||
```typescript
|
||||
// /src/components/fulfillment-supplies/create-consumables-v2.tsx
|
||||
export function CreateConsumablesV2Page() {
|
||||
const featureEnabled = useFeatureFlag('FULFILLMENT_CONSUMABLE_V2')
|
||||
|
||||
if (!featureEnabled) {
|
||||
// Показываем старую версию или заглушку
|
||||
return <CreateConsumablesV1 />
|
||||
}
|
||||
|
||||
// Новая реализация
|
||||
return (
|
||||
<div>
|
||||
<h1>Создать поставку расходников ФФ (v2.0)</h1>
|
||||
{/* Полная форма */}
|
||||
</div>
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### **1.4.3 Список поставок (с feature flag)**
|
||||
```typescript
|
||||
// /src/components/fulfillment-supplies/ff-consumables-v2.tsx
|
||||
export function FFConsumablesV2Tab() {
|
||||
const featureEnabled = useFeatureFlag('FULFILLMENT_CONSUMABLE_V2')
|
||||
|
||||
if (!featureEnabled) {
|
||||
return <FFConsumablesV1Tab />
|
||||
}
|
||||
|
||||
const { data, loading, error } = useQuery(GET_MY_FULFILLMENT_CONSUMABLE_SUPPLIES)
|
||||
|
||||
// Новая реализация отображения
|
||||
}
|
||||
```
|
||||
|
||||
### **1.4.4 Интеграция в роутинг**
|
||||
```typescript
|
||||
// /src/app/fulfillment-supplies/ff-consumables/page.tsx
|
||||
export default function FFConsumablesPage() {
|
||||
const featureEnabled = useFeatureFlag('FULFILLMENT_CONSUMABLE_V2')
|
||||
|
||||
return featureEnabled ? <FFConsumablesV2Tab /> : <FFConsumablesV1Tab />
|
||||
}
|
||||
```
|
||||
|
||||
### **⚠️ ТОЧКА ПРОВЕРКИ 1.4:**
|
||||
- [ ] Форма создания работает
|
||||
- [ ] Список поставок отображается
|
||||
- [ ] Feature flag переключает версии
|
||||
- [ ] Нет поломок в старом интерфейсе
|
||||
- [ ] **ОТКАТ:** Отключить frontend feature flag
|
||||
|
||||
**🔒 ROLLBACK PLAN 1.4:**
|
||||
```bash
|
||||
# Отключение новых компонентов
|
||||
export NEXT_PUBLIC_FULFILLMENT_CONSUMABLE_V2=false
|
||||
# Пользователи увидят старый интерфейс
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔗 STEP 1.5: ИНТЕГРАЦИЯ И END-TO-END ТЕСТИРОВАНИЕ
|
||||
|
||||
### **Задачи:**
|
||||
1. ✅ Полное тестирование workflow поставки
|
||||
2. ✅ Тестирование безопасности доступа
|
||||
3. ✅ Нагрузочное тестирование
|
||||
4. ✅ Проверка совместимости со старой системой
|
||||
|
||||
### **1.5.1 End-to-End тесты**
|
||||
```typescript
|
||||
// /tests/e2e/fulfillmentConsumableSupply.e2e.ts
|
||||
describe('Fulfillment Consumable Supply E2E', () => {
|
||||
test('Complete supply workflow', async () => {
|
||||
// 1. ФФ создает поставку
|
||||
// 2. Поставщик одобряет
|
||||
// 3. Логистика назначается
|
||||
// 4. Отгрузка
|
||||
// 5. Приемка
|
||||
// Проверяем каждый этап
|
||||
})
|
||||
|
||||
test('Security access control', async () => {
|
||||
// Проверяем что селлеры не видят поставки ФФ
|
||||
// Проверяем фильтрацию данных по ролям
|
||||
})
|
||||
})
|
||||
```
|
||||
|
||||
### **1.5.2 Параллельное тестирование**
|
||||
```typescript
|
||||
// /tests/parallel/oldVsNewSystem.test.ts
|
||||
describe('Old vs New System Compatibility', () => {
|
||||
test('Both systems work independently', async () => {
|
||||
// Создаем поставку в старой системе
|
||||
// Создаем поставку в новой системе
|
||||
// Проверяем что они не мешают друг другу
|
||||
})
|
||||
})
|
||||
```
|
||||
|
||||
### **1.5.3 Performance Testing**
|
||||
```bash
|
||||
# Нагрузочное тестирование API
|
||||
npm run test:load -- --scenario=fulfillment-consumable-v2
|
||||
```
|
||||
|
||||
### **⚠️ ТОЧКА ПРОВЕРКИ 1.5:**
|
||||
- [ ] E2E тесты проходят
|
||||
- [ ] Система безопасности работает
|
||||
- [ ] Производительность приемлемая
|
||||
- [ ] Старая система не затронута
|
||||
- [ ] **ОТКАТ:** Полное отключение feature flags
|
||||
|
||||
**🔒 ROLLBACK PLAN 1.5:**
|
||||
```bash
|
||||
# Полное отключение новой системы
|
||||
export FULFILLMENT_CONSUMABLE_V2=false
|
||||
export NEXT_PUBLIC_FULFILLMENT_CONSUMABLE_V2=false
|
||||
npm run restart
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 STEP 1.6: PRODUCTION DEPLOYMENT
|
||||
|
||||
### **Задачи:**
|
||||
1. ✅ Постепенное включение для пользователей
|
||||
2. ✅ Мониторинг в реальном времени
|
||||
3. ✅ Готовность к быстрому откату
|
||||
|
||||
### **1.6.1 Gradual Rollout**
|
||||
```typescript
|
||||
// Включение для 10% пользователей
|
||||
export function shouldUseV2ForUser(userId: string): boolean {
|
||||
if (!isFeatureEnabled('FULFILLMENT_CONSUMABLE_V2')) return false
|
||||
|
||||
// Хэш от userId, включаем для 10%
|
||||
const hash = hashCode(userId)
|
||||
return (hash % 10) === 0
|
||||
}
|
||||
```
|
||||
|
||||
### **1.6.2 Real-time мониторинг**
|
||||
```typescript
|
||||
// Метрики в реальном времени
|
||||
export const supplyV2Metrics = {
|
||||
createSuccess: 0,
|
||||
createError: 0,
|
||||
querySuccess: 0,
|
||||
queryError: 0,
|
||||
rollbackTriggered: false
|
||||
}
|
||||
|
||||
// Автоматический откат при критических ошибках
|
||||
if (supplyV2Metrics.createError > 10) {
|
||||
// Экстренное отключение
|
||||
process.env.FULFILLMENT_CONSUMABLE_V2 = 'false'
|
||||
supplyV2Metrics.rollbackTriggered = true
|
||||
}
|
||||
```
|
||||
|
||||
### **1.6.3 Production Checklist**
|
||||
```markdown
|
||||
## PRODUCTION DEPLOYMENT CHECKLIST
|
||||
- [ ] Database migration applied successfully
|
||||
- [ ] Feature flags configured
|
||||
- [ ] Monitoring dashboards active
|
||||
- [ ] Rollback procedures tested
|
||||
- [ ] Support team notified
|
||||
- [ ] Documentation updated
|
||||
- [ ] Gradual rollout configured (10% users)
|
||||
```
|
||||
|
||||
### **⚠️ ТОЧКА ПРОВЕРКИ 1.6:**
|
||||
- [ ] Deployment прошел успешно
|
||||
- [ ] 10% пользователей используют новую систему
|
||||
- [ ] Метрики показывают стабильность
|
||||
- [ ] Нет критических ошибок
|
||||
- [ ] **ОТКАТ:** Экстренное отключение
|
||||
|
||||
**🔒 ROLLBACK PLAN 1.6:**
|
||||
```bash
|
||||
# ЭКСТРЕННЫЙ ОТКАТ
|
||||
kubectl set env deployment/app FULFILLMENT_CONSUMABLE_V2=false
|
||||
# ИЛИ через admin panel
|
||||
curl -X POST /admin/feature-flags/disable/FULFILLMENT_CONSUMABLE_V2
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 STEP 1.7: МОНИТОРИНГ И СТАБИЛИЗАЦИЯ
|
||||
|
||||
### **Задачи:**
|
||||
1. ✅ Анализ метрик производительности
|
||||
2. ✅ Сбор фидбека пользователей
|
||||
3. ✅ Исправление найденных проблем
|
||||
4. ✅ Подготовка к Phase 2
|
||||
|
||||
### **1.7.1 Мониторинг (1-2 недели)**
|
||||
```typescript
|
||||
// Ключевые метрики для отслеживания
|
||||
const metricsToWatch = {
|
||||
// Функциональные
|
||||
supplyCreationRate: 'число создаваемых поставок/день',
|
||||
successRate: 'процент успешных операций',
|
||||
averageProcessingTime: 'среднее время обработки',
|
||||
|
||||
// Технические
|
||||
databasePerformance: 'время ответа БД',
|
||||
apiLatency: 'задержка API',
|
||||
errorRate: 'процент ошибок',
|
||||
|
||||
// Бизнесовые
|
||||
userAdoption: 'процент пользователей использующих v2',
|
||||
userSatisfaction: 'оценка пользователей',
|
||||
supportTickets: 'количество тикетов поддержки'
|
||||
}
|
||||
```
|
||||
|
||||
### **1.7.2 Feedback Collection**
|
||||
```typescript
|
||||
// Встроенная система сбора фидбека
|
||||
export function FeedbackWidget() {
|
||||
return (
|
||||
<div className="feedback-widget">
|
||||
<p>Как вам новая система поставок?</p>
|
||||
<button onClick={() => sendFeedback('positive')}>👍</button>
|
||||
<button onClick={() => sendFeedback('negative')}>👎</button>
|
||||
</div>
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
### **1.7.3 Анализ и улучшения**
|
||||
```markdown
|
||||
## КРИТЕРИИ УСПЕХА PHASE 1:
|
||||
✅ Успешность операций > 98%
|
||||
✅ Время отклика < 2 сек
|
||||
✅ Пользовательская оценка > 4/5
|
||||
✅ Количество багов < 5 критических
|
||||
✅ Готовность инфраструктуры к Phase 2
|
||||
```
|
||||
|
||||
### **⚠️ ТОЧКА ПРОВЕРКИ 1.7:**
|
||||
- [ ] Метрики в пределах нормы
|
||||
- [ ] Пользователи довольны
|
||||
- [ ] Критические баги исправлены
|
||||
- [ ] Система готова к расширению
|
||||
- [ ] **РЕШЕНИЕ:** Переход к Phase 2 или доработка
|
||||
|
||||
---
|
||||
|
||||
## 🎯 КРИТЕРИИ ГОТОВНОСТИ К PHASE 2
|
||||
|
||||
### ✅ **ОБЯЗАТЕЛЬНЫЕ УСЛОВИЯ:**
|
||||
1. **Функциональность:** Все features Phase 1 работают стабильно
|
||||
2. **Производительность:** Нет деградации по сравнению со старой системой
|
||||
3. **Безопасность:** Нет утечек данных, доступ контролируется корректно
|
||||
4. **Пользователи:** Положительные отзывы от 80%+ пользователей
|
||||
5. **Мониторинг:** Налаженная система отслеживания метрик
|
||||
|
||||
### 📈 **ЧИСЛЕННЫЕ ПОКАЗАТЕЛИ:**
|
||||
- Успешность создания поставок: **> 98%**
|
||||
- Время загрузки списка поставок: **< 2 сек**
|
||||
- Время создания поставки: **< 5 сек**
|
||||
- Uptime системы: **> 99.5%**
|
||||
- Количество критических багов: **= 0**
|
||||
|
||||
---
|
||||
|
||||
## 📋 PHASE 2: SELLER CONSUMABLE SUPPLY ORDERS
|
||||
|
||||
> **Сроки:** 2-3 недели после стабилизации Phase 1
|
||||
> **Риск:** СРЕДНИЙ (более сложная логика с хранением)
|
||||
|
||||
### **Ключевые особенности Phase 2:**
|
||||
1. **Мульти-организационность:** Селлер создает, ФФ хранит
|
||||
2. **Права доступа:** Сложная система доступа к данным
|
||||
3. **Сроки хранения:** Временные ограничения на хранение
|
||||
4. **Интеграция с Phase 1:** Должна работать вместе с поставками ФФ
|
||||
|
||||
### **Plan Phase 2:**
|
||||
- Step 2.1: Database Schema для селлерских расходников
|
||||
- Step 2.2: GraphQL API с правами доступа
|
||||
- Step 2.3: Frontend для селлеров и ФФ
|
||||
- Step 2.4: Интеграция с системой хранения
|
||||
- Step 2.5: Тестирование совместимости с Phase 1
|
||||
|
||||
---
|
||||
|
||||
## 📋 PHASE 3: GOODS SUPPLY ORDERS
|
||||
|
||||
> **Сроки:** 3-4 недели после стабилизации Phase 2
|
||||
> **Риск:** ВЫСОКИЙ (самая сложная система с рецептурами)
|
||||
|
||||
### **Ключевые особенности Phase 3:**
|
||||
1. **Рецептуры:** Сложная JSON структура с услугами
|
||||
2. **Мульти-компонентность:** Товары + услуги + расходники
|
||||
3. **Marketplace интеграция:** Связь с карточками товаров
|
||||
4. **Миграция данных:** Перенос существующих товарных поставок
|
||||
|
||||
---
|
||||
|
||||
## 📋 PHASE 4: ОЧИСТКА И ОПТИМИЗАЦИЯ
|
||||
|
||||
> **Сроки:** 1-2 недели
|
||||
> **Риск:** НИЗКИЙ (только после полного одобрения)
|
||||
|
||||
### **Задачи Phase 4:**
|
||||
1. **Миграция старых данных** (ТОЛЬКО с одобрения)
|
||||
2. **Удаление устаревшего кода** (ТОЛЬКО с одобрения)
|
||||
3. **Оптимизация производительности**
|
||||
4. **Финальное тестирование**
|
||||
|
||||
---
|
||||
|
||||
## 🚨 EMERGENCY PROCEDURES
|
||||
|
||||
### **🔴 CRITICAL ROLLBACK (при критических ошибках)**
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# emergency-rollback.sh
|
||||
|
||||
echo "🚨 EMERGENCY ROLLBACK INITIATED"
|
||||
|
||||
# Отключение всех feature flags
|
||||
export FULFILLMENT_CONSUMABLE_V2=false
|
||||
export SELLER_CONSUMABLE_V2=false
|
||||
export GOODS_SUPPLY_V2=false
|
||||
export NEXT_PUBLIC_FULFILLMENT_CONSUMABLE_V2=false
|
||||
|
||||
# Перезапуск сервисов
|
||||
kubectl rollout restart deployment/app
|
||||
kubectl rollout restart deployment/api
|
||||
|
||||
# Уведомления
|
||||
curl -X POST "$SLACK_WEBHOOK" -d '{"text": "🚨 Supply System V2 Emergency Rollback Executed"}'
|
||||
|
||||
echo "✅ Rollback completed. System reverted to V1."
|
||||
```
|
||||
|
||||
### **🟡 PARTIAL ROLLBACK (при локальных проблемах)**
|
||||
```bash
|
||||
# Откат конкретной фазы
|
||||
rollback_phase_1() {
|
||||
export FULFILLMENT_CONSUMABLE_V2=false
|
||||
kubectl set env deployment/app FULFILLMENT_CONSUMABLE_V2=false
|
||||
}
|
||||
|
||||
rollback_phase_2() {
|
||||
export SELLER_CONSUMABLE_V2=false
|
||||
kubectl set env deployment/app SELLER_CONSUMABLE_V2=false
|
||||
}
|
||||
```
|
||||
|
||||
### **📊 MONITORING ALERTS**
|
||||
```typescript
|
||||
// Автоматические алерты
|
||||
const ALERT_THRESHOLDS = {
|
||||
ERROR_RATE: 5, // > 5% ошибок = алерт
|
||||
RESPONSE_TIME: 5000, // > 5 сек = алерт
|
||||
FAILED_CREATES: 10, // > 10 неудачных создания = алерт
|
||||
DATABASE_ERRORS: 3 // > 3 ошибки БД = критический алерт
|
||||
}
|
||||
|
||||
// Автоматическое отключение при превышении порогов
|
||||
if (currentMetrics.errorRate > ALERT_THRESHOLDS.ERROR_RATE) {
|
||||
triggerEmergencyRollback('HIGH_ERROR_RATE')
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📈 SUCCESS METRICS
|
||||
|
||||
### **📊 KPI для каждой фазы:**
|
||||
|
||||
#### **Phase 1 Success Criteria:**
|
||||
- ✅ 100% функций поставок расходников ФФ работают
|
||||
- ✅ 0 критических багов в production
|
||||
- ✅ < 2 сек время отклика API
|
||||
- ✅ > 90% положительных отзывов пользователей
|
||||
- ✅ 0 инцидентов безопасности
|
||||
|
||||
#### **Phase 2 Success Criteria:**
|
||||
- ✅ Поставки расходников селлеров работают корректно
|
||||
- ✅ Права доступа работают (селлер видит свое, ФФ видит ограниченно)
|
||||
- ✅ Интеграция с Phase 1 без конфликтов
|
||||
|
||||
#### **Phase 3 Success Criteria:**
|
||||
- ✅ Товарные поставки с рецептурами работают
|
||||
- ✅ Миграция существующих данных (если одобрена)
|
||||
- ✅ Интеграция с маркетплейсами
|
||||
|
||||
#### **Overall Success Criteria:**
|
||||
- ✅ **Производительность:** Не хуже старой системы
|
||||
- ✅ **Стабильность:** 99.9% uptime
|
||||
- ✅ **Безопасность:** 0 утечек данных
|
||||
- ✅ **Пользователи:** > 85% satisfaction rate
|
||||
- ✅ **Бизнес:** Увеличение эффективности процессов поставок
|
||||
|
||||
---
|
||||
|
||||
## ⏰ TIMELINE
|
||||
|
||||
```mermaid
|
||||
gantt
|
||||
title Supply System V2 Implementation Timeline
|
||||
dateFormat YYYY-MM-DD
|
||||
section Phase 1
|
||||
Infrastructure Setup :2024-08-25, 3d
|
||||
Database Schema :2024-08-28, 2d
|
||||
GraphQL API :2024-08-30, 4d
|
||||
Frontend Interface :2024-09-03, 4d
|
||||
Integration Testing :2024-09-07, 3d
|
||||
Production Deployment :2024-09-10, 2d
|
||||
Monitoring & Stabilization :2024-09-12, 7d
|
||||
|
||||
section Phase 2
|
||||
Seller Consumables Schema :2024-09-19, 3d
|
||||
Complex Access Control :2024-09-22, 5d
|
||||
Multi-org Frontend :2024-09-27, 4d
|
||||
Integration Testing :2024-10-01, 4d
|
||||
|
||||
section Phase 3
|
||||
Goods Supply Schema :2024-10-05, 4d
|
||||
Recipe System :2024-10-09, 6d
|
||||
Data Migration Prep :2024-10-15, 3d
|
||||
Testing & Validation :2024-10-18, 5d
|
||||
|
||||
section Phase 4
|
||||
Data Migration :2024-10-23, 3d
|
||||
Code Cleanup :2024-10-26, 2d
|
||||
Final Testing :2024-10-28, 2d
|
||||
```
|
||||
|
||||
### **🎯 MILESTONE DATES:**
|
||||
- **Phase 1 Complete:** September 19, 2024
|
||||
- **Phase 2 Complete:** October 4, 2024
|
||||
- **Phase 3 Complete:** October 23, 2024
|
||||
- **Full Migration Complete:** October 30, 2024
|
||||
|
||||
---
|
||||
|
||||
## ✅ ЗАКЛЮЧЕНИЕ
|
||||
|
||||
Данный план обеспечивает:
|
||||
|
||||
### 🛡️ **МАКСИМАЛЬНУЮ БЕЗОПАСНОСТЬ:**
|
||||
- Поэтапное внедрение без риска для работающей системы
|
||||
- Множественные точки отката на каждом этапе
|
||||
- Тщательное тестирование перед каждым шагом
|
||||
|
||||
### 📈 **КОНТРОЛИРУЕМЫЙ РОСТ:**
|
||||
- Постепенное увеличение сложности (ФФ → Селлер → Товары)
|
||||
- Feature flags для контроля доступа
|
||||
- Мониторинг метрик на каждом этапе
|
||||
|
||||
### 🔧 **ГИБКОСТЬ РЕАЛИЗАЦИИ:**
|
||||
- Возможность приостановить на любом этапе
|
||||
- Адаптация планов по результатам предыдущих фаз
|
||||
- Учет пожеланий пользователей
|
||||
|
||||
**Система готова к безопасной поэтапной реализации!**
|
||||
Reference in New Issue
Block a user