Workflows and statuses

The fixed steps of each kind of compensation case, who records each step, what a record needs before a case can open, and what every status means. The step and status tables on this page are read from the running system, so they always match it.

From property to payment

  1. ProjectOfficer creates it and sets its boundary
  2. PropertyCaptured in the field, registered, imported or drafted from the map scan
  3. ClaimantFound by NIN or registered, then linked and checked
  4. CompleteGaps filled, conflicts decided, spatial flags fixed or accepted
  5. CaseOfficer opens one or more: cash or 30% land, each with a scope
  6. StepsValuer, Finance and Officer record each step

A field survey is optional: the office can assign one at any time, for example to verify a property, and an approved survey still marks the property as Surveyed.

Rules the system enforces:

Data completeness

Every property and claimant is checked against a list of rules. The share of rules met is its % complete; the rules not met are listed as Missing. It is worked out again on every save, from the office, the field app or an import.

Property ruleNeeded to save
ProjectAlways
Property typeAlways
GPS position or boundaryIn the field app
At least one photoIn the field app
Boundary outline—
LGA— (the office form and imports ask for it)
Ward—
Items listed (or confirmed none)—
Front view photo—
Claimant linked—
Claimant link approved (no conflict holding it)—
Claimant ruleNeeded to save
Full nameAlways
Phone or NINIn the field app
PhotoIn the field app
NIN—
Phone number—
Bank, account name and account number—
BVN—
Bank account verified—

Every rule counts towards 100%, and a case can only open on complete records. Incomplete records are listed on Records › Fill the gaps.

Case scopes and case numbers

Each case has a number made from its project code, such as COMP-KSR-2026-01-0001, and a scope: what it pays for.

ScopePays for
Whole property (land and everything on it)The land and every item listed on the property
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

For example, a claimant can take the land as a 30% allocation (a Land only case) and, at the same time, the buildings and trees in cash (a Buildings and structures case and an Economic trees and crops case, or one cash case with all those items ticked).

Cash compensation (bank cheque)

When a case opens, each of its lines — every property item, the land (for cases that pay for it) — starts with today’s dictionary rate as a guide and no value. The Valuer gives each line their own figure on the case’s Valuation tab: a rate (× the quantity, which they may correct) or a lump amount; they can add other amounts such as a disturbance allowance, and an adjustment with its reason. No reason is needed for a figure that differs from the guide.

30% land allocation

The land area acquired is taken from the property’s boundary (or, without one, the approved survey or the recorded land area). When the case is valuated, 30% of it is calculated and recorded as the area to allocate back to the claimant.

Side states: disputed and cancelled

StatusHow it happensWhat it means
Disputed (on hold)Dispute, with a reason (comp.hold)Paused at its current step. Nobody can advance it. Resolve & resume returns it to the step it was on.
CancelledCancel case, with a reason and a second click (comp.hold)Closed for good. Its land and items are freed, so a new case can be opened for them.

Property stages

A property’s stage is never typed in; it is worked out from its claimant, survey and case.

Survey statuses

In the field app, a survey saved on the phone shows Waiting to sync until it uploads, or Upload problem if the office refused it. Properties captured under Field capture show Not synced, Photos waiting, Sync problem or Changed in office; see the Field Surveyor guide.

Identity and bank check results

Project statuses

A project can only become Active once its boundary is set. Otherwise project status is for information and filtering; it does not block any work.

Conflict statuses

Conflicts are raised by field sync and imports when new information clashes with what is on record. See the Compensation Officer guide.

Spatial flag statuses

Spatial flags are found on every boundary change and every night. See Spatial flags.

Background job statuses

Staff statuses

Message statuses

Each recipient also has a status: Queued, Sent or Failed (with the reason). Failed deliveries can be retried from the message.

Limits