--- id: CAP-PFM-CSH-004 title: Begin work from the workspace home feature: FEAT-PFM-CSH-01 product_area: platform module: console-shell revision: 2 status: draft product_intent: proposed implementation_evidence: partially-observed supersedes: [] source_sha: react-console: baf6dae382d6f41dce976c7f848667ccc37e076f services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1 intent_sources: [] purpose: The workspace home gives staff a starting point for reviewing work that needs attention. outcomes: - Customer staff enter a suitable workspace home. - Attention work remains independent of dashboard readiness. concepts: - CON-PFM-CSH-001 actors: - ACT-PFM-001 - ACT-PFM-002 surfaces: - console preconditions: [] postconditions: [] permissions: - key: console.access where_checked: console scope: tenant rules: - id: BR-CAP-PFM-CSH-004-01 statement: >- The workspace root renders the greeting, any responsibility-covering banner, attention items and then the dashboard content. kind: policy enforced_at: - console must_prove: false provenance: observed source: 'react-console:app/(console)/console/[tenantId]/page.tsx:HomePage' origin: none - id: BR-CAP-PFM-CSH-004-02 statement: Home mounts its attention block independently of the dashboard’s loading gate. kind: invariant enforced_at: - console must_prove: true provenance: observed source: 'react-console:app/(console)/console/[tenantId]/page.tsx:HomePage' origin: none - id: BR-CAP-PFM-CSH-004-03 statement: >- Dashboard figures are supplied by mock-mode data; the live home receives no dashboard summary and presents the dashboard-unavailable explanation. kind: policy enforced_at: - console must_prove: false provenance: observed source: >- react-console:lib/api/dashboard.ts:useDashboardSummary; components/console/home/dashboard-state.tsx:DashboardErrorAlert origin: none note: The linked finding records the evidence limitation or implementation gap. - id: BR-CAP-PFM-CSH-004-04 statement: >- Customer console users opening the bare address enter a remembered reachable workspace or their default workspace, while staff landing there enter Rhythm HQ. kind: lifecycle enforced_at: - console must_prove: true provenance: test source: >- react-console:e2e/mock/url-architecture.mock.spec.ts#the bare root opens the remembered tenant's home origin: >- react-console:docs/url-architecture.md#4.3 Not tenant pages (decided by Andrew 2026-10-14; final acceptance 2026-10-15) - id: BR-CAP-PFM-CSH-004-05 statement: >- The header logo targets the current workspace home within a workspace and the bare console address from Rhythm HQ. kind: policy enforced_at: - console must_prove: false provenance: observed source: 'react-console:components/console/site-header.tsx:SiteHeader' origin: none - id: BR-CAP-PFM-CSH-004-06 statement: >- The live dashboard hook disables its summary request and returns an unavailable result, while mock mode reads the summary. kind: policy enforced_at: - console must_prove: true provenance: observed source: 'react-console:lib/api/dashboard.ts:useDashboardSummary' origin: none - id: BR-CAP-PFM-CSH-004-07 statement: >- The dashboard distinguishes an absent service, a real failure and missing API configuration with separate explanations. kind: validation enforced_at: - console must_prove: true provenance: test source: >- react-console:components/console/home/__tests__/dashboard-state.test.tsx#shows a calm note when the dashboard does not exist on the backend; components/console/home/__tests__/dashboard-state.test.tsx#keeps the error state for a real failure; components/console/home/__tests__/dashboard-state.test.tsx#keeps the not-configured state origin: none - id: BR-CAP-PFM-CSH-004-08 statement: >- Mock figures format amounts by their kind, treat falling dues as positive, round regional shares and event fill to whole percentages, and scale regional progress by three without guarding zero totals. kind: calculation enforced_at: - console must_prove: true provenance: observed source: >- react-console:components/console/home/kpi-cards.tsx:KpiCards; components/console/home/dashboard-panels.tsx:RegionBreakdown, EventsPanel origin: none scenarios: - id: SC-CAP-PFM-CSH-004-01 given: The last selected customer workspace is the sandbox. when: The person enters through the bare console address. then: The landing destination is the sandbox home. provenance: test source: >- react-console:e2e/mock/url-architecture.mock.spec.ts#the bare root opens the remembered tenant's home edge_cases: [] constraints: [] depends_on: [] related: - CAP-PFM-CSH-012 - CAP-PFM-CSH-013 journeys: - JNY-PFM-CSH-001 open_questions: [] evidence: - >- react-console at baf6dae: app/(console)/console/[tenantId]/page.tsx, app/(console)/page.tsx, components/console/legacy-redirect.tsx, components/console/site-header.tsx, e2e/mock/url-architecture.mock.spec.ts. - >- react-console:lib/api/dashboard.ts; components/console/home/{dashboard-state,kpi-cards,dashboard-panels,growth-chart}.tsx; components/console/home/__tests__/dashboard-state.test.tsx. controls: [TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-AZ-005, TC-DAT-001, TC-DAT-003, TC-IAM-003, TC-LOG-001, TC-LOG-005, TC-MON-002, TC-PI-001, TC-PI-005, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-VEN-001, TC-VEN-002, TC-VEN-003] --- # Begin work from the workspace home ## Purpose The workspace home gives staff a starting point for reviewing work that needs attention. ## How It Works A customer user reaches the workspace home through a starting address or a home destination. The home combines a greeting with work supplied by the attention module. Attention is mounted independently of dashboard readiness. Mock mode supplies illustrative figures, while the live dashboard hook suppresses the unavailable summary request and provides an explanatory result. Error presentation distinguishes a missing dashboard service from a failed request or missing setup. The product should agree a live dashboard purpose and data source before connecting customer figures. ## Relationships - Eligibility and attention supply covering information and attention items. - Workspace entry and staff landing determine the starting destination.