---
module: msp.users
title: Users
tab: Testing
order: 35
audience: dev
---

Frontend test checklist for the **Users** screen (`msp.bcos.dev`). Click through in the UI and mark each row Pass or Fail.

## Set up
Log in at **msp.bcos.dev** — test accounts (all password `Passw0rd-d3v!`):

| Login | Role | Sees |
|-------|------|------|
| `bcos_a@bcos.dev` | Admin | All institutions (C1 + C2 + C3) |
| `msp_a@msp1.bcos.dev` | MSP admin | C1 + C2 only |
| `customer_a@customer1.bcos.dev` | Customer | C1 only · not an admin |

Users are grouped under institutions **C1BD / C2BD / C3BD**. Sample people live under each (e.g. the `customer_a` / `msp_a` accounts show up in the C1 group).

## What to test

| # | Do this | ✅ Pass if |
|---|---------|-----------|
| 1 | As `msp_a`, open **Users** | Page loads with users grouped under institution headers **C1** and **C2** — each group **collapsed** by default |
| 2 | Click an institution header (e.g. **C1**) | Group expands to a table with **Name · Email · Role · Status · Last Login** columns; click again to collapse |
| 3 | Open **Filters** (◀/▶ bar on the left), type a name/email in **Search** | List narrows to matching users; the count pill updates; **Clear all** resets it |
| 4 | In **Filters**, set **Role → MSP Admin** | Only MSP Admin users remain; a filter chip appears above the table; removing it restores the full list |
| 5 | Click **Edit** on a user, change **Role** and toggle **Fleet Task Approver**, click **Save Changes** | Slide-in panel closes, a green **User updated** toast shows, and the row reflects the new role. **Email field is read-only** in the panel |
| 6 | Click **Reset PW** on a user → **Send Reset Email** | Modal closes with a **Password reset — a reset email has been sent** toast (no password is shown on screen) |
| 7 | Click **Disable** on a user → confirm in the modal | Status badge flips to **Disabled**; the button now reads **Enable** and clicking it flips it back to **Active** |
| 8 | Find your own row (`msp_a`) | There is **no Disable/Enable button** on your own account (only Edit / Reset PW) |
| 9 | Log in as `bcos_a`, open **Users** | You see **all three** institution groups including **C3** — more than `msp_a` sees |
| 10 | Log in as `customer_a` | The Users admin screen is **not available** — either it isn't in the menu or it loads with **no users to manage** (no Edit/Reset/Disable actions), never a crash |

**Report a fail with:** the row #, which login you used, and what you actually saw.
