feat(people-worker): multi-representant person representation (CV-validated) #1081
Loading…
Reference in a new issue
No description provided.
Delete branch "feat/multi-representant-person-centroids"
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?
Messgrundlage (PR #1080, Owner-Bibliothek, 2796 Faces / 36 Personen)
Christian-Verwechslungen →Nathalie (51×) / →Jesper (40×) fallen auf <3. Neu unter Multi-Repräsentanten: Christian wird selbst Verwechslungs-Hub (max. 8× als falsches top-1 Ziel) — Band-Neukalibrierung beobachten.
Band-Empfehlung (Deployment-Entscheidung, separat): nach Deploy
suggest_max_distance0.50→0.45 setzen — gleiche Vorschlagsquote wie heute bei WS 1.6% (bei 0.50: 2.7%). Multi-Repräsentant-Distanzen schrumpfen systematisch (korrektes top-1 Median 0.325 vs 0.409).Design (ADR 0108,
docs/adr/0108-multi-representant-person-representation.json)semisupervised-v2: je Person/Modell-Pair werden die zugewiesenen Faces per Average-Linkage-Clustering (Cosine) beirepresentative_split_distancezerlegt; je Cluster ein Unit-Mean-Centroid (gemessener Gewinner vs. Medoid), Singletons = eigener Repräsentant, facelose Person = keiner.d_pess = d + Z·σ·√(1/n_source + 1/size_rep)(ADR-0106-Margin mit Clustergröße als n_target); persons Pessimistic-Key = min über Repräsentanten;distance= RAW-Distanz des pessimistisch gewählten Repräsentanten; Shortlist (Isolation/Ambiguität) bleibt RAW (Formeln unverändert, Geometrie = Raw-Min).confidence = clamp(1 - round(distance,6)), kein Envelope-Feld neu, keine Contract-Version-Bump. Gates, qualityScore, review-only, Emissions-Pfade, v1-Pfad und Legacy-Methoden byte-identisch.representative_split_distance(V155, NUMERIC(4,3), finite [0,2], People-Default 0.50 = gemessenes Knee; 0.40 hätte besserens top-1, aber ~7× Repräsentanten). 2.0 = alles in einem Cluster = exakt die alte Single-Centroid-Darstellung (Operator-Aus-Schalter). Snapshot alssettings.representativeSplitDistance(nur v2-Payloads) in den unveränderlichen Job-Payload; GET/PATCH/api/admin/people/representative-split-distance(super-admin, null=Reset).unit_rows,cosine_distance_matrix,average_linkage_merges,cut_dendrogram) zogen verbatim ins Produktions-clustering.py; das CV-Experiment importiert sie (Kopie gelöscht) — Produktion ist die gemessene Implementierung by construction, Paritätstest pinnt beide Seiten.REPRESENTATIVE_SPLIT_MAX_FACES(2000) nutzbare Faces behalten den Single-Centroid (dokumentierte Degradierung, kein Job-Failure; Live-Max ~1200). Deterministisch (aufsteigende Face-IDs), Neuberechnung pro Lauf, keine Persistenz.Nicht geändert
v1-Pfad, qualityScore/Isolation/Ambiguität-Formeln, Emissions-Gates, review-only-Semantik, Web-Code, Deployment-Settings (Band bleibt 0.50 im Deployment bis der Owner umstellt).
Tests
WorkerResultSemisupervisedEnvelopeTest44/44 grün.🚫 Nicht mergen ohne Owner-Freigabe — Deployment-Band-Entscheidung (0.45) ist bewusst NICHT Teil dieses PRs.