Skip to content

CAP-PFM-CSH-007Visit settings and return to the preceding work

Markdown

CAP-PFM-CSH-007

Visit settings and return to the preceding work

Markdown
  • DocumentDraft
  • Product intentProposed
  • ImplementationObserved

KindCapabilityProduct areaPlatformModuleConsole Shell and NavigationRevision2

Read atreact-console baf6dae3services-platform ad3f6a65

The Formal Contract

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

Outcomes
Administrative areas have focused navigation.Staff have a direct route back to their preceding work.
Surfaces
console
Intent sources
react-console:docs/url-architecture.md#3. Workspaces (decided by Andrew 2026-10-14; final acceptance 2026-10-15)

Controls

25 controls apply, from the corpus control catalogue.

TC-AVL-001 TC-AVL-004 TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-DAT-001 TC-DAT-003 TC-IAM-001 TC-IAM-006 TC-LOG-004 TC-LOG-005 TC-MON-001 TC-MON-003 TC-PI-002 TC-PI-004 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
configuration.accessconsoletenant
maintenance.accessconsoletenant
security.accessconsoletenant
data.jobs.viewconsoletenant
configuration.responsibilities.viewconsoletenant
platform.notifications.manageconsoletenant
platform.application.accessapitenant

Business Rules

10 rules, 5 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
01
Proposed
The registered settings areas are Configuration, Maintenance, Data Management, Security, Responsibilities and Notifications, each with its own root and revealing permission.
policyconsoleobserved
02must prove
Proposed
In workspace mode an area appears in the user menu only when its permission passes and at least one destination in its navigation is visible.
permissionconsoletest
react-console:lib/console/__tests__/settings-area-menu.test.ts#does not offer Security or Maintenance to a person who holds only the areas' access keys
03must prove
Proposed
A settings address replaces main navigation with that area’s menu and Back to app targets the last non-settings path, or home after direct entry.
lifecycleconsoleobserved
react-console:components/console/app-sidebar.tsx:AppSidebar, SettingsNavigation
04must prove
Proposed
The recorded root destinations are Users for Security, Scheduled Jobs for Maintenance and Data Imports for Data Management.
origin: react-console:docs/url-architecture.md#4.1 Tenant console (decided by Andrew 2026-10-14; final acceptance 2026-10-15)
lifecycleconsoledocumented
05
Proposed
Configuration groups Data, Presentation, Workflows, Accounting, Billing and Connections before application settings, with All Applications first among its application links when permitted.
policyconsoleobserved
06must prove
Proposed
Maintenance contains Scheduled Jobs, while duplicate rules and integrations belong in Configuration and their old Maintenance paths preserve views and queries on redirect.
origin: react-console:docs/url-architecture.md#3. Workspaces (Andrew, 2026-10-16: Maintenance holds Scheduled Jobs alone) (decided by Andrew 2026-10-14; final acceptance 2026-10-15)
policyconsoledocumented
07
Proposed
Security lists Users, Roles, Policies and Rhythm Access, each with a separate entry permission.
policyconsoleobserved
08
Proposed
Data Management’s revealing key maps to bulk-record authority rather than application availability.
permissionconsoleobserved
09
Proposed
Each settings area provides its own filter using the same matching behavior as main navigation.
policyconsoleobserved
10must prove
Proposed
Orders & Inventory configuration registers Stores with its own view key and omits Price Schedules from both the configuration-area catalogue and menu.
permissionconsoletest
react-console:lib/console/__tests__/orders-nav.test.ts#lists Stores with its own view permission; lib/console/__tests__/orders-nav.test.ts#does not list Price Schedules: a schedule belongs to the event that sells the product (ruling R5, 2026-10-22)

Scenarios

IdGivenWhenThenProvenance
01A contact page is the administrator’s current work.They enter Configuration and later use Back to app.The contact path is restored.observed
02The person holds Security’s area key but no visible Security entry key.The account menu is generated.Security is not offered.observed

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.