---
module: devices.device-groups
title: Device Groups
tab: Testing
order: 35
audience: dev
---

Frontend test checklist for **Device Groups** (`devices.bcos.dev` → **Device Groups**). Click through in the UI and mark each row Pass or Fail.

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

| Login | Role | Sees |
|-------|------|------|
| `bcos_a@bcos.dev` | Admin | All institutions · can create/edit/delete |
| `msp_a@msp1.bcos.dev` | MSP admin | C1 + C2 only · can create/edit/delete |
| `customer_a@customer1.bcos.dev` | Customer | C1 only · read-only |

Test devices are the simulators: **C1-ATM-001…**, **C1-TCR-001…** (and C2-/C3- for the other institutions).

## What to test

| # | Do this | ✅ Pass if |
|---|---------|-----------|
| 1 | As `msp_a`, open **Device Groups** | Table loads with columns **Name / Description / Institution / ATMs / Default / Actions** and a **+ New Group** button in the toolbar |
| 2 | Click **+ New Group**, type name `QA Test Group`, pick a **Color** swatch, in the ATMs picker highlight `C1-ATM-001` and click **›** to move it to **Assigned**, click **Create Group** | Panel slides in from the right; after save a green **"Group … created"** message shows and a new row appears with **ATMs = 1** and the color strip on its left |
| 3 | Click **+ New Group** again, and in the **Institution** dropdown pick `C1BD` | The **Assigned** panel auto-fills with all of C1's devices (no need to move them by hand) |
| 4 | On the `QA Test Group` row click **Edit**, change the **Description**, click **Save Changes** | Panel opens pre-filled with the group's current values; after save the row shows the new description |
| 5 | On that row click **Assign Devices**, move a different device into **Assigned**, click **Save Assignment** | The **ATMs** count updates to exactly the set now in **Assigned** — note this **replaces** membership, it does not add to it |
| 6 | On that row click **Assign Profile**, pick a hardware profile, click **Assign Profile** | A modal opens; after save it shows **"Profile … assigned to N devices — M CONFIG_UPDATE task(s) queued"** |
| 7 | Click **Set Default** on a group, then **✕ Clear** on it | Set Default turns into a **"Default"** badge + **Clear** button; Clear returns it to **Set Default** |
| 8 | On `QA Test Group` click **Delete** and confirm the popup | Popup warns **"ATMs will not be deleted"**; after confirm the row disappears and the devices still exist in the main device list |
| 9 | Log in as `customer_a` and open **Device Groups** | You see **only C1** groups and only C1 devices in any picker — **no C2 or C3** |
| 10 | Log in as `bcos_a`, then `msp_a`, and compare the group + device lists | `bcos_a` sees groups/devices for **all** institutions; `msp_a` sees **C1 and C2** but **not C3** |

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