Appearance
Locations
The Locations module manages the geographic hierarchy used throughout Femina OS to assign clubs, plan distributions, and filter reporting.
Overview
All location-based records in the system reference this module. Locations follow Tanzania's administrative hierarchy: Zone → Region → District → Council → Ward. This structure underpins club assignment, filtering across all modules, and geographic reporting.
Key Concepts
- Zone — the top-level grouping (e.g. Lake Zone, Eastern Zone)
- Region — an administrative region within a zone
- District — a subdivision within a region
- Council — a subdivision within a district
- Ward — the lowest-level unit, where clubs are physically located
User Roles & Permissions
| Role | Locations Access |
|---|---|
| Root | All (create, view, edit, delete) |
| All other roles | — |
Only Root users can manage the location hierarchy. All other roles use locations as read-only reference data when creating or filtering clubs.
Features
Location List
A tabbed view of locations by level (Zone, Region, District, Council, Ward). Each tab shows a searchable table of entries at that level with their parent location.
Search
Find any location by name across all levels using the search box.
Workflows
Adding a Location
- Navigate to Locations in the sidebar.
- Select the tab for the level you want to add (e.g. Ward).
- Click + Add.
- Enter the name and select the parent location (e.g. the council this ward belongs to).
- Click Save.
Editing a Location Name
- Navigate to Locations and find the entry.
- Click the row to open its details.
- Click Edit, update the name, and click Save.
Viewing Child Locations
- Navigate to Locations and click any entry.
- The detail panel shows which child locations (e.g. wards within a district) are linked to it.
FAQ
Can a ward belong to more than one district? No. Each location has exactly one parent in the hierarchy.
Can I delete a location that has clubs assigned to it? No. You must reassign or deactivate any clubs linked to the location before it can be deleted.
Who can change the location hierarchy? Only Root users. If you need a new zone, region, district, council, or ward added, contact your system administrator.