flowchart TD
    Start([Patient Enters Clinic / Portal]) --> RegCheck{Already Registered?}
    
    RegCheck -- No --> Register[Patient Registration / Reception Walk-in]
    RegCheck -- Yes --> Login[Login / Identity Verification]
    Register --> Login
    
    Login --> ServiceChoice{Required Service?}
    
    %% Outpatient Flow
    ServiceChoice -- Outpatient Consultation --> BookAppt[Book Appointment with Doctor]
    BookAppt --> ApptPending[Status: PENDING]
    ApptPending --> ConfirmAppt[Reception/Doctor Confirms: CONFIRMED]
    ConfirmAppt --> DoctorConsult[Doctor Consultation & Examination]
    DoctorConsult --> ApptComplete[Appointment Marked COMPLETED]
    DoctorConsult --> CreateEMR[Create Medical Record & Prescriptions]
    CreateEMR --> NeedAdmission{Needs Admission / Surgery?}
    
    %% Inpatient Flow
    NeedAdmission -- Yes --> CheckBed[Check Available Ward & Room]
    ServiceChoice -- Direct Inpatient Admission --> CheckBed
    
    CheckBed --> BedAvailable{Bed Available?}
    BedAvailable -- No --> Waitlist[Waitlist / Transfer / Select Alt Ward]
    Waitlist --> CheckBed
    BedAvailable -- Yes --> CreateAdmission[Process Admission: Room Marked OCCUPIED]
    CreateAdmission --> InpatientCare[Inpatient Treatment & Rounds]
    InpatientCare --> DischargeDecision{Ready for Discharge?}
    DischargeDecision -- No --> InpatientCare
    DischargeDecision -- Yes --> DischargeSummary[Author Discharge Summary & Mark Room AVAILABLE]
    
    %% Billing Flow
    NeedAdmission -- No --> GenBill[Generate Invoice / Bill]
    DischargeSummary --> GenBill
    
    GenBill --> AddBillItems[Calculate Consult, Meds, Labs & Room Fees]
    AddBillItems --> BillIssued[Invoice Status: UNPAID]
    BillIssued --> ProcessPayment[Patient Makes Payment: Cash/Card/Insurance/Bank]
    ProcessPayment --> PaidCheck{Full Amount Paid?}
    PaidCheck -- Partial --> PartialPaid[Status: PARTIALLY_PAID]
    PartialPaid --> ProcessPayment
    PaidCheck -- Full --> FullPaid[Status: PAID]
    
    FullPaid --> Finish([Patient Discharged / Process Concluded])
                

flowchart TD
    UserStart([User Enters System]) --> AuthCheck{Authenticated?}
    
    AuthCheck -- No --> LoginPage[Display Login Screen]
    LoginPage --> RoleSelection{Account Exists?}
    RoleSelection -- No --> SelfRegister[Patient Self-Registration /register/]
    SelfRegister --> LoginPage
    RoleSelection -- Yes --> SubmitAuth[Submit Username & Password]
    SubmitAuth --> ValidateAuth{Credentials Valid?}
    ValidateAuth -- No --> AuthError[Display Error Message]
    AuthError --> LoginPage
    ValidateAuth -- Yes --> SessionCreated[Create Authenticated Session]
    
    AuthCheck -- Yes --> SessionCreated
    SessionCreated --> CheckRole{User Role}
    
    CheckRole -- ADMIN --> AdminDash[Admin Dashboard\n- System Statistics\n- Full Clinic & Patient Access\n- Room & Ward Overview\n- Revenue & Financial Reports]
    
    CheckRole -- DOCTOR --> DoctorDash[Doctor Dashboard\n- Daily Appointment Queue\n- Patient Search & EHR View\n- Create Diagnoses & Prescriptions\n- Patient Admission Records]
    
    CheckRole -- RECEPTIONIST --> RecepDash[Receptionist Dashboard\n- Walk-in Registration\n- Appointment Scheduling\n- Room Admissions & Discharges\n- Invoice Generation & Billing]
    
    CheckRole -- PATIENT --> PatientDash[Patient Dashboard\n- My Appointments\n- My Prescriptions & Medical Records\n- My Bills & Payment History\n- Profile Settings]
                

