Geographic Reference

The Geographic Reference module allows you to manage all spatial data used in the Bemba system: administrative divisions, infrastructure, and points of interest.

Objectives

• Structure the administrative hierarchy (regions, sectors, localities)
• Map infrastructure (schools, health centers, water points)
• Geolocate entities with GPS coordinates
• Analyze territorial service coverage

Module Organization

The module is divided into two main categories:

Geographic Reference
├── Administrative hierarchy
│   ├── Regions
│   ├── Sectors
│   └── Localities (villages/neighborhoods)
│
└── Infrastructure
    ├── Health centers
    ├── Schools
    ├── Water points
    └── Police stations

Module Access

From the main menu

1. Click on Geographic Reference in the sidebar
2. Select the desired section

Required Permissions

Section	Read Permission	Write Permission
Regions	regions.view	regions.edit
Sectors	secteurs.view	secteurs.edit
Localities	localites.view	localites.edit
Health centers	centres_sante.view	centres_sante.edit
Schools	ecoles.view	ecoles.edit
Water points	points_eau.view	points_eau.edit
Police stations	polices.view	polices.edit

Common Interface

All geographic reference pages share a unified interface:

Header Bar

Element	Description
Title	Section name with subtitle
Export	Dropdown menu (CSV, Excel, PDF)
Add	Button to create a new element

Statistics

Each page displays indicators:

• Total: Number of elements
• With GPS: Geolocated elements
• Specific indicators: Depending on section

Filters

Depending on the section, cascading filters are available:

• Region → Sector → Locality
• Infrastructure type
• Status (functional/non-functional)

Search

A search field allows filtering by:

• Name
• Code
• Other text fields

Data Table

Feature	Description
Sorting	Click on column headers
Pagination	Navigation between pages
Actions	Edit / Delete each row
GPS	Badge with coordinates if available

Form (modal)

The creation/edit form appears in a modal window:

• Required fields marked with an asterisk (*)
• Automatic validation
• Cancel / Save buttons

GPS Coordinates

GPS coordinates are essential for:

• Visualization on the GIS map
• Distance calculation
• Coverage analysis

Format

Field	Format	Example
Latitude	Decimal	12.3456
Longitude	Decimal	-14.6789

Visual Indicator

In tables, a GPS badge indicates:

• With coordinates: Location icon + abbreviated coordinates
• Without coordinates: Dash (—)

Data Export

Three export formats are available:

Format	Description	Usage
CSV	Comma-separated values	Import into Excel/spreadsheet
Excel	Formatted .xlsx file	Reports and analyses
PDF	Printable document	Archiving and distribution

Integration with GIS Map

Geographic data feeds the GIS Map:

1. Regions/sectors define administrative boundaries
2. Infrastructure is displayed as markers
3. Localities allow household grouping

Next Sections

• Administrative hierarchy - Regions, sectors, localities
• Infrastructure - Health centers, schools, water points, police