Skip to content

Ratepayer Portal — Property Management Module Acceptance Tests

Test series: RPP-PROP-01 to RPP-PROP-17
Objective: Validate that a ratepayer can view their property portfolio, register a new property with location and document data, review property, ownership, rating, location, bill and verification details, and complete the property verification and inspection workflow.

Execution ownership

Recommended owners: Ratepayer/Public Portal users; Customer Service observer

Prerequisites: A signed-in ratepayer with a complete profile, registered properties in different statuses, an eligible digital address, and controlled property, billing and inspection data.

Execution control

Use approved UAT data only. Mask personal, authentication, and payment information in screenshots and attachments.

Feature overview

The Property Management module covers the ratepayer's property portfolio:

  • Property List with search, filters, pagination, and card-based display.
  • Add Property with a four-step wizard (Property Information, Location & GIS, Documents, Review).
  • Property Details with ownership, property, location, rating/financial, bill, verification, and document sections.
  • Property verification and inspection workflow exposed on the details page.

The module does not include a visible edit-property action or a visible assign-inspector action in the current build; these are implemented in code but their entry buttons are hidden.

Coverage summary

Test ID Feature Scenario Priority
RPP-PROP-01 Property List Property list display and navigation Critical
RPP-PROP-02 Property List Search High
RPP-PROP-03 Property List Filters High
RPP-PROP-04 Property List Pagination High
RPP-PROP-05 Property List Empty and error states Medium
RPP-PROP-06 Add Property Profile completion guard Critical
RPP-PROP-07 Add Property Property information step High
RPP-PROP-08 Add Property Location and GIS step Critical
RPP-PROP-09 Add Property Documents step High
RPP-PROP-10 Add Property Review and submission Critical
RPP-PROP-11 Property Details Header and rate payer information Critical
RPP-PROP-12 Property Details Property, location and financial information High
RPP-PROP-13 Property Details Bill information Critical
RPP-PROP-14 Property Details Verification status and activity logs Critical
RPP-PROP-15 Property Details Verification workflow Critical
RPP-PROP-16 Property Details Inspection workflow High
RPP-PROP-17 Property Details Documents and images Medium

Implementation observations requiring UAT confirmation

Observation from implementation Required validation
The Assign Inspector button on the Property Details page is hidden (className: hidden), and the inspector list query is disabled. Confirm whether inspector assignment is in scope for the ratepayer portal release.
The Edit Property modal exists for Property, Location, and Financial sections, but every Edit button is hidden in the current build. Confirm whether editing a property is expected for ratepayers.
The Structure Type value on the Property Details page is rendered as a fixed Permanent tag. Confirm the approved source of the structure type value.
In Add Property, the Property Name and Land Size fields are optional, while Digital Address, Address/Landmark, Region, MMDA, and Block are required. Confirm the required-field matrix for property registration.
A Digital Address longer than 10 characters triggers an automatic lookup that fills rating values, region, MMDA, address and coordinates. Confirm the approved auto-fill behaviour and the data source.
Successful Verify Property does not display a success notification in the current build. Confirm whether a confirmation message is expected.
Supporting documents and property images are optional during registration. Confirm whether documents are mandatory for any property category.

RPP-PROP-01 — Property list display and navigation

Feature overview

The Property Management page at /properties displays the ratepayer's properties as cards in a responsive grid. Each card shows the property ID, status, name, address, rate payer, zone, land size, rateable value, rate, and creation details. Clicking a card opens the property details page.

Preconditions

  • A signed-in ratepayer with at least one registered property.
Field Value
Priority Critical
Test action Open the Property Management page and open a property from the grid.
Expected result Properties render as cards with correct data; clicking a card opens the details page.
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 header and Add button 1. Open /properties. The heading "Property Management" and an Add Property button are shown. PASS
Property card content 1. Inspect a property card. Card shows #<id>, status badge, property name, address, rate payer name and type, zone type, land size, rateable value (GH₵), rate (%), creation date, and creator. PASS
Open property details 1. Click a property card. The user is redirected to /properties/<id> and the details page loads. PASS
Responsive grid 1. Resize the browser across desktop and mobile widths. Cards reflow correctly across columns without overlap. PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

