social.dracome.library.review
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 catalogTarget change over time.
Details · record, key tid
| Kind | record |
|---|---|
| Record key | tid |
| Authority | library.dracome.social |
| Indexed |
Record
record · key tidProperties
Point-in-time catalog metadata for the reviewed work or edition, captured when this record was last written. Refreshed on every update.
The work and edition that this review is about. Mutable.
Canonical UTC instant serialized as ISO 8601 with a trailing Z suffix.
images
refOptional attached images: an optional primary image plus up to 4 secondary images (5 total). Images are independently addable/removable.
language
string · languageOptional language code the review text is written in, if different from or more specific than the actor's default language.
Scale-relative rating value. Valid range depends on ratingScale: 1-5 for 1 (whole stars), 1-10 for 2 (half stars), 1-20 for 4 (quarter stars). Interpretation: stars = rating / ratingScale. Runtime validation MUST enforce per-scale limits.
minimum: 1maximum: 20
The rating granularity divisor used at write time: divide rating by this value to recover stars. 1 = whole stars, 2 = half stars, 4 = quarter stars. Reflects whichever scale was in effect the last time rating was written on this record.
enum: 1 | 2 | 4
reviewCopy
booleanTrue when the posted review discloses that the actor received or owns a review copy of this work or edition.
text
stringOptional review text. When provided, must be non-empty after trimming.
maxLength: 40000maxGraphemes: 10000
updatedAt
string · datetimeCanonical UTC instant serialized as ISO 8601 with a trailing Z suffix.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
A portable review with an embedded book reference.
-
us.off-the-clock.review
recordWhat a member thought of something, with a rating from 1 to 10, in a content space (D99). Members respond by replying to it, so a review heads a thread. The author edits it, rating included, by rewriting it at the same key; it sorts by createdAt, so an edit keeps its place.
-
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.
-
A review for a piece of media
-
net.neodb.review
recordA long-form review of a catalog work, authored on a NeoDB instance.