Doctor Workflows Use Cases (DCT)¶
UC-DCT-001: Approve Generated Note¶
Purpose: Doctor reviews and approves AI-generated SOAP note.
| Property | Value |
|---|---|
| Actor | Doctor |
| Trigger | SOAP note generation complete |
| Priority | P0 |
Main Success Scenario:
1. Display generated SOAP note in review UI
2. Highlight AI-extracted entities (medications, diagnoses)
3. Doctor reviews content for accuracy
4. Doctor clicks "Approve"
5. Mark note status as "APPROVED"
6. Enable EMR push and billing workflows
Acceptance Criteria: 1. [ ] Approval required before EMR push 2. [ ] Approval timestamp and doctor ID captured 3. [ ] Note cannot be edited after approval
UC-DCT-002: Edit Note Inline¶
Purpose: Doctor makes corrections to the note.
| Property | Value |
|---|---|
| Actor | Doctor |
| Trigger | Review of generated note |
| Priority | P0 |
Main Success Scenario:
1. Doctor clicks "Edit" on SOAP section
2. Inline editor activates
3. Doctor modifies text
4. Changes tracked with diff highlighting
5. Save generates new version
6. Original AI output preserved for audit
Acceptance Criteria: 1. [ ] Version history maintained 2. [ ] Edit diffs visible in audit log 3. [ ] AI suggestions can be accepted/rejected
UC-DCT-003: Reject/Regenerate Encounter Note¶
Purpose: Trigger AI to regenerate note with additional context.
| Property | Value |
|---|---|
| Actor | Doctor |
| Trigger | Note quality below expectations |
| Priority | P1 |
Main Success Scenario:
1. Doctor clicks "Regenerate"
2. System prompts for additional context/corrections
3. Doctor provides clarifications
4. Resubmit to NLP pipeline with enhanced prompt
5. Display new version alongside original
6. Doctor selects preferred version
Acceptance Criteria: 1. [ ] Supports up to 3 regeneration attempts 2. [ ] Previous versions archived 3. [ ] Regeneration reason captured
UC-DCT-004: Mark Follow-up Tasks¶
Purpose: Add TODO items (e.g., "Order MRI", "Call patient").
| Property | Value |
|---|---|
| Actor | Doctor |
| Trigger | During note review |
| Priority | P1 |
Main Success Scenario:
1. Doctor clicks "Add Task" button
2. Select task type: Lab Order, Imaging, Callback, Referral
3. Enter task description and due date
4. Assign to: Self, Nurse, Care Coordinator
5. Task added to patient timeline
6. Notification sent to assignee
Acceptance Criteria: 1. [ ] Tasks sync to calendar/EMR 2. [ ] Task completion tracked 3. [ ] Overdue tasks flagged
UC-DCT-005: Add Quick Assessment Codes¶
Purpose: Quickly tag ICD-10/SNOMED codes.
| Property | Value |
|---|---|
| Actor | Doctor |
| Trigger | Encounter documentation |
| Priority | P1 |
Main Success Scenario:
1. Doctor types diagnosis in search box
2. Autocomplete suggests ICD-10 codes
3. Doctor selects appropriate code
4. Code added to encounter
5. Billing module notified
Acceptance Criteria: 1. [ ] Supports ICD-10 and SNOMED CT 2. [ ] Recently used codes prioritized 3. [ ] Invalid codes rejected
UC-DCT-006: Attach Additional Documents¶
Purpose: Link supporting documents to encounter.
| Property | Value |
|---|---|
| Actor | Doctor |
| Trigger | During encounter documentation |
| Priority | P2 |
Main Success Scenario:
1. Doctor uploads file (PDF/Image)
2. System OCRs content
3. Doctor tags document type
4. Document linked to encounter
5. Added to patient timeline
Acceptance Criteria: 1. [ ] Supports PDF, JPG, PNG 2. [ ] Max file size 10MB 3. [ ] OCR text searchable