---
id: SCR-CRM-DQ-009
title: Duplicate rules configuration
route: '/console/{tenantId}/configuration/crm/duplicateRules'
surface: console
product_area: crm
module: data-quality
revision: 1
status: draft
design_intent: proposed
implementation_evidence: partially-observed
inference: []
source_sha:
  services-crm: a8d1364f1dd44b723bb5f9acba12f983e9ec8d69
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
purpose: >-
  Configure matching responses, evaluation order and the available rule switches
  for the workspace.
supports:
  - JNY-CRM-DQ-005
  - CAP-CRM-DQ-003
  - CAP-CRM-DQ-005
permission: >-
  crm.duplicates.configure (the console configuration.duplicate-rules view and
  manage aliases)
entry_from:
  - CRM duplicate configuration navigation
exits_to:
  - The same screen
displays:
  - field: >-
      The fixed rule collection’s label, record type, matching pattern, response
      and active and portal switches.
    source: listDuplicateRules (DOM-CRM-DQ-001 rule facet)
actions:
  - label: Edit a rule
    operation_id: updateDuplicateRule
    permission: crm.duplicates.configure
    confirm: false
  - label: Reorder
    operation_id: >-
      updateDuplicateRule (each moved rule, parked at unused positions from 100
      downward before final placement)
    permission: crm.duplicates.configure
    confirm: false
  - label: Add or delete a rule (inert)
    operation_id: 'none: the service offers neither'
    permission: crm.duplicates.configure
    confirm: false
states:
  - loading
  - error
  - read-only
validation:
  - BR-CAP-CRM-DQ-003-06
  - BR-CAP-CRM-DQ-003-07
  - BR-CAP-CRM-DQ-003-09
patterns:
  - shared configuration collection
  - duplicateRulesAdapter
component: lib/configuration/duplicate-rules.ts with the shared configuration screens
evidence:
  - >-
    react-console at baf6dae3: lib/configuration/duplicate-rules.ts, areas.ts;
    lib/authz/backend-aliases.ts; components/console/nav-config.ts.
controls: [TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-AZ-005, TC-AZ-006, TC-DAT-001, TC-DAT-003, TC-LOG-004, TC-LOG-005, TC-PI-001, TC-PI-003, TC-TEN-001, TC-TEN-002, TC-TEN-003]
---

# Duplicate Rules Configuration

## What the Screen Is For

The duplicate configuration adapter supports the shared rule collection. Its route mount and guard remain partially verified within the registered scope.

## What It Shows and Lets People Do

Administrators replace existing rules and can deactivate or reorder them. Reordering first parks moved rules at unused high positions within the allowed range, then writes final positions; these separate requests can leave a partial order on failure. Add and delete explain that the service does not support those operations.

## States and Errors

Version conflicts require reload rather than silent overwrite. Service locking prevents changes, and neither the confidence floor nor re-check management is exposed by this adapter’s editor fields.

## Patterns It Must Respect

The contract names the shared configuration collection and its actual adapter rather than asserting a specific approved visual baseline. Changing rules does not immediately refresh stored comparison evidence.