PIM — Концепция архитектуры данных

Версия: 2.0.0
Дата: 2025-12-24

1. ИСТОЧНИКИ ИСТИНЫ

Система	Отвечает за	Поля
1С	ERP (учёт)	guid, артикул, остатки, себестоимость
PIM	Товары (продажи)	название, описание, категория, характеристики, цены, изображения

Синхронизация

Этап	Направление	Что синхронизируется
Первичная	1С → PIM	Все поля (один раз)
Обогащение	PIM	Улучшаем, добавляем характеристики
Текущая	1С → PIM	Только stock, cost_price

После обогащения 1С НЕ перезаписывает товарные поля.

2. КАТЕГОРИИ (20 шт)

№	Категория	slug	GUID 1С
1	Салюты и фейерверки	batteries	0699197f-e960-11ed
2	Римские свечи	roman_candles	414d8f60-e957-11ed
3	Фонтаны	fountains	62b720db-68a0-11ee
4	Бенгальские огни	sparklers	185b58c6-e960-11ed
5	Петарды	firecrackers	414d8518-e957-11ed
6	Цветной дым	smoke	1aee671d-e960-11ed
7	Хлопушки пневматические	confetti	1a524796-e960-11ed
8	Хлопушки пиротехнические	pyro_confetti	04fd1a14-68a1-11ee
9	Ракеты	rockets	414d8cba-e957-11ed
10	Фестивальные шары	festival_balls	414d85a3-e957-11ed
11	Наземные фейерверки	ground	414d84c0-e957-11ed
12	Летающие фейерверки	flying	5cb9ea4d-68a0-11ee
13	Катюши	katyusha	12e3c580-e960-11ed
14	Файеры	flares	e40da3a0-78c6-11ee
15	Дневные салюты	day_fireworks	e5d73639-68a0-11ee
16	Стробоскопы	strobes	62b726dc-68a0-11ee
17	Комбинированные фейерверки	combo	02c571af-811d-11ee
18	Свечи фонтаны в торт	cake_fountains	1916d79e-e960-11ed
19	Свечи для торта	cake_candles	2dc1f600-6efc-11ee
20	Карнавал	carnival	23780078-6efc-11ee

3. ХАРАКТЕРИСТИКИ (26 шт)

Обязательные для всех

Поле	Название	Тип	Ед.
article	Артикул	string	—
product_name	Имя изделия	string	—
brand	Бренд	string	—
weight_grams	Вес	int	грамм
pack_qty	Кол-во в упаковке	int	шт

Специфичные по категориям

Поле	Название	Тип	Ед.	Категории
caliber	Калибр	decimal	дюймы	1,2,9,10,13,15
caliber_mm	Калибр (мм)	int	мм	вычисляемое
shots_count	Количество выстрелов	int	шт	1,2,9,13,15
effects_count	Количество эффектов	int	шт	1,9
effects	Эффекты	text	—	1,3,9,11,12,13,14
burn_time_sec	Время работы	int	сек	3,4,6,14,16,18
height_m	Высота подъёма	decimal	м	9,10,12
item_length	Длина изделия	int	мм	4,7,18
fan_angle	Угол веера	int	°	1
has_finale	Финальный залп	bool	—	1
barrels	Количество стволов	int	шт	2
pieces_count	Штук в упаковке	int	шт	5,7
activation_type	Тип активации	string	—	5,6
fuse_type	Тип фитиля	string	—	5,10
hazard_class	Класс опасности	string	К1-К4	5
bangs	Количество хлопков	int	шт	5
color	Цвет	string	—	4,6,14,15,16,18
fountain_type	Тип фонтана	string	—	3
indoor_allowed	Для помещений	bool	—	3,4
filling	Наполнение	string	—	7
range_m	Дальность	int	м	7
ground_type	Тип наземного	string	—	11
flying_type	Тип летающего	string	—	12
flare_type	Тип файера	string	—	14
day_type	Тип дневного	string	—	15
candle_type	Тип свечи	string	—	19
symbol	Символ (цифра/буква)	string	—	19

4. ХАРАКТЕРИСТИКИ ПО КАТЕГОРИЯМ

1. Салюты и фейерверки

Обязательные: caliber, shots_count
Опциональные: effects_count, effects, fan_angle, has_finale

2. Римские свечи

Обязательные: caliber, shots_count
Опциональные: barrels

3. Фонтаны

