Admin Module Overview - hmislk/hmis GitHub Wiki
Administration Module Overview
Overview
The Administration module is the central control panel for setting up and managing all aspects of the HMIS system. It is used by system administrators to create users, define the organisation structure, configure services and pricing, and control access. Most functions in this module affect the entire system and should be handled with care.
Who Can Access Administration
The Administration menu is only visible to users who have the Admin privilege. Individual sub-sections have their own privileges — a user may have access to some areas (for example, managing users) but not others (for example, managing pricing).
Navigating to Administration
Click Administration in the top navigation menu. A dropdown will appear with the following sections, each visible only if you have the relevant privilege:
| Menu Item | What It Opens | Required Privilege |
|---|---|---|
| Manage Users | Create and manage system user accounts | AdminManagingUsers |
| Manage Institutions | Manage hospitals, branches, departments, banks, credit companies | AdminInstitutions |
| Manage Staff | Manage doctors, consultants, and all staff members | AdminStaff |
| Manage HR | Human resources administration | HrAdmin |
| Manage Lab Services | Laboratory investigation master data | LabAdiministrator |
| Manage EMR | Electronic Medical Record form templates | AdminItems |
| Manage Items | OPD services, item categories, packages | AdminItems |
| Manage Inpatient Services | Inward/IPD service configuration | InwardAdministration |
| Pharmaceutical Management | Pharmacy item master data | PharmacyAdministration |
| Manage Store | Store/inventory administration | StoreAdministration |
| Manage Pricing | All fee configuration | AdminPrices |
| Membership Administration | Membership schemes and benefits | MembershipAdministration |
| Manage Metadata | Data administration and schema utilities | AdminItems |
How Access Control Works
Every page checks your privilege before displaying its content. If you navigate to a page without the required privilege, you will see a "Not Authorised" message. Privileges are granted either through your User Role (which applies to all your departments) or as User-specific Privileges (which can be set per department).
Key Concepts
- Institution — The top-level organisation unit (e.g. a hospital or company). Most configuration cascades from institution down.
- Department — A functional unit within an institution (e.g. OPD, Pharmacy, Radiology). Fee and item visibility rules are often set at department level.
- Site — A physical location within an institution. Used to apply site-specific fees.
- User Role — A named set of privileges that can be assigned to many users at once.
- Privilege — An individual permission that controls access to one specific function.
- ConfigOption — A named on/off switch or value that changes how the system behaves at application, institution, department, or user level.
Typical Administration Tasks
- First-time setup: Create institution → Create departments → Create user roles → Create users → Map services to departments → Configure fees
- Ongoing: Add new staff, adjust fees, enable/disable features via configuration options, review audit logs
- Access control: Assign roles to new staff, add or remove specific privileges as responsibilities change