Administrator guide

Administrators look after who can use the system and what they can do, the list of places, the dictionaries (choice lists and compensation rates), the background jobs, and the email and SMS settings. The Administrator role always has every permission, so you can also do everything in the Compensation Officer guide.

Default role: Administrator Key permissions: users.manage roles.manage locations.manage dictionaries.manage jobs.manage settings.manage

First-day checklist

On a new installation the server creates the default roles, the 23 Kaduna LGAs with their 255 wards, and one administrator account (staff ID KADGIS-0001) from the settings your IT operator chose.

  1. Change the administrator password straight away under My account, and put your own name on the account.
  2. Check delivery settings (Messages › Delivery settings) so invitations and SMS actually go out. See below.
  3. Add areas under the wards where projects run (Locations).
  4. Replace the sample rates for economic trees, crops and buildings with the approved KADGIS rate schedule (Dictionaries), and check the choice lists.
  5. Review the roles. The defaults suit most offices; adjust them before inviting people.
  6. Invite staff, at least one Compensation Officer and the field surveyors.

Locations

Needs locations.manage

Places are kept in three levels: LGA › Ward › Area. Properties and searches use them, and the field app filters assignments by ward. The 23 LGAs are fixed and their 255 wards, from INEC's directory, are loaded for you; you add areas.

  1. Open Locations and click an LGA. Its wards appear in the middle column.
  2. Type a ward name in the box at the bottom of the column and click Add.
  3. Click a ward to see and add its areas.
  4. Point at a name to rename (pencil) or delete (bin, click twice). A place used by any property or project cannot be deleted.

To add many at once, use Import with the wards-and-areas template. Export downloads every LGA, ward and area. See Import and export.

Staff

Viewing needs users.view; changes need users.manage

Each person has a status:

StatusMeaning
InvitedInvited but has not set a password yet. Cannot log in.
ActiveCan log in and work.
DisabledAccess withdrawn. Their records and minutes stay. Can be enabled again.

Invite a staff member

  1. On Staff, click Invite staff.
  2. Enter their full name, work email, phone (optional) and staff ID, and choose their role.
  3. Click Send invitation.

The next screen shows the one-time link. If email is set up it has been sent too; if not, copy the link and send it yourself. It works once and for 7 days.

Rules

Manage a staff record

Click a person to open their record.

When someone leaves

Disable them rather than changing their email: their name stays on every minute they wrote. If they were a field surveyor, first reassign their open surveys (an officer can withdraw an assignment and assign it again).

Roles

Needs roles.manage

A role is a named set of permissions. Changes apply to everyone with the role at their next request — no need for them to log out.

Create or edit a role

  1. Click New role, or click an existing role.
  2. Give it a name and description.
  3. Tick the permissions. Ticking a group heading ticks the whole group.
  4. Click Save role.

Every permission is listed in Roles and permissions.

Dictionaries

Needs dictionaries.manage

Administration › Dictionaries holds the lists the field and office forms use. There are two kinds:

KindBuilt-in dictionariesUsed for
Choice listsProperty types, Land use, Structure types, Structure condition, Photo labels, Document categories, ID types, BanksThe options offered in dropdowns
Priced itemsEconomic trees, Crops, Building classificationWhat is found on a property and what it is worth: valuations are built from these rates

Click a dictionary to open it. The Items tab lists its items in a tree, with their code, unit and rate, and how many properties use each one. Minutes records every change.

Edit a list

Priced items and rates

Priced dictionaries are trees. Only the items at the bottom of the tree — with nothing under them — can be put on a property, so those carry a unit and a rate:

DictionaryTreeRate
Economic treesTree type › size: seedling, young, mature or oldPer tree
CropsCropPer hectare
Building classificationClass › component › typePer m², per metre or each
The seeded rates are samples

A new installation starts with sample rates for testing. Replace them with the approved KADGIS compensation rate schedule before any real valuation.

  1. Click Rate… on the item.
  2. Enter the new rate (₦), the date it is in force from, and a reason or reference (for example the approval of the rate schedule).
  3. Click Save rate.

Export and import a dictionary

