iDARMS Frontend (Back Office) — GIS Mapping Module Acceptance Tests¶
Test series: IDA-GIS-01 to IDA-GIS-04
Objective: Validate that property locations render on the map, that region/district and zone-type filters work, and that property details are shown on selection.
Execution ownership¶
Recommended owners: System Super-Admin; Property/GIS business owner
Prerequisites: A signed-in administrator, properties with valid coordinates, and a working Google Maps API key in the UAT environment.
Execution control
Use approved UAT data only. Mask personal, authentication, and payment information in screenshots and attachments.
Feature overview¶
The GIS Mapping module at /gismapping:
- Renders a Google Map with one marker per property, coloured by zone type.
- Filters by Region and District and by up to eight Zone Type checkboxes.
- Shows a property InfoWindow with identity, zone, land size, and coordinates.
- Shows a loading spinner and an empty state.
Coverage summary¶
| Test ID | Feature | Scenario | Priority |
|---|---|---|---|
| IDA-GIS-01 | GIS Mapping | Access and map load | Critical |
| IDA-GIS-02 | Filters | Region and district | High |
| IDA-GIS-03 | Filters | Zone type toggles | High |
| IDA-GIS-04 | Markers | InfoWindow and empty state | High |
Implementation observations requiring UAT confirmation¶
| Observation from implementation | Required validation |
|---|---|
The map loads properties from /property/gismapping keyed by region and district. |
Confirm the approved data source and caching. |
| Zone types use fixed colours and Google Maps dot icons (Residential→green, Commercial→blue, Educational→yellow, Light Industrial→orange, Heavy Industrial→red, Civic & Cultural→purple, Mixed Use→pink, Special Use→light blue). | Confirm the approved legend. |
A property with an invalid "lat, lng" coordinate is skipped and logged; the header shows "{n} of {m} properties shown" based on the zone-type selection. |
Confirm the approved handling of invalid coordinates. |
| The map key and default center (Accra, Ghana) are hardcoded in the config. | Confirm the approved map configuration. |
IDA-GIS-01 — Access and map load¶
Feature overview¶
The GIS Mapping page renders a Google Map centred on Ghana and loads property markers from the mapping endpoint.
Preconditions
- A signed-in administrator with properties that have coordinates.
| Field | Value |
|---|---|
| Priority | Critical |
| Test action | Open the GIS Mapping page. |
| Expected result | The map loads with markers and a loading state. |
| Execution result | PASS |
| Evidence reference | Insert link or reference |
| Defect reference | Insert ID or None |
Test scenarios
| Scenario | Test steps | Expected result | Pass/Fail | Remarks |
|---|---|---|---|---|
| Page access | 1. Open /gismapping. |
The map page renders. | PASS |
|
| Map load | 1. Observe while the map loads. | "Loading Google Maps..." appears until the script loads. | PASS |
|
| Markers | 1. Inspect the map. | Markers render for valid property coordinates. | PASS |
|
| Data request | 1. Inspect the network request. | /property/gismapping is requested with the selected region/district. |
PASS |
|
| Counter | 1. Inspect the header counter. | "{n} of {m} properties shown" is displayed. | PASS |
Tester notes
Record actual result, test data identifiers, device/browser/build, and any variance.
IDA-GIS-02 — Region and district filters¶
Feature overview¶
Region and District selectors filter the property set; the district list depends on the region.
Preconditions
- A signed-in administrator; region/district data available.
| Field | Value |
|---|---|
| Priority | High |
| Test action | Select a region and district, then apply and reset. |
| Expected result | The property set updates and the district selector behaves correctly. |
| Execution result | PASS |
| Evidence reference | Insert link or reference |
| Defect reference | Insert ID or None |
Test scenarios
| Scenario | Test steps | Expected result | Pass/Fail | Remarks |
|---|---|---|---|---|
| Region select | 1. Choose a region. | The district selector enables and lists districts. | PASS |
|
| District select | 1. Choose a district. | The selection is captured. | PASS |
|
| Filter Properties | 1. Click Filter Properties. | The map reloads with the filtered set. | PASS |
|
| Reset | 1. Click Reset. | The selectors clear and the map returns to the default set. | PASS |
Tester notes
Record actual result, test data identifiers, device/browser/build, and any variance.
IDA-GIS-03 — Zone type toggles¶
Feature overview¶
Eight zone-type checkboxes with colour dots include/exclude property markers by usage type.
Preconditions
- A signed-in administrator with properties in multiple zone types.
| Field | Value |
|---|---|
| Priority | High |
| Test action | Toggle zone types and observe markers. |
| Expected result | Markers and the header counter update with the selected zone types. |
| Execution result | PASS |
| Evidence reference | Insert link or reference |
| Defect reference | Insert ID or None |
Test scenarios
| Scenario | Test steps | Expected result | Pass/Fail | Remarks |
|---|---|---|---|---|
| Legend | 1. Inspect the zone-type checkboxes. | All eight usage types render with their colour dots. | PASS |
|
| Exclude a type | 1. Uncheck a zone type. | Markers of that type are hidden and the counter updates. | PASS |
|
| Re-include | 1. Recheck the zone type. | The markers return. | PASS |
Tester notes
Record actual result, test data identifiers, device/browser/build, and any variance.
IDA-GIS-04 — Markers, InfoWindow and empty state¶
Feature overview¶
Clicking a marker opens an InfoWindow with property details; when no properties match, an empty state is shown.
Preconditions
- A signed-in administrator; matching and non-matching filter criteria.
| Field | Value |
|---|---|
| Priority | High |
| Test action | Click a marker and then trigger the empty state. |
| Expected result | The InfoWindow shows the property details; an empty state appears when nothing matches. |
| Execution result | PASS |
| Evidence reference | Insert link or reference |
| Defect reference | Insert ID or None |
Test scenarios
| Scenario | Test steps | Expected result | Pass/Fail | Remarks |
|---|---|---|---|---|
| InfoWindow | 1. Click a marker. | Property ID, name, zone, land size, and coordinates show. | PASS |
|
| Close InfoWindow | 1. Close the InfoWindow. | The window closes. | PASS |
|
| Empty state | 1. Filter to an area with no properties. | "No Properties Found" appears with a hint to adjust filters. | PASS |
|
| Loading state | 1. Trigger a filter change. | A spinner is shown while fetching. | PASS |
Tester notes
Record actual result, test data identifiers, device/browser/build, and any variance.