Compensation Officer guide

Compensation Officers run the process from start to finish: they set up projects and their boundaries, register properties and claimants, make sure every record is complete, decide conflicts and spatial flags, send surveyors to the field, open compensation cases and keep claimants informed.

Default role: Compensation Officer Also useful for: Administrator

The process at a glance

  1. 1. ProjectCreate it, set its boundary
  2. 2. PropertyCaptured in the field, registered or imported
  3. 3. ClaimantLink, check ID and bank
  4. 4. CompleteFill the gaps, decide conflicts and flags
  5. 5. CaseOpen one or more, then each role records its step

A property’s stage is worked out from what has been done, so it is always up to date:

StageMeansWhat you do next
RegisteredNo claimant linked yetLink the claimant
Claimant linkedNo survey yetComplete the data; assign a survey if a visit is needed
Survey in progressAssigned, submitted or returnedReview when submitted
SurveyedSurvey approved, no case yetOpen a case once the data is complete
Compensation in progressA case is openEach role records its step
CompensatedThe case reached its last stepNothing

A survey is no longer needed before a case: a property with complete data can go straight to a case. The property’s next-step box always says what it needs.

The dashboard

Start each day here. The amber note lists conflicts to decide, blocking spatial flags, surveys waiting for your review and disputed cases. The Data completeness panel shows, for each project, how many properties are complete and the average, then the most common gaps for properties and for claimants. Every number opens the matching register.

Projects

Needs projects.manage

  1. Open Projects and click New project.
  2. Enter a unique project code (it is used in imports, filters and case numbers, e.g. KSR-2026-01), the name, main LGA, status and start date. Create it as Planning.
  3. Click Create project. Its file opens.
  4. Set the project boundary on the Map tab, then change the status to Active.

The project’s Overview shows how many properties are at each stage, its data completeness (complete properties, the average, and what is missing most often, each with a link to the matching properties), and any open conflicts. Export incomplete downloads the incomplete properties to Excel.

The census cut-off date

Set the project’s Cut-off date (census) in Edit project when the census closes. From then on, a property captured after that day, or a claimant registered after it, is listed on Conflicts as Added after the cut-off date — and, like every open conflict, holds compensation back. Decide each one with a note: Eligible after all (for example, missed by the census, or captured on time but sent in late) or Not eligible (no case can be opened for it). Setting or moving the date looks through everything the project already holds; buildings drafted from the map scan do not count as new. The date and each decision are minuted.

Project boundary and map scan

A project has a perimeter: the land it takes. A project can only become Active once it has a boundary.

  1. Open the project, then the Map tab, and click Set boundary (Edit once there is one).
  2. Choose how to give it:
    • Draw on the map: click to add corners in order. Drag a corner to move it; drag or click the small dot between two corners to add one; click a corner, then Remove corner.
    • Type coordinates: choose Latitude, longitude (WGS84) or UTM zone 32N, and type one corner per line. Show on map checks them.
    • Upload a file: GeoJSON, KML, or a zipped shapefile (the .shp, .shx, .dbf and .prj together).
  3. Check the area and the note under the map (it says if the outline is not valid), then click Save boundary.

Saving the boundary queues a map scan. In the background, the system reads the open map data (OpenStreetMap) inside the boundary and keeps what it finds as shapes: roads, rivers and streams, water, farmland, orchards and woodland, buildings and power lines, cut to the boundary (with a 100 m margin so edge roads still show). When it finishes, the Map tab shows:

On the map, the layer list (top right) has a layer for each kind of shape: Roads and Rivers and streams are on from the start; switch on farmland, water, power lines or the scanned buildings when you need them. Each loads when you switch it on. With thousands of buildings, zoom in to see them. Hover a shape for its name, class and length or area.

Estimates only

Open map data can be incomplete or out of date. Use the scan to plan the fieldwork, and confirm everything on site.

A scan that has not finished says queued or running; a failed one shows the reason. Administrators can see and retry scans on Background jobs.