Обязательные: burn_time_sec, height_m, fountain_type
Опциональные: effects, indoor_allowed

4. Бенгальские огни

Обязательные: item_length, burn_time_sec, color
Опциональные: indoor_allowed

5. Петарды

Обязательные: activation_type, hazard_class
Опциональные: bangs, pieces_count

6. Цветной дым

Обязательные: activation_type, burn_time_sec, color
Опциональные: —

7. Хлопушки пневматические

Обязательные: item_length, filling
Опциональные: range_m, pieces_count

8. Хлопушки пиротехнические

Обязательные: effects
Опциональные: —

9. Ракеты

Обязательные: caliber, height_m
Опциональные: effects, shots_count

10. Фестивальные шары

Обязательные: caliber
Опциональные: effects, fuse_type

11. Наземные фейерверки

Обязательные: ground_type
Опциональные: effects

12. Летающие фейерверки

Обязательные: flying_type, height_m
Опциональные: effects

13. Катюши

Обязательные: caliber, shots_count
Опциональные: effects

14. Файеры

Обязательные: flare_type, burn_time_sec, color
Опциональные: effects

15. Дневные салюты

Обязательные: day_type, caliber, shots_count, color
Опциональные: —

16. Стробоскопы

Обязательные: burn_time_sec, color
Опциональные: —

17. Комбинированные фейерверки

Обязательные: — (зависит от состава)
Опциональные: все характеристики салютов и фонтанов

18. Свечи фонтаны в торт

Обязательные: burn_time_sec, item_length, color
Опциональные: —

19. Свечи для торта

Обязательные: candle_type
Опциональные: symbol, color

20. Карнавал

Обязательные: — (описательно)
Опциональные: color

5. ШАБЛОНЫ НАЗВАНИЙ

Формула

{Группа} {Тип} {Параметр1} {Параметр2} [Кол-во шт] {Имя} {Артикул} {Бренд}

Примеры по категориям

Категория	Шаблон
Салюты	`Салют {тип} {caliber}" {shots_count} выстр. {effects_count} эфф. {name} {article} {brand}`
Римские свечи	`Римские свечи {caliber}" {shots_count} выстр. {barrels} ствол {pack_qty} шт {name} {article} {brand}`
Фонтаны	`Фонтан {fountain_type} {burn_time_sec} сек {height_m} м {name} {article} {brand}`
Бенгальские огни	`Бенгальские огни {item_length} мм {burn_time_sec} сек {color} {pack_qty} шт {name} {article} {brand}`
Петарды	`Петарды {activation_type} {hazard_class} {bangs} хлопка {pack_qty} шт {name} {article} {brand}`
Цветной дым	`Цветной дым {activation_type} {burn_time_sec} сек {color} {name} {article} {brand}`
Хлопушки	`Хлопушка {item_length} см {filling} {range_m} м {name} {article} {brand}`
Ракеты	`Ракеты {caliber}" {height_m} м {effects} {pack_qty} шт {name} {article} {brand}`
Дневные салюты	`Дневной салют {day_type} {caliber}" {shots_count} выстр. {color} {name} {article} {brand}`

6. ТАБЛИЦА ВЫСОТЫ ПО КАЛИБРУ

Калибр	мм	Высота
0.6"	15	~15 м
0.8"	20	~20 м
1.0"	25	~25 м
1.2"	30	~30 м
1.5"	38	~38 м
2.0"	50	~50 м
3.0"	76	~75 м

7. ТАБЛИЦЫ БД

Основные

Таблица	Назначение
`products_1c`	Товары из 1С
`pim_products`	Товары PIM
`pim_categories`	20 категорий

Характеристики

Таблица	Назначение
`pim_spec_fields`	Справочник 26 полей
`pim_category_spec_mapping`	Какие поля у какой категории
`pim_spec_fireworks`	Значения характеристик

Маппинг

Таблица	Назначение
`pim_category_mapping`	Связь с 1С/OZON/ОС

8. ИСТОЧНИКИ

Документ	Путь
PIM_CLASSIFICATION.md	data/PIM_CLASSIFICATION.md
SCHEMA.md	data/nocodb/SCHEMA.md
pim_1c_mapping.yaml	app/mp1/solution/config/pim_1c_mapping.yaml
DATA_STRUCTURE.md	app/ozon/design/DATA_STRUCTURE.md

Версия: 2.0.0