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 (3 sub-modules, 20 UCs).
- 02 - Imaging: DICOM processing and viewer integration.
- 03 - Alerts: Clinical and operational alerts.
- 04 - Processing: OCR and ASR pipelines (2 sub-modules, 12 UCs).
- 05 - API: Core API operations.
- 06 - UI: Frontend user interface workflows.
- 07 - Integration: External system integrations.
- 08 - Operations: DevOps and pipeline monitoring.
- 09 - Analytics: Dashboards and insights.
- 10 - Security: Compliance and access control.
- 11 - Capture: Audio capture and recording.
- 12 - ML Training: Model training and evaluation.
- 13 - NLP: Medical intelligence and structuring.
- 14 - EMR: EMR write-back and integration.
- 15 - Consent: DPDP compliance and consent management.
- 16 - Doctor Workflows: Note review and editing.
- 17 - Quality & Safety: Clinical safety and audit.
- 18 - Billing: Tariff and billing integration.
- 19 - Oncology: Specialized oncology workflows (9 sub-modules, 49 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 |