net.olamaelcu.livtet.biblio.bookReview

A user's review of a book. StrongRefs the catalog book and optionally the originating bookShelving. rkey: tid. Written by the OAuth client (livtet-service) via com.atproto.repo.putRecord.

Details · record, key tid
Kindrecord
Record keytid
Authoritybiblio.livtet.olamaelcu.net
Indexed

Record

record · key tid

Properties

book

requiredstring · at-uri

AT-URI of the catalog book record being reviewed.

createdAt

requiredstring · datetime

rating

integer

Optional 1-10 rating. Half-stars are not yet supported at the lexicon level; round to the nearest integer. Tracked separately as a writer-side concern (see BookReviewRating type in livtet-service).

  • minimum: 1
  • maximum: 10

shelf

string · at-uri

AT-URI of the originating bookShelving record, if any.

text

requiredstring

Free-form review body.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • social.dracome.library.review

    record not from the namespace authority

    A review of one edition by an actor. Duplicate convention: the rkey is a TID minted once at first create and never changes. Several records may exist for one actor and edition (for example from out-of-band writers); consumers SHOULD treat the record with the greatest `updatedAt` (falling back to `createdAt`) as the winner and break ties by the lowest TID, ignoring the others. This is a convention, not an enforced contract: AppViews MUST tolerate a differing winner, and may see a record's catalog

  • A record representing a review of a work.

  • A user's shelf entry for a book. Exactly one record per book per user (deduplicate by ids.olWorkId, then by isbn13, then by fuzzy title+author). Status, dates, rating and notes are all carried inline; aggregators and other apps may render the same record as a 'wantToRead' card or a 'finished' review depending on the status field.

  • A long-form review of a catalog work, authored on a NeoDB instance.

  • A user review of an AT Store directory listing. Subject must be the at:// URI of a fyi.atstore.listing.detail record.