# Browse User List

## User Story

As a user with the appropriate role, I want to browse a list of all users, so that I can find and manage user accounts.

## Story Diagram

```mermaid
flowchart TD
    A[Open User List] --> B[View paginated user list]
    B --> C{Filter or search?}
    C -- Yes --> D[Apply name/email/status filter]
    D --> B
    C -- No --> E[Select a user to view detail]
```

## Scenario Patterns

- View the full list of users with name, email, role, and status columns
- Filter users by status (ACTIVE / INACTIVE)
- Search users by name or email
- Empty list when no users match the filter criteria

## Test Cases

- Open the user list page; verify all users are displayed with name, email, role, and status
- Filter by INACTIVE status; verify only inactive users are shown
- Search by a partial name; verify matching users are displayed
- Apply a filter that matches no users; verify an empty state message is shown

## Screens

- [user-list](../../../screen/user-list.md)

## Resolvers

- None
