hvp-shared 6.97.0 → 6.99.0

package/dist/contracts/qvet/client-duplicates.d.ts

@@ -2,15 +2,15 @@
  * QVET Client Duplicate Detection Contracts
  *
  * Types for the duplicate client detection and audit system.
- * Detects potential duplicate client records using scoring-based matching
- * on phone, email, name similarity, and shared pets.
+ * Returns groups of clients (2 or more) detected as potential duplicates
+ * using scoring-based matching on phone, email, name, and pet data.
  *
- * @example GET /api/qvet/clients/duplicates?branch=MAT&confidence=HIGH
+ * @example GET /api/qvet/clients/duplicates?branch=URBAN&confidence=HIGH
  */
 export type DuplicateClientConfidence = 'HIGH' | 'MEDIUM' | 'LOW';
 /**
- * Information about a single client within a duplicate pair.
- * Includes enrichment data (pets, visits, sales) to help decide which to keep.
+ * A single client within a duplicate group.
+ * Includes enrichment data to help decide which record to keep.
  */
 export interface DuplicateClientInfo {
     qvetClientId: number;
@@ -19,43 +19,31 @@ export interface DuplicateClientInfo {
     isActive: boolean;
     phone1: string;
     phone2: string;
+    phoneSms: string;
     email: string;
     lastActivityAt: string | null;
     petCount: number;
     visitCount: number;
     salesTotalAmount: number;
-    /** Pet names for quick visual comparison */
     petNames: string[];
 }
 /**
- * A pair of clients detected as potential duplicates.
+ * A group of 2+ clients detected as potential duplicates.
  *
- * Scoring:
- * - Same phone (last 7 digits): 60 pts
- * - Same email: 60 pts
- * - Same pet name: 40 pts
- * - Exact name match: +30 pts
- * - Name contained: +25 pts
- * - Name similarity >= 50%: +1 to +25 pts
- * - Same branch: +5 pts
- * - Name-only match (no other signal): 40 pts
- *
- * Confidence: HIGH >= 80, MEDIUM 60-79, LOW < 60
+ * The score reflects the strongest link between any two clients in the group.
+ * Reasons are deduplicated across all links.
  */
-export interface DuplicateClientPair {
+export interface DuplicateClientGroup {
+    groupId: number;
     score: number;
     confidence: DuplicateClientConfidence;
     reasons: string[];
-    clientA: DuplicateClientInfo;
-    clientB: DuplicateClientInfo;
-    /** Groups pairs sharing clients (e.g., A-B, A-C, B-C all get same groupId) */
-    groupId: number;
+    clients: DuplicateClientInfo[];
 }
 /**
  * Summary statistics for duplicate detection results.
  */
 export interface DuplicateClientsSummary {
-    totalPairs: number;
     totalGroups: number;
     highConfidence: number;
     mediumConfidence: number;
@@ -69,7 +57,7 @@ export interface DuplicateClientsSummary {
  */
 export interface DuplicateClientsResponse {
     summary: DuplicateClientsSummary;
-    pairs: DuplicateClientPair[];
+    groups: DuplicateClientGroup[];
 }
 /**
  * Query parameters for filtering duplicate detection results.
@@ -78,6 +66,5 @@ export interface DuplicateClientsQueryParams {
     branch?: string;
     minScore?: number;
     confidence?: DuplicateClientConfidence;
-    /** Include inactive clients in detection (default: false, only active) */
     includeInactive?: boolean;
 }

package/dist/contracts/qvet/client-duplicates.js

@@ -3,9 +3,9 @@
  * QVET Client Duplicate Detection Contracts
  *
  * Types for the duplicate client detection and audit system.
- * Detects potential duplicate client records using scoring-based matching
- * on phone, email, name similarity, and shared pets.
+ * Returns groups of clients (2 or more) detected as potential duplicates
+ * using scoring-based matching on phone, email, name, and pet data.
  *
- * @example GET /api/qvet/clients/duplicates?branch=MAT&confidence=HIGH
+ * @example GET /api/qvet/clients/duplicates?branch=URBAN&confidence=HIGH
  */
 Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hvp-shared",
-  "version": "6.97.0",
+  "version": "6.99.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",