«Каталка»: справочник тегов и экспортных значений

Версия документа: 1.0.0 Статус: официальный справочник для frontend и backend Актуальность: 5 августа 2026 года Совместимость: content-admin / export contract 1.9

Назначение: единый словарь строковых кодов, enum-значений и тегов, которые приходят из content-admin через export и backend API.

Ответственность за ведение:

• backend использует этот файл при импорте, маппинге и подготовке публичных DTO;
• frontend использует коды как стабильный контракт, а отображаемые подписи — как справочную локализацию;
• изменение существующего кода или его смысла требует новой версии документа и записи в журнале изменений.

Важно: значения кодов (RESTAURANT, DAY_MOOD_RELAX, TOP_SERVICE и т. п.) являются частью контракта. Для отображаемого текста frontend может использовать собственную локализацию, но сравнивать и фильтровать нужно по коду.

1. Resort

1.1. previewTags

Пример:

{
  "previewTags": {
    "infrastructure": "TOP_SERVICE",
    "format": "VACATION",
    "budget": "MID_RANGE",
    "ridingSpecific": ["FREERIDE"],
    "vibe": ["PARTY"]
  }
}

previewTags.infrastructure

previewTags.format

previewTags.budget

previewTags.ridingSpecific[]

previewTags.vibe[]

1.2. metaTags[]

metaTags — более широкий набор классификационных / рекомендательных тегов курорта.

{
  "metaTags": [
    "FREERIDE_EXCELLENT",
    "LONG_SEASON",
    "APRES_SKI"
  ]
}

Уровень катания

Фрирайд

Разнообразие

Аудитория

Стиль отдыха

Бюджет

Инфраструктура

1.3. features[] — особенности курорта

Начиная с export 1.9, основным источником блока «Особенности курорта» является отдельный массив resorts[].features[].

ResortMedia.role = STORY пока остаётся допустимым legacy-значением для существующего контента, но не является основным источником нового блока особенностей.

2. Place — тип места type

Это актуальная типизация content-admin/export.

2.1. Place — группа отображения groupCode

groupCode определяет редакционную секцию, в которой место удобно показывать. Это не то же самое, что type.

Пример:

{
  "type": "CAFE",
  "groupCode": "FOOD"
}

2.2. Place — контакт contacts.items[].type

Пример:

{
  "contacts": {
    "items": [
      {
        "name": "Сайт",
        "type": "WEBSITE",
        "value": "https://example.com"
      }
    ]
  }
}

3. Day-Off — теги мест и событий

Day-Off параметры могут находиться в:

place.tags.dayOff
event.tags.dayOff

Типовая структура:

{
  "dayOff": {
    "tags": [
      "DAY_COMPANY_FRIENDS",
      "DAY_MOOD_IMPRESSIONS",
      "DAY_INTEREST_NATURE"
    ],
    "budgetLevel": "DAY_BUDGET_COMFORT",
    "activityLevel": "DAY_ACTIVITY_ACTIVE",
    "recommendedTimeBlocks": [
      "MORNING",
      "AFTERNOON"
    ],
    "indoor": false,
    "outdoor": true,
    "familyFriendly": true,
    "kidsFriendly": false,
    "dietaryFriendly": false,
    "noLongTransfer": false,
    "partnerPriority": false
  }
}

3.1. Компания dayOff.tags[]

3.2. Настроение / формат дня dayOff.tags[]

3.3. Интересы dayOff.tags[]

3.4. Уровень активности activityLevel

3.5. Бюджет budgetLevel

3.6. Рекомендуемое время recommendedTimeBlocks[]

3.7. Day-Off boolean-флаги

4. Event — type

Событие также может иметь Day-Off параметры из раздела 3.

5. Collection

5.1. type

5.2. placement

5.3. items[].targetType

6. Article / News

6.1. category

6.2. status

7. Banner

7.1. placement

7.2. targetType

targetPayload содержит параметры перехода и зависит от targetType.

8. Media — основные роли

Для связанных медиа в экспорте используется поле role.

Для курортов backend поддерживает:

Для ResortFeature используются две отдельные роли:

В экспортируемых Place / Event / Collection / Article / Banner наиболее часто используются COVER, GALLERY и специализированные роли конкретной сущности.

9. Resort — прочие важные экспортные поля

Эти поля не являются тегами, но frontend обычно использует их рядом с классификацией.

10. Общие правила frontend

1. Не переводить enum-код перед сравнением.

Храним / сравниваем PHOTO_SPOT, отображаем «Инсталокация».

1. Не строить логику по русскому label.

Label может измениться без изменения API-кода.

1. Не путать Place.type и Place.groupCode.

Например:

``json { "type": "RESTAURANT", "groupCode": "DAY_OFF" } ``

означает: сущность остаётся рестораном, но редакционно участвует в секции «День без каталки».

1. Day-Off tags[], budgetLevel, activityLevel и boolean-флаги — разные измерения.

Не следует объединять их в один массив на клиенте.

1. Неизвестное значение enum лучше отображать безопасным fallback, а не падать.

Для UI допустим fallback «Другое» / исходный код.

1. metaTags и previewTags — разные системы тегов курорта.

• previewTags — короткие пользовательские характеристики карточки.
• metaTags — расширенная классификация / рекомендации.

1. searchAliases не показываются как пользовательские теги.

Это поисковые синонимы.

1. sortOrder — числовой редакционный порядок.

Для сущностей, где он заполнен, меньшее значение показывается раньше.

11. Быстрый TypeScript-шаблон

Пример, как безопасно завести словарь на frontend:

export const PLACE_TYPE_LABELS: Record<string, string> = {
  RESTAURANT: 'Ресторан',
  CAFE: 'Кафе',
  BAR: 'Бар',
  SPA: 'SPA / бассейн',
  BATH: 'Баня',
  HOTEL: 'Отель',
  VIEWPOINT: 'Видовая точка',
  PHOTO_SPOT: 'Инсталокация',
  SHOP: 'Магазин',
  MEDICAL: 'Медпункт',
  RESCUE: 'Спасатели',
  PARKING: 'Парковка',
  TOILET: 'Туалет',
  ACTIVITY: 'Активность / досуг',
  RENTAL: 'Прокат',
  TRANSPORT: 'Транспорт',
  OTHER: 'Другое',
};

export function enumLabel(
  dictionary: Record<string, string>,
  value?: string | null,
): string {
  if (!value) return '';
  return dictionary[value] ?? value;
}

12. История версий

13. Переход со старых значений Place

Справочник ориентирован на текущий content-admin и экспортную линию 1.9.

Особенно важно для Place.type: PHP content-admin уже использует новую типизацию:

PHOTO_SPOT
ACTIVITY
RENTAL
TRANSPORT

а более старый backend merge может ещё содержать прежние значения:

INSTAGRAM_SPOT
ATTRACTION
RENTAL_POINT

Для нового frontend-контента ориентироваться следует на актуальный экспортный контракт.