mirror of
https://github.com/chmouel/liseur-sync.git
synced 2026-08-27 08:21:42 +00:00
0a6d4167aa
Highlights, notes and bookmarks are the first mutable kind of reading state: each record carries a rev, and every write is a compare-and-set against it. The server orders writes; it never merges. Store: an annotations table with its own per-user seq counter (migration 5 on both backends), batched push in one transaction under the work-graph lock, a delta feed with tombstones, a per-work cap on live records, split/merge reassignment, and an hourly sweep that drops tombstones after the retention window. API: four sync-scoped routes. POST /v1/annotations answers 200 with one result per item (applied, duplicate, conflict carrying the server copy, or invalid with the reason); one bad item fails alone, including an item the decoder cannot type. The request cap is computed from the documented field bounds with worst-case JSON escaping, and exceeding it is a 413, not a misleading parse error. Tombstones carry identity, rev, seq and timestamps, nothing else. Web UI: the reader draws synced highlights through the foliate overlayer, mapping palette tokens to fixed CSS. Notes, bookmarks and highlights that no longer anchor appear in the drawer list. The work page gains a read-only annotations panel. The browser check now seeds three annotations and verifies the highlight renders as an overlay rect in a real Chromium. |
||
|---|---|---|
| .. | ||
| adr | ||
| screenshots | ||
| deployment.md | ||
| DESIGN.md | ||
| integrating.md | ||
| openapi.yaml | ||