Property Management
Overview
Property Management is the core module for registering, inspecting, and managing properties across all MMDAs. It includes a 6-step registration wizard, an inspection workflow (assign → submit → review → verify), property list views with multiple status filters, and bulk import via Excel.
Navigate to: Sidebar → Property Management
Property List Views
The property module provides multiple list views, each filtered by status:
| View | Route | Description |
|---|---|---|
| All Properties | /property/listproperty |
All registered properties regardless of status |
| Pending Properties | /property/pendingproperty |
Properties awaiting inspection assignment |
| Under Inspection | /property/underinspection |
Properties currently being inspected by agents |
| Inspection Completed | /property/inspectioncompleted |
Properties with completed inspection reports |
Property List
| Element | Description |
|---|---|
| Search bar | Search by property name, ID, owner name, or address |
| Filter tabs | All, Pending, Under Inspection, Inspection Completed |
| Add Property button | Opens the 6-step registration wizard |
| Import Property button | Opens the bulk Excel import |
| Property card | Shows property details and status badge |
Property Card
| Field | Description |
|---|---|
| Property Name | Display name of the property |
| Property ID | System-generated unique identifier |
| Owner Name | Linked rate payer name |
| Digital Address | Ghana Post digital address |
| MMDA | Metropolitan/Municipal/District Assembly |
| Region | Region where the property is located |
| Status badge | Current status (Pending, Under Inspection, Completed, etc.) |
| View Details button | Opens the property detail page |
Status Badges
| Badge | Colour | Meaning |
|---|---|---|
Pending |
Orange | Registered but not yet assigned for inspection |
Under Inspection |
Blue | Assigned to an agent, inspection in progress |
Inspection Completed |
Green | Inspection report submitted |
Verified |
Green | Fully verified and approved by admin |
Rejected |
Red | Inspection report rejected, needs re-inspection |
!!! tip "Things to check" - Each tab shows only properties matching that status - The count on each tab matches the actual number of properties - Search works across all visible fields (name, ID, owner, address) - Property cards display correctly for all status types - Pagination works correctly for large datasets
Add Property (6-Step Wizard)
Navigate to: Sidebar → Property Management → Add Property
The property registration is a 6-step wizard with a progress tracker at the top. Completed steps show a checkmark.
Progress Steps
| Step | Name | Description |
|---|---|---|
| 1 | Rate Payer Selection | Select or create the rate payer (property owner) |
| 2 | Property Info | Property details (name, type, size, ownership) |
| 3 | Location & GIS | Address, coordinates, MMDA assignment |
| 4 | Documents | Property images and ownership documents |
| 5 | Review | Summary of all entered information |
| 6 | Submit | Confirmation and submission |
Step 1: Rate Payer Selection
Select the rate payer (property owner) this property will be linked to.
| Field | Required | Description |
|---|---|---|
| Search Rate Payer | Yes | Search existing rate payers by name, phone, or email |
| Rate Payer Type | Yes | Individual or Organisation (auto-populated from selection) |
| Rate Payer ID | Yes | Auto-populated when a rate payer is selected |
If the rate payer is not yet registered, the user can navigate to Rate Payer Management to add them first.
!!! tip "Things to check" - Search returns matching rate payers as the user types - Selecting a rate payer auto-fills the type and ID fields - The wizard blocks progression if no rate payer is selected - Both Individual and Organisation rate payers can be linked
Step 2: Property Info
| Field | Required | Description |
|---|---|---|
| Property Name | Yes | Display name for the property |
| Property Type | Yes | Residential, Commercial, Industrial, etc. |
| Ownership Type | Yes | Single or Multiple |
| Land Size | Yes | Property area in square metres (sq. m.) |
| Structure Type | Yes | Permanent, Semi-Permanent, Temporary |
| Occupancy Status | Yes | Owner-Occupied, Rented, Vacant |
| Year of Construction | No | When the property was built |
| Number of Units | No | Number of residential/commercial units |
!!! tip "Things to check" - All required fields block progression when left blank - Land Size accepts only numeric values - Property Type and Ownership Type dropdowns show all valid options - Optional fields can be skipped without blocking progression
Step 3: Location & GIS
| Field | Required | Description |
|---|---|---|
| Digital Address | Yes | Ghana Post digital address (e.g. GA-123-4567) |
| Address | Yes | Free-text physical address |
| Landmark | No | Nearby landmark for easy identification |
| Region | Yes | Dropdown — region selection |
| MMDA | Yes | Dropdown — dependent on selected Region |
| Community | No | Free text |
| Postal Area | No | Free text |
| Postal Code | No | Free text |
| Zone | Yes | Zone within the MMDA |
| Latitude | Yes | GPS latitude (can be picked from map) |
| Longitude | Yes | GPS longitude (can be picked from map) |
| Pick Coordinates button | — | Opens map to set Latitude/Longitude |
!!! tip "Things to check" - MMDA options filter correctly based on the selected Region - Digital Address format is validated (rejects malformed values) - Pick Coordinates correctly populates Latitude/Longitude - Required fields block Next until filled - Zone options filter based on the selected MMDA
Step 4: Documents
Property Images
| Element | Description |
|---|---|
| Upload Images button | Upload property photos (front view, side view, etc.) |
| Supported formats | JPG, PNG — max 10MB each |
| Max images | Configurable per system settings |
| Image preview | Thumbnail preview of uploaded images |
Rate Payer Documents
| Document | Required | Description |
|---|---|---|
| Ownership Proof | Yes | Title deed, allocation letter, etc. |
| Land Deed | Yes | Registered land deed |
| Survey Plan | No | Property survey document |
| Building Permit | No | Construction permit |
| + Add Document button | — | Attach additional document types |
Each document supports: - Drag & drop upload - Choose (file picker) - Camera capture - Supported formats: JPG, PNG, PDF — max 10MB per file
!!! tip "Things to check" - Image upload rejects files over 10MB and unsupported formats - Camera capture works and the photo attaches correctly - Both required documents (Ownership Proof, Land Deed) must be uploaded - + Add Document allows attaching additional document types - Uploaded files show correct file names and sizes
Step 5: Review
Summarizes everything entered across the previous four steps for final verification before submission.
| Section | Shows |
|---|---|
| Rate Payer Information | Name, type, ID of the linked rate payer |
| Property Information | Property name, type, ownership type, land size, structure type |
| Location & GIS | Digital address, address, MMDA, region, zone, coordinates |
| Documents | File count for property images and ownership documents |
Each section has an Edit link that jumps back to that step without losing data from other steps.
!!! tip "Things to check" - Edit on each section returns to the correct step - Changes made in a step are reflected back on Review - All entered values display accurately - Previous navigates back without losing data - Submit is blocked if required data is missing
Step 6: Submit
Confirmation screen with a summary and Submit button.
After submission:
- A success message confirms the property was registered
- The property appears in the list with status Pending
- An inspection can be assigned from the property details page
!!! tip "Things to check"
- Success message is clear and informative
- New property appears in the list immediately (no manual refresh needed)
- Property starts with status Pending
- Property ID is unique and correctly generated
Property Details
Navigate to: Sidebar → Property Management → Property List → View Details
The property details page is a comprehensive view (~2800 lines of component code) that shows all property information and manages the inspection workflow.
Property Information Section
| Field | Description |
|---|---|
| Property ID | System-generated unique identifier |
| Property Name | Display name |
| Property Type | Residential, Commercial, Industrial, etc. |
| Ownership Type | Single or Multiple |
| Land Size | Area in sq. m. |
| Structure Type | Permanent, Semi-Permanent, Temporary |
| Occupancy Status | Owner-Occupied, Rented, Vacant |
| Digital Address | Ghana Post address |
| Physical Address | Free-text address |
| MMDA | Metropolitan/Municipal/District Assembly |
| Region | Region |
| Zone | Zone within the MMDA |
| Coordinates | GPS Latitude/Longitude |
Owner Information Section
| Field | Description |
|---|---|
| Owner Name | Rate payer's name |
| Owner Type | Individual or Organisation |
| Contact Phone | Phone number |
| Email address | |
| Rate Payer ID | Linked rate payer identifier |
Documents Section
| Field | Description |
|---|---|
| Property Images | Uploaded property photos |
| Ownership Proof | Uploaded ownership document |
| Land Deed | Uploaded land deed |
| Other Documents | Additional uploaded documents |
Inspection Workflow Section
The property details page manages the full inspection lifecycle:
| Action | Description |
|---|---|
| Assign Inspector | Assign an agent to conduct field inspection |
| Submit Report | Agent submits the inspection report (from field) |
| Review Report | Admin reviews the submitted inspection report |
| Verify | Admin verifies and approves the property |
| Reject | Admin rejects the inspection, requiring re-inspection |
Inspection Status Flow
Property Registered (Pending)
↓
Assign Inspector (Agent assigned)
↓
Agent Conducts Inspection (Under Inspection)
↓
Agent Submits Report (Inspection Completed)
↓
Admin Reviews Report
↓ Approve ↓ Reject
Verified ✅ Rejected ❌
↓
Re-inspection Required
!!! tip "Things to check"
- Assign Inspector shows a list of available agents
- Only assigned agents can submit inspection reports
- Admin review shows the full inspection report with images and notes
- Verify changes the property status to Verified
- Reject returns the property to pending status for re-inspection
- The full workflow is trackable from the property details page
Import Property (Bulk Import)
Navigate to: Sidebar → Property Management → Import Property
Bulk import properties via Excel upload.
| Element | Description |
|---|---|
| Download Template button | Downloads an Excel template with required columns |
| Upload File button | Select an Excel file for import |
| Import button | Processes the uploaded file |
| Import preview | Shows rows to be imported with validation status |
| Error log | Displays validation errors for rejected rows |
Template Columns
The Excel template includes columns for all required property fields:
| Column | Required | Description |
|---|---|---|
| Property Name | Yes | Display name |
| Property Type | Yes | Residential, Commercial, etc. |
| Ownership Type | Yes | Single or Multiple |
| Rate Payer ID | Yes | Linked rate payer |
| Digital Address | Yes | Ghana Post address |
| Address | Yes | Physical address |
| Region | Yes | Region name |
| MMDA | Yes | Assembly name |
| Zone | Yes | Zone name |
| Land Size | Yes | Area in sq. m. |
| Structure Type | Yes | Permanent, Semi-Permanent, etc. |
!!! tip "Things to check" - Template download provides a correctly formatted Excel file - Upload validates file format (only .xlsx accepted) - Missing required columns are flagged with clear errors - Duplicate property names/addresses are detected - Import preview shows all rows before final submission - Partial imports handle errors gracefully (valid rows import, invalid rows flagged) - After import, properties appear in the list with correct data
Complete Property Workflow
Add Property (6-step wizard)
↓
Property Registered (Pending)
↓
Admin Assigns Inspector
↓
Agent Conducts Field Inspection (geofenced, 40m radius)
↓
Agent Submits Inspection Report
↓
Admin Reviews Report
↓ Approve ↓ Reject
Verified ✅ Re-inspection Required ❌
↓
Property Active → Bills Can Be Issued
!!! tip "Things to check" - A verified property can have bills issued against it - A property in any other status cannot be billed - The full audit trail is visible on the property details page - Document versions are tracked (original vs updated during inspection) - GIS coordinates are validated and map correctly