Feature overview

The search box filters the property grid by property name. Each change triggers a new request and resets the pagination to the first page.

Preconditions

  • A signed-in ratepayer with properties that have distinct names.
Field Value
Priority High
Test action Search for a property by name.
Expected result The grid updates to show only properties matching the search text.
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
Match by name 1. Enter a known property name in the search box. Only matching properties are displayed and pagination resets to page 1. PASS
No matches 1. Enter text with no matching property. The empty state "No properties found" is shown. PASS
Clear search 1. Click the clear icon in the search box. The full property grid is restored. PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

RPP-PROP-03 — Property list filters

Feature overview

The list provides filters for status (Pending, Approved, Under Inspection, Inspection Completed, Rejected), ownership type (Private, Government, Institutional), owner type (Individual, Institution), and region. Filters can be combined and cleared.

Preconditions

  • A signed-in ratepayer with properties in multiple statuses, ownership and owner types, and regions.
Field Value
Priority High
Test action Apply and combine filters, then clear them.
Expected result Results respect the selected filters and pagination resets.
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
Status filter 1. Select Approved in the status filter. Only approved properties are displayed. PASS
Ownership type filter 1. Select Private in the ownership type filter. Only private properties are displayed. PASS
Owner type filter 1. Select Individual in the owner type filter. Only properties owned by individuals are displayed. PASS
Region filter 1. Select a region. Only properties in the selected region are displayed; the region selector supports search. PASS
Combined filters 1. Apply two or more filters together. Results satisfy all active filters. PASS
Clear all filters 1. Click Clear all filters. All filters reset and the full grid is restored. PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

RPP-PROP-04 — Property list pagination

Feature overview

The grid is paginated with configurable page sizes (12, 24, 48, 96), a quick jumper, and a total counter.

Preconditions

  • A signed-in ratepayer with more properties than the default page size.
Field Value
Priority High
Test action Navigate pages and change the page size.
Expected result Pagination controls update the grid and show correct totals.
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 navigation 1. Go to the next page using the pagination control. The grid shows the next set of properties. PASS
Quick jumper 1. Use the quick jumper to open a specific page. The grid jumps to the requested page. PASS
Page size change 1. Change the page size from 12 to 24. The grid displays up to 24 properties per page. PASS
Total counter 1. Inspect the total counter text. It shows "X-Y of Z properties". PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

RPP-PROP-05 — Property list empty and error states

Feature overview

The list shows a loading spinner while fetching, an empty state when no properties exist, and an error state with a retry action when the request fails.

Preconditions

  • An account with no properties for the empty state; a network/API failure for the error state.
Field Value
Priority Medium
Test action Trigger loading, empty, and error states on the property list.
Expected result Each state is clear and recoverable.
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
Loading state 1. Open /properties while the request is pending. A spinner is displayed. PASS
Empty state 1. Open /properties for an account with no properties. "No properties found" is shown with an Add First Property button. PASS The button opens /properties/create.
Error state 1. Trigger an API failure and observe the page. "Error loading properties" is shown with a Try Again button. PASS
Recovery 1. Click Try Again after restoring connectivity. The grid loads successfully. PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

RPP-PROP-06 — Add property — profile completion guard

Feature overview

The Add Property page at /properties/create blocks registration until the ratepayer profile is 100% complete. Incomplete profiles see a "Complete Your Profile First" screen with a button to Account Settings.

Preconditions

  • A signed-in ratepayer whose profile completion is below 100%.
