---
id: ADR-CRM-DQ-015
title: Persist bounded review groups
product_area: crm
module: data-quality
revision: 1
status: proposed
design_intent: proposed
source_sha:
  services-crm: a8d1364f1dd44b723bb5f9acba12f983e9ec8d69
decision: >-
  Groups store bounded connected components for one review standing and are
  refreshed with pair changes, preserving the prior identity with the largest
  contribution.
constrains:
  - DOM-CRM-DQ-001
  - STATE-CRM-DQ-002
  - WF-CRM-DQ-001
  - WF-CRM-DQ-004
  - SCR-CRM-DQ-002
  - SCR-CRM-DQ-003
origin: 'services-crm:docs/merging/duplicate-detection.md#14 (backend gaps G1, G2, G10)'
alternatives:
  - option: Group a page of pairs in the browser
    why_not: >-
      Paging would prevent reliable whole-group counting and stable shared
      links.
  - option: Refresh groups later on a schedule
    why_not: New decisions would leave grouping out of date until the next refresh.
consequences:
  - >-
    Most growth and shrinkage preserve the group link; split and join rules
    select which identity survives.
  - Larger connected sets carry an indication that the result is bounded.
  - Attention publication waits for metadata registration.
supersedes: []
evidence:
  - >-
    services-crm at a8d1364f:
    modules/duplicates/services/groups/group-components.ts;
    services/persistence/duplicate-groups.ts.
---

# Persist bounded review groups

## Context

Reviewers need shareable groups rather than isolated pages of pairs.

## Decision

Groups store bounded connected components for one review standing and are refreshed with pair changes, preserving the prior identity with the largest contribution.

## Alternatives Considered

Group a page of pairs in the browser. Paging would prevent reliable whole-group counting and stable shared links.

Refresh groups later on a schedule. New decisions would leave grouping out of date until the next refresh.

## Consequences

Most growth and shrinkage preserve the group link; split and join rules select which identity survives. Larger connected sets carry an indication that the result is bounded. Attention publication waits for metadata registration.