Treatment Pathway¶
UC-ONC-020: Identify Chemo Regimen¶
Purpose: Extract chemotherapy regimen from OPD notes.
| Property | Value |
|---|---|
| Actor | Treatment Extraction Service |
| Trigger | OPD note ingested |
| Priority | P0 |
Main Success Scenario:
1. Parse treatment note for chemo drugs
2. Identify regimen (e.g., "FOLFOX", "AC-T")
3. Extract cycle number and date
4. Update treatment timeline
Alternative Flows:
Alt-1: Unrecognized Regimen
- Regimen name not in dictionary - Extract drug names individually - Flag for oncology team reviewObservability:
- Metric: onc_regimen_identified, onc_cycle_tracked
- Log: {"event": "chemo_regimen", "regimen": "FOLFOX", "cycle": 6, "date": "2024-01-15"}
Acceptance Criteria: 1. [ ] Recognizes common regimens 2. [ ] Captures cycle number 3. [ ] Links to cancer diagnosis
UC-ONC-021: Suggest Standard Regimen¶
Purpose: Suggest evidence-based regimen by cancer type.
| Property | Value |
|---|---|
| Actor | Treatment Recommendation Service |
| Trigger | Cancer diagnosis and stage confirmed |
| Priority | P1 |
Main Success Scenario:
1. Read cancer type, stage, biomarkers
2. Query treatment guidelines (NCCN-equivalent)
3. Suggest 1st-line regimen options
4. Display for physician consideration
Acceptance Criteria: 1. [ ] Suggestions based on guidelines 2. [ ] Configurable per institution 3. [ ] Non-prescriptive (informational only)
UC-ONC-022: Extract Dose Modifications¶
Purpose: Track dose reductions or delays.
| Property | Value |
|---|---|
| Actor | Dose Tracking Service |
| Trigger | Treatment note ingested |
| Priority | P1 |
Main Success Scenario:
1. Identify dose changes (e.g., "Reduced to 75%")
2. Extract reason (toxicity, low counts)
3. Link to adverse events
4. Update treatment record
Acceptance Criteria: 1. [ ] Dose reduction % captured 2. [ ] Reason for modification tracked 3. [ ] Supports delayed cycles
UC-ONC-023: Track Adverse Events¶
Purpose: Track adverse events with CTCAE grading.
| Property | Value |
|---|---|
| Actor | Adverse Event Tracker |
| Trigger | Adverse event documented |
| Priority | P0 |
Main Success Scenario:
1. Extract adverse event from note
2. Map to CTCAE term
3. Assign grade (1-5)
4. Link to treatment cycle
Alternative Flows:
Alt-1: Grade Ambiguity
- Adverse event described but grade unclear - Assign provisional grade based on description - Flag for clinician grading confirmationObservability:
- Metric: onc_adverse_event_logged, onc_ctcae_graded
- Log: {"event": "adverse_event", "term": "Neutropenia", "grade": 3, "cycle": 4}
Acceptance Criteria: 1. [ ] CTCAE 5.0 compliant 2. [ ] Grade captured 3. [ ] Severity trends tracked
UC-ONC-024: Generate Treatment Timeline¶
Purpose: Visual timeline of treatment journey.
| Property | Value |
|---|---|
| Actor | Timeline Visualization Service |
| Trigger | Treatment data available |
| Priority | P1 |
Main Success Scenario:
1. Compile all treatment events (chemo, surgery, radiation)
2. Add imaging and response assessments
3. Generate visual timeline for tumor board
Acceptance Criteria: 1. [ ] Timeline includes all modalities 2. [ ] Exportable for tumor board 3. [ ] Filterable by event type
UC-ONC-025: Predict Next Follow-Up¶
Purpose: Suggest next follow-up visit date.
| Property | Value |
|---|---|
| Actor | Follow-up Scheduler |
| Trigger | Treatment cycle completed |
| Priority | P2 |
Main Success Scenario:
1. Calculate next follow-up based on protocol
2. Suggest date range
3. Create task for scheduling team
Acceptance Criteria: 1. [ ] Protocol-based scheduling 2. [ ] Configurable per cancer type 3. [ ] Integrates with calendar