Developer Use Cases - Hospital MVP¶
Document Purpose: This document defines detailed, granular developer use cases for the Hospital MVP. It breaks down complex pipelines into atomic, testable units while retaining full implementation details, error handling, and observability requirements.
Functional Groups¶
- 01 - Ingestion: HL7, PACS, and CSV data ingestion pipelines (20 UCs).
- 02 - Imaging: DICOM processing and viewer integration (7 UCs).
- 03 - Alerts: Clinical and operational alerts (2 UCs).
- 04 - Processing: OCR and ASR pipelines (12 UCs).
- 05 - API: Core API operations (8 UCs).
- 06 - UI: Frontend user interface workflows (8 UCs).
- 07 - Integration: External system integrations (6 UCs).
- 08 - Operations: DevOps and pipeline monitoring (9 UCs).
- 09 - Analytics: Dashboards and insights (4 UCs).
- 10 - Security: Compliance and access control (7 UCs).
- 11 - Capture: Audio capture and recording (2 UCs).
- 12 - ML Training: Model training and evaluation (4 UCs).
- 13 - NLP: Medical intelligence and structuring (6 UCs).
- 14 - EMR: EMR write-back and integration (4 UCs).
- 15 - Consent: DPDP compliance and consent management (4 UCs).
- 16 - Doctor Workflows: Note review and editing (6 UCs).
- 17 - Quality & Safety: Clinical safety and audit (4 UCs).
- 18 - Billing: Tariff and billing integration (3 UCs).
- 19 - Oncology: Specialized oncology workflows (49 UCs).
- 20 - Notifications: Multi-channel patient engagement & alerts (7 UCs).
- 21 - Document Generation: Print, PDF, and email document generation (8 UCs).
- 22 - Appointments: Patient registration, OPD scheduling, queue management (8 UCs).
- 23 - Pharmacy: Prescription, dispensing, inventory, controlled substances (8 UCs).
- 24 - Bed Management: IPD beds, transfers, housekeeping, census (8 UCs).
- 25 - OT & Surgery: Surgery scheduling, WHO checklist, intra-op, post-op (8 UCs).
- 26 - Blood Bank: Requisition, cross-match, transfusion, reactions (8 UCs).
- 27 - Telemedicine: Video consult, e-prescription, remote monitoring (8 UCs).
- 28 - Diet & Nutrition: Diet orders, meal planning, enteral/parenteral (8 UCs).
Use Case Quick Reference¶
| ID | Name | Group | Priority |
|---|---|---|---|
| ING-001 | Receive HL7 Message | Ingestion | P0 |
| ING-002 | Validate HL7 Structure | Ingestion | P0 |
| ING-003 | Normalize Patient Identity | Ingestion | P0 |
| ING-004 | Parse Lab Results | Ingestion | P0 |
| ING-005 | Update Patient Bundle (Labs) | Ingestion | P0 |
| ING-009 | Detect Duplicate HL7 Messages | Ingestion | P0 |
| ING-010 | Persist Raw HL7 Payloads | Ingestion | P1 |
| ING-011 | Extract Visit Context | Ingestion | P1 |
| ING-015 | Receive HL7 Radiology Order (ORM) | Ingestion | P0 |
| ING-016 | Receive HL7 Radiology Result (ORU) | Ingestion | P0 |
| ING-017 | Receive HL7 Scheduling (SIU) | Ingestion | P1 |
| ING-018 | Receive HL7 Medication Orders (RDE) | Ingestion | P1 |
| ING-019 | Receive HL7 Immunization (VXU) | Ingestion | P2 |
| ING-020 | Handle HL7 Error ACKs (AE/AR) | Ingestion | P1 |
| ING-006 | Detect PACS File Drop | Ingestion | P0 |
| ING-007 | Validate Imaging Metadata | Ingestion | P0 |
| ING-008 | Resolve Imaging Assets | Ingestion | P0 |
| ING-012 | Detect CSV Batch Drop | Ingestion | P1 |
| ING-013 | Validate CSV Schema | Ingestion | P1 |
| ING-014 | Transform CSV Row | Ingestion | P1 |
| IMG-009 | Link Imaging Study to Patient Bundle | Imaging | P0 |
| IMG-010 | Update Patient Bundle (Imaging) | Imaging | P0 |
| IMG-011 | Generate Viewer Artifacts | Imaging | P1 |
| IMG-012 | DICOM Metadata Extraction | Imaging | P1 |
| IMG-013 | Publish Imaging Study Event | Imaging | P1 |
| IMG-014 | Radiology Report Linking | Imaging | P0 |
| IMG-015 | AI Inference Scheduling | Imaging | P2 |
| ALR-001 | Evaluate Critical Lab Alerts | Alerts | P1 |
| ALR-002 | Detect Rapid Weight Loss | Alerts | P2 |
| PROC-001 | Queue OCR Job | Processing | P1 |
| PROC-002 | Detect Document Language | Processing | P1 |
| PROC-003 | Execute Tesseract Engine | Processing | P1 |
| PROC-004 | Process OCR Output | Processing | P1 |
| PROC-007 | Classify Document Type | Processing | P1 |
| PROC-008 | Redact Sensitive Entities | Processing | P1 |
| PROC-009 | Extract Structured Fields | Processing | P1 |
| PROC-010 | Summarize Document Content | Processing | P2 |
| PROC-005 | Queue ASR Job | Processing | P1 |
| PROC-006 | Execute Whisper Engine | Processing | P1 |
| PROC-011 | Identify Speaker Turns | Processing | P1 |
| PROC-012 | Generate Encounter Note | Processing | P2 |
| API-001 | Get Patient by ABHA ID | API | P0 |
| API-002 | Upload Document | API | P1 |
| API-003 | Query Job Status | API | P1 |
| API-004 | Generate FHIR Bundle | API | P1 |
| API-005 | Search Patients | API | P0 |
| API-006 | Issue Presigned Upload URL | API | P1 |
| API-007 | Cancel Background Job | API | P1 |
| API-008 | Subscribe to Event Stream | API | P2 |
| UI-001 | View Patient List | UI | P0 |
| UI-002 | View Patient Overview | UI | P0 |
| UI-003 | View Timeline | UI | P0 |
| UI-004 | View Lab Trends | UI | P0 |
| UI-005 | Acknowledge Clinical Alert | UI | P1 |
| UI-006 | Annotate Document | UI | P1 |
| UI-007 | Compare Lab Panels | UI | P1 |
| UI-008 | Manage Worklist Queue | UI | P1 |
| INT-001 | Receive HL7 ADT | Integration | P0 |
| INT-002 | Ingest FHIR Bundle | Integration | P1 |
| INT-003 | Push Radiology Results | Integration | P1 |
| INT-004 | Receive LIS CSV | Integration | P1 |
| INT-005 | Send Status Webhook | Integration | P2 |
| INT-006 | Sync Provider Directory | Integration | P2 |
| OPS-001 | Monitor Pipeline Health | Operations | P0 |
| OPS-002 | Review Failed Jobs | Operations | P0 |
| OPS-003 | Rotate API Keys | Operations | P0 |
| OPS-004 | Reprocess Historical Backlog | Operations | P1 |
| OPS-005 | Manage Feature Flags | Operations | P2 |
| OPS-006 | Run Disaster Recovery Drill | Operations | P0 |
| OPS-301 | Job Queue & Worker Orchestration | Operations | P0 |
| OPS-302 | Monitor Inference Time & Failures | Operations | P1 |
| OPS-303 | Human-in-the-Loop Correction | Operations | P1 |
| ANL-001 | Generate Tumor Board Digest | Analytics | P2 |
| ANL-002 | Compute Care Gap Scorecards | Analytics | P1 |
| ANL-003 | Forecast Lab Trajectories | Analytics | P2 |
| ANL-004 | Build Quality KPI Dashboard | Analytics | P2 |
| SEC-001 | Enforce Data Retention Policies | Security | P0 |
| SEC-002 | Audit Access Trails | Security | P0 |
| SEC-003 | Process Consent Revocation | Security | P0 |
| SEC-004 | Detect Anomalous Login Patterns | Security | P1 |
| SEC-401a | Verify Doctor Authorization | Security | P0 |
| SEC-401b | Verify Patient Consent | Security | P0 |
| SEC-402 | Data Encryption & Masking | Security | P0 |
| CAP-001 | Start Recording / Start Encounter | Capture | P0 |
| CAP-002 | Stop / Pause Recording | Capture | P0 |
| ML-001a | Curate Training Dataset | ML | P2 |
| ML-001b | Execute Fine-tuning Run | ML | P2 |
| ML-002 | Dialect Evaluation & Benchmarking | ML | P1 |
| ML-003 | Continuous Quality Feedback Loop | ML | P2 |
| NLP-101 | Generate Structured SOAP Notes | NLP | P0 |
| NLP-102a | Extract Medications (RxNorm) | NLP | P1 |
| NLP-102b | Extract Diagnoses (ICD-10) | NLP | P1 |
| NLP-102c | Extract Procedures & Symptoms (SNOMED) | NLP | P1 |
| NLP-103 | Summarization + Noise Filtering | NLP | P1 |
| NLP-104 | EMR Field Mapping | NLP | P1 |
| EMR-201 | Save Transcript + Structured Note | EMR | P0 |
| EMR-202a | Link Patient Identity | EMR | P0 |
| EMR-202b | Push Clinical Artifacts | EMR | P0 |
| EMR-203 | Create Encounter & Audit Trail | EMR | P0 |
| CONS-001 | Capture DPDP-Compliant Consent | Compliance | P0 |
| CONS-002 | Revoke DPDP Consent | Compliance | P0 |
| CONS-003 | ABDM Gateway Consent Artifact Sync | Compliance | P0 |
| CONS-004 | Consent Expiry & Renewal Logic | Compliance | P1 |
| DCT-001 | Approve Generated Note | Doctor | P0 |
| DCT-002 | Edit Note Inline | Doctor | P0 |
| DCT-003 | Reject/Regenerate Encounter Note | Doctor | P1 |
| DCT-004 | Mark Follow-up Tasks | Doctor | P1 |
| DCT-005 | Add Quick Assessment Codes | Doctor | P1 |
| DCT-006 | Attach Additional Documents | Doctor | P2 |
| QAS-001 | Record Model Failures | Quality | P0 |
| QAS-002 | Perform Clinical Safety Review | Quality | P0 |
| QAS-003 | Track Audit Violations | Quality | P1 |
| QAS-004 | Model Drift Detection | Quality | P1 |
| BILL-001 | Fetch Tariff From HIS | Billing | P1 |
| BILL-002 | Generate Billable Item From Encounter | Billing | P1 |
| BILL-003 | Publish Billing Event to HIS | Billing | P1 |
| ONC-001 | Extract Tumor Location | Oncology | P0 |
| ONC-002 | Extract Histopathology Findings | Oncology | P0 |
| ONC-003 | Extract Cancer Stage (TNM) | Oncology | P0 |
| ONC-004 | Detect Primary vs Metastatic | Oncology | P1 |
| ONC-005 | Extract IHC Panel | Oncology | P0 |
| ONC-006 | Interpret Biomarkers | Oncology | P0 |
| ONC-010 | Extract Findings from Reports | Oncology | P0 |
| ONC-011 | Detect RECIST Lesions | Oncology | P1 |
| ONC-012 | Track Lesion Progression | Oncology | P1 |
| ONC-013 | Link Imaging to Oncology History | Oncology | P1 |
| ONC-014 | Auto-score Response | Oncology | P2 |
| ONC-020 | Identify Chemo Regimen | Oncology | P0 |
| ONC-021 | Suggest Standard Regimen | Oncology | P1 |
| ONC-022 | Extract Dose Modifications | Oncology | P1 |
| ONC-023 | Track Adverse Events | Oncology | P0 |
| ONC-024 | Generate Treatment Timeline | Oncology | P1 |
| ONC-025 | Predict Next Follow-Up | Oncology | P2 |
| ONC-030 | Spotlight Critical Labs | Oncology | P1 |
| ONC-031 | Track Tumor Markers | Oncology | P1 |
| ONC-032 | Detect Lab Red Flags | Oncology | P0 |
| ONC-040 | Parse NGS Reports | Oncology | P1 |
| ONC-041 | Extract Variants | Oncology | P1 |
| ONC-042 | Map to Actionable Therapies | Oncology | P2 |
| ONC-043 | Generate Genomics Summary | Oncology | P1 |
| ONC-044 | Detect Germline vs Somatic | Oncology | P2 |
| ONC-050 | Build Tumor Board Packet | Oncology | P0 |
| ONC-051 | Route Cases to Boards | Oncology | P1 |
| ONC-052 | Track Recommendations | Oncology | P0 |
| ONC-053 | Follow-up Compliance Check | Oncology | P1 |
| ONC-060 | Generate Follow-up Plan | Oncology | P2 |
| ONC-061 | Detect Recurrence Flags | Oncology | P1 |
| ONC-062 | Calculate Prognostic Score | Oncology | P2 |
| IN-ONC-001 | ABHA/ABDM Oncology Bundle Compliance | Oncology | P0 |
| IN-ONC-002 | NCRP/ICMR Cancer Registry Auto-Reporting | Oncology | P1 |
| IN-ONC-003 | India-Specific Drug Formulary & Generic Mapping | Oncology | P1 |
| IN-ONC-004 | Regional Language + Hinglish Clinical NLP | Oncology | P1 |
| IN-ONC-005 | NABH-Compliant Documentation & Audit Checks | Oncology | P1 |
| IN-ONC-006 | TPA/Health Insurance Pre-Auth & Discharge Mapping | Oncology | P1 |
| ONC-070 | Generate Quick Patient Summary | Oncology | P0 |
| ONC-071 | Track Changes Since Last Visit | Oncology | P0 |
| ONC-072 | Aggregate Multi-Source Patient Data | Oncology | P0 |
| ONC-073 | Draft Clinic Note with Citations | Oncology | P1 |
| ONC-074 | Screen Clinical Trial Eligibility | Oncology | P1 |
| ONC-075 | Flag Missing/Overdue Tests | Oncology | P0 |
| ONC-076 | Capture Patient-Reported Outcomes (PROs) | Oncology | P1 |
| ONC-077 | Manage Clinical Task List | Oncology | P1 |
| ONC-078 | Compare Sequential Imaging Studies | Oncology | P1 |
| ONC-079 | Generate Handover/Referral Packet | Oncology | P1 |
| ONC-080 | Ingest Patient-Shared Documents | Oncology | P1 |
| NOTIF-001 | Critical Alert Delivery (Multi-Channel) | Notifications | P0 |
| NOTIF-002 | Patient Appointment Reminders | Notifications | P1 |
| NOTIF-003 | Lab Result Notifications | Notifications | P1 |
| NOTIF-004 | Treatment Schedule Reminders | Notifications | P1 |
| NOTIF-005 | Caregiver & Family Notifications | Notifications | P1 |
| NOTIF-006 | Medication Adherence Reminders | Notifications | P2 |
| NOTIF-007 | Discharge Follow-Up Notifications | Notifications | P1 |
| DOC-001 | Generate Patient Bill/Invoice | Document Gen | P0 |
| DOC-002 | Generate Discharge Summary | Document Gen | P0 |
| DOC-003 | Generate Lab Report PDF | Document Gen | P1 |
| DOC-004 | Generate Prescription Document | Document Gen | P0 |
| DOC-005 | Generate Insurance Claim Form | Document Gen | P1 |
| DOC-006 | Generate Payment Receipt | Document Gen | P0 |
| DOC-007 | Generate Referral Letter | Document Gen | P1 |
| DOC-008 | Generate Medical Certificate | Document Gen | P1 |
| APPT-001 | Register New Patient | Appointments | P0 |
| APPT-002 | Book OPD Appointment | Appointments | P0 |
| APPT-003 | Doctor Availability Management | Appointments | P1 |
| APPT-004 | Check-In Patient for Appointment | Appointments | P0 |
| APPT-005 | OPD Queue Management | Appointments | P1 |
| APPT-006 | Reschedule Appointment | Appointments | P1 |
| APPT-007 | Cancel Appointment | Appointments | P1 |
| APPT-008 | Follow-Up Appointment Booking | Appointments | P1 |
| PHRM-001 | Receive Prescription Order | Pharmacy | P0 |
| PHRM-002 | Drug-Drug Interaction Check | Pharmacy | P0 |
| PHRM-003 | Dispense Medication | Pharmacy | P0 |
| PHRM-004 | Manage Drug Inventory | Pharmacy | P1 |
| PHRM-005 | Process Stock Receipt (GRN) | Pharmacy | P1 |
| PHRM-006 | Expiry Management | Pharmacy | P1 |
| PHRM-007 | Generate Prescription Label | Pharmacy | P1 |
| PHRM-008 | Controlled Substance Dispensing | Pharmacy | P0 |
| BED-001 | Check Bed Availability | Bed Mgmt | P0 |
| BED-002 | Allocate Bed for Admission | Bed Mgmt | P0 |
| BED-003 | Transfer Patient Between Beds | Bed Mgmt | P1 |
| BED-004 | Process Patient Discharge | Bed Mgmt | P0 |
| BED-005 | Housekeeping Bed Turnaround | Bed Mgmt | P1 |
| BED-006 | Bed Reservation & Blocking | Bed Mgmt | P1 |
| BED-007 | Census & Occupancy Reporting | Bed Mgmt | P2 |
| BED-008 | ICU/Critical Care Bed Management | Bed Mgmt | P0 |
| OT-001 | Schedule Surgery | OT/Surgery | P0 |
| OT-002 | Pre-Operative Assessment | OT/Surgery | P0 |
| OT-003 | OT Checklist (WHO Safe Surgery) | OT/Surgery | P0 |
| OT-004 | Intra-Operative Documentation | OT/Surgery | P1 |
| OT-005 | Post-Operative Care Orders | OT/Surgery | P0 |
| OT-006 | Surgical Instrument Tracking | OT/Surgery | P1 |
| OT-007 | Emergency Surgery Workflow | OT/Surgery | P0 |
| OT-008 | Surgical Case Costing | OT/Surgery | P1 |
| BB-001 | Blood Requisition | Blood Bank | P0 |
| BB-002 | Blood Sample Collection | Blood Bank | P0 |
| BB-003 | Blood Grouping & Cross-Match | Blood Bank | P0 |
| BB-004 | Blood Unit Issue | Blood Bank | P0 |
| BB-005 | Transfusion Administration | Blood Bank | P0 |
| BB-006 | Transfusion Reaction Reporting | Blood Bank | P0 |
| BB-007 | Blood Inventory Management | Blood Bank | P1 |
| BB-008 | Emergency Blood Release | Blood Bank | P0 |
| TM-001 | Schedule Telemedicine Appointment | Telemedicine | P0 |
| TM-002 | Conduct Video Consultation | Telemedicine | P0 |
| TM-003 | E-Prescription Generation | Telemedicine | P0 |
| TM-004 | Remote Vitals Monitoring | Telemedicine | P1 |
| TM-005 | Asynchronous Consultation | Telemedicine | P1 |
| TM-006 | Specialist Referral (Tele-Referral) | Telemedicine | P1 |
| TM-007 | Post-Discharge Follow-Up | Telemedicine | P1 |
| TM-008 | Telemedicine Consent & Documentation | Telemedicine | P0 |
| DIET-001 | Create Diet Order | Diet/Nutrition | P0 |
| DIET-002 | Nutritional Assessment | Diet/Nutrition | P1 |
| DIET-003 | Menu Planning & Kitchen Production | Diet/Nutrition | P1 |
| DIET-004 | Meal Delivery & Tracking | Diet/Nutrition | P1 |
| DIET-005 | Enteral Feeding Management | Diet/Nutrition | P1 |
| DIET-006 | Parenteral Nutrition Order | Diet/Nutrition | P1 |
| DIET-007 | Dietary Counseling | Diet/Nutrition | P2 |
| DIET-008 | Kitchen Hygiene & FSSAI Compliance | Diet/Nutrition | P1 |