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

Словарь терминов Граф филармоний

Дополнительные термины, используемые в стандарте Граф филармоний

Пространство имен:

https://id.filarmonia.online/vocab/

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

uuid

URI	`https://id.filarmonia.online/vocab/uuid`
Тип данных	Text (UUID v4)
Домен	Organization, Place, Event, Person, MusicGroup
Статус	Обязательно с версии 1.1
Описание	Уникальный постоянный идентификатор объекта в формате UUID v4. Генерируется один раз при создании объекта и никогда не меняется. Обеспечивает принцип постоянства адресов — гарантирует неизменность идентификаторов в графе знаний.

Пример использования:

{
  "@id": "https://filarmonia.online/places/7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "@type": "MusicVenue",
  "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "name": "Большой зал филармонии"
}

Важно: UUID используется в URL объекта (@id) и гарантирует, что ссылка на объект никогда не изменится, даже если изменится название или другие атрибуты.

slug

URI	`https://id.filarmonia.online/vocab/slug`
Тип данных	Text (lowercase, латиница, дефисы)
Домен	Organization, Place, Event, Person, MusicGroup
Статус	Опционально с версии 1.1
Описание	Человекопонятный идентификатор для SEO-дружественных URL. Формат: только латинские буквы в нижнем регистре, цифры и дефисы. URL со slug должен делать 308 Permanent Redirect на UUID-версию URL.

Пример использования:

{
  "@id": "https://filarmonia.online/places/7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "@type": "MusicVenue",
  "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "slug": "big-hall",
  "name": "Большой зал филармонии"
}

Правила формата slug:

Только латинские буквы (a-z)
Только нижний регистр (lowercase)
Цифры (0-9) разрешены
Дефисы (-) в качестве разделителей
Примеры: big-hall, tchaikovsky-symphony-5, perm-orchestra

⚠️ Важно: Slug-версия URL (/places/big-hall.jsonld) должна делать 308 Permanent Redirect на UUID-версию (/places/7c9e6679-7425-40de-944b-e07fc1f90ae7.jsonld). UUID остается каноническим идентификатором.

links

URI	`https://id.filarmonia.online/vocab/links`
Тип данных	Object (массив навигационных ссылок)
Домен	Organization, Place, Event, Person, MusicGroup
Статус	Опционально с версии 1.1
Описание	Гипермедиа-навигация (HATEOAS). Поле содержит массив ссылок на связанные ресурсы, позволяя клиентам автоматически обнаруживать доступные действия и связи без жесткого кодирования URL.

Пример использования:

{
  "@id": "https://filarmonia.online/events/a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d",
  "@type": "MusicEvent",
  "uuid": "a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d",
  "name": "Симфония № 5 П.И. Чайковского",
  "links": [
    {
      "rel": "location",
      "href": "https://filarmonia.online/data/places/7c9e6679-7425-40de-944b-e07fc1f90ae7.jsonld"
    },
    {
      "rel": "performer",
      "href": "https://filarmonia.online/data/performers/f47ac10b-58cc-4372-a567-0e02b2c3d479.jsonld"
    },
    {
      "rel": "organization",
      "href": "https://filarmonia.online/data/organization.jsonld"
    }
  ]
}

Стандартные типы связей (rel):

self — ссылка на сам ресурс
location — ссылка на место проведения (Place)
performer — ссылка на исполнителя (Person, MusicGroup)
organization — ссылка на организацию
event — ссылка на событие

canonicalProfileUrl

URI	`https://id.filarmonia.online/vocab/canonicalProfileUrl`
Тип данных	URL
Домен	Organization, Place, Event, Person, MusicGroup
Описание	Канонический URL JSON-LD профиля организации на сайте партнёра (Slash URI). Используется для синхронизации данных с реестром. Это первичный источник данных.

Пример использования:

{
  "@id": "https://filarmonia.online/id/organization.jsonld",
  "@type": "Organization",
  "name": "Пермская краевая филармония",
  "canonicalProfileUrl": "https://id.filarmonia.online/org/permskaya-kraevaya-filarmoniya/profile.jsonld"
}

orgType

URI	`https://id.filarmonia.online/vocab/orgType`
Тип данных	Text (контролируемый словарь)
Домен	Organization
Допустимые значения (v1.0)	`philharmonia`
Описание	Тип организации. Версия 1.0 поддерживает только филармонии (`philharmonia`). Значения `theater`, `museum`, `festival`, `ensemble` зарезервированы для будущих версий стандарта.

