ApplicationNote
biblioteka/entity/application_note.jsonUne note libre attachée à n'importe quelle entité pour le contexte, les commentaires ou des informations supplémentaires.
Biblioteka
Entités
Author
biblioteka/entity/author.jsonUne identité d'auteur liée à un ou plusieurs personnages, utilisée pour attribuer des œuvres littéraires.
Book
biblioteka/entity/book.jsonUne édition publiée spécifique d'une œuvre littéraire, identifiée par l'éditeur, l'année et le format. Généralement liée à ses œuvres littéraires via contains_work, à son auteur via authored_by et à un éditeur via published_by. Les exemplaires physiques sont suivis comme des entités book_exemplar liées via exemplar_of.
Book Exemplar
biblioteka/entity/book_exemplar.jsonUn exemplaire physique d'une édition de livre, représentant un article dans la bibliothèque personnelle. Lié à son édition de livre via exemplar_of. Les images (couvertures, pages) sont attachées via has_image. L'emplacement de stockage est suivi via located_in. Plusieurs associations exemplar_of indiquent un recueil factice (plusieurs livres reliés ensemble).
Book Series
biblioteka/entity/book_series.jsonUne série thématique de livres ouverte publiée sous une marque ou un label commun (par ex. Penguin Classics, ЖЗЛ). Les livres sont liés via part_of_series avec un seriesNumber optionnel. Un livre peut appartenir à plusieurs séries. L'éditeur est lié via published_by.
Book Set
biblioteka/entity/book_set.jsonUn ensemble de publications à volume fixe regroupant plusieurs livres dans une collection numérotée (par ex. œuvres complètes, édition en plusieurs volumes). Les volumes individuels sont des entités book liées via volume_of avec volumeNumber. L'éditeur est lié via published_by.
Ephemera Exemplar
biblioteka/entity/ephemera_exemplar.jsonUn objet éphémère physique dans la collection personnelle, tel qu'une carte postale, carte de vœux, marque-page, coupure de journal, lettre ou photographie. Représente des objets de collection au niveau de l'exemplaire. Les images sont attachées via has_image. L'emplacement de stockage est suivi via located_in.
Literary Work
biblioteka/entity/literary_work.jsonUne œuvre créative abstraite indépendante de toute édition ou traduction spécifique. Les éditions publiées sont suivies comme des entités book liées via contains_work. La paternité est enregistrée via authored_by reliant à une persona.
Printer
biblioteka/entity/printer.jsonUne maison d'impression responsable de la production physique des livres.
Publisher
biblioteka/entity/publisher.jsonUne maison d'édition ou un label responsable de la production d'éditions de livres. Les livres, ensembles de livres et séries de livres sont liés aux éditeurs via published_by.
Quote
biblioteka/entity/quote.jsonUne citation notable attribuée à un personnage ou extraite d'une œuvre littéraire. L'attribution est enregistrée via attributed_to. La source est suivie via taken_from ou contains_quote.
Translated Literary Work
biblioteka/entity/translated_literary_work.jsonUne traduction d'une œuvre littéraire dans une autre langue. Liée à l'œuvre originale via le champ originalWorkId. Le traducteur est lié via translated_by. Peut être contenue dans un livre via contains_work.
Associations
Addressed To
biblioteka/association/addressed_to.jsonRelie une œuvre littéraire (côté gauche : lettre ou adresse ouverte) à la personne ou à l'organisation à laquelle elle est adressée (côté droit : personnage, auteur, organisation ou éditeur).
Attributed To
biblioteka/association/attributed_to.jsonRelie une citation (côté gauche) à son auteur ou orateur présumé (côté droit : personnage ou auteur).
Authored By
biblioteka/association/authored_by.jsonRelie une œuvre créative (côté gauche : livre ou œuvre littéraire) au personnage qui l'a écrite (côté droit : auteur).
Book Has Illustrator
biblioteka/association/book_has_illustrator.jsonRelie une édition de livre (côté gauche) au personnage qui l'a illustrée (côté droit : illustrateur).
Contains Comments By
biblioteka/association/contains_comments_by.jsonRelie une œuvre (côté gauche : livre, œuvre littéraire ou traduction) au personnage qui a fourni des commentaires, une préface ou des notes (côté droit : commentateur).
Contains Epigraph
biblioteka/association/contains_epigraph.jsonRelie une œuvre (côté gauche : livre, œuvre littéraire ou traduction) à une citation utilisée comme épigraphe (côté droit : citation).
Contains Quote
biblioteka/association/contains_quote.jsonRelie une œuvre (côté gauche : livre, œuvre littéraire ou traduction) à une citation mentionnée dans son texte (côté droit : citation).
Contains Work
biblioteka/association/contains_work.jsonRelie une édition de livre ou un ensemble de livres (côté gauche) à une œuvre littéraire qu'elle contient (côté droit : œuvre littéraire ou traduction).
Copyright Held By
biblioteka/association/copyright_held_by.jsonRelie une œuvre littéraire (côté gauche : œuvre littéraire ou traduction) à l'entité qui détient ses droits d'auteur (côté droit : éditeur, personnage ou auteur).
Dedicated By
biblioteka/association/dedicated_by.jsonRelie une œuvre créative (côté gauche : book ou literary work) à la personne qui l'a dédiée (côté droit : persona ou author).
Dedicated To
biblioteka/association/dedicated_to.jsonRelie une œuvre créative (côté gauche : livre ou œuvre littéraire) à l'entité à laquelle elle est dédiée (côté droit : personnage, auteur ou œuvre littéraire).
Dedication multi
biblioteka/multi_association/dedication.jsonUn événement de dédicace : la personne A a dédié une œuvre littéraire à la personne B. La première sous-association (dedicated_by) relie l'œuvre au dédicateur ; la seconde (dedicated_to) relie la même œuvre au dédicataire.
dedicated_by: literary_work → persona, authordedicated_to: literary_work → persona, author
Designed By
biblioteka/association/designed_by.jsonRelie une œuvre (côté gauche : livre, œuvre littéraire ou traduction) au designer ou artiste responsable de son style visuel (côté droit : personnage ou auteur).
Edited By
biblioteka/association/edited_by.jsonRelie une œuvre (côté gauche : livre, œuvre littéraire ou traduction) à l'éditeur scientifique responsable de son édition (côté droit : personnage ou auteur).
Exemplar Of
biblioteka/association/exemplar_of.jsonRelie un exemplaire physique d'un livre (côté gauche : exemplaire de livre) à son édition (côté droit : livre).
First Published In
biblioteka/association/first_published_in.jsonRelie une œuvre littéraire (côté gauche : œuvre littéraire ou traduction) au livre dans lequel elle a été publiée pour la première fois (côté droit : livre).
Found With
biblioteka/association/found_with.jsonRelie un objet éphémère (côté gauche : exemplaire d'éphémère) à l'exemplaire physique du livre dans lequel il a été trouvé lors de l'acquisition (côté droit : exemplaire de livre). Plus spécifique qu'une relation de stockage ou de transaction générale.
Founder Of
biblioteka/association/founder_of.jsonRelie un personnage (côté gauche : personnage ou auteur) à l'organisation qu'il a fondée (côté droit : éditeur, imprimeur ou entreprise).
Gift multi
biblioteka/multi_association/gift.jsonUn événement de don : la personne A a offert un objet à la personne B. La première sous-association (gifted_by) relie l'objet au donateur ; la seconde (gifted_to) relie le même objet au destinataire.
gifted_by: book_exemplar → persona, authorgifted_to: book_exemplar → persona, author
Gifted By
biblioteka/association/gifted_by.jsonRelie un exemplaire physique d'un livre (côté gauche : book_exemplar) à la personne qui l'a offert (côté droit : persona ou author).
Gifted To
biblioteka/association/gifted_to.jsonRelie un exemplaire physique d'un livre (côté gauche : book_exemplar) à la personne qui l'a reçu en cadeau (côté droit : persona ou author).
Has Application Note Attached
biblioteka/association/has_application_note_attached.jsonRelie n'importe quelle entité (côté gauche) à une note d'application contenant des métadonnées supplémentaires ou des annotations (côté droit : note d'application).
Imprint Of
biblioteka/association/imprint_of.jsonRelie un label d'éditeur (côté gauche : éditeur) à son éditeur parent (côté droit : éditeur). Représente les relations hiérarchiques entre éditeurs.
Inscribed By
biblioteka/association/inscribed_by.jsonRelie un exemplaire physique d'un livre (côté gauche : book_exemplar) à la personne qui l'a inscrit, signé ou marqué (côté droit : persona ou author). Couvre les autographes, dédicaces, ex-libris et tampons.
Inscription Image
biblioteka/association/inscription_image.jsonRelie une personne qui a réalisé une inscription (côté gauche : persona ou author) à la photographie montrant cette inscription (côté droit : image). Permet à la même image de participer à d'autres associations (p. ex. has_image avec le rôle title_page) sans conflit.
Interviewed By
biblioteka/association/interviewed_by.jsonRelie une œuvre littéraire (côté gauche : interview en tant qu'œuvre littéraire) au personnage qui a conduit l'interview (côté droit : intervieweur ou auteur).
Mentions
biblioteka/association/mentions.jsonRelie une œuvre (côté gauche : œuvre littéraire, cinématographique ou logiciel) à toute entité mentionnée ou citée dans celle-ci (côté droit : tout type d'entité, y compris personnes, autres œuvres, organisations, lieux, localités, etc.).
Part Of Series
biblioteka/association/part_of_series.jsonRelie un livre ou une collection de livres (côté gauche : édition ou collection multi-volumes) à la série thématique dans laquelle il a été publié (côté droit : book series), avec un numéro de série facultatif.
Printed By
biblioteka/association/printed_by.jsonRelie une édition de livre (côté gauche : livre) à l'imprimeur responsable de sa production physique (côté droit : imprimeur).
Published By
biblioteka/association/published_by.jsonRelie une édition de livre ou un ensemble de livres (côté gauche : livre ou ensemble de livres) à l'éditeur responsable de sa publication (côté droit : éditeur).
Published In
biblioteka/association/published_in.jsonRelie une œuvre publiée (côté gauche : livre ou ensemble de livres) à la localité ou au lieu où elle a été publiée (côté droit : localité ou lieu).
Reprint Of
biblioteka/association/reprint_of.jsonRelie une édition de livre (côté gauche) à une édition antérieure dont elle est une réimpression ou dérivée (côté droit). Couvre les réimpressions, les éditions ultérieures et les autres éditions dérivées.
Sequel Of
biblioteka/association/sequel_of.jsonRelie une œuvre littéraire (côté gauche : suite) à l'œuvre littéraire qu'elle continue (côté droit : prédécesseur). Représente l'ordre des séries.
Taken From
biblioteka/association/taken_from.jsonRelie une citation (côté gauche) à l'œuvre littéraire dont elle a été extraite (côté droit : œuvre littéraire ou traduction).
Takes Place In
biblioteka/association/takes_place_in.jsonRelie une œuvre créative (côté gauche : œuvre littéraire ou traduction) au lieu géographique où l'action se déroule (côté droit : localité ou lieu).
Translated By
biblioteka/association/translated_by.jsonRelie une œuvre (côté gauche : livre, œuvre littéraire ou traduction) au traducteur responsable de sa traduction (côté droit : personnage ou auteur).
Translation Of
biblioteka/association/translation_of.jsonRelie une œuvre littéraire traduite (côté gauche : œuvre littéraire traduite) à l'œuvre littéraire originale dont elle a été traduite (côté droit : œuvre littéraire).
Volume Of
biblioteka/association/volume_of.jsonRelie un livre (côté gauche : volume individuel) à la collection multi-volumes à laquelle il appartient (côté droit : book set), avec son numéro de volume.
Business
Entités
Company
business/entity/company.jsonUne entreprise commerciale ou industrielle.
Associations
Competed Against
business/association/competed_against.jsonRelie deux entités dans une compétition ou un match (les côtés gauche et droit sont interchangeables : personnage, logiciel, entreprise ou organisation). Les exemples incluent les matchs d'échecs, les rivalités commerciales ou les concours sportifs.
Headquartered In
business/association/headquartered_in.jsonRelie une entreprise (côté gauche) à la localité ou au lieu où son siège social est situé (côté droit : localité ou lieu).
Incorporated In
business/association/incorporated_in.jsonRelie une entreprise (côté gauche) à l'État ou à la juridiction où elle est légalement constituée ou enregistrée (côté droit : État).
Geography
Entités
Place
geography/entity/place.jsonUn emplacement géographique nommé qui n'est pas une localité.
Settlement
geography/entity/settlement.jsonUn lieu peuplé tel qu'une ville, un bourg ou un village.
Associations
Located In
geography/association/located_in.jsonRelie une entité (côté gauche : lieu, localité, organisation, exemplaire de livre, exemplaire d'éphémère ou emplacement de stockage) à l'emplacement dans lequel elle se trouve (côté droit : localité, état ou emplacement de stockage).
Library
Entités
Storage Location
library/entity/storage_location.jsonUn emplacement physique où sont stockés des exemplaires de livres, avec prise en charge de la hiérarchie (étagère, bibliothèque, pièce, appartement). Les exemplaires de livres sont liés via located_in. La hiérarchie est construite avec located_in entre les emplacements de stockage (transitif). Peut se connecter à la hiérarchie géographique via located_in vers settlement.
Media
Entités
Image
media/entity/image.jsonUne entité image représentant un fichier image binaire avec des métadonnées descriptives.
Associations
Has Image
media/association/has_image.jsonRelie n'importe quelle entité (côté gauche) à une image qui lui est associée (côté droit : image), avec un rôle précisant l'objectif de l'image (ex. : couverture, portrait).
Primary Image
media/association/primary_image.jsonEnregistre une préférence explicite de l'utilisateur désignant une image (côté droit : image) comme la représentation visuelle principale de toute entité (côté gauche). Une seule association primary_image est autorisée par entité. Il s'agit d'un choix d'affichage sélectionné par l'utilisateur, et non d'une propriété intrinsèque de l'entité ou de l'image elle-même. L'image référencée doit également avoir une association has_image avec la même entité.
People
Entités
Persona
people/entity/persona.jsonUne figure documentée, contestée, traditionnelle ou fictive avec des attributs biographiques. Couramment liée comme auteur via authored_by, traducteur via translated_by ou éditeur via edited_by. Les lieux de naissance et de décès sont enregistrés via born_in_settlement/born_in_state et died_in_settlement/died_in_state.
Associations
Born In Settlement
people/association/born_in_settlement.jsonRelie un personnage (côté gauche) à la localité ou à la ville où il est né (côté droit : localité).
Born In State
people/association/born_in_state.jsonRelie un personnage (côté gauche) à l'État ou au pays où il est né (côté droit : État).
Coauthor Of
people/association/coauthor_of.jsonRelie deux personnages qui ont coécrit une œuvre ensemble (les côtés gauche et droit sont interchangeables : personnage).
Died In Settlement
people/association/died_in_settlement.jsonRelie un personnage (côté gauche) à la localité ou à la ville où il est décédé (côté droit : localité).
Died In State
people/association/died_in_state.jsonRelie un personnage (côté gauche) à l'État ou au pays où il est décédé (côté droit : État).
Friend Of
people/association/friend_of.jsonRelie deux personnages dans une amitié (les côtés gauche et droit sont interchangeables : personnage).
Granted By
people/association/title_granted_by.jsonRelie un personnage (côté gauche) à l'organisation ou à l'État qui lui a accordé un titre, un diplôme ou une distinction (côté droit : organisation ou État).
Interviewer Of
people/association/interviewer_of.jsonRelie un personnage intervieweur (côté gauche) au personnage interviewé (côté droit : personnage).
Lived In
people/association/lived_in.jsonRelie un personnage (côté gauche) à la localité ou au lieu où il a résidé (côté droit : localité ou lieu).
Parent Of
people/association/parent_of.jsonRelie un personnage parent (côté gauche) à son enfant (côté droit : personnage).
Relative Of
people/association/relative_of.jsonRelie deux personnages dans une relation familiale générale (les côtés gauche et droit sont interchangeables : personnage).
Resided In State
people/association/resided_in_state.jsonRelie un personnage (côté gauche) à l'État ou au pays où il a résidé pendant une période de temps (côté droit : État).
Romantic Relationship With
people/association/romantic_relationship_with.jsonRelie deux personnages dans une relation romantique (les côtés gauche et droit sont interchangeables : personnage).
Spouse Of
people/association/spouse_of.jsonRelie deux personnages dans une relation matrimoniale (les côtés gauche et droit sont interchangeables : personnage).
Worked For
people/association/worked_for.jsonRelie un personnage (côté gauche) à la personne ou l'organisation pour laquelle il a travaillé (côté droit : personnage ou organisation).
Performing_arts
Entités
Cinematic Work
performing_arts/entity/cinematic_work.jsonUn film, un documentaire ou toute autre œuvre cinématographique.
Performance
performing_arts/entity/performance.jsonUn spectacle ou événement unique — une date et une heure précises dans un lieu donné, avec une distribution spécifique.
Production
performing_arts/entity/production.jsonUne mise en scène spécifique d'une œuvre scénique par un metteur en scène, une compagnie de théâtre ou un festival particulier, au cours d'une saison définie.
Stage Work
performing_arts/entity/stage_work.jsonUne composition abstraite pour les arts du spectacle — un opéra, un ballet, une pièce de théâtre ou une comédie musicale — indépendante de toute mise en scène ou représentation spécifique.
Associations
Based On
performing_arts/association/based_on.jsonRelie une œuvre scénique ou cinématographique (côté gauche) à l'œuvre littéraire dont elle est tirée (côté droit : œuvre littéraire).
Choreographed By
performing_arts/association/choreographed_by.jsonRelie une œuvre scénique ou une production (côté gauche) à son chorégraphe (côté droit : personnage).
Composed By
performing_arts/association/composed_by.jsonRelie une œuvre scénique (côté gauche) à son compositeur (côté droit : personnage).
Directed By
performing_arts/association/directed_by.jsonRelie une œuvre cinématographique ou une production (côté gauche) à son réalisateur (côté droit : personnage).
Features Performer
performing_arts/association/features_performer.jsonRelie une représentation (côté gauche) à un interprète qui y a participé (côté droit : personnage), avec des détails optionnels sur le rôle et le type d'instrument/voix.
Instance Of Production
performing_arts/association/instance_of_production.jsonRelie une représentation (côté gauche) à la production à laquelle elle appartient (côté droit : production).
Libretto By
performing_arts/association/libretto_by.jsonRelie une œuvre scénique (côté gauche) à son librettiste (côté droit : personnage).
Performed At
performing_arts/association/performed_at.jsonRelie une représentation (côté gauche) au lieu où elle s'est déroulée (côté droit : lieu ou organisation).
Produced By
performing_arts/association/produced_by.jsonRelie une production (côté gauche) à l'organisation qui l'a produite (côté droit : organisation).
Staging Of
performing_arts/association/staging_of.jsonRelie une production (côté gauche) à l'œuvre scénique qu'elle réalise (côté droit : œuvre scénique).
Reader
Entités
Reader Persona
reader/entity/reader_persona.jsonLe personnage propre du lecteur utilisé pour suivre l'historique de lecture et les préférences.
User List
reader/entity/user_list.jsonUne liste nommée et curée par l'utilisateur d'entités arbitraires (par ex. une liste 'Desiderata' de livres à acquérir, un 'Projet de lecture 2026', une compilation de 'Recommandations de N' ou une liste de librairies à visiter). Les éléments sont rattachés via le schéma de sous-type selon le type de liste (fichier `
Associations
Custom List Contains
reader/association/custom_list_contains.jsonRelie un user_list de type custom défini par l'utilisateur (côté gauche : user_list avec listType='custom') à un élément arbitraire qu'il contient (côté droit : tout type d'entité). Porte une machine à états générique (pending, done, abandoned) pour les cas qui ne correspondent à aucun listType prédéfini. Prend en charge un indicateur de priorité optionnel et une position optionnelle (1-based) lorsque le user_list parent est ordonné.
Desiderata List Contains
reader/association/desiderata_list_contains.jsonRelie un user_list de type desiderata (côté gauche : user_list avec listType='desiderata') à un élément arbitraire qu'il contient (côté droit : tout type d'entité, par ex. livre, œuvre littéraire, personnage). Porte l'état d'acquisition du desideratum (pending, found, abandoned), la date d'acquisition et un indicateur de priorité optionnel pour mettre en évidence les éléments que l'utilisateur souhaite trouver en premier.
Reading Project List Contains
reader/association/reading_project_list_contains.jsonRelie un user_list de projet de lecture (côté gauche : user_list avec listType='reading_project') à une œuvre qu'il contient (côté droit : book, literary_work ou translated_literary_work). Porte à la fois l'appartenance à la liste et l'état de lecture de cette œuvre dans le contexte de la liste — le même enum status et les mêmes champs de date que reads_v1 (to_read, reading, finished, abandoned). Quand une œuvre figure dans un projet de lecture, cet enregistrement est la source de vérité consolidée pour « dans la liste » et « état de lecture » ; un enregistrement reads_v1 séparé n'est pas requis pour cette intersection.
Reads
reader/association/reads.jsonRelie un personnage lecteur (côté gauche : personnage lecteur) à une œuvre créative représentant une expérience de lecture (côté droit : livre, œuvre littéraire ou traduction).
Recommendations List Contains
reader/association/recommendations_list_contains.jsonRelie un user_list de type recommendations (côté gauche : user_list avec listType='recommendations') à un élément arbitraire qu'il contient (côté droit : tout type d'entité). Suit si l'utilisateur a donné suite à la recommandation : pending, followed_up ou dismissed ; enregistre éventuellement la date du suivi.
Reference List Contains
reader/association/reference_list_contains.jsonRelie un user_list de type reference (côté gauche : user_list avec listType='reference') à un élément arbitraire qu'il contient (côté droit : tout type d'entité, par ex. personnage, literary_work, localité). Les listes de référence sont des regroupements analytiques issus de la recherche (par ex. « auteurs mentionnés dans Empire Must Die ») ; les éléments y sont simplement inclus ou non, donc ce sous-type ne porte pas de champ status. Le champ position optionnel enregistre l'ordre canonique dans la source (par ex. ordre de mention).
Wishlist List Contains
reader/association/wishlist_list_contains.jsonRelie un user_list de type wishlist (côté gauche : user_list avec listType='wishlist') à une cible arbitraire non acquérable qu'il contient (côté droit : lieu, localité, organisation, performance, etc.). Suit si la cible a été visitée ou expérimentée (pending, visited, abandoned), enregistre éventuellement la date de visite, prend en charge un indicateur de priorité optionnel pour les éléments incontournables et une position optionnelle (1-based) lorsque le wishlist est intentionnellement ordonné.
Social
Entités
Organization
social/entity/organization.jsonUne organisation formelle, une institution ou un groupe.
State
social/entity/state.jsonUne entité politique telle qu'un pays, un empire ou un territoire autonome.
Software
Entités
Software
software/entity/software.jsonUne application logicielle, un outil, un jeu vidéo ou un service web.
Associations
Developed By
software/association/developed_by.jsonRelie un logiciel (côté gauche : logiciel) à son développeur (côté droit : personnage, entreprise ou organisation).