Care Plan Service — AI Integration
Status: populated Owner: TBD Last updated: 2026-04-18 Companion: Service Template · 03 platform-services · 02 DDD
AI Usage Status
Tier A (platform-mediated AI via ai-gateway-service) — No direct vendor AI SDKs in care-plan-service. All AI-assisted features use ai-gateway-service via Kong /v1/ai/* per platform standard.
AI Calls
| # | Feature | Purpose | Prompt template | Moderation | HITL required | Status |
|---|---|---|---|---|---|---|
| 1 | Goal suggestion | Suggest evidence-based goals for a given diagnosis (ICD-10 code) | care-plan/suggest-goals-v1 | Content safety filter; no PHI in prompt — diagnosis code only | Clinician reviews and selects from suggestions; AI output is non-authoritative | Backlog |
| 2 | Care plan summary | Generate a plain-language summary of a care plan for patient portal | care-plan/patient-summary-v1 | Content safety + PHI redaction gate | Output labeled as AI-generated; clinician must approve before patient view | Backlog |
Constraints
- No AI calls in v1 release. Both features are backlog items pending clinical governance approval.
- No PHI in AI prompts. Prompts use coded clinical terms (ICD-10, SNOMED) and anonymized plan structure only.
- Clinician approval required. AI suggestions are displayed as drafts; the clinician must explicitly accept or modify before persisting.
- Offline behavior: When the ai-gateway-service is unreachable, the UI degrades gracefully — AI suggestion buttons are disabled with a visible "AI unavailable" indicator.
- Audit: All AI calls are logged via the platform audit pipeline with
aiProvider,promptTemplate,inputHash, andresponseHash.
Platform Reference
See docs/standards/FHIR_FIRST_STANDARD.md and ai-gateway-service/AI_INTEGRATION.md for the platform-wide AI governance model.