Rhythm 2.0 Specifications

Appearance

CAP-PFM-CSH-012Resolve older console links during the address transition

Markdown

CAP-PFM-CSH-012

Resolve older console links during the address transition

Markdown
  • DocumentDraft
  • Product intentProposed
  • ImplementationObserved

Planning

Feature
FEAT-PFM-CSH-03
Key concepts
CON-PFM-CSH-003
Actors
ACT-PFM-001, ACT-PFM-002, ACT-PFM-004, ACT-PFM-005
Related
CAP-PFM-CSH-009, CAP-PFM-CSH-013
Open questions
OQ-PFM-CSH-001
Proved by
ATS-PFM-CSH-012
Exercised by
JNY-PFM-CSH-003

KindCapabilityProduct areaPlatformModuleConsole Shell and NavigationRevision2

Read atreact-console baf6dae3services-platform ad3f6a65

Resolve older console links during the address transition ​

Purpose ​

Temporary legacy entry lets staff continue using bookmarks created before workspace addresses.

How It Works ​

A person arrives at a link created before workspace routing. The browser-side legacy entry consults a temporary mapping. A recognized destination is rebound to the selected context. An unknown path stays not found instead of inventing a destination. Staff landing and remembered access affect which context can be reopened. The product should record a dated retirement decision for the compatibility mechanism.

Relationships ​

  • Console address builders construct the mapped destination.
  • Security’s remembered workspace and staff landing determine the usable context.

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Outcomes
Recognized older links map to current console destinations.Unrecognized older paths remain visibly unavailable.
Surfaces
console
Intent sources
react-console:docs/url-architecture.md#7. Compatibility redirects (decided by Andrew 2026-10-14; final acceptance 2026-10-15)

Controls

21 controls apply, from the corpus control catalogue.

TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-AZ-005 TC-DAT-001 TC-DAT-002 TC-DAT-003 TC-DAT-004 TC-IAM-003 TC-LOG-001 TC-PI-001 TC-PI-005 TC-PRV-001 TC-PRV-002 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-VEN-001 TC-VEN-002 TC-VEN-003

Permissions

KeyChecked atScope
platform.security-self.readapitenant

Business Rules

7 rules, 4 to be proved before approval. A rule's product intent is derived from its origin: 0 confirmed by a product decision, the rest inheriting this capability's proposed.

IdRuleKindEnforced atProvenance
01must prove
Proposed
A recognized older address redirects under the remembered or default workspace while retaining its record values and query.
origin: react-console:docs/url-architecture.md#7. Compatibility redirects (decided by Andrew 2026-10-14; final acceptance 2026-10-15)
no proof recorded yet
lifecycleconsoletest
react-console:e2e/mock/url-architecture.mock.spec.ts#an old tenant-less URL lands on its canonical URL, id and query kept
02
Proposed
Workspace-relative canonical paths are rebound to the selected workspace, and recognized planned-area legacy words are converted to camelCase.
origin: react-console:docs/url-architecture.md#11. Decisions made during the build, item 13 (decided by Andrew 2026-10-14; final acceptance 2026-10-15)
lifecycleconsoleobserved
react-console:lib/routes/legacy.ts:legacyTenantPath
03must prove
Proposed
An unmapped legacy path displays the page-not-found message.
origin: react-console:docs/url-architecture.md#7. Compatibility redirects (decided by Andrew 2026-10-14; final acceptance 2026-10-15)
no proof recorded yet
validationconsoleobserved
react-console:components/console/legacy-redirect.tsx:LegacyRedirect
04must prove
Proposed
A staff user with no selected workspace and a recognized legacy destination is redirected to HQ.
origin: react-console:docs/url-architecture.md#7. Compatibility redirects (decided by Andrew 2026-10-14; final acceptance 2026-10-15)
no proof recorded yet
policyconsoleobserved
react-console:components/console/legacy-redirect.tsx:LegacyRedirect
05
Proposed
Legacy authentication, custom-query-table and design-preview paths use permanent camelCase redirects that retain queries.
origin: react-console:docs/url-architecture.md#4.3 Not tenant pages (decided by Andrew 2026-10-14; final acceptance 2026-10-15)
lifecycleconsoleobserved
react-console:next.config.mjs:redirects
06
Proposed
The compatibility table’s documented retirement condition is Andrew’s confirmation that older links are no longer held.
origin: react-console:docs/url-architecture.md#7. Compatibility redirects (decided by Andrew 2026-10-14; final acceptance 2026-10-15)
lifecycleconsoledocumented
react-console:docs/url-architecture.md#7. Compatibility redirects
07must prove
Proposed
A still-cleared staff user’s older bookmark can reopen the remembered workspace after an HQ landing.
origin: react-console:docs/url-architecture.md#11. Decisions made during the build, item 24 (Andrew, 2026-10-15) (decided by Andrew 2026-10-14; final acceptance 2026-10-15)
no proof recorded yet
lifecycleconsoletest
react-console:e2e/mock/url-architecture.mock.spec.ts#a staff member's old tenant-less bookmark opens their remembered tenant after landing in Rhythm HQ

Scenarios

IdGivenWhenThenProvenance
01An older contact bookmark includes a tab query.The person follows it with a usable workspace context.The canonical contact address retains the identifier and query.test
react-console:e2e/mock/url-architecture.mock.spec.ts#an old tenant-less URL lands on its canonical URL, id and query kept
02A cleared staff user previously entered a workspace and then landed in HQ.They open an older workspace-relative bookmark.The bookmark reopens the remembered workspace while the grant remains valid.observed
react-console:lib/security-context/boot.ts:bootSecurityContext; components/console/legacy-redirect.tsx:LegacyRedirect

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.

Rhythm Software