Пример использования:

{
  "@type": "Organization",
  "orgType": "philharmonia",
  "name": "Пермская краевая филармония"
}

registryStatus

URI	`https://id.filarmonia.online/vocab/registryStatus`
Тип данных	Text (контролируемый словарь)
Домен	Organization, Place, Event, Person, MusicGroup
Допустимые значения	`active`, `pending`, `pending_update`, `draft`, `archived`
Описание	Статус объекта в централизованном реестре id.filarmonia. Это служебное поле, добавляемое автоматически системой реестра.

Значения статусов:

active — активная, проверенная запись
pending — ожидает модерации (новая запись)
pending_update — обновление ожидает модерации
draft — черновик
archived — архивная запись

lastSyncDate

URI	`https://id.filarmonia.online/vocab/lastSyncDate`
Тип данных	DateTime (ISO 8601)
Домен	Organization, Place, Event, Person, MusicGroup
Описание	Дата и время последней синхронизации данных с каноническим источником. Это служебное поле, обновляемое автоматически системой реестра.

Пример значения:

"lastSyncDate": "2025-12-22T15:30:00+05:00"

dataQuality

URI	`https://id.filarmonia.online/vocab/dataQuality`
Тип данных	Text (контролируемый словарь)
Домен	Organization, Place, Event, Person, MusicGroup
Допустимые значения	`verified`, `unverified`, `partial`
Описание	Уровень качества и достоверности данных. Оценивается модераторами реестра на основе полноты информации и подтверждения фактов.

Значения уровней:

verified — данные проверены и подтверждены
unverified — данные не прошли проверку
partial — данные заполнены частично

projectType

URI	`https://id.filarmonia.online/vocab/projectType`
Тип данных	Text (контролируемый словарь)
Домен	Project, Event
Статус	Зарезервировано для версии 1.3
Описание	Тип проекта или культурной программы. Поле зарезервировано для версии 1.3, когда будет добавлена поддержка сущности Project (фестивали, абонементы, образовательные программы).

eventStatus

URI	`https://id.filarmonia.online/vocab/eventStatus`
Тип данных	Text (контролируемый словарь)
Домен	Event
Допустимые значения	`scheduled`, `postponed`, `cancelled`, `rescheduled`
Статус	Опционально с версии 1.1
Описание	Статус события (концерта, спектакля). Дополняет стандартное поле Schema.org `eventStatus`, предоставляя дополнительные состояния специфичные для филармонических организаций.

Примечание: Для описания статуса события также можно использовать стандартное поле Schema.org eventStatus с значениями типа EventStatusType.

performingRole

URI	`https://id.filarmonia.online/vocab/performingRole`
Тип данных	Text
Домен	Person, MusicGroup (в контексте события)
Статус	Опционально с версии 1.1
Описание	Роль исполнителя в конкретном событии или коллективе. Используется для уточнения функции исполнителя в контексте конкретного выступления. Отличается от `jobTitle` тем, что описывает роль именно в контексте события, а не постоянную должность.

Типичные значения:

дирижер — дирижер на концерте
солист — сольный исполнитель
концертмейстер — ведущий музыкант оркестра
приглашенный артист — гастролирующий исполнитель
ведущий — ведущий концерта

Пример использования:

{
  "@type": "MusicEvent",
  "name": "Симфония № 5 П.И. Чайковского",
  "performer": [
    {
      "@type": "Person",
      "@id": "https://filarmonia.online/performers/6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "name": "Иван Иванов",
      "jobTitle": "Главный дирижер",
      "performingRole": "дирижер"
    },
    {
      "@type": "Person",
      "@id": "https://filarmonia.online/performers/a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d",
      "uuid": "a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d",
      "name": "Анна Петрова",
      "jobTitle": "Пианистка",
      "performingRole": "солист"
    }
  ]
}

Отличие от jobTitle: Поле jobTitle описывает постоянную должность исполнителя (например, "Главный дирижер"), тогда как performingRole описывает роль именно в контексте конкретного события (например, один и тот же человек может быть "дирижером" на одном концерте и "солистом" на другом).

← Вернуться к спецификации