bearingsinfo/data/README.md

Структурированные данные — Справочная система подшипников

Единый эталонный справочник и каталог подшипников для подбора, расчёта, замены и автоматизации (БД, ИИ, ERP)

Версия: 1.0
Дата: 2026-01-20

Объединяет данные из репозиториев Baza и bearing-api + новая справочная система

---

🎯 Цель

Создать единый источник достоверной информации для:

• Подбора подшипников
• Расчёта и проектирования
• Замены и взаимозаменяемости
• Автоматизации (БД, ИИ, ERP-системы)
• Интеграции с Bitrix и каталогами

---

📁 Структура

data/
├── schema/                          # SQL схемы БД (НОВОЕ)
│   └── bearings_db_schema.sql      # Полная PostgreSQL схема
├── csv/                             # CSV таблицы (расширенные)
│   ├── master_catalog.csv          # ⭐ Мастер-каталог (НОВОЕ)
│   ├── tolerance_classes.csv       # Классы точности (НОВОЕ)
│   ├── tn_ved_codes.csv           # Коды ТН ВЭД (НОВОЕ)
│   ├── bearing_units.csv           # Корпусные подшипники (НОВОЕ)
│   ├── gost/                       # Данные по ГОСТ
│   ├── iso/                        # Данные по ISO
│   └── reports/                    # Отчеты
├── analogs/                         # ⭐ Таблицы аналогов (РАСШИРЕНО)
│   ├── gost_to_iso.csv             # ГОСТ → ISO (НОВОЕ)
│   ├── iso_to_gost.csv             # ISO → ГОСТ (НОВОЕ)
│   ├── import_analogs.csv          # Импортные аналоги (НОВОЕ)
│   └── additional_designations.csv # Доп. обозначения (НОВОЕ)
├── brands/                          # ⭐ Производители (НОВОЕ)
│   ├── manufacturers_cis.csv       # Производители СНГ
│   ├── manufacturers_europe.csv    # Европейские
│   ├── manufacturers_asia.csv      # Азиатские
│   ├── manufacturers_china.csv     # Китайские
│   └── brand_comparison.csv        # Сравнение уровней
├── dimensions/                      # ⭐ Размеры (НОВОЕ)
│   └── bearing_dimensions.csv      # Полные размеры + нагрузки
├── inbox/                           # Входящие файлы (из bearing-api)
└── schemas/                         # JSON схемы

---

⭐ Ключевые улучшения (v1.0)

1. Мастер-каталог

master_catalog.csv — единая точка входа для всех подшипников:

• Все стандарты: ГОСТ ↔ ISO ↔ Бренды
• Полные размеры: d, D, B, r
• Вес и категория
• Статус (Active/Obsolete)

2. Система аналогов

Четыре таблицы для полного покрытия:

• gost_to_iso.csv — ГОСТ → ISO
• iso_to_gost.csv — ISO → ГОСТ (обратная)
• import_analogs.csv — импортные аналоги (SKF, FAG, NSK, NTN, KOYO)
• additional_designations.csv — суффиксы и модификаторы

Важно: Условные аналоги помечены, ограничения указаны!

3. База производителей

Расширенный справочник по регионам:

• СНГ: ГПЗ, СПЗ, ВПЗ, МПЗ и др.
• Европа: SKF, FAG, INA, NSK Europe, NKE, Timken
• Азия: NSK, NTN, KOYO, Nachi, NMB
• Китай: ZWZ, HRB, LYC, C&U

С указанием:

• Уровня качества (Премиум/Индустриальный/Бюджетный)
• Специализации
• Контактов

4. SQL схема

bearings_db_schema.sql — готовая к использованию схема PostgreSQL:

• 8 основных таблиц
• Индексы для быстрого поиска
• Представления (views) для типовых запросов
• Функции для валидации и поиска аналогов
• Комментарии на русском языке

---

📊 Основные таблицы (НОВОЕ)

Полная документация: Руководство пользователя справочной системы

master_catalog.csv

Мастер-каталог всех подшипников - единая точка входа

