In-Scope Modules (Product Requirements)¶
Document Purpose: This document details the functional scope and feature requirements for the MVP modules. It defines what functionality must be delivered, whereas the Developer Use Cases define how to implement it technically.
1. Longitudinal Timeline View [UI: Complete]¶
Purpose: Unified chronological view of patient's cancer journey
Features: - Display all clinical events in single timeline - Events grouped by month/year for easy navigation - Filter by event type (labs, imaging, procedures, treatments) - Click to expand event for details
Event Types Included: - ✅ Diagnosis date - ✅ Hospital admissions/discharges - ✅ Surgical procedures - ✅ Chemotherapy/radiation cycles - ✅ Lab test dates (with ability to drill down) - ✅ Imaging studies - ✅ Pathology reports - ✅ Genomics/molecular tests - ✅ Clinical notes/consultations
UI Requirements: - Timeline loads in <3 seconds - Supports 500+ events without performance degradation - Mobile-responsive (tablet support)
Related Use Cases: [UI-003], [API-002], [ONC-024]
2. Vitals & Performance Status [UI: Complete]¶
Purpose: Track functional status and key vitals over time
Data Captured: - Vitals: - Weight, Height, BMI - Blood Pressure (systolic/diastolic) - Heart Rate - Respiratory Rate - Temperature - SpO2 (oxygen saturation)
- Performance Status:
- ECOG score (0-5)
- Karnofsky score (0-100)
- Subjective assessment notes
Display Features: - Trend charts for weight, BP over time - Latest vitals snapshot on overview page - Alerts for rapid weight loss (>5% in 30 days)
Data Sources: - EMR vitals module - Manual entry by nurses/physicians
Related Use Cases: [UI-002], [ING-001]
3. Labs (Hematology, Chemistry, Tumor Markers) [UI: Complete]¶
Purpose: Comprehensive lab results with trends and abnormal value highlighting
Lab Categories: - Hematology: CBC, differential, platelets - Chemistry: Metabolic panel, liver/renal function - Tumor Markers: CA-125, CA 15-3, CEA, PSA, AFP, etc. - Coagulation: PT/INR, aPTT - Urinalysis
Features: - ✅ Latest vs. previous value comparison (Δ value, % change) - ✅ Normal/abnormal/critical flags - ✅ Reference range display - ✅ Trend charts for key tests (e.g., hemoglobin over 6 months) - ✅ Tumor marker longitudinal tracking
Data Format:
{
"testName": "Hemoglobin",
"value": 12.5,
"unit": "g/dL",
"referenceRange": "12-16 g/dL",
"status": "normal",
"date": "2024-12-01",
"source": "LIS-HOSPITALX",
"change": { "delta": -0.3, "percent": -2.3, "direction": "down" }
}
Related Use Cases: [ING-004], [UI-004], [ONC-031]
4. Imaging (PACS Integration) [UI: Complete]¶
Purpose: Display imaging studies with key measurements
Supported Modalities: - CT, MRI, PET, X-Ray, Ultrasound, Mammography
Features: - ✅ Study list with modality, date, body part, findings - ✅ Radiologist impression/report text - ✅ Structured measurements (when available): - RECIST target lesion diameters - SUVmax for PET scans - ✅ Links to DICOM viewer (if hospital has one) - ✅ Asset availability status (complete/incomplete)
Data Sources: - PACS JSON feeds (preferred) - HL7 ORM (Order) / ORU (Result) messages - Manual PDF upload with OCR
Related Use Cases: [ING-006], [IMG-009], [ONC-010]
5. Pathology Reports [UI: Complete]¶
Purpose: Display pathology findings and biomarkers
Report Types: - Biopsy reports - Surgical pathology - Cytology
Key Data Extracted: - ✅ Specimen type and site - ✅ Histology (e.g., "Invasive Ductal Carcinoma") - ✅ Grade (G1, G2, G3) - ✅ Biomarkers: - ER/PR/HER2 status (breast) - Ki67 proliferation index - p16/HPV (head & neck) - MSI/dMMR status - ✅ Margin status (if surgical specimen)
Display: - Tabular view with key findings - Full report text (OCR if PDF) - Link to original document
Related Use Cases: [ONC-002], [ONC-005]
6. Genomics / Molecular Testing [UI: Complete]¶
Purpose: Track genetic mutations and actionable biomarkers
Data Captured: - Somatic Mutations: - Gene name - Variant (HGVS notation) - VAF (Variant Allele Frequency) - Clinical significance (pathogenic/VUS/benign)
- Key Biomarkers:
- TMB (Tumor Mutational Burden)
- MSI (Microsatellite Instability)
- PD-L1 expression
- EGFR, ALK, ROS1, BRAF, KRAS, etc.
UI Features: - ✅ Actionable variants highlighted - ✅ Link to genomics report PDF - ⚠️ NOT included in MVP: Treatment recommendations, trial matching
Related Use Cases: [ING-012], [ONC-040], [ONC-041]
7. Therapy & Treatment Lines [UI: Complete]¶
Purpose: Track cancer treatments and response
Treatment Types: - Chemotherapy - Targeted therapy - Immunotherapy - Radiation therapy - Surgery - Palliative care
Data per Treatment: - Regimen name (e.g., "FOLFOX", "Pembrolizumab") - Start and end dates - Line of therapy (1st line, 2nd line, etc.) - Status: Planned / Ongoing / Completed / Abandoned - Response assessment: CR, PR, SD, PD (or free text) - Cycle information (when available)
UI Display: - Treatment timeline showing start/end of each line - Current active treatments highlighted - Response summary per line
Related Use Cases: [ONC-020], [ONC-024]
8. Medications & Allergies [UI: Complete]¶
Purpose: Current medication list and allergy tracking
Features: - ✅ Active medications (oncology and non-oncology) - ✅ Home medications - ✅ Drug allergies and intolerances - ✅ Reaction type and severity
Data Sources: - EMR medication module - Pharmacy feeds (if available) - Manual physician entry
⚠️ NOT in MVP: Drug-drug interaction checking
Related Use Cases: [ING-018]
9. Notes & Scribe with OCR/ASR (English + Hindi) [UI: Complete]¶
Purpose: Capture clinical notes and live encounters in multiple formats and languages.
Note Types: - EMR text notes - PDF documents (via OCR) - Audio recordings (via Scribe/ASR)
AI Core Capabilities (MVP): - Model Training: - LoRA/QLoRA Fine-tuning for ASR (Whisper Large V3) on Indian clinical audio. - OCR model tuning (PaddleOCR/Tesseract) for medical documents. - Inference Optimization: - GPU acceleration (vLLM/DeepSpeed) for low-latency transcription. - Optimized batch processing for OCR document stacks.
Language Support: - ✅ English (OCR + ASR) - ✅ Hindi (OCR + ASR) - ⚠️ Other Indian languages: Post-MVP
Features: - ✅ Display note type, date, language tag - ✅ Full text search within notes - ✅ Filter by language - ✅ OCR/ASR confidence score visible - ✅ Link back to original document/audio - ✅ Automated SOAP Note Generation (English/Hindi)
Quality Requirements: - English OCR: >90% accuracy - Hindi OCR: >80% accuracy - English ASR: <15% word error rate - Hindi ASR: <20% word error rate
Related Use Cases: [PROC-001], [PROC-005], [ML-001b], [NLP-101]
10. FHIR R4 Bundle Generation [UI: Pending]¶
Purpose: Enable interoperability and ABDM compliance
FHIR Resources Generated:
- Patient
- Condition (cancer diagnosis)
- Observation (labs, vitals, biomarkers)
- ImagingStudy
- DiagnosticReport (labs, imaging, pathology, genomics)
- MedicationStatement
- Procedure
- (Optional) AllergyIntolerance
Validation: - ✅ Structural validation via FHIR Validator - ✅ Zero critical errors - ✅ MUST-SUPPORT elements populated where data available - ✅ Provenance metadata included
Related Use Cases: [API-004], [IN-ONC-001]
11. Basic Rule-Based Alerts [UI: Complete]¶
Purpose: Notify clinicians of critical conditions
Alert Types (MVP): 1. Critical Lab Values - Hemoglobin <7 g/dL - Platelets <20,000 - Creatinine >3.0 mg/dL - (Configurable thresholds)
- Rapid Weight Loss
-
5% in 30 days
-
10% in 90 days
-
Overdue Labs/Imaging
- Simple rules: "CBC due every 2 weeks during chemo"
- Configurable per treatment protocol
Alert Display: - ✅ Alert badge on patient card and overview - ✅ Alert details with timestamp and trigger - ✅ Physician can dismiss or acknowledge
⚠️ NOT in MVP: - Complex clinical decision support - Guideline adherence checking - LLM-based predictions
Related Use Cases: [ALR-001], [NOTIF-001]
Parent Document: MVP Scope