Field Value
Priority Critical
Test action Open the Add Property page with an incomplete profile.
Expected result The registration form is replaced by a profile-completion message and a link to Settings.
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
Incomplete profile 1. Open /properties/create with a profile below 100%. "Complete Your Profile First" is shown with the completion percentage. PASS
Complete My Profile 1. Click Complete My Profile. The user is redirected to /settings. PASS
Complete profile 1. Complete the profile to 100%, then reopen /properties/create. The four-step registration wizard is displayed. PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

RPP-PROP-07 — Add property — property information step

Feature overview

Step 1 captures the property name (optional), ownership type (required, loaded from the server), and land size (optional).

Preconditions

  • A signed-in ratepayer with a 100% complete profile.
Field Value
Priority High
Test action Complete the Property Information step.
Expected result Ownership type is required; name and land size are optional.
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
Optional name and land size 1. Leave Property Name and Land Size empty; select Ownership Type.
2. Click Next.
The step advances to Location & GIS. PASS
Missing ownership type 1. Leave Ownership Type empty and click Next. A field-level error requires the ownership type. PASS Options load from /sys/ownershiptype.
Land size input 1. Enter a land size with decimal precision. Negative values are not accepted; step 0.01 is allowed. PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

RPP-PROP-08 — Add property — location and GIS step

Feature overview

Step 2 captures the digital address (required), which can auto-fill rating and location values, together with the physical address, region, MMDA, block, community, postal details, and coordinates.

Preconditions

  • A signed-in ratepayer with a 100% complete profile and an eligible digital address for auto-fill.
Field Value
Priority Critical
Test action Enter location details and use the digital-address auto-fill.
Expected result Required fields are validated and a valid digital address populates dependent values.
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
Digital address auto-fill 1. Enter a digital address longer than 10 characters. A lookup runs; rating values, region, MMDA, address and coordinates are auto-filled, and a "Found Property Values" notification appears. PASS Uses /sys/getpropertyvalues.
Required location fields 1. Leave Address/Landmark, Region, MMDA, or Block empty. Field-level errors block progression to the next step. PASS
MMDA dependency 1. Observe MMDA before and after selecting a region. MMDA is disabled until a region is selected, then loads MMDAs for that region. PASS
Block dependency 1. Select an MMDA and open the Block selector. Block options load for the selected MMDA. PASS
Optional fields 1. Leave Community, Postal Area, Post Code and Coordinates empty. The step still advances once required fields are complete. PASS
Coordinate picker 1. Open the coordinate picker and select a location. Latitude and longitude are captured. PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

RPP-PROP-09 — Add property — documents step

Feature overview

Step 3 optionally captures property images (up to five files) and supporting documents by type (Land Deed, Site Plan, Building Permit, Ownership Proof). Files must be JPG, JPEG, PNG or PDF up to 5MB each.

Preconditions

  • A signed-in ratepayer at the Documents step of property registration.
Field Value
Priority High
Test action Upload images and supporting documents.
Expected result Valid files upload; invalid types, oversized files, or duplicate document types are rejected.
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
Upload property images 1. Upload JPG/PNG images. Images are accepted up to five files. PASS
Invalid image type 1. Try to upload a non-image file. "You can only upload jpg, jpeg, png, pdf file only!" error is shown. PASS
Oversized image 1. Upload a file above 5MB. "Please upload file smaller than 5MB!" error is shown. PASS
Add document group 1. Click Add Document, select a type and upload one file. The document group is accepted; the selected type is removed from the available list. PASS
Duplicate document type 1. Try to add a second group with the same document type. The already-used type is not selectable again. PASS
Remove file 1. Remove an uploaded image or document. A confirmation prompt appears and the file is removed. PASS
Skip documents 1. Proceed without any images or documents. The step advances; documents are optional. PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

RPP-PROP-10 — Add property — review and submission

Feature overview

Step 4 reviews all entered data with Edit shortcuts and a document summary, then submits through a confirmation modal. Successful submission returns the ratepayer to the property list.

Preconditions

  • A completed Property Information, Location & GIS, and Documents step.