The system map

Map, at the top of the menu, shows every project boundary, coloured by status, with a bubble counting its properties. Click a bubble to zoom in; once you are close enough, the properties of the area in view load on their own, and more load as you move. Click a project for its details, or Show properties for all of them. Choose what the properties are coloured by at the top right.

Sub-boundaries

Needs subboundaries.manage to draw and change; anyone who can see projects can see them

A project can be divided into sub-boundaries: named, coloured areas such as “Kakau North” or “Market square”. They organise the work: which properties fall where, how far each area has got, and which field team captures it.

  1. Open the project and its Sub-boundaries tab.
  2. Click New sub-boundary, give it a name (the code, such as KEB-S04, is made for you) and click Create.
  3. Draw, type or upload its outline. The project boundary and the other sub-boundaries are shown underneath. Click Save boundary.

All sub-boundaries of every project are also listed under Registers › Sub-boundaries.

Divide a project automatically

Instead of drawing every area, let the system propose them. It needs the project’s map scan (for the roads, rivers and buildings).

  1. On the project’s Sub-boundaries tab, click Generate automatically…
  2. Set the target size of an area (the form suggests one for about ten areas and says how many your size gives).
  3. Choose what to divide: the whole project (accepting then replaces its current sub-boundaries, which are archived) or only the free space outside the active ones.
  4. Choose how to balance the areas: by size, or by the number of buildings (equal workload for field teams).
  5. Keep Follow roads (main roads, residential and unclassified — not paths or tracks), Follow rivers, streams and water and Keep property parcels whole on, unless you have a reason not to. Click Generate drafts.

After a few seconds the drafts appear: dashed on the map, and listed above it with their figures — the size range and average, how much of the dividing lines follow a road or water, how many parcels were kept whole, and about how many buildings each area has.

Names from the map (AI)

When AI is switched on, the drafts of an automatic division have Suggest names for the drafts. The system finds the named roads, rivers, places and landmarks in or near each area — whether a road runs through it or along its edge, the side of a market or river the area lies on, how far — and the AI words a short name from them, such as Kawo Market North or Between Kachia Road and the River.

Describe this area (AI)

On a project’s Overview tab, and in the Map Studio’s inspector (the project when nothing is selected, or one area), Describe this area gives four to six plain lines: how many buildings and of what kind, the roads and rivers by name, landmarks, farmland and where it lies, and how far the register has got (properties recorded and the share of the buildings that is, complete, cases, paid, open flags). The figures are worked out by the system from the map scan and the register; the AI only words them, and any number in its lines that is not one of the figures is highlighted. Copy puts the lines on the clipboard for a report.

Field teams: who captures where

Needs surveys.assign to assign; surveys.view to see

Field agents work in areas: an area’s field team is one lead and any number of members. An agent’s phone downloads only their areas (and properties within 200 m of them), so it stays small and they see their own work.

The Map Studio

Anyone who can see projects can open it; drawing and publishing need subboundaries.manage

The Map Studio is a full-screen map of one project for working on its sub-boundaries: draw, reshape, split and merge them with every layer the system knows underneath. Open it with Open in Map Studio on the project (or its Sub-boundaries tab), Map Studio on a sub-boundary, or Map Studio in a project’s bubble on the system map. Back to the project at the top left returns.

Nothing is saved while you work. Every change goes into a draft set, shown as “3 unsaved changes” at the top and dotted on the map. Publish saves the whole set at once (one bad shape stops all of it, with the change named); Discard changes drops it. Leaving with unsaved changes asks first (Back to the project takes a second click; closing the tab asks through the browser).

