# Quick Start Guide - Patients Tab Flow ## 🚀 Getting Started in 60 Seconds ### Step 1: Access the Application 1. Ensure server is running: `php artisan serve` 2. Open browser: `http://localhost:8000` ### Step 2: Login as Doctor ``` Email: doctor@rxnetworx.com Password: (any value works - this is a prototype) ``` ### Step 3: Navigate to Patients Tab - Click **"Patients"** in the left sidebar - You'll see 5 pending patient requests ### Step 4: Review a Patient - Click **"View"** on any patient (try Sarah Johnson first) - Review all patient information ### Step 5: Approve a Prescription 1. Scroll to **"Approval & Sig"** section 2. Enter in the **Sig** field: ``` Take 1 capsule by mouth three times daily for 10 days ``` 3. Click **"Approve & Sign"** (green button) ### Step 6: View Approved Prescription - You'll be redirected to the **Prescriptions** tab - See the newly approved eRX with unique ID - Success message displayed at top ## 📋 What You'll See ### Page 1: Patients List ``` ┌─────────────────────────────────────────────────────────────┐ │ Patients [5 Pending Review]│ │ New and Pending prescription requests from patients │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Patient Name Date Chief Complaint Action │ │ ─────────────────────────────────────────────────────────── │ │ [SJ] Sarah Johnson │ │ DOB: 03/15/1985 Jan 20, 2026 Persistent cough [View] │ │ 9:30 AM │ │ │ │ [MC] Michael Chen │ │ DOB: 07/22/1978 Jan 20, 2026 Blood pressure [View] │ │ 8:15 AM refill │ │ │ │ ... 3 more patients ... │ └─────────────────────────────────────────────────────────────┘ ``` ### Page 2: Patient Assessment ``` ┌─────────────────────────────────────────────────────────────┐ │ [← Back to Patients] [Pending Review] │ │ Patient Assessment Form │ │ Review patient information and prescription request │ ├─────────────────────────────────────────────────────────────┤ │ │ │ 📋 Personal Information │ 🏥 Medical Information │ │ ─────────────────────────────│───────────────────────────── │ │ Name: Sarah Johnson │ Chief Complaint: │ │ DOB: 03/15/1985 │ Persistent cough and chest │ │ Gender: Female │ congestion for 5 days │ │ Phone: (555) 123-4567 │ │ │ Email: sarah.johnson@... │ Medication: │ │ Address: 123 Main Street │ 💊 Amoxicillin 500mg │ │ Los Angeles, CA │ │ │ │ Pregnant: No │ │ │ Breastfeeding: No │ │ │ Medical Conditions: │ │ │ Hypertension │ │ │ Current Medications: │ │ │ Lisinopril 10mg daily │ │ │ Drug Allergies: None │ ├─────────────────────────────────────────────────────────────┤ │ 🏪 Pharmacy Information │ │ CVS Pharmacy - 456 Main St, Los Angeles, CA 90001 │ │ [New Prescription] │ ├─────────────────────────────────────────────────────────────┤ │ ✅ Approval & Sig │ │ ─────────────────────────────────────────────────────────────│ │ Sig (Directions for Use) * │ │ ┌───────────────────────────────────────────────────────┐ │ │ │ Take 1 capsule by mouth three times daily for 10 days│ │ │ └───────────────────────────────────────────────────────┘ │ │ │ │ Additional Notes (Optional) │ │ ┌───────────────────────────────────────────────────────┐ │ │ │ │ │ │ └───────────────────────────────────────────────────────┘ │ │ │ │ [Decline] [Request More Info] [Approve & Sign] │ └─────────────────────────────────────────────────────────────┘ ``` ### Page 3: Prescriptions List ``` ┌─────────────────────────────────────────────────────────────┐ │ ✅ Prescription approved and sent to pharmacy! eRX ID: eRX-0004 ├─────────────────────────────────────────────────────────────┤ │ Prescriptions [4 Approved] │ │ Approved eRX prescriptions │ ├─────────────────────────────────────────────────────────────┤ │ │ │ eRX ID Patient Medication Sig Actions │ │ ────────────────────────────────────────────────────────────│ │ eRX-0004 [SJ] Sarah 💊 Amoxicillin Take 1 capsule [View] │ │ Johnson 500mg by mouth 3x [Download] │ 03/15/1985 daily for 10 days │ │ Jan 20, 2026 10:00 AM │ │ CVS Pharmacy - Main St [Sent to Pharmacy] │ │ │ │ eRX-0001 [JS] John 💊 Lisinopril Take 1 tablet [View] │ │ Smith 10mg once daily [Download] │ ... │ └─────────────────────────────────────────────────────────────┘ ``` ## 🎯 Key Actions to Test ### ✅ Test Approval Flow (Primary) 1. Patients → View Patient → Enter Sig → Approve & Sign 2. Verify redirect to Prescriptions 3. Verify eRX appears with unique ID ### ✅ Test Request More Info 1. Patients → View Patient → Request More Info 2. Verify info message appears 3. Returns to Patients list ### ✅ Test Decline 1. Patients → View Patient → Decline 2. Verify warning message appears 3. Returns to Patients list ### ✅ Test Navigation 1. Click between Dashboard, Patients, Prescriptions 2. Verify active states 3. Verify badge counts ### ✅ Test Mobile View 1. Resize browser to <768px width 2. Verify bottom navigation appears 3. Test all actions on mobile ## 📊 Demo Patient Scenarios ### Scenario 1: Simple Antibiotic (Sarah Johnson) - **Complaint:** Cough and congestion - **Medication:** Amoxicillin 500mg - **Risk Factors:** Hypertension (controlled) - **Suggested Sig:** "Take 1 capsule by mouth three times daily for 10 days" - **Decision:** ✅ Approve ### Scenario 2: Blood Pressure Refill (Michael Chen) - **Complaint:** Medication refill - **Medication:** Losartan 50mg - **Risk Factors:** Multiple conditions, Penicillin allergy - **Suggested Sig:** "Take 1 tablet by mouth once daily" - **Decision:** ✅ Approve (routine refill) ### Scenario 3: Migraine - Breastfeeding (Emily Rodriguez) - **Complaint:** Severe migraines - **Medication:** Sumatriptan 100mg - **Risk Factors:** ⚠️ Currently breastfeeding - **Suggested Action:** ⚠️ Request More Info (verify safety while breastfeeding) - **Decision:** 🟡 Request More Info ### Scenario 4: Cholesterol Refill (David Thompson) - **Complaint:** Routine refill - **Medication:** Atorvastatin 40mg - **Risk Factors:** Cardiac history - **Suggested Sig:** "Take 1 tablet by mouth once daily at bedtime" - **Decision:** ✅ Approve ### Scenario 5: Skin Infection - Drug Allergy (Jennifer Martinez) - **Complaint:** Bacterial skin infection - **Medication:** Cephalexin 500mg - **Risk Factors:** ⚠️ Sulfa drug allergy - **Suggested Sig:** "Take 1 capsule by mouth four times daily for 7 days" - **Decision:** ✅ Approve (Cephalexin is safe - not a sulfa drug) ## 🔍 What to Look For ### Visual Indicators - ✅ Green badges for success/approval - 🟡 Yellow badges for pending/warning - 🔴 Red text for allergies - 💊 Icons for medications - 👤 Avatar initials for patients ### Form Validation - Required field: Sig must be filled - Optional field: Notes can be empty - Form won't submit without Sig ### Navigation States - Active tab highlighted in primary color - Inactive tabs in default color - Hover effects on all links ### Flash Messages - Green success banner after approval - Blue info banner for "Request More Info" - Yellow warning banner for decline ## ⚡ Pro Tips ### Realistic Sig Examples ``` ✅ Good Examples: - "Take 1 tablet by mouth twice daily after meals for 7 days" - "Take 1 capsule by mouth three times daily for 10 days" - "Apply thin layer to affected area once daily" - "Inject 0.5 mL weekly" - "Take 1 tablet by mouth once daily at bedtime" ❌ Avoid: - Too vague: "Take as needed" - Missing details: "Take daily" - Unclear: "Use medicine" ``` ### Testing Different Paths 1. **Happy Path:** Review → Approve → View in Prescriptions 2. **Info Path:** Review → Request Info → Return to list 3. **Decline Path:** Review → Decline → Return to list 4. **Multiple Approvals:** Approve 2-3 patients in sequence ### Mobile Testing - Use Chrome DevTools (F12) - Toggle device toolbar (Ctrl+Shift+M) - Select iPhone or Android device - Test all interactions ## 🐛 Troubleshooting ### Issue: "Patient not found" - **Cause:** Invalid patient ID in URL - **Fix:** Return to `/patients` and click "View" button ### Issue: Can't see Patients tab - **Cause:** Not logged in as doctor - **Fix:** Login with email containing "doctor" ### Issue: No prescriptions showing - **Cause:** Haven't approved any yet - **Fix:** Demo data shows 3 sample prescriptions, approve one to see it added ### Issue: Session data lost - **Cause:** Session cleared or expired - **Fix:** Approved prescriptions stored in session - they'll reset on logout ## 📱 URLs Reference ``` Login: http://localhost:8000/ Dashboard: http://localhost:8000/dashboard Patients: http://localhost:8000/patients View Patient: http://localhost:8000/patients/PT-001 Prescriptions: http://localhost:8000/prescriptions ``` ## 🎓 Learning Path ### For Developers 1. Review `PrototypeController.php` methods 2. Examine Blade templates structure 3. Study route definitions in `web.php` 4. Review form handling and validation 5. Understand session management ### For Testers 1. Test each user action 2. Verify all data displays correctly 3. Check responsive behavior 4. Test edge cases (empty forms, etc.) 5. Verify flash messages ### For Stakeholders 1. Follow typical doctor workflow 2. Review patient information display 3. Test approval process 4. View prescription output 5. Assess overall user experience ## ✅ Completion Checklist Test each item: - [ ] Login as doctor works - [ ] Patients tab displays 5 patients - [ ] View patient shows all sections - [ ] Personal information complete - [ ] Medical information complete - [ ] Pharmacy information complete - [ ] Sig input accepts text - [ ] Approve button works - [ ] eRX ID generated - [ ] Redirects to Prescriptions - [ ] Success message shows - [ ] New prescription appears in list - [ ] Request More Info works - [ ] Decline works - [ ] Navigation active states work - [ ] Mobile view renders correctly - [ ] All buttons are clickable - [ ] Form validation works - [ ] Flash messages display - [ ] Back button works ## 🎉 Success Metrics You've successfully tested the flow when: 1. ✅ Can view all 5 pending patients 2. ✅ Can review complete patient details 3. ✅ Can approve a prescription with Sig 4. ✅ eRX appears in Prescriptions tab 5. ✅ Can navigate between all tabs 6. ✅ All actions provide feedback 7. ✅ Mobile view is functional --- **Ready to test?** Start at `http://localhost:8000` and login with `doctor@rxnetworx.com`! 🚀