KADGIS Compensation Register — user guide
How to use the system day to day, from every seat in the office and the field: what each screen is for, the steps for each job, what the messages mean and what to do when something goes wrong.
What the system does
The Compensation Register tracks land and property compensation for the Kaduna State Geographic Information Service (KADGIS). Every property acquired for a project moves through the same five steps:
- ProjectA road, drain or other scheme that needs land, with its boundary on the map
- PropertyEach plot, building or farm affected, with its outline and what is on it
- ClaimantThe owner, found by NIN, with ID and bank details checked
- Complete dataCaptured on site with the field app, or filled in by the office
- CompensationCash by bank cheque, or 30% of the land back
There are two kinds of compensation: cash, paid by bank cheque, and 30% land allocation, where the claimant receives a plot equal to 30% of the land acquired. A property can have several cases — for example the land as a 30% allocation and the buildings and trees in cash. Cash values are built from the items on the property (trees, crops, buildings) and the approved rates. Each case moves through its own fixed steps, and each step is recorded by the person whose role allows it.
A case can only open once the property and claimant records are complete, any conflict (such as a possible duplicate claimant) has been decided, and the property’s boundary has no blocking problem, such as overlapping its neighbour.
Everything anyone does is written to the record’s minute sheet: a numbered, dated and initialled history, like the minutes in a paper file. Nothing is silently changed.
The two apps
| App | Address | Who uses it |
|---|---|---|
| Office app | the main KADGIS address (e.g. http://localhost:3000) | All office staff. What you see depends on your role. |
| Field survey app | the survey address (e.g. http://survey.localhost:3000) | Field surveyors, on a phone: capturing properties and claimants on site, and assigned surveys. Works offline. |
| This guide | http://docs.localhost:3000 | Everyone. No log-in needed. |
Claimants never log in. They hear from KADGIS by SMS and email sent from the office app.
Choose your guide
Start with Getting started if you have never used the system. Then read the guide for your role. Not sure which role you have? It is under your name in the top-right corner of the office app.
- AdministratorStaff accounts, roles, locations, dictionaries and rates, background jobs, email and SMS settingsRead →
- Compensation OfficerRuns the process: projects and boundaries, properties, claimants, data gaps, conflicts, spatial flags, surveys, cases and messagesRead →
- ValuerValues cases from their items and rates, and attaches valuation reportsRead →
- FinanceApproves amounts, records cheques and payments, downloads the payment scheduleRead →
- Viewer / AuditorReads every record, message and minute; exports registersRead →
- Field SurveyorCaptures properties, boundaries, claimants and items on a phone, online or offlineRead →
- Workflow rolesField Supervisor, GIS Officer, Claims / Verification Officer, Approving Officer, Payments Officer and Payment Approver: one step each; following the field teamsRead →
- IT operatorInstalls and runs the server, email, SMS, storage and backupsRead →
Roles can be changed by an administrator, so your organisation may use extra roles or different names. The roles and permissions reference lists exactly what each permission allows.
When something goes wrong
The troubleshooting page lists every message the system shows, with the cause, the fix and who can fix it. Type the message you see into its search box, or into the search at the top of any page (press /).
How to read the screenshots
The screenshots in this guide come from a demo copy of the system filled with made-up people and places. Numbered amber markers point at the parts of the screen, and the list under each picture explains them. Point at an entry in the list to highlight its place, and click a picture to see it full size.