Skip to main content

Administrator Guide

As an administrator, you have full access to all system features including staff management, system configuration, reports, and complete CRUD permissions across all modules.

Access Level

Administrators can:
  • Manage all staff members (doctors and receptionists)
  • Access all patient records
  • Create and manage consultations
  • View appointments across all doctors
  • Access financial reports and analytics
  • Process payments
  • Configure system settings
  • Delete any records (exclusive permission)

Staff Management

Manage doctors and receptionists in your organization.

Creating Staff Members

1

Navigate to Staff Management

Click Staff in the main navigation menu to access /staffYou’ll see a list of all doctors and receptionists with their assigned roles.
2

Add New Staff Member

Click the Create Staff button in the top rightScreenshot: Staff listing page with “Create Staff” button highlighted
3

Fill in Staff Details

Complete the registration form with:
  • Name: Full name of the staff member
  • Email: Must be unique in the system
  • Password: Minimum 8 characters (must be confirmed)
  • Role: Select either Doctor or Receptionist
Screenshot: Staff creation form showing all fields
4

Submit and Verify

Click Create to register the staff memberYou’ll be redirected back to the staff list with a success message confirming registration.

Editing Staff Members

1

Locate the Staff Member

From the staff list at /staff, find the staff member you want to edit
2

Open Edit Form

Click the Edit button next to their name
You cannot edit administrator accounts through this interface
3

Update Information

Modify any of the following:
  • Name
  • Email address
  • Password (leave blank to keep current password)
  • Role (switch between doctor and receptionist)
4

Save Changes

Click Update to save the changesThe staff member’s role will be synchronized automatically.

Deleting Staff Members

Deleting a staff member is permanent and cannot be undone. Ensure you have proper backups before deletion.
1

Find the Staff Member

Navigate to /staff and locate the staff member
2

Delete Action

Click the Delete button next to their name
3

Confirm Deletion

Confirm the deletion when prompted
Administrator accounts cannot be deleted through this interface

Patient Management

Administrators have full CRUD access to patient records.

Registering New Patients

1

Access Patient Module

Navigate to Patients from the main menu
2

Create New Patient

Click New Patient buttonComplete the patient registration form with:
  • Full name
  • Document ID (national ID or similar)
  • Birth date
  • Gender
  • Contact information (phone, email)
  • Address
  • Medical history (antecedents, allergies, chronic diseases)
  • Current medications
3

Submit Registration

Click Save to create the patient record

Searching Patients

Use the search bar on the patients page to search by:
  • Full name
  • Document ID
  • Phone number
  • Email address
Screenshot: Patient search interface with search results

Viewing Patient Records

Click on any patient name to view their complete medical record including:
  • Personal information
  • Consultation history with doctors
  • Uploaded attachments and documents
  • Prescriptions
  • Payment history

Deleting Patients

Only administrators can delete patient records. This action is irreversible.
From the patient detail page, click the Delete button and confirm the action.

Appointment Management

View and manage appointments across all doctors.

Viewing All Appointments

1

Navigate to Appointments

Click Appointments in the main navigation
2

Filter Appointments

Use the filters to narrow down appointments:
  • Doctor: Filter by specific doctor
  • Date: Filter by appointment date
Screenshot: Appointment listing with filter options

Creating Appointments

1

Start New Appointment

Click New Appointment from the appointments page
2

Select Patient and Doctor

  • Choose the patient from the dropdown
  • Select the doctor
3

Set Time

  • Pick the start date and time
  • Set the end time (appointments are typically 30 minutes)
  • Add appointment reason and any notes
4

Confirm Booking

Click Schedule Appointment to create it

Updating Appointment Status

Update appointment status between:
  • Scheduled: Initial state
  • Confirmed: Patient confirmed attendance
  • Completed: Patient attended and was seen
  • Cancelled: Appointment was cancelled
  • No Show: Patient did not attend

Consultation Access

Administrators can create and view all consultations.

Creating Consultations

1

Initiate Consultation

From a patient’s record or appointment, click New Consultation
2

Record Vital Signs

Enter the patient’s vital signs:
  • Weight (kg)
  • Height (cm)
  • Temperature (°C)
  • Blood Pressure (systolic/diastolic)
  • Heart Rate (bpm)
  • Respiratory Rate
  • Oxygen Saturation (%)
3

Document Clinical Information

  • Reason for visit
  • Clinical findings and examination notes
  • Diagnosis
  • Treatment plan
4

Add Prescription (Optional)

If prescribing medication:
  • Add each medication with dosage
  • Specify frequency and duration
  • Include special instructions
5

Record Payment (Optional)

If payment is collected during consultation:
  • Enter payment amount
  • Select payment method (cash, card, transfer)
6

Save Consultation

Click Save Consultation to complete the record

Financial Reports

Access comprehensive financial analytics and reports.

Accessing Reports

1

Navigate to Reports

Click Reports in the main navigation to access /reports
Only administrators have access to this section
2

View Dashboard Metrics

The reports dashboard displays:
  • Total Revenue (Month): Sum of all paid invoices this month
  • Payments Today: Number of payments received today
  • Revenue Today: Total amount collected today
  • Pending Amount: Outstanding unpaid invoices
Screenshot: Reports dashboard showing all key metrics
3

Analyze Revenue Trends

View the Daily Revenue Chart showing payment trends over the last 30 daysThis helps identify:
  • Peak revenue days
  • Revenue patterns
  • Month-over-month comparisons
4

Review Payment Methods

Check the Revenue by Payment Method breakdown showing:
  • Cash payments
  • Card payments
  • Bank transfers
Use this data for reconciliation and payment processing analysis.

Payment Processing

Manage patient payments and billing.

Viewing Payment History

Navigate to Payments to see:
  • All payment transactions
  • Associated patient names
  • Related consultations
  • Payment methods and status

Recording Payments

1

Access Payment Module

Navigate to Payments from the main menu
2

Create New Payment

Click New Payment button
3

Enter Payment Details

  • Select the patient
  • Link to consultation (if applicable)
  • Enter payment amount
  • Choose payment method (cash, card, transfer)
  • Set status (paid, pending, cancelled)
  • Add any notes
4

Submit Payment

Click Save to record the payment

Searching Payments

Use the search bar to find payments by patient name.

System Configuration

Profile Settings

Manage your administrator account:
  • Update your name and email
  • Change password
  • Enable two-factor authentication for enhanced security
Access via the profile icon in the top right navigation.

Two-Factor Authentication

1

Enable 2FA

Go to Settings > Two-Factor Authentication
2

Scan QR Code

Use an authenticator app (Google Authenticator, Authy) to scan the QR code
3

Verify Setup

Enter the 6-digit code from your authenticator app to confirm
4

Save Recovery Codes

Store the recovery codes in a safe place
Recovery codes are needed if you lose access to your authenticator device

Best Practices

Regular Backups

Ensure regular database backups are configured and tested for disaster recovery

Staff Training

Provide proper training to all staff members on their respective roles and system usage

Access Control

Regularly review staff access levels and remove accounts for departed employees

Data Privacy

Follow HIPAA and local regulations for patient data protection and privacy

Troubleshooting

Common Issues

Ensure the staff member is not an administrator. Admin accounts cannot be deleted through the staff management interface.
Verify you are logged in with an administrator account. Reports are only accessible to admins.
Check if the patient record was soft-deleted. Contact technical support to restore if needed.

Need Help?

If you encounter issues not covered in this guide, contact your system administrator or technical support team.

Build docs developers (and LLMs) love