flowchart TD
    StartReg([Initiate Patient Onboarding]) --> Channel{Channel}
    
    %% Self Registration
    Channel -- Online Self-Service --> OnlineForm[Fill Registration Form /register/\nUsername, Password, Demographics]
    OnlineForm --> ValidateUserForm{Form Valid?}
    ValidateUserForm -- No --> ShowUserErrors[Show Validation Errors]
    ShowUserErrors --> OnlineForm
    ValidateUserForm -- Yes --> CreateUserObj[Create accounts.User: Role = PATIENT]
    CreateUserObj --> AutoCreatePatient[Auto-create clinic.Patient Profile]
    
    %% Staff Assisted
    Channel -- Reception Walk-in --> StaffForm[Receptionist Fills /clinic/patients/add/\nFull Demographics & Emergency Contact]
    StaffForm --> ValidateStaffForm{Form Valid?}
    ValidateStaffForm -- No --> ShowStaffErrors[Show Validation Errors]
    ShowStaffErrors --> StaffForm
    ValidateStaffForm -- Yes --> CreateStaffUser[Create User & Patient simultaneously]
    
    AutoCreatePatient --> ProfileReady[Patient Profile Active]
    CreateStaffUser --> ProfileReady
    
    ProfileReady --> EditProfile{Update Profile /profile/?}
    EditProfile -- Yes --> UpdateForm[Update Demographics, Medical History, Allergies]
    UpdateForm --> SyncModels[Synchronize User and Patient Model Data]
    SyncModels --> ProfileReady
    EditProfile -- No --> DashboardReady([Ready for Booking & Care])
                

flowchart TD
    StartBooking([Start Appointment Booking]) --> SelectDept[Select Medical Department]
    SelectDept --> SelectDoctor[Select Doctor & Check Availability]
    SelectDoctor --> SelectTime[Select Date, Time Slot & Reason]
    SelectTime --> SubmitBooking[Submit Appointment Request]
    
    SubmitBooking --> StatusPending[Status: PENDING]
    
    StatusPending --> ActionReview{Staff / Doctor Review}
    
    ActionReview -- Reject / Patient Cancels --> StatusCancelled[Status: CANCELLED]
    ActionReview -- Confirm Booking --> StatusConfirmed[Status: CONFIRMED]
    
    StatusConfirmed --> VisitDay{Visit Appointment Time}
    VisitDay -- Patient Did Not Arrive --> StatusNoShow[Status: NO_SHOW]
    VisitDay -- Patient Arrives --> Consultation[Doctor Consultation Conducted]
    
    Consultation --> StatusCompleted[Status: COMPLETED]
    StatusCompleted --> TriggerEMR[Prompt Doctor to Add Medical Record]
                

flowchart TD
    DoctorStart([Doctor Opens Patient Consultation]) --> ViewHistory[Inspect Patient History & Past Allergies]
    ViewHistory --> ExaminePatient[Perform Clinical Examination]
    ExaminePatient --> OpenEMRForm[Open Create Medical Record Form]
    
    OpenEMRForm --> InputClinicalData[Enter Symptoms, Diagnosis & Treatment Plan]
    InputClinicalData --> OrderLabs{Order Lab Tests?}
    OrderLabs -- Yes --> AddLabNotes[Record Lab Tests to be performed]
    OrderLabs -- No --> SetFollowup
    AddLabNotes --> SetFollowup[Set Next Follow-up Date]
    
    SetFollowup --> PrescribeMeds{Prescribe Medications?}
    PrescribeMeds -- Yes --> AddRxRow[Add Prescription Line Item\n- Drug Name\n- Dosage & Frequency\n- Duration & Instructions]
    AddRxRow --> MoreMeds{More Medications?}
    MoreMeds -- Yes --> AddRxRow
    MoreMeds -- No --> SaveRecord[Save Medical Record & Prescriptions]
    PrescribeMeds -- No --> SaveRecord
    
    SaveRecord --> LinkAppt{Linked to Appointment?}
    LinkAppt -- Yes --> MarkApptDone[Update Appointment Status to COMPLETED]
    LinkAppt -- No --> RecordSaved[Record Saved in Patient EHR]
    MarkApptDone --> RecordSaved
    
    RecordSaved --> NextClinicalStep{Next Action}
    NextClinicalStep -- Inpatient Needed --> TriggerAdmission[Refer for Inpatient Admission]
    NextClinicalStep -- Outpatient Only --> TriggerBilling[Send to Billing Desk]
                

