📋 Features Guide

Patient Management

The Patient Management module is the heart of HealthCIP. From registration to complete medical history tracking, everything revolves around the patient record.

Registering a New Patient

1. Navigate to Patient > Management & Booking
2. Click Register New Patient
3. Fill in patient details: name, phone number, gender, date of birth, address
4. The system validates phone numbers using Google's libphonenumber library
5. Save — the patient is now registered and can be searched by name or phone

Patient Record Details

Each patient record contains:

• Demographics: Name, age, gender, contact, address
• Medical History: Past consultations, prescriptions, diagnoses
• Allergies: Documented allergic reactions
• Investigations: Lab reports and test results across visits
• Treatment Plans: Current and past treatment plans
• Appointments: Complete appointment history

Searching for Patients

Use the search bar on the Patient Management page. You can search by:

• Patient name (partial match)
• Phone number
• Patient ID / UUID

Doctor Management

Adding a Doctor

1. Go to Doctor > Manage
2. Click Add Doctor
3. Enter doctor details: name, specialization, contact, department
4. Set up Consultation Fee Structure — different fees for different visit types
5. Assign the doctor to a department
6. Save — the doctor now appears in appointment booking and queue systems

Consultation Fee Structure

Each doctor can have multiple fee tiers based on visit type. You can manage these from the doctor's detail view. The system supports different fees for first visits, follow-ups, and emergency consultations.

Appointments & Booking

Booking an Appointment

1. Navigate to Patient > Management & Booking
2. Search for and select the patient
3. Select the doctor from the list
4. Choose appointment date and time
5. Add any notes (optional)
6. Save — the appointment appears on the doctor's schedule and the queue system

Doctor's Appointment List

Doctors can view their daily schedule from Doctor > Appointments. The list shows:

• Patient name and details
• Appointment time
• Visit type (first visit, follow-up)
• Status (pending, in consultation, completed)
• Click on any appointment to start the Consultation

Consultation & Prescriptions

Starting a Consultation

1. From the appointments list, click on an appointment row
2. The Consultation view opens with the patient's history on the side
3. Record Symptoms from the master symptom list
4. Enter Diagnosis / Inference in the clinical notes
5. Order Investigations (lab tests) if needed
6. Use the AI Treatment Plan to auto-generate a plan, or create one manually

Creating a Prescription

1. Inside the consultation, go to the Prescription section
2. Add medicines from the master medicine list (search by name or drug family)
3. Set dosage, interval, duration, and timing (before/after meals)
4. Add remarks or special instructions
5. Save the prescription — it becomes part of the patient's permanent record
6. Click Print to generate a print-friendly view

Consultation Chart

Each consultation creates a permanent Consultation Chart that records:

• Date and time of consultation
• Doctor who treated the patient
• Symptoms recorded
• Diagnosis / clinical inference
• Prescriptions issued
• Investigations ordered
• Treatment plan

Patient Queue System

The queue system manages patient flow through the clinic or hospital.

How the Queue Works

1. When a patient arrives for their appointment, the receptionist marks them as checked in
2. The patient appears in the Doctor's Queue
3. Doctors can see their queue from Doctor > Queue
4. When the doctor is ready, they call the next patient from the queue
5. A Display Screen can show the live queue in the waiting area

Queue Display Screen

Log in with ROLE_DISPLAY to show the queue on a waiting-room TV or monitor. The display auto-updates and can be filtered by doctor.

Lab & Investigations

Ordering Investigations

During a consultation, the doctor can order lab investigations. These appear in the Lab Technician's view.

Lab Technician Workflow

1. Log in with ROLE_LAB
2. Navigate to Lab > Reports
3. View pending investigations ordered by doctors
4. Enter results for each investigation
5. Upload report files (PDF, images) if applicable
6. Mark the investigation as complete
7. The results are immediately visible to the doctor in the patient's record

Supported investigation types include:

• Blood tests (CBC, lipid profile, etc.)
• Temperature readings
• Blood pressure monitoring
• X-Ray and imaging reports
• Custom investigations defined by the organization

Master Data Management

Master data forms the backbone of HealthCIP's clinical features. Access it from the Master menu in the sidebar.

Master Type	Description	Example Entries
Drug Family	Classification of medicines	Antibiotics, Analgesics, Antihypertensives
Medicine	Individual medicine records with drug family association	Paracetamol 500mg, Amoxicillin 250mg
Symptom	Standard symptom list	Fever, Headache, Cough, Nausea
Department	Hospital departments	Cardiology, Pediatrics, Orthopedics
Dosage	Medicine strength/amount	500mg, 250mg, 1 Tablet, 5ml
Duration	Treatment duration	5 Days, 7 Days, 2 Weeks, 1 Month
Interval	Dosing frequency	1-0-1, Every 8 Hours, Twice Daily

Master data can be pre-loaded from seed files during setup, and can be customized at both the organization level and the system-wide level (for multi-org deployments).

Chat Feature

HealthCIP includes an AI-powered chat feature accessible from Doctor > Chat. This allows doctors to:

• Ask clinical questions to the AI assistant
• Get quick references on medicine information
• Discuss treatment approaches with the AI (note: always verify with clinical judgment)

The chat maintains context within a session, allowing follow-up questions without repeating context.

Dashboard & Analytics

The Dashboard provides a real-time overview of your healthcare facility:

• Today's Appointments: Count and status breakdown
• Patient Queue: Current waiting count by doctor
• Recent Activity: Latest consultations and registrations
• Charts: Weekly/daily trends in patient volume
• Widgets: Customizable KPI widgets

The dashboard is role-aware — doctors see clinical metrics, while admins see operational and financial data.