---
id: JNY-CRM-REG-005
title: An organization address change updates linked placements
feature: FEAT-CRM-REG-03
product_area: crm
module: regions
revision: 2
status: draft
product_intent: proposed
implementation_evidence: observed
supersedes: []
source_sha:
  services-crm: a8d1364f1dd44b723bb5f9acba12f983e9ec8d69
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
actor: ACT-CRM-001
goal: Save an office move once and reconcile the organization and its linked people.
capabilities:
  - CAP-CRM-ENT-005
  - CAP-CRM-REG-008
screens:
  - '/console/{tenantId}/crm/organizations/{id}'
  - '/console/{tenantId}/crm/contacts/{id}'
steps:
  - 'n': 1
    surface: '/console/{tenantId}/crm/organizations/{id}'
    action: Save the organization’s main address in another region’s coverage.
    capability: CAP-CRM-ENT-005
    expected: The organization address change is committed.
    provenance: test
    source: 'react-console:acceptance/crm/playwright/journeys/organizations/CRM-ACC-0119.spec.ts#CRM-ACC-0119'
  - 'n': 2
    surface: '/console/{tenantId}/crm/organizations/{id}'
    action: Read the organization after assignment processing.
    capability: CAP-CRM-REG-008
    expected: Its placement reflects the new deciding address.
    provenance: test
    source: >-
      services-crm:modules/regions/tests/integration/services/region-assignment/region-assignment.integration.spec.js#moving
      › moves an organization when its main address moves
  - 'n': 3
    surface: '/console/{tenantId}/crm/contacts/{id}'
    action: Read an employee using the organization’s linked work address.
    capability: CAP-CRM-REG-008
    expected: Regional reconciliation updates the employee without editing their contact address rows.
    provenance: test
    source: >-
      services-crm:modules/regions/tests/integration/services/region-assignment/region-assignment.integration.spec.js#a
      linked address (docs/affiliations/README.md §0b.3, the fan-out) › moves the linked contact when its
      organization’s address moves, though no contact row was written
alternates:
  - from_step: 3
    condition: The employee has an automatic-assignment override.
    path: Reconciliation preserves the stored exception.
    outcome: Only eligible linked employees receive a new region.
    provenance: test
    source: >-
      services-crm:modules/regions/tests/integration/services/region-assignment/region-assignment.integration.spec.js#manual
      regions and the override › never changes the region of a contact that overrides automatic assignment
failures:
  - from_step: 3
    condition: The employee’s affiliation expired before the organization moved.
    path: The link no longer supplies a current deciding address.
    outcome: The organization event can reconcile the contact and clear its previously calculated region.
    provenance: inferred
    source: >-
      services-crm:modules/entities/services/persistence/contacts.ts:readContactRegionAddresses;
      services-crm:modules/regions/services/region-assignment/region-assignment.ts:linkedContactRegionAssignmentHandler,
      reconcileRegionAssignments
    note: >-
      Expiry alone produces no address event, but a subsequent organization address event finds linked
      contacts and reconciles their currently resolved addresses.
rules_in_play:
  - BR-CAP-CRM-REG-008-02
  - BR-CAP-CRM-REG-008-10
  - BR-CAP-CRM-REG-008-11
  - BR-CAP-CRM-REG-008-12
  - BR-CAP-CRM-REG-009-01
assertions:
  - id: AS-JNY-CRM-REG-005-01
    statement: Changing the linked employee’s region adds one version increment without writing contact address rows.
    provenance: test
    source: >-
      services-crm:modules/regions/tests/integration/services/region-assignment/region-assignment.integration.spec.js#a
      linked address (docs/affiliations/README.md §0b.3, the fan-out) › bumps the contact’s version once, for
      the region that moved and nothing else
e2e_policy: optional
e2e_reason: >-
  Service evidence covers linked assignment; the organization-maintenance browser journey exercises it as part
  of its broader address workflow.
---

# An organization address change updates linked placements

## Story

A coordinator saves an organization’s office move and regional processing evaluates its new address. Contacts linked to the changed address also become eligible for reconciliation without copied address edits. Each current eligible placement can follow the new coverage. Overrides and expired affiliations affect those decisions.