---
id: ADR-CRM-ENT-012
title: Resolve Shared Details on Read
product_area: crm
module: entities
revision: 1
status: proposed
design_intent: confirmed
source_sha:
  services-crm: 7ea48a414c42eade10d60753b8bcc323b1dd726f
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
decision: >-
  Live organization links resolve contact-point values during reads; removing
  the source converts dependent details into disconnected snapshots with origin,
  time and reason in the same transaction.
constrains:
  - STATE-CRM-ENT-006
  - WF-CRM-ENT-010
  - DOM-CRM-ENT-001
  - DOM-CRM-ENT-002
origin: 'D-25 (Andrew, 2026-10-19); CRM-M1 plan A11; CRM-M2 plan A9 and A19'
alternatives:
  - option: Copy every source edit into all linked contacts.
    why_not: >-
      The retired flowdown design repeatedly rewrote contacts and obscured the
      difference between a deliberate copy and a live link.
  - option: Treat source removal as an ordinary copy.
    why_not: >-
      Readers would lose the warning that the organization withdrew that contact
      point.
consequences:
  - >-
    Source value edits do not rewrite live linked contacts; source removal does
    disconnect and version them. Region work follows organization address
    events.
  - Disconnected values require human resolution and have no dedicated reminder.
evidence:
  - >-
    services-crm at 7ea48a41: docs/disconnected-information.md;
    modules/entities/db/contact-information-effective.view.ts
---
# Resolve Shared Details on Read

## Context

A shared contact point is a reference, while a copy is a local snapshot. Read-time resolution keeps live references aligned without repeatedly rewriting their contacts.

## Decision

Live organization links resolve contact-point values during reads; removing the source converts dependent details into disconnected snapshots with origin, time and reason in the same transaction.

## Alternatives Considered

Copy every source edit into all linked contacts. The retired flowdown design repeatedly rewrote contacts and obscured the difference between a deliberate copy and a live link.

Treat source removal as an ordinary copy. Readers would lose the warning that the organization withdrew that contact point.

## Consequences

Source removal changes that contract: the database preserves the last value as a disconnected snapshot needing review. Calendar ineligibility instead leaves the reference unresolved. The console’s review choices use general contact patches, with the dedicated API distinction recorded separately.

Source value edits do not rewrite live linked contacts; source removal does disconnect and version them. Region work follows organization address events. Disconnected values require human resolution and have no dedicated reminder.