gost_to_iso.csv и iso_to_gost.csv

Прямые соответствия между стандартами ГОСТ ↔ ISO

import_analogs.csv

Импортные аналоги с указанием ограничений применяемости

manufacturers_*.csv

Справочники производителей по регионам с уровнями качества

Подробнее см. data/README.md

---

Описание разделов

📥 inbox/

Назначение: Входящие файлы для автоматического импорта

Источник: bearing-api

Содержит:

• Загруженные архивы с данными
• Файлы, ожидающие обработки
• Временные файлы импорта

Обработка:

python api/scripts/unpack_and_classify.py

📊 csv/

Назначение: Структурированные данные в CSV формате

Источник: Baza (43,000+ записей)

csv/gost/

Данные по стандартам ГОСТ:

• bearings.csv - подшипники по ГОСТ
• dimensions.csv - размеры
• series.csv - серии подшипников
• tolerances.csv - допуски и посадки

csv/iso/

Данные по стандартам ISO:

• bearings.csv - подшипники по ISO
• dimensions.csv - размеры
• prefixes.csv - префиксы обозначений
• suffixes.csv - суффиксы обозначений

csv/analogs/

Таблицы аналогов и взаимозаменяемости:

• gost_iso.csv - соответствие ГОСТ ↔ ISO
• units.csv - подшипниковые узлы
• housings.csv - корпуса

csv/brands/

Данные о производителях:

• brands.csv - список производителей и брендов

csv/reports/

Сводные отчеты и агрегированные данные

📋 schemas/

Назначение: JSON схемы для валидации данных

Источник: Baza

Содержит:

• Схемы структуры данных
• Правила валидации
• Определения форматов

📂 sources/ (в корне репозитория)

Назначение: Исходные данные в различных форматах

Источник: Baza

Содержит:

• Исходные файлы производителей
• Сканы каталогов
• Справочные материалы
• Сырые данные до обработки

См. также: sources/README.md

---

Формат данных

CSV файлы

Кодировка: UTF-8 Разделитель: , (запятая) Заголовки: первая строка

Пример структуры bearings.csv:

designation,type,d,D,B,manufacturer,standard
6205,Radial Ball Bearing,25,52,15,SKF,ISO
ГОСТ 8338-75,Шариковый радиальный,25,52,15,ГПЗ,ГОСТ

JSON схемы

Формат: JSON Schema Draft 7 Валидация: используется для проверки корректности данных

---

Использование

Для разработчиков

Импорт в PostgreSQL:

python api/scripts/import_to_postgres.py

Чтение в Python:

import pandas as pd

# Чтение данных ГОСТ
bearings = pd.read_csv('data/csv/gost/bearings.csv')

# Чтение аналогов
analogs = pd.read_csv('data/csv/analogs/gost_iso.csv')

Для API

API автоматически использует данные из этой структуры:

# Запуск API сервера
cd api
python main.py

Для обработки новых данных

1. Поместите файлы в inbox/
2. Запустите обработку:

python api/scripts/unpack_and_classify.py

3. Импортируйте в БД:

python api/scripts/import_to_postgres.py

---

Статистика

• CSV файлы: 43,000+ записей (из Baza)
• Форматы: CSV, JSON, XLSX
• Кодировка: UTF-8
• Разделы: ГОСТ, ISO, аналоги, производители

---

Обновление данных

Автоматическое

GitHub Actions workflows обновляют данные:

• .github/workflows/data_pipeline.yml

Ручное

1. Добавьте новые файлы в соответствующие разделы
2. Обновите схемы при необходимости
3. Запустите валидацию
4. Импортируйте в БД

---

Интеграция

С knowledge-base

Структурированные данные дополняют текстовые материалы

С API

API использует эти данные для endpoints

С основными разделами

Дополняет справочную базу (02-12, 90, 99) машиночитаемыми данными

---

Источники

• Baza: CSV данные, схемы, исходные файлы
• bearing-api: inbox, пайплайн импорта

См. MIGRATION_GUIDE.md для деталей.

---

Последнее обновление: 2026-01-19