---
id: SCR-PFM-CSH-013
title: Applications overview
route: '/console/{tenantId}/configuration'
surface: console
product_area: platform
module: console-shell
revision: 1
status: draft
design_intent: confirmed
origin: >-
  services-platform:docs/proposals/application-access-and-entitlements.md#6.4
  Console integration, item 6 and #7.2 (built and accepted by Andrew 2026-10-15)
implementation_evidence: observed
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
purpose: >-
  The Configuration overview lets administrators inspect workspace application
  availability without changing it.
supports:
  - JNY-PFM-CSH-005
  - CAP-PFM-CSH-017
permission: configuration.applications.view (mapped to platform.tenant-applications.read)
entry_from:
  - Configuration (its home)
  - View Applications on the application-unavailable page
  - All Applications in the Configuration menu
exits_to:
  - An application's configuration (Open Configuration)
inference: []
displays:
  - field: Application rows sorted by availability and name
    source: listTenantApplicationsForTenant
  - field: Translated availability or licence-ending explanation
    source: listTenantApplicationsForTenant (reason code translated by the console)
  - field: Read-only ownership guidance
    source: Static copy
  - field: Calendar dates embedded in the explanation
    source: listTenantApplicationsForTenant; applicationAvailabilityReason
actions:
  - label: Open Configuration
    operation_id: 'none: console navigation'
    permission: >-
      none: link requires an available application and a known configuration
      destination
    confirm: false
  - label: Retry
    operation_id: listTenantApplicationsForTenant
    permission: platform.tenant-applications.read
    confirm: false
states:
  - initial loading
  - first read failed with retry
  - empty application list
  - populated application list
  - permission refused
validation:
  - BR-CAP-PFM-CSH-017-01
  - BR-CAP-PFM-CSH-017-02
  - BR-CAP-PFM-CSH-017-03
  - BR-CAP-PFM-CSH-017-04
  - BR-CAP-PFM-CSH-017-05
  - BR-CAP-PFM-CSH-017-06
  - BR-CAP-PFM-CSH-017-07
  - BR-CAP-PFM-CSH-017-08
  - BR-CAP-PFM-CSH-017-09
  - BR-CAP-PFM-CSH-017-11
  - BR-CAP-PFM-CSH-017-12
  - BR-CAP-PFM-CSH-017-13
  - BR-CAP-PFM-CSH-017-14
patterns:
  - PageLayout with Standard width
  - Configuration page header with read-only description
  - Design-system list rows with Badge
  - 'Loading, error-with-retry and empty states'
component: >-
  components/configuration/applications/{tenant-applications,applications-page}.tsx
evidence:
  - >-
    react-console at baf6dae:
    app/(console)/console/[tenantId]/configuration/page.tsx;
    components/configuration/applications/**; lib/applications/**.
  - >-
    services-platform at ad3f6a6:
    modules/tenants/aws/api/tenant-applications.routes.ts.
controls: [TC-AVL-001, TC-AVL-004, TC-AVL-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-AZ-006, TC-DAT-001, TC-DAT-003, TC-IAM-001, TC-IAM-002, TC-IAM-004, TC-IAM-005, TC-LOG-004, TC-LOG-005, TC-MON-001, TC-MON-002, TC-PI-001, 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-TEN-004, TC-VEN-001, TC-VEN-002, TC-VEN-003]
---
# Applications overview

## What the Screen Is For

The Configuration overview lets administrators inspect workspace application availability without changing it. The page makes Rhythm’s responsibility for changes explicit.

## What It Shows and Lets People Do

Rows sort available applications first, then by name. Badges report availability, and explanations translate licensing or operational reasons. Calendar dates appear within those explanations rather than as separate columns. Available entries with a known configuration destination offer Open Configuration without an additional link permission check.

## States and Errors

The wrapper guards the overview permission after mounting its data hook. Initial load failure offers retry, an empty list suggests contacting Rhythm, and a populated list suppresses later refresh errors while cached data exists. Missing or malformed availability is parsed as available unless explicitly false.

## Patterns It Must Respect

ApplicationsPage uses Standard PageLayout, PageHeader, Badge, LoadingIndicatorPanel, Alert and EmptyState. Its read-only rows omit commercial details, staff identities and overrides.