Field Value
Priority Critical
Test action Review and submit a new property registration.
Expected result The confirmation flow works and a successful submission returns to the property list.
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
Review content 1. Inspect the Review step. Property, Location & GIS, and Documents sections reflect the entered values with Edit shortcuts. PASS
Document summary 1. Inspect the document summary. It shows the number of property images and supporting documents uploaded. PASS
Confirmation modal 1. Click Register Property. A "Confirm Property Registration" modal is shown. PASS
Confirm submission 1. Click Yes, Register. A "Property Registration" success notification appears and the user is redirected to /properties. PASS Posts to /web/addproperty.
Cancel submission 1. Click No, Cancel in the modal. No submission occurs and the user stays on the Review step. PASS
In-flight button 1. Submit and observe the button while pending. The button shows "Registering..." and is disabled. PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

RPP-PROP-11 — Property details — header and rate payer information

Feature overview

The details page at /properties/<id> opens with a header showing the property name, registration date, and status, plus context-dependent actions. The Rate Payer Information section shows the owner type, name, phone, and email.

Preconditions

  • A signed-in ratepayer with a registered property.
Field Value
Priority Critical
Test action Open a property's details page and review the header and owner information.
Expected result Header and rate payer details are accurate and status-aware.
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
Header details 1. Open /properties/<id>. Property name, registration date, and status tag are shown. PASS
Individual owner 1. Inspect Rate Payer Information for an individual owner. Full name, phone, and email are shown with an Individual tag. PASS
Organization owner 1. Inspect Rate Payer Information for an organization. Organization name and representative phone/email are shown with an Organization tag. PASS
Status-aware actions 1. Compare the action buttons for different property statuses. Submit Inspection, Review Inspection, and Verify Property appear only under the conditions described in the observations. PASS See RPP-PROP-15 and RPP-PROP-16.

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

RPP-PROP-12 — Property details — property, location and financial information

Feature overview

The main content area shows Property Information (name, ownership type, zone, structure, land size, region, MMDA), Location & GIS Information (address, coordinates), and Rating & Financials (rateable value, rate impost, assessment year, exemption details).

Preconditions

  • A signed-in ratepayer with a registered property.
Field Value
Priority High
Test action Review the property, location, and financial sections.
Expected result Values match the central property record and exemption details appear only when applicable.
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
Property information 1. Inspect Property Information. Name, ownership type, zone type, zone class, structure type, land size, region, and MMDA are shown. PASS Structure type renders as "Permanent".
Location information 1. Inspect Location & GIS Information. Address is shown; coordinates appear only when present. PASS
Financial information 1. Inspect Rating & Financials. Rateable value, rate impost, assessment year, and exemption status are shown. PASS
Exempted property 1. Open a property with exemption enabled. Exemption rate and reason appear; a non-exempt property does not show them. PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

RPP-PROP-13 — Property details — bill information

Feature overview

The Bill Information section shows the current bill's charge type, year, effective and due dates, and the financial breakdown (calculated, amount, discount, exemption, penalty, payable, paid, outstanding). It links to the bill and offers payment when outstanding.

Preconditions

  • A signed-in ratepayer with a property that has a bill, and one with no bill for the empty state.
Field Value
Priority Critical
Test action Review the bill information and open the bill.
Expected result Bill figures reconcile and navigation works; a property without a bill shows the empty 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
Bill breakdown 1. Inspect Bill Information for a billed property. Charge type, year, dates, and financial breakdown are shown and reconcile. PASS
View bill 1. Click View Details. The user is redirected to /bill/<id>. PASS
Pay now 1. For a property with an outstanding amount, click Pay Now. The bill payment page opens. PASS
No bill state 1. Open a property without a bill. "No bill found for this property" is shown. PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

RPP-PROP-14 — Property details — verification status and activity logs

Feature overview

The Verification Status card shows the current status with an icon and message, assigned inspectors, submitted inspection reports, and an activity-log timeline of the property's history.

Preconditions

  • A signed-in ratepayer with properties in different verification states.
