---
module: devices.map
title: Map
tab: Testing
order: 35
audience: dev
---

Frontend test checklist for the **Fleet Map** (`devices.bcos.dev` → **Map**). It's a read-only view — no create/edit/delete. 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 (C1 + C2 + C3) |
| `msp_a@msp1.bcos.dev` | MSP admin | C1 + C2 only |
| `customer_a@customer1.bcos.dev` | Customer | C1 only · read-only |

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

## What to test

| # | Do this | ✅ Pass if |
|---|---------|-----------|
| 1 | As `bcos_a`, open **Map** | Map loads with coloured pins, a legend (Online / Offline / Out of Cash / Supervisor), and a count like **"N of M ATMs shown"** |
| 2 | Set **Status** → **Online** | Map shows only green pins and the count drops; a **Filters:** tag bar appears with an **Online** tag |
| 3 | Open the **Group** dropdown and pick a group | Map narrows to that group's ATMs and the count updates; a **Group** tag shows in the Filters bar |
| 4 | Click **Clear all** in the Filters bar | All tags disappear and every pin returns (count back to the full total) |
| 5 | Set a filter, click **💾 Save preset**, name it, **Save** — then Clear all and click the preset chip under **Saved:** | Clicking the chip re-applies exactly those filters; its **×** deletes the chip |
| 6 | Click a pin, then in its popup click the blue **ATM ID** | Popup lists ATM ID, location, address, status and agent connection; clicking the ID opens that ATM's detail |
| 7 | Find a pin with a **count badge** (number) and open it | Popup header reads **"N ATMs at this location"** and lists each ATM stacked |
| 8 | Toggle **Auto-refresh** off, then on | Off = countdown timer stops; On = a live "(Ns)" countdown resumes next to the toggle |
| 9 | Log in as `customer_a`, open **Map** | You see **only C1** pins — no C2 or C3 ATMs anywhere on the map |
| 10 | As `msp_a`, open **Map** | You see **C1 and C2** pins but **not C3** |

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