The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.
| # | Surface | Action | Capability | Expected | Provenance |
|---|---|---|---|---|---|
| 1 | /console/{tenantId}/crm/organizations/{id} | Save the organization’s main address in another region’s coverage. | CAP-CRM-ENT-005 | The organization address change is committed. | test |
| 2 | /console/{tenantId}/crm/organizations/{id} | Read the organization after assignment processing. | CAP-CRM-REG-008 | Its placement reflects the new deciding address. | test services-crm:modules/regions/tests/integration/services/region-assignment/region-assignment.integration.spec.js#moving › moves an organization when its main address moves |
| 3 | /console/{tenantId}/crm/contacts/{id} | Read an employee using the organization’s linked work address. | CAP-CRM-REG-008 | Regional reconciliation updates the employee without editing their contact address rows. | test 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 |
| Path | From step | Condition | Path taken | Outcome | Provenance |
|---|---|---|---|---|---|
| alternate | 3 | The employee has an automatic-assignment override. | Reconciliation preserves the stored exception. | Only eligible linked employees receive a new region. | test 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 |
| failure | 3 | The employee’s affiliation expired before the organization moved. | The link no longer supplies a current deciding address. | The organization event can reconcile the contact and clear its previously calculated region. | inferred services-crm:modules/entities/services/persistence/contacts.ts:readContactRegionAddresses; services-crm:modules/regions/services/region-assignment/region-assignment.ts:linkedContactRegionAssignmentHandler, reconcileRegionAssignments |
| Id | Statement | Provenance |
|---|---|---|
01 | Changing the linked employee’s region adds one version increment without writing contact address rows. | test 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 |
End-to-end policy: optional: Service evidence covers linked assignment; the organization-maintenance browser journey exercises it as part of its broader address workflow.