Administrative Hierarchy

The administrative hierarchy structures the country's territorial divisions. It is used to organize data and filter information throughout the system.

Structure

Region
  └── Sector
        └── Locality (village / neighborhood / tabanca)

Each level is linked to the upper level, allowing cascading filters.

Regions

Access

Menu: Geographic Reference → Regions

Description

Regions are the highest administrative level. In the context of the PCH program, the intervention regions are typically Bafatá and Oio.

Displayed Columns

Column	Description
Name	Region name
Code	Abbreviated code (e.g., BA, OI)
Households	Number of registered households
GPS	Centroid coordinates

Statistics

• Total: Number of regions
• With GPS: Regions with coordinates
• Households: Total households in displayed regions

Actions

Action	Permission	Description
Add	regions.create	Create a new region
Edit	regions.edit	Update information
Delete	regions.delete	Delete a region

Form

Field	Type	Required	Description
Name	Text	Yes	Region name
Code	Text	No	Abbreviated code
Latitude	Number	No	Centroid latitude
Longitude	Number	No	Centroid longitude

---

Sectors

Access

Menu: Geographic Reference → Sectors

Description

Sectors are administrative subdivisions of regions. They group several localities.

Available Filters

Filter	Description
Region	Filter by parent region

Displayed Columns

Column	Description
Region	Parent region
Name	Sector name
Code	Sector code
Households	Number of households
GPS	Centroid coordinates

Statistics

• Total: Number of sectors
• With GPS: Sectors with coordinates
• Households: Total households

Actions

Action	Permission	Description
Add	secteurs.create	Create a new sector
Edit	secteurs.edit	Update information
Delete	secteurs.delete	Delete a sector

Form

Field	Type	Required	Description
Name	Text	Yes	Sector name
Code	Text	No	Sector code
Region	Selection	No	Parent region
Latitude	Number	No	Centroid latitude
Longitude	Number	No	Centroid longitude

---

Localities

Access

Menu: Geographic Reference → Localities

Description

Localities represent the finest level of the hierarchy: villages, neighborhoods, or tabancas. Households are linked at this level.

Available Filters

Filter	Description
Region	Filter by region
Sector	Filter by sector (cascade)

Cascading Filters

First select a region to see only that region's sectors in the second filter.

Locality Types

Type	Description
Village	Rural area
Neighborhood	Urban area
Tabanca	Traditional village (Guinea-Bissau)

Displayed Columns

Column	Description
Region	Region (via sector)
Sector	Parent sector
Name	Locality name
Code	Locality code
Type	Village / Neighborhood / Tabanca
Population	Estimated population
Households	Number of registered households
GPS	Coordinates

Statistics

• Total: Number of localities
• With GPS: Geolocated localities
• Households: Total households
• Population: Total estimated population

Actions

Action	Permission	Description
Add	localites.create	Create a new locality
Edit	localites.edit	Update information
Delete	localites.delete	Delete a locality

Form

Field	Type	Required	Description
Name	Text	Yes	Locality name
Code	Text	No	Locality code
Sector	Selection	Yes	Parent sector
Type	Selection	No	Village / Neighborhood / Tabanca
Population	Number	No	Estimated population
Households	Number	No	Estimated number of households
Latitude	Number	No	Latitude
Longitude	Number	No	Longitude

---

Best Practices

Name Consistency

• Use consistent capitalization (e.g., first letter uppercase)
• Avoid ambiguous abbreviations
• Prefer official names

Codes

Codes facilitate identification and import:

• Regions: 2 letters (BA, OI)
• Sectors: Region code + number (BA-01)
• Localities: Sector code + number (BA-01-001)

GPS Coordinates

For regions and sectors, use the centroid (geographic center). For localities, use the central point of the village/neighborhood.

Household Assignment

Each household is linked to:

• A locality (required for fine geolocation)
• A sector (via locality or directly)
• A region (via sector or directly)

---

Use Cases

Add a new locality

1. Go to Geographic Reference → Localities
2. Click Add
3. Enter the name and select the sector
4. Indicate the type (village/neighborhood/tabanca)
5. Add GPS coordinates if available
6. Click Save

Filter by geographic area

1. Use the Region filter to select a region
2. The Sector filter shows only that region's sectors
3. The table displays matching localities

Export data

1. Apply desired filters
2. Click the Export menu
3. Choose the format (CSV, Excel, PDF)
4. The file contains only filtered data

Correct GPS coordinates

1. Find the element in the table
2. Click the Edit icon (pencil)
3. Update latitude and/or longitude
4. Click Save

---

Pagination

Lists are paginated to improve performance:

• 50 elements per page by default
• Navigation with previous/next buttons
• Current page and total indicator

info

Search and filters apply to all data, not just the current page.