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}/configuration/crm/regions/assignmentRules | Change New York coverage to the second region and save the policy. | CAP-CRM-REG-004 | The new coverage is stored without updating existing placements. | test |
| 2 | /console/{tenantId}/configuration/crm/regions?tab=rules | Visit the saved Assignment Rules tab. | CAP-CRM-REG-010 | The need banner provides the recalculation action. | test react-console:e2e/dev/regions.dev.spec.ts#asks for a recalculation after a rule changes, and stops asking once it has run |
| 3 | /console/{tenantId}/configuration/crm/regions?tab=rules | Start recalculation from the banner. | CAP-CRM-REG-011 | The view displays processing progress in place of the need notice. | test react-console:components/regions/__tests__/recalculation.test.tsx#the banner › shows the progress of a run in its place, without a second button |
| 4 | getRegionRecalculation | Inspect the completed run record. | CAP-CRM-REG-012 | The result identifies completion and the examined and changed counts. | test services-crm:modules/regions/tests/e2e/regions.e2e.spec.js#reads the recalculation |
| 5 | /console/{tenantId}/crm/contacts/{id} | Read the placements of an eligible New York member, an overridden member and a never-addressed member. | CAP-CRM-REG-011 | The eligible member moves, while the two exceptions retain their placements. | test |
| 6 | /console/{tenantId}/configuration/crm/regions?tab=rules | Return to the policy view after completion. | CAP-CRM-REG-010 | A successful run covering the current generation clears the need signal. | test react-console:e2e/dev/regions.dev.spec.ts#asks for a recalculation after a rule changes, and stops asking once it has run |
| Path | From step | Condition | Path taken | Outcome | Provenance |
|---|---|---|---|---|---|
| alternate | 3 | Another start is requested while processing remains active. | The request returns the existing running record. | The workspace retains one active run. | test |
| alternate | 3 | Policy changes before the run completes. | Later batches read the changed coverage. | Completion still leaves another recalculation needed. | test services-crm:modules/regions/tests/integration/services/region-assignment/region-assignment-rules.integration.spec.js#whether a recalculation is needed › a rule saved while a recalculation is under way › says one is still needed, because the run was recorded under the rules as they were before |
| failure | 3 | A batch cannot finish. | The run retains a redacted reason and resumes on later delivery. | It recovers or becomes failed on final unsuccessful delivery, permitting a new run. | test services-crm:modules/regions/tests/integration/services/region-assignment/region-recalculation-errors.integration.spec.js#the last delivery of a run’s event › fails the run, because nothing will deliver its event again |
| Id | Statement | Provenance |
|---|---|---|
01 | Eligible addressed records receive the updated policy’s result. | test services-crm:modules/regions/tests/integration/services/region-assignment/region-assignment.integration.spec.js#rule changes and the recalculation › moves a contact to its region under the new rules |
02 | Overrides and records without a past or present deciding address preserve placement. | test services-crm:modules/regions/tests/integration/services/region-assignment/region-assignment.integration.spec.js#rule changes and the recalculation › leaves a contact that overrides automatic assignment |
03 | Repeating the run without changed inputs does not alter placement. | test services-crm:modules/regions/tests/integration/services/region-assignment/region-assignment.integration.spec.js#rule changes and the recalculation › changes nothing on a second run under the same rules |
End-to-end policy: required: Starting, watching and completing background work involve console states that require browser coverage.