Skip to content

CON-CRM-DQ-003Merge Plan

Markdown

CON-CRM-DQ-003

Merge Plan

Markdown
  • DocumentDraft
  • Product intentConfirmed
  • ImplementationObserved

Planning

Feature
FEAT-CRM-DQ-03
Owned by
MOD-CRM-DQ
Acted on by
CAP-CRM-DQ-012, CAP-CRM-DQ-013, CAP-CRM-DQ-014, CAP-CRM-DQ-015, CAP-CRM-DQ-016
Visible to
ACT-CRM-009
Not to be confused with
Distinguish this from the merge itself, which is the execution of an approved plan and its permanent record, Distinguish this from a possible duplicate, which only says two records look alike

Design

Specified by
DOM-CRM-DQ-003

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 plan describes the participants, survivor, value decisions and related changes proposed for one contact or organization merge.
Synonyms
merge workspacemerge preview
Intent sources
services-crm:docs/merging/README.md#Statusservices-crm:docs/merging/experience/README.md#Status

Relationships

ToStatementProvenance
CON-CRM-DQ-001Reviewed suggestions commonly start planning, but any selected records of one type can participate.documented
CON-CRM-DQ-004Execution creates a merge attempt, and failure restores the working plan with its decisions.test
services-crm:modules/merges/tests/integration/services/merges/merge-settlement.integration.spec.js#returns the plan to the status it had before it was executed, rather than leaving it executing
CON-CRM-ENT-001Contact plans compare identity, details, communication choices and affiliations.observed
CON-CRM-ENT-002Organization plans compare identity, domains, hierarchy and owned contact details.observed
CON-CRM-ENT-003Planning combines equivalent employment stays and describes affiliation movements for absorbed organizations.observed

Lifecycle

StateMeaningHow it changes
needs decisionsA required conflict has no answer.Answering it can establish readiness, while refreshing may introduce another question.
readyAll required choices are settled and no blocker remains.Confirmation starts work, while changed data can remove readiness.
blockedA condition prevents safe execution.Resolving the cause and refreshing can return the plan to review or readiness.
executingA merge attempt is queued or running.Success settles the plan as executed and failure restores its earlier standing.
executedThe requested merge has completed.The plan remains settled and its outcome is retained by the merge.
expiredThe open plan has passed its abandonment deadline.Further work requires a new plan.

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.