ToolKeyHow
SelectVClick an area to see and change its name, colour, status and “May cross other areas”, its tags, field team, recent minutes, Split into parts… and Assign…. Shift-click adds more areas to the selection.
Draw areaDClick the corners; click the first one again to finish. Corners snap to the project edge, other areas, parcels and roads within a few metres.
RectangleClick one corner, then the opposite one.
Edit cornersESelect one area first. Drag a corner (it snaps); click a small mid-point to add a corner; right-click a corner to remove it.
MoveDrag the selected area.
SplitSSelect one area, then draw a line right across it (click the last point again to finish). Each part becomes an area; the largest keeps the code.
MergeMShift-click two or more areas, then Merge. The largest keeps its code; the others are archived.
Cut a holeHSelect one area, then draw the shape to take out of it (a school compound, say).
MeasureRClick points; double-click to finish. The length shows at the top (and the area, if you end where you started).
Generate…GThe automatic division (above). While it works, and when its drafts are ready (dashed on the map), a panel above the side tabs shows them with Accept all, Accept selected and Discard drafts.
Undo / RedoCtrl Z / Ctrl YStep back and forward through your changes (up to 100).
ArchiveDeleteArchive the selected areas (an unpublished one is simply removed).

Esc cancels a drawing and clears the selection; [ and ] step through the areas by code; the box at the top finds an area by code or name.

Properties

Needs properties.manage

Properties reach the register in four ways: captured in the field, registered here, imported from a spreadsheet, or drafted from the map scan. The Captured filter and the property’s Source say which.

  1. Open Properties and click Register property (or Add property in a project file).
  2. Enter a reference number that is unique across all projects, the project, the type and the location. Choose the LGA first; the ward and area lists then show only places inside it.
  3. Land area and GPS are optional: the boundary gives the land area once it is set.
  4. Click Register property.
Missing ward or area?

Only administrators can add places. Ask one to add it on the Locations page.

Many properties at once? Use Import; see Import and export.

The property file

The property boundary

On the Overview, click Edit boundary (or Set boundary in the checklist). Draw, type or upload the outline as for a project; the project boundary and neighbouring properties are shown for reference. Saving the boundary runs the spatial checks for that property.

Items: what is on the land

The Items tab lists the trees, crops, buildings and other things on the property. Valuations are built from it.

  1. Click Add item.
  2. From the dictionaries: search (for example mango, zinc roof, maize), pick the exact item and enter the quantity. Items carry no money: the valuer values each one on the compensation case.
  3. Custom item: for anything the dictionaries do not list, say what it is, give details, the quantity and the unit. Custom items are marked custom for review.
  4. Click Add item.

Field photos: checks and suggested items

Claimants

Link or register the claimant

Open the property. Its next-step box says Link the claimant.

  1. Click Link claimant and start typing a name, phone number or email — or an 11-digit NIN.
  2. If they are already registered (one claimant can hold several properties), click Link.
  3. Otherwise click Register a new claimant. The new claimant is linked straight away.

The claimant form takes personal details, NIN, ID and bank details. Enter names exactly as on the ID and bank account, because the checks compare them.

Identity and bank checks

Needs claimants.verify

On the claimant’s Overview tab, run the three checks before any money is approved. A verified bank account is part of complete claimant data, so a case cannot open without it.

CheckNeedsCompares
Bank accountBank and account numberThe account holder’s name with the claimant’s name
BVNBVN, bank and account numberWhether the BVN belongs to that account
NINThe claimant’s NINThe name on the NIN record with the claimant’s name

Data completeness

Every property and claimant shows a % complete and a checklist of what is in place and what is missing, with a button to fix each gap. A compensation case can only open when both the property and its claimant are at 100%.

Property checklistClaimant checklist
Project
Property type
GPS position or boundary
At least one photo
Boundary outline
LGA
Ward
Items listed (or confirmed none)
Front view photo
Claimant linked
Claimant link approved
Full name
Phone or NIN
Photo
NIN
Phone number
Bank, account name and account number
BVN
Bank account verified

Fill the gaps

Needs properties.manage or claimants.manage

