UC‑PROG‑01 — View Program Detail

Use Case ID: UC‑PROG‑01
Use Case Name: View Program Detail
Module: Exercise Programs

Purpose

To define how the user views the full details of an Exercise Program, including metadata, weekly structure, day previews, and exercise summaries. This use case covers loading program data, rendering the detail page, and ensuring accessibility and performance requirements are met.
This UC is strictly display‑only — no editing, logging, or execution occurs here.

Primary Actor

Stakeholders & Interests

Stakeholder	Interest
User	Wants quick, predictable access to the Dashboard from anywhere in the app.
System	Must route the user correctly and close the menu.
Product Owner	Wants intuitive navigation and consistent behavior.
UX/UI Team	Requires smooth transitions and accessibility compliance.
Security Team	Ensures only authenticated users can access the Dashboard.

Preconditions

• User is authenticated.
• Program list has been loaded (UC‑EP‑01 ViewPrograms).
• User has selected a specific program (UC‑EP‑02 ViewProgramDetail).
• Program exists in the system.

Postconditions

Success

• Program detail page is displayed.
• Program metadata, weekly structure, and day previews are visible.
• User can navigate between weeks and days.
• User may choose to activate the program (handled in UC‑EP‑05 ActivateProgram).

Failure

• Program detail page does not load.
• System may display an error message.

Trigger

User selects a program from the Exercise Program List.

Main Success Scenario (Basic Flow — View Program Detail)

1. User selects a program from the program list. (BR‑PROG‑01)
2. System receives the request to load program details. (FS‑PROG‑DETAIL‑01)
3. System retrieves the program metadata, including:
   • Program name
   • Duration (weeks)
   • Difficulty level
   • Description
   • Target goals
   (BR‑PROG‑02 → BR‑PROG‑06)
4. System retrieves the weekly structure and day‑level summaries. (BR‑PROG‑07 → BR‑PROG‑12)
5. System retrieves exercise summaries for each day. (BR‑PROG‑13 → BR‑PROG‑18)
6. System renders the Program Detail page, including:
   • Metadata header
   • Week selector
   • Day preview cards
   • Exercise summaries
   (UIS‑PROG‑01)
7. System sets focus to the top of the Program Detail screen for accessibility. (SRS‑A11Y‑01)
8. User views the Program Detail page.

Alternate Flows

A1 — User Navigates Between Weeks

• User selects a different week from the week selector.
• System loads the corresponding day previews.
• System updates the UI without reloading the entire page. (BR‑PROG‑11)

A2 — User Expands a Day Preview

• User taps a day card.
• System expands the card to show exercise summaries. (BR‑PROG‑13)

A3 — Program Has Variable Length

• Some programs may have fewer or more weeks.
• System dynamically renders the correct number of weeks. (BR‑PROG‑07)

Exception Flows

E1 — Program Not Found

• Program ID does not exist or was removed.
• System displays: “This program is no longer available.”
• System logs the event.

E2 — Data Load Failure

• System cannot retrieve program details.
• System displays: “Unable to load program details. Please try again.”
• System logs the failure.

E3 — Unauthorized Access

• User attempts to view a restricted program.
• System blocks access and logs a security event. (BR‑PROG‑20)

Non‑Functional Requirements

• Performance: Program detail must load within 500ms.
• Accessibility: All sections must support screen readers and keyboard navigation.
• Responsiveness: Layout must adapt to mobile, tablet, and desktop.
• Security: Only authorized users may view program details.
• Scalability: Must support programs with large numbers of exercises.
• Consistency: UI must match the Exercise Program module’s visual patterns.

Related UI Screens

• UIS‑PROG‑01 — Program Detail Page
• UIS‑PROG‑02 — Week Selector
• UIS‑PROG‑03 — Day Preview Cards
• UIS‑GLOBAL‑HEADER‑01
• UIS‑GLOBAL‑FOOTER‑01

Flowchart (Top‑Down)

A[User Selects Program] --> B[Load Program Metadata]
B --> C[Load Weekly Structure]
C --> D[Load Day & Exercise Summaries]
D --> E[Render Program Detail Page]
E --> F[Set Accessibility Focus]
F --> END[Program Detail Displayed]