Managing Staff Profiles
How to add staff members, assign roles, and manage your hospital team.
Managing Staff Profiles
Staff profiles represent all hospital personnel — doctors, nurses, administrators, lab technicians, and other roles. Each staff member is linked to an agent account in the system and can be assigned to centres and departments.
Staff Profile Fields
Field | Required | Description |
|---|---|---|
Staff Type | Yes | Role category validated against tenant-configured types (e.g., DOCTOR, NURSE, ADMIN) |
Employee Code | No | Internal employee identifier |
Designation | No | Job title (e.g., Senior Consultant, Chief Cardiologist) |
Registration Number | No | Professional license number (e.g., MCI-12345) |
Specialization | No | Clinical specialization (e.g., Cardiology, Neurology) |
Qualifications | No | List of qualifications (e.g., MBBS, MD, DM) |
Bio | No | Professional biography text |
Profile Photo URL | No | CDN link to profile image |
Signature URL | No | CDN link to digital signature (used in prescriptions) |
Joining Date | No | Date the staff member joined (epoch seconds) |
Primary Centre | No | Default centre assignment |
Primary Department | No | Default department assignment |
Metadata | No | Extensible JSON object for custom fields |
Staff Types
Staff types are tenant-configurable. Each tenant defines which staff types are valid (e.g., DOCTOR, NURSE, RECEPTIONIST, LAB_TECHNICIAN, PHARMACIST, ADMIN). When creating a staff profile, the type must match one of the tenant's configured types.
Each agent (user account) can have only one staff profile. The agent_id is unique across all staff profiles.
Doctor-Specific Configuration
Staff with type DOCTOR have an additional configuration block that controls appointment behavior:
Consultation Settings
- Slot Duration (minutes): the length of each appointment slot (e.g., 15, 20, 30)
- Buffer Between Slots (minutes): gap between consecutive slots for rest or preparation
- Consultation Fee (paise): the base fee for appointments with this doctor
- Max Patients Per Day: optional daily cap on the number of appointments
Overbooking Settings
- Allowed: whether overbooking is enabled for this doctor
- Percentage: by how much capacity can be exceeded (e.g., 20 means 20% more patients than slot capacity)
Walk-In Settings
- Enabled: whether the doctor accepts walk-in patients
- Reserve Strategy: how walk-in slots are reserved — NONE (no reservation), PERCENTAGE (reserve a percentage of slots), or FIXED_COUNT (reserve a fixed number of slots)
- Reserve Percentage/Count: the amount to reserve based on the strategy
- Daily Limit: optional maximum walk-in patients per day
- Serving Strategy: how walk-in patients are queued (e.g., FIFO)
- Notification Thresholds: queue position triggers for patient alerts (e.g., notify when 3 patients ahead)
Patient Type Duration
You can configure additional time for different patient types:
- NEW: extra minutes added for first-time patients (e.g., +10 minutes for history taking)
- EXISTING: extra minutes for returning patients
- FOLLOW_UP: extra minutes for follow-up visits
These values add to the base slot duration when generating slots for the respective patient type.
Approval Settings
- Required: whether appointments need doctor/admin approval before confirmation
- Timeout Hours: how long to wait for approval before taking the timeout action
- Timeout Action: what happens if approval is not given in time (e.g., auto-reject or auto-confirm)
Doctor Centre Assignments
Doctors are assigned to specific centres where they practice. Each assignment includes:
- Centre: which centre the doctor works at
- Department: which department within the centre
- Is Primary: marks the doctor's primary location
- Services: list of service IDs the doctor offers at this centre
- Room Number: optional assigned room or clinic number
- Validity Period: optional start and end dates for the assignment (epoch seconds). Outside this period, the doctor is not available at this centre
A doctor can be assigned to multiple centres. Each assignment can have different services and validity dates.
Deactivating an assignment removes the doctor from new bookings at that centre without cancelling existing appointments.
Listing and Filtering Staff
You can list staff profiles with the following filters:
- Staff Type: filter by role (e.g., only doctors)
- Centre: filter by centre assignment
- Active Status: show only active or inactive profiles
Results are paginated using cursor-based pagination with a configurable limit (default 20 per page).
Last updated on