AIKraft/AI/Войти
AIKraft/Skills/VTEX IO: паттерны доступа к данным

VTEX IO: паттерны доступа к данным

Apply when deciding where and how a VTEX IO app should store and read data. Covers when to use app settings, configuration apps, Master Data, VBase, VTEX core APIs, or external stores, and how to avoid duplicating sources of truth or abusing configuration stores for operational data. Use for new data flows, caching decisions, refactors, or reviewing suspicious storage and access patterns in VTEX I

vtex official Данные

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

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

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

  • Проектирование новых потоков данных для IO-приложения
  • Выбор между использованием app settings, Master Data, VBase или VTEX core APIs
  • Рефакторинг кода, который читает или записывает большие, дублированные или критичные наборы данных
  • Введение слоев кэширования или производных локальных представлений вокруг существующих API

Как работает

  1. Ответить на четыре вопроса: чьи это данные, кто является источником истины, как приложение будет их запрашивать и нужна ли локальная копия
  2. Выбрать хранилище: app settings для стабильной конфигурации, Master Data для структурированных записей, VBase для простых ключевых документов, VTEX core APIs для авторитетных коммерческих данных или внешние системы
  3. Обеспечить явность источника истины: использовать VTEX core APIs как основной источник для заказов, каталога, цен и инвентаря, а локальные копии хранить только как минимальные производные представления
  4. Избегать использования app settings для операционных данных, журналов или больших списков записей
  5. Применять API-уровневую фильтрацию, пагинацию и выбор полей вместо загрузки полных наборов данных в Node.js для фильтрации в памяти
  6. Использовать кэширование только при наличии четких правил инвалидации и свежести данных

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

Как правильно хранить данные о статусе модерации: в app settings или в Master Data?
Проверь, не дублирует ли наше приложение полные данные заказов из VTEX core в Master Data
Рефакторинг запроса к Master Data: как избежать полной выборки и фильтрации в памяти Node.js

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

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

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

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