ИНВЕНТАРИЗАЦИЯ ДАННЫХ: Pirotehnika

Дата: 2025-12-22
Статус: DRAFT
Цель: Полная инвентаризация всех данных для миграции в L2-DATA

ОБЗОР

Результат исследования проекта $WORKSPACE/projects/pirotehnika/

1. ИСТОЧНИКИ ДАННЫХ (Data Sources)

1.1. Базы данных

Физический сервер: @dev-pro.server
Статус: Production (active)
Backup: ?

1.2. Внешние API

Вопросы:
- [ ] Как подключаемся к 1С? (API, файлы, БД?)
- [ ] Есть ли API у поставщиков или только файлы?

1.3. Файловые источники

Хранилище: @beget-s3.storage

Вопросы:
- [ ] Где физически лежат прайсы? (FTP, email, локально?)
- [ ] Как часто обновляются прайсы?
- [ ] Сколько поставщиков? Какие форматы?

2. ТАБЛИЦЫ БАЗЫ ДАННЫХ

2.1. PIM (Product Information Management)

Группа: Управление товарами

Итого: 5 таблиц, ~3,900 записей

Структура pim_products:

- article (PK)
- name
- brand_id → Brands
- supplier_id → Suppliers
- category_id → Categories
- base_price (из прайса)
- cost_price (base_price × скидка)
- sku (для OZON)

Структура pim_catalog:

- article (PK)
- caliber (калибр, мм)
- shots_count (выстрелов)
- duration_sec (время работы, сек)
- height_m (высота полёта, м)
- effects (JSON)
- safety_distance_m
- weight_kg
- certificate_number
- country

2.2. PRODUCTS (Каталог из 1С)

Группа: Основной каталог

Итого: 4 таблицы, ~7,400 записей

Связи:

Products (1C) ──article──> pim_products ──sku──> OZON_Products
    │                            │
    └── Каталог БЕЗ цен          └── Цены, бренды, себестоимость

2.3. PRICES (Цены)

Группа: Ценообразование

Итого: 4 таблицы (+4 пустых), ~4,100 записей

Правила ценообразования:

base_price (из прайса) × (1 - скидка%) = cost_price

Скидки по брендам (pim_cost_rules):
- JF-Pyro:     50%
- Maxsem:      50%
- Стрелецкий:  50%
- Салют Люкс:  55%
- УПЗ:         60%

2.4. ORDERS (Заказы)

Группа: Заказы с маркетплейсов

Итого: 6 таблиц, ~2,200 записей

2.5. REFERENCE (Справочники)

Группа: Справочные данные

Итого: 9 таблиц, ~120 записей

Поставщики (5):
1. JF-Pyro (скидка 50%)
2. Maxsem (скидка 50%)
3. УПЗ (скидка 60%)
4. Стрелецкий (скидка 50%)
5. Салют Люкс (скидка 55%)

Каналы продаж (6):
- O1, O2, O3 (OZON аккаунты)
- WB (Wildberries)
- YM (Яндекс.Маркет)
- Site (pirotehnika.spb.ru)

2.6. ANALYTICS (Аналитика)

Группа: Расчетные данные

Итого: 4 таблицы, ~1,300 записей

2.7. MAPPINGS (Связи артикулов)

Группа: Маппинги между системами

Итого: 4 таблицы, ~3,800 записей

2.8. FINANCE (Финансы)

Итого: 3 таблицы, ~800 записей

2.9. WAREHOUSE (Склад)

Итого: 4 таблицы, ~30 записей

2.10. CRM

Итого: 3 таблицы, ~4,000 записей

2.11. SYSTEM (Системные)

Итого: 5 таблиц, ~60 записей

3. ПОТОКИ ДАННЫХ (Data Flows)

3.1. Входящие потоки

ИСТОЧНИКИ ДАННЫХ
│
├─→ 1C
│   └─→ Products (4,626 товаров)
│       └─→ Каталог БЕЗ цен и брендов
│
├─→ ПРАЙСЫ (Excel от поставщиков)
│   └─→ PriceList → PriceListItem
│       └─→ pim_products (цены, бренды)
│
├─→ OZON API
│   ├─→ OZON_Products (2,051 карточек)
│   ├─→ OZON_Orders (343 заказа)
│   ├─→ OZON_Transactions (830 транзакций)
│   └─→ OZON_Analytics_Stocks (1,221 позиций)
│
└─→ MANUAL (Ручной ввод)
    ├─→ pim_catalog (характеристики пиротехники)
    ├─→ Categories, Brands, Suppliers
    └─→ pim_cost_rules (правила скидок)

