Provider Experience
Physicians, nurse-practitioners, and specialists see the complete chart in one pane — not fragmented tabs across specialties.
Primary workflows
Chart review with AI-surfaced evidence
Clinical documentation
- ASR — speech to text in the note editor
- NER — auto-extract medications / conditions / procedures
- CDS — flag interactions, missing screenings, guideline gaps
- Coding AI — suggest ICD-10 / CPT codes with review
All 4 AI surfaces carry the FR-020 metadata block (disclaimer, model, confidence, FDA CDS-exemption ref).
Referral workflow
Referrals carry delegation_type: 'team' | 'specialist' and route through the care-team shared view.
Break-glass access
When a provider needs PHI without standing consent (emergency, continuity-of-care): invoke /api/break-glass/invoke with a justification ≥50 chars + rationale category. 15-minute validity window. HIGH-severity audit event + async care-manager notification + patient alert.
Provider dashboard surfaces
| Route | Purpose |
|---|---|
/dashboard | patient list + recent activity + tasks |
/dashboard/patients/{id} | full chart |
/dashboard/encounters/{id} | single visit |
/dashboard/referrals | outbound + inbound referral queue |
/dashboard/decision-graph | AI decision lineage (SPEC-04 Slice 5) |
/dashboard/messages | care-team + patient messaging |
/dashboard/care-plans | active care plans + annotations |
Every dashboard route has a Screen Profile registered (Spec 016) with ownerRoles, checklist, freshnessRules, and primaryActions.
AI transparency contract
Every AI response the provider sees includes:
- Disclaimer — "AI-generated recommendation. Review before acting."
- Model name + version — e.g.,
gpt-4o-2024-11-20 - Model confidence — schema-enforced numeric
- Evidence citations — with direct links to source records in memory-store
- FDA CDS-exemption ref —
docs/compliance/fda-cds-exemption.md - Fallback indicator —
fallback_occurred: trueshows a toast if Gemini was used due to GPT-4o failure
Provider can accept, modify, reject, or defer — decision feeds back into DPO training (SPEC-04 Slice 4).
Role + MFA requirements
Providers always enforce MFA (FR-009d) — step-up every 15 minutes for PHI routes. provider, coordinator, nurse, admin roles are MFA-required. Patient role is MFA-optional.
Single sign-on via Microsoft Entra ID (MSAL) or Google Workspace (GIS). Per-tenant allowlist.