---
id: JNY-CRM-REG-004
title: An administrator retires and removes a referenced region
feature: FEAT-CRM-REG-01
product_area: crm
module: regions
revision: 2
status: draft
product_intent: proposed
implementation_evidence: inconsistent
supersedes:
  - CRM-ACC-0361
source_sha:
  services-crm: a8d1364f1dd44b723bb5f9acba12f983e9ec8d69
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
actor: ACT-CRM-003
goal: Retire a chapter’s grouping and remove it only after clearing dependencies.
capabilities:
  - CAP-CRM-REG-002
  - CAP-CRM-REG-010
  - CAP-CRM-REG-006
  - CAP-CRM-REG-005
  - CAP-CRM-REG-011
screens:
  - '/console/{tenantId}/configuration/crm/regions'
  - '/console/{tenantId}/configuration/crm/regions?tab=rules'
  - '/console/{tenantId}/configuration/crm/regions/assignmentRules'
steps:
  - 'n': 1
    surface: '/console/{tenantId}/configuration/crm/regions'
    action: 'Open North’s drawer, disable Active and save.'
    capability: CAP-CRM-REG-002
    expected: The catalogue labels North inactive while current references remain.
    provenance: test
    source: 'react-console:acceptance/crm/playwright/journeys/configuration/CRM-ACC-0361.spec.ts#CRM-ACC-0361'
  - 'n': 2
    surface: '/console/{tenantId}/configuration/crm/regions?tab=rules'
    action: Visit the saved policy tab.
    capability: CAP-CRM-REG-010
    expected: Recalculation is requested and analysis warns of the inactive target.
    provenance: observed
    source: >-
      react-console:acceptance/crm/playwright/journeys/configuration/CRM-ACC-0361.spec.ts#CRM-ACC-0361;
      react-console:lib/configuration/regions-analysis.ts:analyzeRules
  - 'n': 3
    surface: '/console/{tenantId}/crm/contacts/new'
    action: Create a New York member covered by North’s rule.
    capability: CAP-CRM-REG-006
    expected: The enabled rule still assigns inactive North.
    provenance: test
    source: 'react-console:acceptance/crm/playwright/journeys/configuration/CRM-ACC-0361.spec.ts#CRM-ACC-0361'
  - 'n': 4
    surface: '/console/{tenantId}/configuration/crm/regions'
    action: Attempt to remove North.
    capability: CAP-CRM-REG-002
    expected: Deletion is refused because dependencies remain.
    provenance: test
    source: 'react-console:acceptance/crm/playwright/journeys/configuration/CRM-ACC-0361.spec.ts#CRM-ACC-0361'
  - 'n': 5
    surface: '/console/{tenantId}/configuration/crm/regions/assignmentRules; patchContact'
    action: 'Remove North’s rule and save, then clear contact references while enabling their overrides.'
    capability: CAP-CRM-REG-009
    expected: No remaining rule or contact in the test references North.
    provenance: test
    source: 'react-console:acceptance/crm/playwright/journeys/configuration/CRM-ACC-0361.spec.ts#CRM-ACC-0361'
  - 'n': 6
    surface: '/console/{tenantId}/configuration/crm/regions'
    action: Delete the now unused North entry.
    capability: CAP-CRM-REG-002
    expected: The catalogue no longer contains North.
    provenance: test
    source: 'react-console:acceptance/crm/playwright/journeys/configuration/CRM-ACC-0361.spec.ts#CRM-ACC-0361'
alternates: []
failures:
  - from_step: 4
    condition: The visitor lacks deletion authority.
    path: The row menu withholds usable Delete.
    outcome: The regional definition remains.
    provenance: test
    source: >-
      react-console:components/regions/__tests__/regions-row-menu.test.tsx#the Regions row menu › does not let
      somebody who may manage regions but not delete them press Delete
rules_in_play:
  - BR-CAP-CRM-REG-002-01
  - BR-CAP-CRM-REG-002-06
  - BR-CAP-CRM-REG-002-07
  - BR-CAP-CRM-REG-002-08
  - BR-CAP-CRM-REG-002-03
  - BR-CAP-CRM-REG-010-03
assertions:
  - id: AS-JNY-CRM-REG-004-01
    statement: A remaining reference prevents region removal.
    provenance: test
    source: >-
      services-crm:modules/regions/tests/integration/db/regions.table.integration.spec.js#references › refuses
      to delete a region a contact is in, naming what uses it
  - id: AS-JNY-CRM-REG-004-02
    statement: Retirement preserves the existing record and policy references.
    provenance: test
    source: 'react-console:acceptance/crm/playwright/journeys/configuration/CRM-ACC-0361.spec.ts#CRM-ACC-0361'
e2e_policy: optional
e2e_reason: >-
  Service evidence covers reference refusals; browser checks add retirement display while inactive-target
  policy remains unresolved.
---

# An administrator retires and removes a referenced region

## Story

An administrator retires North while its rule and members still reference it. The view marks it inactive and requests recalculation, yet its enabled rule continues receiving new members. Deletion remains blocked until the administrator removes the rule and clears the remaining record references. The unused regional definition can then be removed.