flowchart TD
    AdmitDecision([Patient Requires Inpatient Care]) --> OpenBedList[View Room Directory /clinic/rooms/]
    OpenBedList --> FilterWard[Filter by Ward Type:\nGeneral, Semi-Private, Private, ICU, Emergency, etc.]
    FilterWard --> CheckStatus{Room Status}
    
    CheckStatus -- OCCUPIED / MAINTENANCE --> ChooseOther[Select Alternate Room / Waitlist]
    ChooseOther --> OpenBedList
    
    CheckStatus -- AVAILABLE --> OpenAdmitForm[Open Admission Form /clinic/admissions/add/]
    OpenAdmitForm --> AssignDetails[Assign Patient, Room, Doctor & Admission Reason]
    AssignDetails --> SaveAdmission[Save Admission Record]
    
    SaveAdmission --> AutoOccupyRoom[System Trigger: Room Status -> OCCUPIED]
    AutoOccupyRoom --> InpatientStay[Patient Inpatient Stay & Treatment]
    
    InpatientStay --> DischargeReq{Doctor Approves Discharge?}
    DischargeReq -- No --> InpatientStay
    DischargeReq -- Yes --> OpenDischargeView[Open /clinic/admissions/id/discharge/]
    
    OpenDischargeView --> EnterSummary[Enter Discharge Summary & Set Discharge Date]
    EnterSummary --> SubmitDischarge[Submit Discharge]
    
    SubmitDischarge --> AutoFreeRoom[System Trigger: Room Status -> AVAILABLE]
    AutoFreeRoom --> AdmissionStatusDischarged[Admission Status -> DISCHARGED]
    AdmissionStatusDischarged --> RouteToBill[Generate Inpatient Hospital Bill]
                

flowchart TD
    BillStart([Create Bill Request]) --> SelectPatient[Select Patient & Link Appointment / Admission]
    SelectPatient --> AutoGenNumber[System Generates Invoice No: INV-YYYYMMDD-XXXXXX]
    
    AutoGenNumber --> AddItems[Add Bill Line Items\n- Consultations\n- Room Charges per Day\n- Lab Tests\n- Medications]
    
    AddItems --> ComputeTotals[Compute Subtotal\n+ Tax Amount\n- Discount Amount\n= Total Amount Due]
    
    ComputeTotals --> SetUnpaid[Initial Status: UNPAID\nPaid Amount = 0.00]
    
    SetUnpaid --> ReceivePayment([Receive Payment /billing/id/record-payment/])
    ReceivePayment --> SelectMethod[Select Payment Method:\nCash / Credit Card / Debit Card /\nInsurance / Bank Transfer / Other]
    SelectMethod --> InputAmount[Enter Payment Amount]
    
    InputAmount --> UpdateLedger[Update Paid Amount & Calculate Remaining Balance]
    
    UpdateLedger --> CheckBalance{Paid Amount >= Total Amount?}
    CheckBalance -- No, Partial --> StatusPartial[Status: PARTIALLY_PAID]
    StatusPartial --> OutstandingAlert[Outstanding Balance Visible on Invoices & Dashboard]
    OutstandingAlert --> ReceivePayment
    
    CheckBalance -- Yes, Complete --> StatusPaid[Status: PAID]
    StatusPaid --> SetPaidDate[Set Paid Timestamp]
    SetPaidDate --> BillComplete([Receipt Generated / Bill Finalized])