Admin View Home Dashboard

1. What does this feature do? (High-Level Overview)

The Admin View Home Dashboard gives authorized admin users a central place to manage testing workspaces. From this page, users can review workspace capacity, create new demo workspaces, open workspace details, export workspace information, and delete workspaces when permitted.

2. Who is this for? (Roles & Permissions)

• Superadmin / Admin users in Admin View: Can use the Home page as the entry point for workspace management when their role includes the required permissions.
• Users with view_workspaces: Can see the Testing Workspaces table.
• Users with create_workspace: Can open the create workspace dialog.
• Users with show_workspace: Can open workspace details.
• Users with export_workspaces: Can export a workspace summary to PDF.
• Users with delete_workspaces: Can delete a workspace after confirmation.

3. Business Rules & Enforcements

• Rule 1: The route /dashboard/home loads this Admin View dashboard only when Admin View mode is active.
• Rule 2: The same root Home route loads the location Home dashboard when Admin View mode is not active.
• Rule 3: The Testing Workspaces table is displayed only for users with view_workspaces.
• Rule 4: Workspace row actions are permission-based. The system only shows Details, Delete, and Export to PDF when the user has the matching permission.
• Rule 5: New workspace creation requires a name and positive counts for RBTs, BCBAs, Managers, and Clients. The workspace name must be unique across workspaces and location titles and must not exceed 150 characters.
• Rule 6: Workspace deletion requires confirmation. After a successful deletion, the list reloads so the removed workspace no longer appears.
• Rule 7: Workspace detail routes remain available under /dashboard/home/workspace/:id so admin users can open shared workspace detail pages from Admin View.

4. UI Placement

1. Admin View > Home: Opens the Admin View Home Dashboard.
2. Route: /dashboard/home while Admin View mode is active.
3. Breadcrumb: Home > Admin View.
4. Main section: Testing Workspaces, which displays workspace Name, RBTs, BCBAs, Managers, and Clients.
5. Workspace actions: Create, Details, Delete, and Export to PDF, based on the user’s permissions.

5. How-To Guide (Step-by-Step)

Scenario A: Review testing workspaces

1. Enter Admin View.
2. Open Home from the main sidebar.
3. Review the Testing Workspaces table.
4. Compare each workspace by name and the configured number of RBTs, BCBAs, Managers, and Clients.

Scenario B: Create a new testing workspace

1. Enter Admin View and open Home.
2. Click the create button in the Testing Workspaces section.
3. Enter the workspace name.
4. Enter the number of RBTs, BCBAs, Managers, and Clients to create.
5. Click Save.
6. Wait for the success message and confirm the new workspace appears in the table.

Scenario C: Open, export, or delete a workspace

1. Enter Admin View and open Home.
2. Find the workspace in the Testing Workspaces table.
3. Use Details to open the workspace summary and generated credentials.
4. Use Export to PDF to download the workspace summary when needed.
5. Use Delete only when the workspace should be removed, then confirm the deletion in the dialog.

6. What happens if…? (Edge Cases / FAQ)

• Q: What happens if the user does not have view_workspaces?
  • A: The Testing Workspaces section is not displayed.
• Q: What happens if the user can view workspaces but cannot create, delete, export, or view details?
  • A: The table remains visible, but those specific action buttons are hidden.
• Q: What happens if a workspace creation or deletion request fails?
  • A: The page shows an error message from the system and leaves the current workspace list available for review.