Records › Fill the gaps lists every incomplete property (or, on the Claimants tab, claimant), with what each is missing. Filter by project, by what is missing, or by how it was captured.

  1. Click Fill in… on a row. The form asks only for what is missing: for a property the LGA and ward or a front view photo; for a claimant the NIN, phone, bank details, BVN or photo.
  2. Use the buttons for the rest: Set the boundary…, Add an item…, Nothing on this land, or a link to the property to link the claimant. For a claimant, leave Run the bank account check after saving ticked.
  3. Click Save. The field app gets the changes on its next sync.

Reading a document with AI

When document reading is switched on and your role has ai.documents: on a claimant’s Evidence tab, AI Read under a photo of an ID card, voter card, licence or land document shows what AI read beside the image. Compare each field with the document, tick the ones to use (full name, sex, address) — you can correct them first — and Use the ticked fields. Each is minuted “from document (AI)”. NIN, BVN, account and ID numbers are never read by AI: type them, and the usual checks verify them.

Conflicts

Needs conflicts.resolve

When field data or an import clashes with what is on record, the system does not guess: it raises a conflict for you to decide. Records › Conflicts lists the open ones.

ConflictRaised whenYou can
Possible duplicate claimantThe same NIN was given with another name; or a new claimant has the same phone and a similar name, the same BVN, or the same bank account as a registered oneMerge, Accept the new information, Not a conflict
Property claimed by another personThe field names a different claimant for a property that already has oneKeep existing, Accept the new information
Possible duplicate propertyTwo outlines cover mostly the same land (more than 60% overlap)Merge, Not a conflict
Field change clashes with an office changeThe field changed a record the office had also changed since the phone last syncedKeep existing, Accept the new information
Added after the cut-off dateA property captured, or a claimant registered, after the project’s census cut-off dateEligible after all, Not eligible (a note is required)
  1. Open a conflict. It shows why it was raised and the two records side by side (for properties, with their outlines on small maps).
  2. For Merge, choose which record to keep.
  3. Type a note (for example “confirmed by phone with the claimant”) and click the decision.
While a conflict is open

The property’s claimant link is on hold (the checklist shows Claimant link approved as missing) and no compensation case can open for that property or claimant.

Same person? (AI)

On a possible duplicate claimant, Explain with AI sets out the evidence for and against “same person”: name variants (Mohammed / Muhammad / Mamman), titles that come and go (Alhaji, Hajiya, Mallam), the same phone or address, linked properties — and suggests merge or keep both, with how sure it is. The identifiers are compared by the system: the AI only sees “same / different / missing”, never the numbers. It never merges anything: you decide.

Integrity

Needs claimants.view to see, conflicts.resolve to set aside

Work queues › Integrity lists patterns worth a second look, found by fixed rules each time the page opens:

A hint is not an accusation — a family may share a phone. Open the records from its links; then Set aside… with a note (minuted on the records), or put things right. With AI on, Why might this matter? explains the pattern and what to check.

Spatial flags

Needs spatial.resolve

Every time a boundary changes, and every night, the system checks the outlines. Problems appear on Records › Spatial flags, in the property’s Spatial checks box, and as a red layer on the project map.

FlagMeansBlocks a case?
Overlaps another propertyTwo property outlines overlap. Thin slivers from GPS error are ignored.Yes, when the overlap is over 20%; otherwise a warning
Project areas overlapTwo project boundaries overlap.Warning
Outside its projectThe property is partly or fully outside its project boundary — or, for a property known only by its GPS point, the point is outside.Yes, when the outline is fully outside; otherwise a warning
Cut by a sub-boundary edgeThe parcel is partly inside its sub-boundary and partly outside it.Warning
Sub-boundaries crossTwo active sub-boundaries overlap and not both allow it.Warning
Sub-boundary outside its projectMore than 1% of a sub-boundary is outside the project.Warning (on the sub-boundary)
GPS point inside another parcelA property with no outline yet has its GPS point inside another property’s outline: the same land twice, or a wrong point.Warning
Invalid outlineThe outline crosses itself or is otherwise not a valid shape.Yes
Weak GPS fixesThe corners were captured with poor GPS accuracy.Warning

