AIKraft/AI/Войти
AIKraft/Skills/headless BFF архитектура

headless BFF архитектура

Apply when designing or modifying a BFF (Backend-for-Frontend) layer, middleware, or API proxy for a headless VTEX storefront. Covers BFF middleware architecture, public vs private API classification, VtexIdclientAutCookie management, API key protection, and secure request proxying. Use for any headless commerce project that must never expose VTEX_APP_KEY or call private VTEX APIs from the browser

vtex official Дизайн

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

Навык предназначен для проектирования и настройки слоя BFF (Backend-for-Frontend), middleware или API-прокси для headless-витрин VTEX. Он обеспечивает безопасное проксирование запросов, разделение публичных и приватных API, а также управление учетными данными и защита API-ключа.

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

  • Настройка слоя BFF для нового headless-проекта (кастомная витрина, мобильное приложение, киоск)
  • Определение того, какие VTEX API требуют серверного проксирования, а какие могут вызываться напрямую с фронтенда
  • Реализация управления учетными данными, включая VTEX_APP_KEY, VTEX_APP_TOKEN и VtexIdclientAutCookie
  • Проверка headless-архитектуры на соответствие требованиям безопасности

Как работает

  1. Определить контекст использования: кастомная витрина, мобильное приложение или киоск, общающийся с VTEX APIs
  2. Решить, какие VTEX APIs необходимо проксировать на стороне сервера, а какие можно вызывать напрямую из фронтенда
  3. Настроить управление учетными данными, включая безопасное хранение и передачу VTEX_APP_KEY, VTEX_APP_TOKEN и VtexIdclientAutCookie
  4. Обеспечить безопасное проксирование запросов от клиента к VTEX API
  5. Провести аудит архитектуры на предмет соответствия стандартам безопасности headless-решений

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

Как правильно настроить BFF слой для нового headless-проекта на VTEX?
Какие VTEX API нужно проксировать через сервер, а какие можно вызывать напрямую из браузера?
Как безопасно управлять VtexIdclientAutCookie и VTEX_APP_KEY в headless-архитектуре?

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

  • Доступ к VTEX API
  • Знание структуры headless-архитектуры VTEX
  • Инструменты для настройки серверного проксирования

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

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

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

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