AIKraft/AI/Войти
AIKraft/Skills/VTEX IO: стратегия Master Data

VTEX IO: стратегия Master Data

Apply when deciding whether and how VTEX IO apps should use Master Data v2 for custom data. Covers entity boundaries, schema lifecycle, indexing strategy, and when Master Data is the right storage mechanism versus another data approach. Use for reviews, wishlists, forms, or other custom data modeling decisions in VTEX IO apps.

vtex official Данные

Что делает навык

Навык определяет стратегию использования Master Data v2 для хранения пользовательских данных в приложениях VTEX IO, помогая выбрать между Master Data, VBase, VTEX core API и внешними хранилищами. Он охватывает проектирование границ сущностей, жизненный цикл схем, индексирование и выбор между использованием masterdata builder или только клиента Master Data.

Когда применять

  • Моделирование отзывов, списков желаний, форм или пользовательских записей приложения
  • Выбор границ сущностей и планирование индексирования для полей, используемых в фильтрах
  • Принятие решения о том, должен ли приложение владеть схемой через masterdata builder или только потреблять существующую схему через клиент
  • Планирование жизненного цикла схем для предотвращения разрастания (schema sprawl)
  • Оценка целесообразности использования Master Data для структурированных данных с требованиями валидации и запросов

Как работает

  1. Определить, является ли Master Data подходящим механизмом хранения для структурированных пользовательских данных, исключая сценарии с неограниченным ростом объема или хранением секретов
  2. Выбрать подход взаимодействия: владение схемой через masterdata builder, потребление существующей схемы через клиент или владение стабильной схемой в коде с контролируемым созданием через клиент
  3. Спроектировать сущности так, чтобы каждая представляла четкую бизнес-концепцию, избегая смешивания несвязанных понятий
  4. Назначить индексацию только для полей, которые фактически используются для фильтрации и поиска
  5. Обеспечить стабильность имен сущностей и схем across всех рабочих пространств и аккаунтов, не кодируя окружение в имена
  6. Разработать явный план жизненного цикла схем, включающий очистку старых версий и синхронизацию между средами

Примеры запросов агенту

Как лучше спроектировать структуру данных для отзывов товаров в моем приложении VTEX IO, чтобы обеспечить быстрый поиск?
Стоит ли мне использовать masterdata builder для управления схемой сущности RV, или достаточно использовать только клиент Master Data?
Как правильно настроить индексирование в схеме Master Data для поля approved, чтобы оптимизировать запросы?

Что понадобится

  • Репозиторий с приложением VTEX IO
  • Доступ к контексту данных платформы VTEX (Master Data, VBase, core APIs)
  • Понимание бизнес-логики и требований к хранению пользовательских данных

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «vtex-io-masterdata-strategy» из репозитория: # https://github.com/vtex/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r vtex-io-masterdata-strategy/ ~/.claude/skills/vtex-io-masterdata-strategy/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.