Field surveys

Surveys are optional: a property with complete data does not need one before a case. Use them when you want a surveyor to visit a property already on record, for example to verify it.

Assign field surveys

Needs surveys.assign

Properties that already have an open or approved survey are skipped automatically. There are three ways:

The surveyor sees new assignments the next time their phone syncs, under Assigned surveys. The message after assigning says how many were assigned and how many skipped.

To take an assignment back before it is submitted, open the survey and click Withdraw assignment (twice).

Review a survey

Needs surveys.review

Submitted surveys appear on the dashboard and under Surveys with status Submitted. Open one and check the findings, the GPS position (opens OpenStreetMap) and the photos.

Compensation cases

Open a compensation case

Needs compensations.open

A case can only open when:

  1. Open the property. When its data is complete, the next-step box says Open a compensation case.
  2. Click Open case. If something is still missing, the dialog says Not ready for a compensation case and lists each problem with a Fix link.
  3. Choose the Compensation type: Cash (Bank Cheque) or 30% Land Allocation.
  4. Choose What the case pays for (the scope). The items that scope covers are ticked; untick or tick items as needed.
  5. Add a note if useful, then click Open case. The case gets its number, for example COMP-KSR-2026-01-0001.
ScopePays for
Whole property (land and everything on it)The land and every item listed on it
Land onlyThe land, no items
Buildings and structuresThe items from the Building classification dictionary
Economic trees and cropsThe items from the Economic trees and Crops dictionaries
Supplementary (top-up of an earlier case)A top-up of an earlier case on the same property. Choose the case it adds to under Adds to.

A property can have several cases. For example, the land as a 30% allocation and, at the same time, the buildings and trees in cash. To stop anything being paid twice:

For a property that already has a case, use Open another case in its next-step box.

Move a case through its steps

The case file shows the steps, the latest minute, what the next step needs, and What this case pays for: its items with their quantity, rate and amount. Each step can only be recorded by a role with its permission — by default the Valuer values, Finance approves and pays, and you can do any step.

Cash30% landRecorded by (default)
Pending valuationPending valuation— (case opened)
Valuated: every line valued on the Valuation tab (the assessed value is their total)Valuated: land area (30% calculated)Valuer, Officer
Approved: approved amount (a minute when it differs from the assessed value)ApprovedFinance, Officer
Cheque issued: number, bank, datePlot allocated: plot referenceFinance (cheque), Officer
Paid / collected: dateCompleted: dateFinance, Officer

Click the amber Mark as … button, fill in the figures, add an optional minute, and confirm. Attach the matching document on the Evidence tab (the right kind is suggested). Full details: Workflows and statuses.

Disputes and cancellation

Needs comp.hold

Messages to claimants

Needs messages.send

Send SMS, email or both to:

Placeholders are filled in for each claimant:

Open a sent message to see its deliveries. If some failed, Retry failed sends them again.

Import and export

Export needs data.export; import needs data.import

Every register can be exported. Projects, properties and claimants can be imported from a filled-in template. The Properties page also has Import boundaries (a GeoJSON, KML or zipped shapefile of outlines) and Import items (what is on each property). Nothing is saved until the file passes the check and you confirm.

Each problem is listed by spreadsheet row and column. Fix them in the file and choose it again.

Templates, matching rules and limits: Import and export reference.

Daily routine

  1. Dashboard: decide open conflicts, look at blocking spatial flags, review submitted surveys and look at disputed cases.
  2. Fill the gaps — complete the properties and claimants captured in the field or imported.
  3. Properties filtered by Claimant: missing — link claimants.
  4. Claimants filtered by Bank check: not verified — run the checks.
  5. Properties filtered by Data: complete — open cases for those that do not have one yet.
  6. Compensation cases with an amber dot — see what changed.