ink.resenha.migrationChoice
One of three kinds, named by kind. A book record is keyed item-<record key> or review-<record key>, after the book's anchor: its oldest social.popfeed.feed.listItem, or its oldest social.popfeed.feed.review for a book with only reviews. The plan record is keyed plan, with further parts plan-1, plan-2, … when the confirmed digests don't fit one record. The writer record is keyed writer.
Details · record, key any
| Kind | record |
|---|---|
| Record key | any |
| Authority | resenha.ink |
| Indexed |
Record
record · key anyProperties
anchor
string · at-uriFor a book: the record that names the book in the move, its oldest Popfeed list item, or its oldest review for a book with only reviews.
confirmedAt
string · datetimeFor the plan: when the reader confirmed it. Set last, after every part of the digests is written; no book is moved before it.
counts
refFor the plan: how many books each outcome had when the reader confirmed it.
device
stringFor the writer: the name of the device moving the books, as shown on the reader's other devices.
maxLength: 200
digests
unknownFor the plan or one of its parts: an object from each confirmed book's anchor key (item-<record key> or review-<record key>) to its digest, a string. The digest is a hash of the versions of every record the book's move deletes or overwrites, its outcome, and its catalogue ID; a book whose digest no longer matches is not moved, and is asked about again.
hiveId
stringFor a book: the BookHive book the reader picked as its match.
maxLength: 64
book: what the reader changed for one book, which also requires anchor and sources. plan: the choices for every book, and the confirmation, or one part of the confirmed digests. writer: the device moving the books, which also requires device and seenAt.
knownValues: book | plan | writer
merge
string · at-uriFor a book: a record Resenha proposed merging the book into, which the reader confirmed.
part
integerFor a further part of the plan (plan-1, plan-2, …): its number.
minimum: 1
review
string · at-uriFor a book with more than one review: the review the reader chose to keep.
seenAt
string · datetimeFor the writer: when that device last said it was writing. It says so every 5 minutes; another device waits while this is less than 10 minutes old, unless the reader takes over there.
side
stringFor a book in both apps whose details disagree: the record whose details the reader kept.
knownValues: bookhive | popfeed | reading
sources
arrayFor a book: the records, at the versions the reader saw, that the choice was made against. A choice whose records have changed since is asked about again.
maxLength: 2000
status
stringFor a book: the reading status the reader set, as the book's new record will carry it: a buzz.bookhive.defs token (#wantToRead, #reading, #finished, #abandoned).
maxLength: 128
#bulk
objectChanges to the defaults that apply to every book without a choice of its own.
Properties
reviewOnlyStatus
stringThe reading status given to a book with only reviews, as a buzz.bookhive.defs token; buzz.bookhive.defs#finished unless changed.
maxLength: 128
side
stringThe record whose details are kept for a book in both apps whose details disagree.
knownValues: bookhive | popfeed
#counts
objectProperties
bookhive
integerNew books moving to BookHive.
minimum: 0
held
integerBooks the reader already holds in BookHive or as a reading, which the move merges into or upgrades.
minimum: 0
pending
integerBooks waiting to be looked up in the catalogue, which aren't part of this run.
minimum: 0
reading
integerNew books moving to Resenha readings, for want of a certain catalogue match.
minimum: 0
skipped
integerBooks left out of this run.
minimum: 0
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
ink.resenha.bookLink
recordWhich catalog book a book in the reader's library is, and which of the reader's records in each book app are that book. Resenha writes these when it matches a reader's Popfeed books to BookHive's catalog, so Popfeed's and BookHive's own records are never changed to hold the match.
-
ink.resenha.reading
recordA reader's reading of a book BookHive's catalogue doesn't hold, or can't be matched to for certain: the home of last resort, so any book can be added to a library and reviewed. One per book. Status, dates, rating, review and progress live here as they do on a buzz.bookhive.book; the book is named in every key anyone uses, so any app that recognises one of them can show the reading. When BookHive's catalogue has the book, Resenha moves the reading there: it writes a buzz.bookhive.book with everyt