Admin Organisation Hierarchy Overview - hmislk/hmis GitHub Wiki
Organisation Hierarchy Overview
Overview
HMIS models your organisation as a hierarchy of entities. Understanding this structure is essential because it controls how users log in, how fees are applied, how items are mapped, and how reports are grouped. The hierarchy flows from top to bottom: Institution → Site → Department.
The Three Levels
Institution
An institution is the top-level organisation unit. In a typical hospital group, the main hospital is an institution. Branches, collecting centres, and subsidiary entities are also modelled as institutions, linked to a parent institution.
Examples: "City General Hospital", "Northside Branch", "Lab Collecting Centre 01"
Site
A site is a physical location within an institution. Sites are used when an institution operates across multiple buildings or campuses, and you want fees or departments to be differentiated by location.
Examples: "Main Building", "Annex Block", "Night Clinic"
Department
A department is the operational unit where work actually happens. Each department has a type (e.g. OPD, Pharmacy, Radiology, Ward) and is linked to an institution. Most configuration in HMIS — fees, item mappings, user login — is done at the department level.
Examples: "OPD Counter", "Radiology", "Maternity Ward", "Main Pharmacy"
Other Organisation Entities
In addition to the main hierarchy, the following support entities are managed under Manage Institutions:
| Entity | Purpose |
|---|---|
| Collecting Centre | External sample or referral point, separate from main branches |
| Area | Geographic zone or region, used for route planning |
| Bank / Bank Account | Bank and account details for payments and cheque printing |
| Banking Branch | Individual branch of a bank |
| Credit Company | Insurance companies and corporate credit clients |
| Route | Named delivery or collection circuit |
| Institution Branch | Sub-branches of an institution |
How the Hierarchy Affects the System
- User login: When a user logs in, they select their institution and department. Only departments assigned to them are shown.
- Item mapping: Services can be restricted to specific institutions or departments. A service that is not mapped to a department will not appear during billing there.
- Fee calculation: The system looks for department fees first, then site fees, then base fees — allowing different prices per location.
- Bill numbering: Bill number prefixes and sequences can be configured per institution.
- Reports: Most reports can be filtered by institution and/or department.
Navigating to Institution Management
- Click Administration in the main menu
- Click Manage Institutions
- The institution management hub opens
Required privilege: AdminInstitutions