Rhythm 2.0 Specifications

Appearance

SVC-CRM-DQ-mergesMerges Service Module

Markdown

SVC-CRM-DQ-merges

Merges Service Module

Markdown
  • DocumentDraft
  • ImplementationObserved

KindService contractProduct areaCRMModuleDuplicate Review and Record MergingRevision1

Read atservices-crm a8d1364f

Merges Service Module ​

What This Service Is For ​

The merges module prepares reviewed combinations and executes them as durable attempts. It retains original values and absorbed identities so staff and integrations can explain the result after participant deletion.

Boundary ​

Plans, attempt history, job records and aliases belong here. Ordinary survivor saves and absorbed deletes call Entities; merge persistence also moves affiliations and references and prepares organization hierarchy. Application-owned functions apply changes outside CRM ownership.

Operations in Words ​

Type-specific read and merge permission pairs authorize planning and execution. Merge-read authority controls workspace history and aliases, while record-scoped lineage operations use the record’s read authority and selectively expose additional audit detail.

Events and Jobs ​

Contact merging writes a committed business event; organization merging currently writes none. Participant audit pointers and ordinary record events share the successful transaction. Job reporting begins before execution and maps the outcome to watched steps afterward.

Consistency Guarantees ​

Business changes are atomic, with failure recorded separately after rollback. Task reporting, announcement delivery and derived projections can lag that outcome. Each operation declares its unpublished Submissions status.

Owns
DOM-CRM-DQ-003DOM-CRM-DQ-004
Repository
services-crm

Controls

35 controls apply, from the corpus control catalogue.

TC-AVL-004 TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-AZ-005 TC-AZ-006 TC-DAT-001 TC-DAT-002 TC-DAT-003 TC-DAT-004 TC-DAT-005 TC-IAM-001 TC-IAM-002 TC-IAM-004 TC-IAM-005 TC-IAM-006 TC-LOG-001 TC-LOG-002 TC-LOG-003 TC-LOG-004 TC-LOG-005 TC-MON-001 TC-MON-002 TC-PI-001 TC-PI-002 TC-PI-003 TC-PI-004 TC-PI-005 TC-PRV-001 TC-PRV-002 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-TEN-004

Does Not Own

  • Entities owns ordinary record saves, deletes and record endpoints; merging uses those services alongside its own reference and parent preparation.
  • Application participants remain responsible for their own reference changes.
  • Platform owns portal accounts and relinking, job infrastructure, audit storage and event catalogue delivery.
  • The duplicates module owns pair decisions carried or removed during execution.

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.

Rhythm Software