US: Compare role permissions

[MaferMazu]

As a Library Member, I want to compare the permissions of each role side by side, so that I can choose the right role for each person.

Figma: https://www.figma.com/design/q3Knq0BKoVTBbtaxb81n9R/RBAC---Console---Wireframes?node-id=2750-9659&t=71PeX22gyABqxnHu-4

Acceptance criteria

• Placement
  Integrated as a tab named Permissions in the Library Team Management view, alongside Team Members and Roles.

• Access
  Any user with a role in the library can view this tab.
  Non members cannot access this panel.

• Header context
  Shows library name and library ID in the header.

• Content
  Matrix table for comparison.
  Rows are permissions grouped by category, for example, Library, Content, Team, Collections.
  Columns are role names.
  Cells show whether the role includes the permission using symbols, ✓ for included, ✕ for not included.
  Category headers have a tooltip with a short description. Descriptions are WIP.

• States
  Loading uses skeleton rows or blocks.
  Error shows a message with a Retry action.

Notes, out of scope for this card

• Sorting and filters are separate stories.

• There is an API GET endpoint to retrieve all roles and their permissions for the current scope.

• API and error views are defined in a separate card. 401 and 403 use the same auth error view. 404 and general server errors use a not found or generic error view with a Retry.

[gviedma-aulasneo]

@MaferMazu

Test Cases

Setup

• I am a member of the target library.
• The library has multiple roles with defined permissions.
• Start on Libraries → Library Team Management → Permissions tab.

Scenarios

• 1) Header shows library context
  Given: I am a member of the library
  When: I open the Permissions tab
  Then: I see the library name and library ID in the header

• 2) Matrix renders with categories as rows and roles as columns
  Given: I am on the Permissions tab
  When: the comparison view loads
  Then: I see a matrix where rows are permissions grouped by Library, Content, Team, Collections, and columns are role names

• 3) Cells indicate inclusion with symbols, aligned to the roles catalog
  Given: the matrix is visible
  When: I inspect any cell for a permission and a role
  Then: I see a ✓ if the role includes the permission, and a ✕ if it does not
  And: when I compare that role’s expected permissions to the catalog here, https://openedx.atlassian.net/wiki/spaces/OEPM/pages/4840095745/Library+Roles+and+Permissions
  Then: the matrix symbols match the catalog for that role

• 4) Category headers have tooltips with short descriptions
  Given: the matrix is visible
  When: I hover a category header, for example Content
  Then: I see a tooltip with a short description
  And: when I move the cursor away
  Then: the tooltip disappears

• 5) Loading state shows skeleton rows or blocks, then data
  Given: I open the Permissions tab
  When: data is still loading
  Then: I see skeleton rows or blocks in place of the matrix
  And: when loading completes
  Then: the skeletons are replaced by the populated matrix

[dcoa]

this one is approved for development

[dcoa]

Evidence

2025-10-14.22-49-10.mp4

@gviedma-aulasneo @jmakowski1123

I recordered the video with the wrong backend branch so the policy was not updated, but I left a screen shot with the new version, so you can validate