ApplicationNote
biblioteka/entity/application_note.jsonПроизвольная заметка, прикреплённая к любой сущности для контекста, комментариев или дополнительной информации.
Biblioteka
Сущности
Author
biblioteka/entity/author.jsonАвторская идентичность, связанная с одной или несколькими персонами и используемая для атрибуции литературных произведений.
Book
biblioteka/entity/book.jsonКонкретное опубликованное издание литературного произведения, определяемое издателем, годом и форматом. Обычно связывается с литературными произведениями через contains_work, с автором через authored_by и с издательством через published_by. Физические экземпляры отслеживаются как сущности book_exemplar, связанные через exemplar_of.
Book Exemplar
biblioteka/entity/book_exemplar.jsonФизический экземпляр книжного издания, представляющий единицу в личной библиотеке. Связан с книжным изданием через exemplar_of. Изображения (обложки, страницы) прикрепляются через has_image. Место хранения отслеживается через located_in. Несколько связей exemplar_of указывают на конволют (несколько книг, переплетённых вместе).
Book Series
biblioteka/entity/book_series.jsonОткрытая тематическая книжная серия, издаваемая под общим брендом (напр. ЖЗЛ, Библиотека поэта). Книги связываются через part_of_series с необязательным номером серии. Книга может входить в несколько серий. Издательство связывается через published_by.
Book Set
biblioteka/entity/book_set.jsonМноготомное издание, объединяющее несколько книг в нумерованную коллекцию (напр. собрание сочинений). Отдельные тома представлены как сущности book, связанные через volume_of с номером тома. Издательство связывается через published_by.
Ephemera Exemplar
biblioteka/entity/ephemera_exemplar.jsonФизический предмет эфемеры в личной коллекции, такой как открытка, поздравительная карточка, закладка, газетная вырезка, письмо или фотография. Представляет коллекционные объекты уровня экземпляра. Изображения прикрепляются через has_image. Место хранения отслеживается через located_in.
Literary Work
biblioteka/entity/literary_work.jsonАбстрактное творческое произведение, независимое от конкретного издания или перевода. Опубликованные издания отслеживаются как сущности book, связанные через contains_work. Авторство фиксируется через authored_by, связывая с персоной.
Printer
biblioteka/entity/printer.jsonТипография, ответственная за физическое производство книг.
Publisher
biblioteka/entity/publisher.jsonИздательство или импринт, ответственный за выпуск книжных изданий. Книги, книжные комплекты и книжные серии связываются с издательствами через published_by.
Quote
biblioteka/entity/quote.jsonПримечательная цитата, приписываемая персоне или извлечённая из литературного произведения. Авторство фиксируется через attributed_to. Источник отслеживается через taken_from или contains_quote.
Translated Literary Work
biblioteka/entity/translated_literary_work.jsonПеревод литературного произведения на другой язык. Связан с оригинальным произведением через поле originalWorkId. Переводчик связывается через translated_by. Может входить в книгу через contains_work.
Ассоциации
Addressed To
biblioteka/association/addressed_to.jsonСвязывает литературное произведение (левая сторона: письмо или открытое обращение) с адресатом (правая сторона: персона, автор, организация или издатель).
Attributed To
biblioteka/association/attributed_to.jsonСвязывает цитату (левая сторона) с её предполагаемым автором или говорящим (правая сторона: персона или автор).
Authored By
biblioteka/association/authored_by.jsonСвязывает произведение (левая сторона: книга или литературное произведение) с автором (правая сторона: персона).
Book Has Illustrator
biblioteka/association/book_has_illustrator.jsonСвязывает издание книги (левая сторона) с персоной, выполнившей иллюстрации (правая сторона: иллюстратор).
Contains Comments By
biblioteka/association/contains_comments_by.jsonСвязывает произведение (левая сторона: книга, литературное произведение или перевод) с персоной, предоставившей комментарии, предисловие или примечания (правая сторона: комментатор).
Contains Epigraph
biblioteka/association/contains_epigraph.jsonСвязывает произведение (левая сторона: книга, литературное произведение или перевод) с цитатой, использованной в качестве эпиграфа (правая сторона: цитата).
Contains Quote
biblioteka/association/contains_quote.jsonСвязывает произведение (левая сторона: книга, литературное произведение или перевод) с цитатой, упомянутой в тексте (правая сторона: цитата).
Contains Work
biblioteka/association/contains_work.jsonСвязывает издание книги или книжный набор (левая сторона) с литературным произведением, которое оно содержит (правая сторона: литературное произведение или перевод).
Copyright Held By
biblioteka/association/copyright_held_by.jsonСвязывает литературное произведение (левая сторона: литературное произведение или перевод) с правообладателем (правая сторона: издатель, персона или автор).
Dedicated By
biblioteka/association/dedicated_by.jsonСвязывает произведение (левая сторона: книга или литературное произведение) с лицом, посвятившим его (правая сторона: персона или автор).
Dedicated To
biblioteka/association/dedicated_to.jsonСвязывает произведение (левая сторона: книга или литературное произведение) с тем, кому оно посвящено (правая сторона: персона, автор или литературное произведение).
Dedication мульти
biblioteka/multi_association/dedication.jsonСобытие посвящения: лицо A посвятило литературное произведение лицу B. Первая подассоциация (dedicated_by) связывает произведение с посвятителем; вторая (dedicated_to) связывает то же произведение с адресатом посвящения.
dedicated_by: literary_work → persona, authordedicated_to: literary_work → persona, author
Designed By
biblioteka/association/designed_by.jsonСвязывает произведение (левая сторона: книга, литературное произведение или перевод) с дизайнером или художником, ответственным за визуальное оформление (правая сторона: персона или автор).
Edited By
biblioteka/association/edited_by.jsonСвязывает произведение (левая сторона: книга, литературное произведение или перевод) с редактором, ответственным за его подготовку (правая сторона: персона или автор).
Exemplar Of
biblioteka/association/exemplar_of.jsonСвязывает физический экземпляр книги (левая сторона: экземпляр) с изданием книги (правая сторона: книга).
First Published In
biblioteka/association/first_published_in.jsonСвязывает литературное произведение (левая сторона: литературное произведение или перевод) с книгой, в которой оно впервые было опубликовано (правая сторона: книга).
Found With
biblioteka/association/found_with.jsonСвязывает предмет эфемеры (левая сторона: экземпляр эфемеры) с физическим экземпляром книги, в котором он был обнаружен при приобретении (правая сторона: экземпляр книги). Более специфично, чем общее хранение или транзакция.
Founder Of
biblioteka/association/founder_of.jsonСвязывает персону (левая сторона: персона или автор) с организацией, которую она основала (правая сторона: издатель, типография или компания).
Gift мульти
biblioteka/multi_association/gift.jsonСобытие дарения: лицо A подарило предмет лицу B. Первая подассоциация (gifted_by) связывает предмет с дарителем; вторая (gifted_to) связывает тот же предмет с получателем.
gifted_by: book_exemplar → persona, authorgifted_to: book_exemplar → persona, author
Gifted By
biblioteka/association/gifted_by.jsonСвязывает физический экземпляр книги (левая сторона: book_exemplar) с лицом, подарившим его (правая сторона: персона или автор).
Gifted To
biblioteka/association/gifted_to.jsonСвязывает физический экземпляр книги (левая сторона: book_exemplar) с лицом, получившим его в подарок (правая сторона: персона или автор).
Has Application Note Attached
biblioteka/association/has_application_note_attached.jsonСвязывает любую сущность (левая сторона) с прикладной заметкой, содержащей дополнительные метаданные или аннотации (правая сторона: прикладная заметка).
Imprint Of
biblioteka/association/imprint_of.jsonСвязывает импринт издательства (левая сторона: издатель) с головным издательством (правая сторона: издатель). Представляет иерархию издательств.
Inscribed By
biblioteka/association/inscribed_by.jsonСвязывает физический экземпляр книги (левая сторона: book_exemplar) с лицом, оставившим надпись, автограф или пометку (правая сторона: персона или автор). Охватывает автографы, дарственные надписи, экслибрисы и штампы.
Inscription Image
biblioteka/association/inscription_image.jsonСвязывает лицо, оставившее надпись (левая сторона: персона или автор), с фотографией этой надписи (правая сторона: изображение). Позволяет одному изображению участвовать в нескольких ассоциациях без конфликтов.
Interviewed By
biblioteka/association/interviewed_by.jsonСвязывает литературное произведение (левая сторона: интервью как литературное произведение) с персоной, проводившей интервью (правая сторона: интервьюер).
Mentions
biblioteka/association/mentions.jsonСвязывает произведение (левая сторона: литературное произведение, кинематографическое произведение или программное обеспечение) с любой сущностью, упомянутой в нём (правая сторона: любой тип сущности, включая персон, другие произведения, организации, места, населённые пункты и т. д.).
Part Of Series
biblioteka/association/part_of_series.jsonСвязывает книгу или книжный комплект (левая сторона: издание или многотомник) с тематической серией (правая сторона: книжная серия), с необязательным номером в серии.
Printed By
biblioteka/association/printed_by.jsonСвязывает издание книги (левая сторона: книга) с типографией, ответственной за её печать (правая сторона: типография).
Published By
biblioteka/association/published_by.jsonСвязывает издание книги или книжный набор (левая сторона: книга или книжный набор) с издателем, ответственным за публикацию (правая сторона: издатель).
Published In
biblioteka/association/published_in.jsonСвязывает опубликованное произведение (левая сторона: книга или книжный комплект) с населённым пунктом или местом, где оно было издано (правая сторона: населённый пункт или место).
Reprint Of
biblioteka/association/reprint_of.jsonСвязывает издание книги (левая сторона) с более ранним изданием, перепечаткой или производным которого оно является (правая сторона). Охватывает перепечатки, последующие издания и другие производные издания.
Sequel Of
biblioteka/association/sequel_of.jsonСвязывает литературное произведение (левая сторона: продолжение) с литературным произведением, которое оно продолжает (правая сторона: предшественник). Представляет порядок в серии.
Taken From
biblioteka/association/taken_from.jsonСвязывает цитату (левая сторона) с литературным произведением, из которого она была извлечена (правая сторона: литературное произведение или перевод).
Takes Place In
biblioteka/association/takes_place_in.jsonСвязывает произведение (левая сторона: литературное произведение или перевод) с географическим местом, где происходит действие (правая сторона: населённый пункт или место).
Translated By
biblioteka/association/translated_by.jsonСвязывает произведение (левая сторона: книга, литературное произведение или перевод) с переводчиком, выполнившим перевод (правая сторона: персона или автор).
Translation Of
biblioteka/association/translation_of.jsonСвязывает переводное литературное произведение (левая сторона: переводное литературное произведение) с оригинальным литературным произведением, с которого был выполнен перевод (правая сторона: литературное произведение).
Volume Of
biblioteka/association/volume_of.jsonСвязывает книгу (левая сторона: отдельный том) с многотомным изданием (правая сторона: набор книг), указывая номер тома.
Business
Сущности
Company
business/entity/company.jsonКоммерческое или промышленное предприятие.
Ассоциации
Competed Against
business/association/competed_against.jsonСвязывает две сущности в соревновании или матче (левая и правая стороны взаимозаменяемы: персона, программное обеспечение, компания или организация). Примеры: шахматные матчи, деловая конкуренция или спортивные состязания.
Headquartered In
business/association/headquartered_in.jsonСвязывает компанию (левая сторона) с населённым пунктом или местом, где расположена её штаб-квартира (правая сторона: населённый пункт или место).
Incorporated In
business/association/incorporated_in.jsonСвязывает компанию (левая сторона) с государством или юрисдикцией, в которой она юридически зарегистрирована (правая сторона: государство).
Geography
Сущности
Place
geography/entity/place.jsonИменованное географическое место, не являющееся населённым пунктом.
Settlement
geography/entity/settlement.jsonНаселённый пункт, такой как город, посёлок или деревня.
Ассоциации
Located In
geography/association/located_in.jsonСвязывает сущность (левая сторона: место, населённый пункт, организация, экземпляр книги, экземпляр эфемеры или место хранения) с местоположением, в котором она находится (правая сторона: населённый пункт, штат/область или место хранения).
Library
Сущности
Storage Location
library/entity/storage_location.jsonФизическое место хранения экземпляров книг с поддержкой иерархии (полка, шкаф, комната, квартира). Экземпляры книг связываются через located_in. Иерархия строится через located_in между местами хранения (транзитивно). Может связываться с географической иерархией через located_in к settlement.
Media
Сущности
Image
media/entity/image.jsonСущность изображения, представляющая бинарный файл изображения с описательными метаданными.
Ассоциации
Has Image
media/association/has_image.jsonСвязывает любую сущность (левая сторона) с изображением (правая сторона: изображение), с указанием роли изображения (например, обложка, портрет).
Primary Image
media/association/primary_image.jsonФиксирует явный выбор пользователя, назначающий одно изображение (правая сторона: изображение) в качестве основного визуального представления любой сущности (левая сторона). Допускается не более одной связи primary_image на сущность. Это пользовательское предпочтение для отображения, а не внутреннее свойство сущности или самого изображения. Указанное изображение также должно иметь связь has_image с той же сущностью.
People
Сущности
Persona
people/entity/persona.jsonДокументированная, оспариваемая, традиционная или вымышленная фигура с биографическими атрибутами. Обычно связывается как автор через authored_by, переводчик через translated_by или редактор через edited_by. Места рождения и смерти фиксируются через born_in_settlement/born_in_state и died_in_settlement/died_in_state.
Ассоциации
Born In Settlement
people/association/born_in_settlement.jsonСвязывает персону (левая сторона) с населённым пунктом или городом, где она родилась (правая сторона: населённый пункт).
Born In State
people/association/born_in_state.jsonСвязывает персону (левая сторона) с государством или страной, где она родилась (правая сторона: государство).
Coauthor Of
people/association/coauthor_of.jsonСвязывает две персоны, являющиеся соавторами произведения (левая и правая стороны взаимозаменяемы: персона).
Died In Settlement
people/association/died_in_settlement.jsonСвязывает персону (левая сторона) с населённым пунктом или городом, где она скончалась (правая сторона: населённый пункт).
Died In State
people/association/died_in_state.jsonСвязывает персону (левая сторона) с государством или страной, где она скончалась (правая сторона: государство).
Friend Of
people/association/friend_of.jsonСвязывает две персоны в дружеских отношениях (левая и правая стороны взаимозаменяемы: персона).
Granted By
people/association/title_granted_by.jsonСвязывает персону (левая сторона) с организацией или государством, присвоившим ей титул, степень или награду (правая сторона: организация или государство).
Interviewer Of
people/association/interviewer_of.jsonСвязывает интервьюера (левая сторона: персона) с респондентом, которого он интервьюировал (правая сторона: персона).
Lived In
people/association/lived_in.jsonСвязывает персону (левая сторона) с населённым пунктом или местом, где она проживала (правая сторона: населённый пункт или место).
Parent Of
people/association/parent_of.jsonСвязывает родителя (левая сторона: персона) с ребёнком (правая сторона: персона).
Relative Of
people/association/relative_of.jsonСвязывает две персоны родственными отношениями (левая и правая стороны взаимозаменяемы: персона).
Resided In State
people/association/resided_in_state.jsonСвязывает персону (левая сторона) с государством или страной, в которой она проживала в течение определённого периода (правая сторона: государство).
Romantic Relationship With
people/association/romantic_relationship_with.jsonСвязывает две персоны в романтических отношениях (левая и правая стороны взаимозаменяемы: персона).
Spouse Of
people/association/spouse_of.jsonСвязывает две персоны в брачных отношениях (левая и правая стороны взаимозаменяемы: персона).
Worked For
people/association/worked_for.jsonСвязывает персону (левая сторона) с персоной или организацией, на которую она работала (правая сторона: персона или организация).
Performing_arts
Сущности
Cinematic Work
performing_arts/entity/cinematic_work.jsonФильм, документальное кино или иное кинопроизведение.
Performance
performing_arts/entity/performance.jsonОдно представление или событие — конкретная дата и время в определённом месте с определённым составом исполнителей.
Production
performing_arts/entity/production.jsonКонкретная постановка сценического произведения определённым режиссёром, театральной труппой или фестивалем в рамках определённого сезона.
Stage Work
performing_arts/entity/stage_work.jsonАбстрактная композиция для исполнительских искусств — опера, балет, пьеса или мюзикл — независимо от конкретной постановки или исполнения.
Ассоциации
Based On
performing_arts/association/based_on.jsonСвязывает сценическое или кинематографическое произведение (левая сторона) с литературным произведением, на котором оно основано (правая сторона: литературное произведение).
Choreographed By
performing_arts/association/choreographed_by.jsonСвязывает сценическое произведение или постановку (левая сторона) с его хореографом (правая сторона: персона).
Composed By
performing_arts/association/composed_by.jsonСвязывает сценическое произведение (левая сторона) с его композитором (правая сторона: персона).
Directed By
performing_arts/association/directed_by.jsonСвязывает кинематографическое произведение или постановку (левая сторона) с его режиссёром (правая сторона: персона).
Features Performer
performing_arts/association/features_performer.jsonСвязывает представление (левая сторона) с исполнителем, принявшим в нём участие (правая сторона: персона), с возможным указанием роли и типа инструмента/голоса.
Instance Of Production
performing_arts/association/instance_of_production.jsonСвязывает представление (левая сторона) с постановкой, к которой оно относится (правая сторона: постановка).
Libretto By
performing_arts/association/libretto_by.jsonСвязывает сценическое произведение (левая сторона) с его либреттистом (правая сторона: персона).
Performed At
performing_arts/association/performed_at.jsonСвязывает представление (левая сторона) с площадкой, где оно состоялось (правая сторона: место или организация).
Produced By
performing_arts/association/produced_by.jsonСвязывает постановку (левая сторона) с организацией, которая её осуществила (правая сторона: организация).
Staging Of
performing_arts/association/staging_of.jsonСвязывает постановку (левая сторона) со сценическим произведением, которое она воплощает (правая сторона: сценическое произведение).
Reader
Сущности
Reader Persona
reader/entity/reader_persona.jsonПерсона читателя, используемая для отслеживания истории чтения и предпочтений.
User List
reader/entity/user_list.jsonПользовательский именованный список произвольных сущностей (напр. список «Desiderata» книг для приобретения, проект чтения «2026», подборка «Рекомендации от N», список книжных магазинов для посещения). Элементы прикрепляются через схему подтипа по типу списка (файл `
Ассоциации
Custom List Contains
reader/association/custom_list_contains.jsonСвязывает пользовательский custom-список (левая сторона: user_list с listType='custom') с произвольным элементом, который он содержит (правая сторона: сущность любого типа). Включает обобщённую модель состояния (pending, done, abandoned) для случаев, не подпадающих ни под один предопределённый listType. Поддерживает опциональный флаг приоритета и опциональную позицию (1-based), когда родительский user_list упорядочен.
Desiderata List Contains
reader/association/desiderata_list_contains.jsonСвязывает desiderata-список (левая сторона: user_list с listType='desiderata') с произвольным элементом, который он содержит (правая сторона: сущность любого типа, напр. книга, литературное произведение, персона). Отражает состояние приобретения желаемого (pending, found, abandoned), дату приобретения и опциональный флаг приоритета для выделения предметов, которые пользователь хочет найти в первую очередь.
Reading Project List Contains
reader/association/reading_project_list_contains.jsonСвязывает читательский проект (левая сторона: user_list с listType='reading_project') с произведением, которое он содержит (правая сторона: книга, литературное произведение или перевод). Хранит и членство в списке, и состояние чтения произведения в контексте этого списка — те же enum status и поля дат, что и в reads_v1 (to_read, reading, finished, abandoned). Когда произведение находится в читательском проекте, эта запись является объединённым источником истины и для «в списке», и для «состояния чтения»; отдельная запись reads_v1 для этого пересечения не требуется.
Reads
reader/association/reads.jsonСвязывает персону-читателя (левая сторона: персона читателя) с произведением, представляющим опыт чтения (правая сторона: книга, литературное произведение или перевод).
Recommendations List Contains
reader/association/recommendations_list_contains.jsonСвязывает recommendations-список (левая сторона: user_list с listType='recommendations') с произвольным элементом, который он содержит (правая сторона: сущность любого типа). Отслеживает реакцию пользователя на рекомендацию: pending, followed_up или dismissed; опционально фиксирует дату обращения к рекомендации.
Reference List Contains
reader/association/reference_list_contains.jsonСвязывает reference-список (левая сторона: user_list с listType='reference') с произвольным элементом, который он содержит (правая сторона: сущность любого типа, напр. персона, литературное произведение, населённый пункт). Справочные списки — это аналитические группировки, полученные в результате исследования (напр. «авторы, упомянутые в „Империи должно умереть“»); элементы либо включены, либо нет, поэтому в этом подтипе нет поля status. Опциональное поле position фиксирует канонический порядок в источнике (напр. порядок упоминания).
Wishlist List Contains
reader/association/wishlist_list_contains.jsonСвязывает wishlist-список (левая сторона: user_list с listType='wishlist') с произвольной неприобретаемой целью, которую он содержит (правая сторона: место, населённый пункт, организация, представление и т. п.). Отслеживает, посещена ли цель (pending, visited, abandoned), опционально фиксирует дату посещения, поддерживает опциональный флаг приоритета для обязательных к посещению и опциональную позицию (1-based), когда wishlist намеренно упорядочен.
Social
Сущности
Organization
social/entity/organization.jsonФормальная организация, учреждение или группа.
State
social/entity/state.jsonПолитическое образование, такое как страна, империя или автономная территория.
Software
Сущности
Software
software/entity/software.jsonПрограммное приложение, инструмент, видеоигра или веб-сервис.
Ассоциации
Developed By
software/association/developed_by.jsonСвязывает программное обеспечение (левая сторона: программное обеспечение) с его разработчиком (правая сторона: персона, компания или организация).