In a dictionary, Export downloads its items and Import loads them from Excel or CSV (also needs data.export or data.import). The columns are Code, Label, Parent code, Unit, Rate, Active and Order. Existing codes are updated and new codes are added; a different rate starts a new rate from today. Export first to see the codes. See Import and export.

Tags

Administration → Tags (permission Define tags) holds the labels staff put on records: for example a Priority group with High and Low, a Risk group, or a single Revisit tag for the field teams.

Staff with Add and remove tags tag records from the record's file (the chips under its heading, + Tag) or many at once (tick rows in a register, then Tags…). Registers filter by tag, the find box finds #tag, project maps colour parcels by tag, messages can go to claimants with a tag, and exports and imports carry a Tags column. Every change is minuted on the record.

Rules

Needs settings.manage

Administration › Rules holds the checks that keep one person from doing everything alone. They start off; each applies from the next step recorded, and every change is minuted on your staff record.

The census cut-off date is set on each project (Officer › The census cut-off date). Work queues › Integrity still lists a valuation approved by its own valuer, for anything recorded before the rule was on.

AI suggestions

Needs ai.manage

Administration › AI controls where the system may ask a language model for a suggestion. AI only suggests: staff accept, edit or dismiss each one, and accepted ones are minuted. See AI suggestions for what each feature sends and the data-protection checklist to complete first.

  1. The IT operator sets AI_ENABLED=true and the keys (OPENROUTER_API_KEY, OLLAMA_API_KEY) on the server, and default models (AI_OPENROUTER_MODEL, AI_OLLAMA_MODEL). Until then the page says AI is not set up.
  2. Under Providers, run a Test call for each provider with the model you mean to use: it reports OK and the time, or the provider’s error.
  3. Under All features, set the daily and monthly caps (USD), and tick AI suggestions on. Leave Read ID cards and land documents off unless the data-protection checklist covers it.
  4. Switch on the features you want, one by one. Models sets a feature’s models in fallback order (up to three) and its own caps; empty uses the server’s defaults.

Reports and overnight reports

Needs reports.view to write reports; reports.manage to schedule them

Outreach › Reports writes progress, management and RAP status reports from the register’s figures (see Finance › Reports for writing, checking and printing one). Under Overnight reports:

Background jobs

Needs jobs.manage

Administration › Background jobs lists the work the server does in the background:

JobQueued when
Project map scanA project boundary is saved, or Run again is clicked on its Map tab. It keeps roads, rivers, water, landuse, buildings and power lines as shapes; a project over the scan limit (SCAN_MAX_AREA_KM2, 150 km² by default) fails at once, without retries
Spatial check: propertyA property boundary changes
Spatial check: projectA project boundary changes, or Check again is clicked on its Map tab. All the project’s properties are checked together in a few seconds, also those known only by a GPS point
Nightly spatial re-checkEvery night, over all boundaries
Sub-boundaries: refreshA sub-boundary’s outline, status or overlap setting changes, or the project boundary changes: colours, crossings, and which properties lie in which area
Sub-boundaries: membershipA property boundary changes in a project that has sub-boundaries
Sub-boundaries: automatic divisionGenerate automatically… on a project’s Sub-boundaries tab. It is not retried: a failure says why on the tab
Nightly sub-boundary re-checkEvery night, for every project with sub-boundaries
AI log: clear old debug textDaily: removes the troubleshooting text of AI calls older than 7 days (only kept when that switch is on)

Email and SMS delivery settings

Needs settings.manage

Messages › Delivery settings shows which service each part of the system is using. Your IT operator sets them on the server; here you can check them.

ShowsMeaning
smtp / termiiEmail / SMS really goes out.
console · not sendingNothing goes out: messages are only printed in the server log. Invitations and reset links must be passed on by hand. Ask your IT operator to configure the service.
test mode · not sending (identity & bank checks)Bank, BVN and NIN checks use the built-in test rules, not Monnify. Results are not real.

The outbox

Messages › Outbox lists every email and SMS the system has sent — invitations, password resets, claimant messages and tests — with its status and the provider’s reference. Click one to read it, including any link. It is only available when the IT operator has turned it on (OUTBOX_VIEWER_ENABLED).

Privacy

The outbox shows invitation and reset links. Anyone who can see it could use a link that has not been used yet, so only give settings.manage to people who need it.

Good habits