PatientAdvanceDirective
Legal documents expressing a patient's healthcare preferences when they are unable to communicate or make decisions. Covers living wills, DNR orders, healthcare proxy designations, and organ donation wishes.
Overview
PatientAdvanceDirective captures legally binding documents that guide healthcare decisions when patients cannot speak for themselves. These directives are critical for emergency situations, end-of-life care, and ensuring patient autonomy is respected. The entity tracks the directive type, designated decision-makers, specific instructions, and verification by healthcare providers.
Key Concepts
Directive Types
The directiveType field categorizes the advance directive:
End-of-Life Directives
living-will- Instructions for treatment if terminally ill or permanently unconsciousdnr- Do Not Resuscitate order refusing CPRpolst- Physician Orders for Life-Sustaining Treatment (portable medical order)
Decision-Maker Designations
healthcare-proxy- Designates a person to make healthcare decisions
Specific Wishes
mental-health- Psychiatric advance directive for mental health treatmentorgan-donation- Wishes regarding organ and tissue donationother- Other advance directive types
Healthcare Proxy System
Patients can designate decision-makers through:
healthcareProxy- Primary person via Person authorized to make healthcare decisionsalternateProxies- Backup decision-makers if primary proxy is unavailable
The proxy hierarchy ensures someone is always available to make decisions when the patient cannot.
Document Timeline
Key Dates
documentDate- When the directive was signed/createdeffectiveDate- When the directive becomes active (often same as document date)expirationDate- Optional expiration for directives with limited duration
Verification Process
Healthcare providers verify directives to ensure authenticity:
verifiedBy- Practitioner who confirmed the directiveverifiedDate- Date of verificationdocuments- Scanned copies of signed legal documents via Document
Directive Status
The status field tracks the current validity:
| Value | Description |
|---|---|
active | Currently in effect and should be followed |
revoked | Patient has withdrawn the directive |
expired | Past the expiration date |
superseded | Replaced by a newer directive |
Use Cases
Emergency Room Admission
When an unconscious patient arrives:
- Query active advance directives for the patient
- Check
directiveTypefor DNR or living-will - Review
instructionsfor specific treatment wishes - Contact
healthcareProxyfor additional decisions - Document that directive was followed
End-of-Life Care Planning
During palliative care discussions:
- Review existing directives with patient and family
- Create or update directives based on patient wishes
- Designate healthcare proxy and alternates
- Have directive verified by attending physician
- Ensure documents are accessible to care team
Organ Donation Coordination
When patient has organ donation directive:
- Identify patients with
directiveType: "organ-donation" - Contact organ procurement organization
- Coordinate with family and healthcare proxy
- Honor specific instructions about organs/tissues
Directive Renewal
For directives approaching expiration:
- Query directives where
expirationDateis approaching - Notify patient to review and renew
- Mark old directive as
supersededwhen replaced - Create new directive with updated
documentDate
Related Entities
| Entity | Relationship | Description |
|---|---|---|
| Patient | Belongs to | The patient who created this directive |
| Person | References | Healthcare proxy and alternate decision-makers |
| Practitioner | References | Provider who verified the directive |
| Document | Contains many | Scanned copies of signed directive documents |
Enums
directiveType
| Value | Description |
|---|---|
living-will | Instructions for treatment if terminally ill or permanently unconscious |
dnr | Do Not Resuscitate order - no CPR if heart/breathing stops |
healthcare-proxy | Designates a person to make healthcare decisions on patient's behalf |
polst | Physician Orders for Life-Sustaining Treatment - portable medical order |
mental-health | Psychiatric advance directive for mental health treatment preferences |
organ-donation | Wishes regarding donation of organs and tissues after death |
other | Other advance directive types not covered above |
status
| Value | Description |
|---|---|
active | Directive is currently in effect and should be followed |
revoked | Patient has officially withdrawn/cancelled this directive |
expired | Directive has passed its expiration date |
superseded | Directive has been replaced by a newer version |
Properties
| Property | Type | Mode | Description | Required |
|---|---|---|---|---|
| patient | Patient | stored | Patient who created this directive | Required |
| directiveType | string | stored | Type of advance directive Values: Example: | Required |
| status | string | stored | Current status of the directive Values: Example: | Required |
| documentDate | Date | stored | Date the directive was signed or created Example: | Required |
| effectiveDate | Date | stored | Date from which the directive becomes effective Example: | Optional |
| expirationDate | Date | stored | Date when the directive expires if applicable | Optional |
| healthcareProxy | Person | stored | Designated healthcare proxy who makes decisions on patient's behalf | Optional |
| alternateProxies | Person[] | stored | Alternate healthcare proxies if primary is unavailable | Optional |
| instructions | string | stored | Specific treatment instructions and wishes Example: | Optional |
| documents | Document[] | calculated | Scanned or digital copies of the signed directive (polymorphic) | Optional |
| verifiedBy | Practitioner | stored | Healthcare practitioner who verified the directive | Optional |
| verifiedDate | Date | stored | Date when directive was verified by healthcare provider | Optional |
Examples
Example 1
{
"@type": "PatientAdvanceDirective",
"patient": {
"@type": "Patient",
"givenName": "Robert",
"familyName": "Johnson"
},
"directiveType": "living-will",
"status": "active",
"documentDate": "2023-05-15",
"effectiveDate": "2023-05-15",
"healthcareProxy": {
"@type": "Person",
"givenName": "Mary",
"familyName": "Smith"
},
"alternateProxies": [
{
"@type": "Person",
"givenName": "David",
"familyName": "Johnson"
},
{
"@type": "Person",
"givenName": "Lisa",
"familyName": "Johnson"
}
],
"instructions": "No mechanical ventilation or artificial nutrition if in persistent vegetative state",
"verifiedBy": {
"@type": "Practitioner",
"givenName": "Sarah",
"familyName": "Williams"
},
"verifiedDate": "2023-05-20"
}Example 2
{
"@type": "PatientAdvanceDirective",
"patient": {
"@type": "Patient",
"givenName": "Eleanor",
"familyName": "Martinez"
},
"directiveType": "dnr",
"status": "active",
"documentDate": "2024-01-10",
"effectiveDate": "2024-01-10",
"instructions": "Do not attempt resuscitation. Comfort care only.",
"verifiedBy": {
"@type": "Practitioner",
"givenName": "Michael",
"familyName": "Chen"
},
"verifiedDate": "2024-01-10"
}Example 3
{
"@type": "PatientAdvanceDirective",
"patient": {
"@type": "Patient",
"givenName": "Thomas",
"familyName": "Anderson"
},
"directiveType": "organ-donation",
"status": "active",
"documentDate": "2020-03-01",
"instructions": "Willing to donate all viable organs and tissues"
}