3.2. Обработки данных

PIPELINE
│
1. ИМПОРТ ПРАЙСОВ
   Excel → PriceListItem → pim_products
   - Парсинг Excel файлов
   - Нормализация данных
   - Применение скидок по брендам
   - Обновление себестоимости
│
2. СИНХРОНИЗАЦИЯ 1C
   1C → Products
   - Импорт каталога
   - Обновление артикулов
   - Статус синхронизации
│
3. СИНХРОНИЗАЦИЯ OZON
   pim_products → OZON_Products
   - Создание/обновление карточек
   - Обновление цен и остатков
   - Получение заказов
│
4. РАСЧЕТ АНАЛИТИКИ
   Orders + Prices → analytics_order_profitability
   - ROI по заказам
   - Маржинальность
   - Прибыльность товаров

3.3. Исходящие потоки

ПОТРЕБИТЕЛИ ДАННЫХ
│
├─→ OZON (маркетплейс)
│   └── pim_products → OZON API
│       - Карточки товаров
│       - Цены
│       - Остатки
│
├─→ pirotehnika.spb.ru (сайт)
│   └── Products → OpenCart MySQL
│       - Каталог
│       - Цены
│
├─→ MP1 API (FastAPI)
│   └── NocoDB → REST API
│       - Дашборды
│       - Аналитика
│
└─→ Экспорты (CSV/JSON)
    └── NocoDB → Files
        - Выгрузки для маркетплейсов
        - Отчеты

4. СУЩЕСТВУЮЩИЕ КОННЕКТОРЫ

4.1. Реализованные

Структура:

pochta/
├── __init__.py
├── client.py
├── config.py
├── models.py
├── constants.py
├── mcp_server.py
└── README.md

4.2. Необходимые (отсутствуют)

5. СКРИПТЫ И ОБРАБОТКИ

5.1. Существующие скрипты

Вопросы:
- [ ] Что делают эти скрипты точно?
- [ ] Как часто запускаются?
- [ ] Есть ли расписание (cron)?

5.2. Необходимые обработки

6. СЕРВИСЫ (Потребители данных)

6.1. Внутренние сервисы

6.2. Внешние системы

7. ПРОБЛЕМЫ И ВОПРОСЫ

7.1. Критические вопросы

1. Подключение к 1С:
   - [ ] Как происходит синхронизация? (API, файлы, прямой доступ к БД?)
   - [ ] Как часто?
   - [ ] В каком направлении? (1C → NocoDB или bidirectional?)

2. Прайсы поставщиков:
   - [ ] Где физически хранятся файлы?
   - [ ] Как часто обновляются?
   - [ ] Сколько поставщиков всего?
   - [ ] Какие форматы (XLSX, CSV, другие)?

3. Физическое хранилище PostgreSQL:
   - [ ] Где физически БД? (какая схема на сервере?)
   - [ ] pt7k98pv0fwi1el - это workspace ID NocoDB, а какая настоящая схема PostgreSQL?
   - [ ] Backup есть? Как часто?

4. Сайты (pirotehnika.spb.ru, pirofey.ru):
   - [ ] Как синхронизируются товары с NocoDB?
   - [ ] Есть ли коннектор?
   - [ ] Какая база данных используется? (MySQL на beget?)

7.2. Технические вопросы

1. Дублирование таблиц:
   - Products vs pim_products vs PIM_Catalog vs OZON_Products
   - Order vs OZON_Orders vs orders
   - Какая таблица master?

2. Пустые таблицы:
   - orders (0), order_items (0), OZON_Shipments (0), и др.
   - Зачем созданы? Планируется использование?

3. Устаревшие таблицы:
   - PIM_Catalog (762) - устаревшая
   - Bundles - старая
   - Можно удалить?

8. СЛЕДУЮЩИЕ ШАГИ

Перед началом миграции нужно:

1. Уточнить:
   - [ ] Подключение к 1С
   - [ ] Местоположение прайсов
   - [ ] Физическая схема PostgreSQL
   - [ ] Синхронизация с сайтами

2. Создать:
   - [ ] Коннекторы (nocodb, ozon, 1c, suppliers)
   - [ ] Схемы данных для L2-DATA
   - [ ] План миграции

3. Обсудить:
   - [ ] Какие таблицы master?
   - [ ] Что делать с дубликатами?
   - [ ] Что делать с пустыми/устаревшими таблицами?

Статус: DRAFT - требуется обсуждение и уточнение
Следующий шаг: Обсудить критические вопросы с пользователем