Field Value
Priority Critical
Test action Review the verification status section for different statuses.
Expected result Status, inspectors, reports, and activity history are accurate and chronological.
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
Status display 1. Inspect the Verification Status card. Status tag, icon, and descriptive message match the property state. PASS
Activity logs 1. Inspect the Activity Logs timeline. Title, details, notes, actor, and timestamp are shown in order. PASS
Assigned inspectors 1. Open a property with assigned inspectors. Inspector name and assignment notes are shown. PASS
Inspection reports 1. Open a property with submitted inspection reports. Report number, inspected-by, notes, documents, and date are shown. PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

RPP-PROP-15 — Property details — verification workflow

Feature overview

When a property reaches Inspection Completed (status 3), a Verify Property action opens a modal to update the verification status with required notes. The update is sent to the approval endpoint.

Preconditions

  • A property in Inspection Completed status.
Field Value
Priority Critical
Test action Verify a property from the details page.
Expected result The verification status updates with notes and the page refreshes.
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
Verify availability 1. Open a property in Inspection Completed status. The Verify Property button is shown; it is hidden for other statuses. PASS
Verify with status and notes 1. Click Verify Property.
2. Select Approved and enter notes.
3. Click Submit Verification.
The page refreshes and the property status updates. PASS PATCH to /property/approveproperty/<id>. No success toast in current build.
Missing status or notes 1. Submit the verification modal without a status or without notes. "Please select a status" / "Please provide verification notes" errors are shown. PASS
Status options 1. Inspect the status selector. Pending, Approved, Under Inspection, Inspection Completed, and Rejected are available. PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

RPP-PROP-16 — Property details — inspection workflow

Feature overview

For properties with an assigned inspector, a Submit Inspection action captures inspection notes and supporting documents. When an inspection report exists, a Review Inspection action lets the user approve or reject the inspection and optionally request re-inspection.

Preconditions

  • A property with an assigned inspector, and one with a submitted inspection report.
Field Value
Priority High
Test action Submit an inspection report and review an existing report.
Expected result Inspection submissions and reviews complete with validation and the page refreshes.
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
Submit Inspection availability 1. Open a property with an assigned inspector in Under Inspection status. The Submit Inspection button is shown. PASS
Submit report 1. Click Submit Inspection.
2. Enter notes and attach documents.
3. Click Submit Report.
"Inspection Submitted" notification appears and the page refreshes. PASS POST to /property/inspectionsubmission/<id>.
Missing inspection notes 1. Submit the inspection modal without notes. "Please provide inspection notes" error is shown. PASS
Review availability 1. Open a property with a submitted inspection report in status 2 or 3. The Review Inspection button is shown. PASS
Review decision 1. Click Review Inspection.
2. Choose Approve/Reject, optionally tick re-inspect, enter notes, and submit.
"Inspection Reviewed" notification appears and the page refreshes. PASS PATCH to /property/inspectionreview/<reportId>.
Review validation 1. Submit the review without a decision or notes. "Please make a decision" / "Please provide review notes" errors are shown. PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.

RPP-PROP-17 — Property details — documents and images

Feature overview

The Documents & Images card shows up to four property images (with preview and a "more" counter) and up to three supporting documents (with View links and a "more" counter).

Preconditions

  • A signed-in ratepayer with a property that has images and documents.
Field Value
Priority Medium
Test action View property images and supporting documents.
Expected result Images and documents are readable and open 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
Image preview 1. Click a property image. The image opens in a preview. PASS
Image more counter 1. Inspect a property with more than four images. A "+N more" tile is shown. PASS
Document view 1. Click View on a supporting document. The document opens in a new tab. PASS
Document more counter 1. Inspect a property with more than three documents. A "+N more documents" note is shown. PASS
No documents 1. Open a property without documents. The card shows no image or document blocks. PASS

Tester notes

Record actual result, test data identifiers, device/browser/build, and any variance.