Skip to content

CON-CRM-DQ-004Merge

Markdown

CON-CRM-DQ-004

Merge

Markdown
  • DocumentDraft
  • Product intentConfirmed
  • ImplementationObserved

Planning

Feature
FEAT-CRM-DQ-04
Owned by
MOD-CRM-DQ
Acted on by
CAP-CRM-DQ-016, CAP-CRM-DQ-017, CAP-CRM-DQ-019, CAP-CRM-DQ-011, CAP-CRM-DQ-018
Visible to
ACT-CRM-009, ACT-CRM-008, ACT-CRM-002
Not to be confused with
Distinguish this from the merge plan, which is the working state a person approves before a merge exists, Distinguish this from deleting a record, which removes it without leaving an alias or moving what pointed at it

Design

Specified by
DOM-CRM-DQ-004

KindKey conceptProduct areaCRMModuleDuplicate Review and Record MergingRevision1

Read atservices-crm a8d1364freact-console baf6dae3

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Definition
A merge executes one reviewed plan atomically and retains an accountable outcome, including the identities absorbed by the survivor.
Synonyms
record mergemerge record
Intent sources
services-crm:docs/merging/README.md#Statusservices-crm:docs/merging/experience/README.md#Status

Relationships

ToStatementProvenance
CON-CRM-DQ-003Each attempt executes one plan, with at most one active or successful attempt and retained failed attempts.test
services-crm:modules/merges/tests/integration/db/record-merges.table.integration.spec.js#takes a new merge of a plan whose every earlier merge failed, which is how a failed merge is retried
CON-CRM-DQ-005Every absorbed record leaves an alias identifying its merge and survivor.test
CON-CRM-ENT-033The merge groups each record's captured changes with a common merge correlation.documented
CON-CRM-ENT-002Organization execution updates hierarchy and moves affiliations to its survivor.test

Lifecycle

StateMeaningHow it changes
queuedThe confirmed attempt awaits execution.Its job claims work or reconciliation starts or fails a lost job.
runningThe merge transaction is applying locked changes.Commit succeeds or failure rolls the transaction back.
succeededThe complete combination has committed.This attempt remains permanently settled.
failedThe combination is unapplied and its reason is recorded.The restored plan can create another distinct attempt.

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.