feat(api): decision endpoint honors selectedOccurrenceRefs subset #1007
Loading…
Reference in a new issue
No description provided.
Delete branch "feat/decision-subset-refs"
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?
Zusammenfassung
POST /api/discovery/class-instance-candidates/{id}/decisionakzeptiert optionalselectedOccurrenceRefs(List<String>| null), damit der Suggestion-Carousel-Merge-Dialog nur eine von der Card ausgewählte Teilmenge der Bilder auf eine Zielperson anwendet.null/abwesend = exaktes Legacy-Verhalten (alle Refs, alle bestehenden Aufrufe unverändert)decision:"accepted"mitexistingInstanceIdundcreateNewInstance(Feld anwesend; Legacy-Signaldetails.createdAsNewwird ebenfalls akzeptiert)occurrence_refsder Candidate stehen, Subset ohne Ziel/Flag, oder Subset bei jedem nicht-accepted-Entscheid (inkl. Stash) → 400allowMove=trueunverändert), die Candidate bleibtpendingmit geschrumpftenoccurrence_refs(Rest-Card erscheint erneut), Responseoutcome:"subset_applied"state:"accepted",outcome:"applied")Semantik-Begründung
snapshot/lockedSnapshotbleiben vollständig — der 409-Fix-Vergleich (PR #1005) liest weiterhin die kompletten Ref-Setze; gefiltert werden nur die Writes. Ein veraltetes Subset, das nicht mehr in die gelockte Zeile passt, schlägt wie ein Parity-Miss fehl (keine Writes → 409-Pfad), nie ein Ref das die Candidate nicht trägt.afterAcceptance: erhält für Subset-Erwartungen eine lokal eingeschränkte Snapshot-Kopie, damit nur die angewendeten Refs indiscovery_results.state='accepted'landen (Rest-Refes bleibenowner_tentative).partialSubset/selectedOccurrences/remainingOccurrences(Owner-Audit bleibt wahrheitsgemäß).existingInstanceIdgesetzt ist: dort gewinnt das explizite Ziel über die Neuperson-Erzeugung (Merge-Semantik) — sonst würde der vertraglich geforderte Tripleaccepted + existingInstanceId + createNewInstanceohne Namen mit 400 scheitern.type:id(kanonisch), bare kanonische id, rohefaceAnnotationId/occurrenceId/occurrenceKey;mediaItemIdbewusst nicht (mehrere Refs pro Bild).LinkedHashMap-Copy auf H2 (Großbuchstaben-Spaltenlabels) —candidate_id+Provenance wurden NULL geschrieben. JetztLinkedCaseInsensitiveMap(PG-Verhalten unverändert, H2-Latentfehler behoben u. a. auch fürfilterAssignedRefs-Pfade).Tests
ClassInstanceDiscoveryServiceTest(4 Fälle):subsetAcceptWritesOnlySelectedRefsAndKeepsCandidatePendingWithRemainder(inkl. Rest-Card-Entscheid im Legacy-Nachlauf)subsetAcceptWithAllRefsOrWithoutFieldKeepsLegacyBehavior(explizit vollständige Liste + abwesendes Feld)subsetValidationRejectsEmptyUnknownAndUnsupportedRequests(leer/unbekannt/blank/Stash/ohne Ziel/ohne Flag → 400, keine Writes)subsetAcceptWithCreateNewInstanceStillMergesIntoExplicitTarget(Ziel gewinnt, keine neue Person,type:id-Form)rtk ./gradlew :apps:api:testgrün: 139 Testklassen, 1503 Tests, 0 Failures/Errorsspecs/001-v1-baseline/contracts/core-api.openapi.yaml) umselectedOccurrenceRefs,existingInstanceId,createNewInstance(Request) undoutcome(Result) ergänzt;specs/037/047dokumentieren dieses Request/Response-Verhalten nicht (unverändert)Abweichungen / Hinweise
state:"accepted"+outcome:"subset_applied"(applied/all_faces_already_assignedunverändert). Frontend liest die Decision-Response nicht aus (geprüft) — geringes Risiko.createNewInstancewird als Anwesenheit (non-null) gelesen, nicht als Wahrheitswert —falseist zulässig und entspricht dem Merge-Flow.POST /api/discovery/class-instance-candidates/{id}/decision accepts an optional selectedOccurrenceRefs list so the Suggestion-Carousel Merge dialog can apply only a chosen subset of a candidate's images to a target person. Contract: - absent/null -> exact legacy all-refs behavior (all existing callers) - non-empty subset only for decision=accepted with existingInstanceId AND createNewInstance present; empty array, blank refs, refs not belonging to the candidate, or any non-accepted decision -> 400 - strict subset: selected refs get occurrence writes, candidate stays pending with the remainder (state=pending, occurrence_refs shrunk), response outcome=subset_applied - full selection -> degrades to legacy accept (state=accepted) Parity/locking (PR #1005) unchanged: snapshot/lockedSnapshot stay complete, only the applied writes are filtered; a stale override fails like a parity miss (no writes, 409 path). Also fixes candidate_id/provenance written NULL when the accept unit copies the candidate row on H2 (plain LinkedHashMap copy drops Spring's case-insensitive row keys).