feat(api): canonical representative thumbnail per ADR 0114 #1277
Loading…
Reference in a new issue
No description provided.
Delete branch "feat/rep-thumb-api"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Single canonical representative-thumbnail entry point (ClassInstanceRepresentativeService): manual pin (manual_selection provenance) -> medoid of the largest cluster (persisted medoid_face_annotation_id V170 for people, one embedding cluster over class_occurrence_embeddings elsewhere) -> deterministic terminal ladder (accepted-first, ADR 0103 quality else confidence, captured recency, id). All former per-service ladder copies routed through it (listing, detail, people enrichment, ranking preview URLs with ISSUE-140 batching kept, relations, collaborative bridge owner reps, self-person avatar, face-picker marker); manual pins now honored on listings that ignored them; auto-pin removed; setRepresentativeMedia resolves canonical occurrence on the chosen media; re-pinning idempotently re-enqueues the generate_discovery_thumbnail crop; thumbnail pointer accepts fail closed unless the payload occurrence is the current canonical representative; missing-crop sweeps enqueue canonical crops only (payload occurrenceId). Depends on the worker PR shipping medoidFaceAnnotationId but is absent-legal until then (older workers fall to the terminal ladder). rtk :apps:api:test 2164 tests 0 failures.
411d5ca65dcf9048dad1