CSV_CMD — встроенное приложение Her-Age для умной интеграции поставщиков с Shopify

Когда это нужно

• Поставщиков много, форматы разные, а скорость онбординга критична.
• Нужен регулярный автоимпорт CSV по расписанию и автоматическая очистка/обогащение карточек.
• Требуется централизованный контроль качества (фото, заполненность полей, консистентность цен, отсутствие дублей).
• Необходимо применять/конвертировать таксономии: Her-Age для импорта, партнёрскую — для экспорта.

Дизайн самого интерфейса сделан по макету заказчика.

Архитектура (в разрезе компонентов)

• Backend: Node.js / Fastify — ingestion, преобразование, валидации, очереди, API для фронтенда и встроенного приложения.
• Web-интерфейс: Next.js — дашборд, настройка источников, превью импорта, правки CSV «на лету».
• Встраиваемое приложение Shopify: Remix.js + Shopify Polaris — управление из админки Shopify (правила, расписания, логи).
• Хостинг: гибридная схема — часть сервисов на AWS, часть на DigitalOcean (баланс между ценой и гибкостью).
• Планировщик: cron-джобы для регулярных импортов/апдейтов и фоновых задач.
• Хранилище промежуточных данных: табличные слои для снапшотов импорта, журналов проверок и версионирования наборов.

Ключевой функционал

1. Конвертер файлов
   Унификация входных данных: парсинг CSV (поддержка разных разделителей/кодировок), опционально TSV/XLSX; нормализация дат, чисел, валют, единиц измерения.

2. Аутоапдейтер (cron)
   Подтягивает файлы из разных источников (HTTP/S, SFTP, облачные хранилища, e-mail-вложения, Shopify-фиды), запускает пайплайн трансформаций и отчёт по итогу.

3. Паттерн-матчер
   Сопоставляет поля поставщика с целевой схемой: правила и словари для брендов, категорий, материалов; поддержка регулярных выражений и эвристик.

4. AI-анализатор качества
   По заданным градациям оценивает карточки и отбраковывает:

   • нет фото / битые ссылки на медиа;
   • не заполнено более трёх критичных полей (например, название/бренд/категория/цена/состояние);
   • дублирующиеся позиции (по SKU, названию + бренду, близости изображений);
   • явные аномалии цен/размеров.
     Результат — скор и пояснения, чтобы оператор видел «почему» и мог быстро исправить.

5. CSV-редактор с умными функциями
   Рич-правки в браузере: массовые операции, автодополнение по справочникам, подсветка проблемных полей, откат изменений, сравнение версий и экспорт.

6. Таксономии и схемы
   На выходе можно применить таксономию Her-Age для импорта или объединить несколько файлов и применить другую таксономию для экспорта (для партнёров/маркетплейсов).

---

Поток данных (high-level)

1. Загрузка источников → 2) Парсинг/конвертация → 3) Сопоставление полей (паттерн-матчер) →
2. AI-оценка и отбраковка → 5) Полуавтоматические правки в CSV-редакторе →
3. Применение таксономии/обогащение → 7) Экспорт в Shopify/каналы → 8) Отчёт и аудит-лог.

---

Управление и UX

• Дашборд поставщиков: расписания, статусы импорта, быстрые действия (перезапуск, откат, экспорт).
• Превью импорта: дифф между предыдущей и текущей версией, подсчёт изменений (новые/обновлённые/удалённые).
• Профили правил: пресеты для конкретных поставщиков (входной формат → сопоставление → фильтры → экспортная схема).
• Прозрачные ошибки: «человеческие» сообщения и методы самоисправления (например, автопоиск изображения по SKU).

---

Безопасность и доступ

• Разграничение прав: операторы, редакторы, администраторы.
• Минимизация и разделение данных поставщиков, управление секретами и токенами интеграций.
• Журналы доступа и действия в интерфейсе и API.

---

Что получает бизнес

• Резкое ускорение онбординга новых поставщиков без хрупких Excel-процессов.
• Единое качество каталога: меньше мусора и дублей, больше карточек, готовых к публикации.
• Повторяемость и прозрачность: одно и то же правило даёт один и тот же результат, легко масштабировать.

Итог

CSV_CMD — это «транспортный узел» данных о товарах между поставщиками и Shopify-витриной Her-Age. Он забирает разношёрстные CSV, приводит их к порядку, умно фильтрует с помощью AI и позволяет применить нужную таксономию — как для импорта, так и для экспорта. Результат — чистый, согласованный каталог и предсказуемые процессы, которые масштабируются вместе с бизнесом.