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 unconscious
  • dnr - Do Not Resuscitate order refusing CPR
  • polst - 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 treatment
  • organ-donation - Wishes regarding organ and tissue donation
  • other - Other advance directive types

Healthcare Proxy System

Patients can designate decision-makers through:

  • healthcareProxy - Primary person via Person authorized to make healthcare decisions
  • alternateProxies - 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/created
  • effectiveDate - 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 directive
  • verifiedDate - Date of verification
  • documents - Scanned copies of signed legal documents via Document

Directive Status

The status field tracks the current validity:

ValueDescription
activeCurrently in effect and should be followed
revokedPatient has withdrawn the directive
expiredPast the expiration date
supersededReplaced by a newer directive

Use Cases

Emergency Room Admission

When an unconscious patient arrives:

  1. Query active advance directives for the patient
  2. Check directiveType for DNR or living-will
  3. Review instructions for specific treatment wishes
  4. Contact healthcareProxy for additional decisions
  5. Document that directive was followed

End-of-Life Care Planning

During palliative care discussions:

  1. Review existing directives with patient and family
  2. Create or update directives based on patient wishes
  3. Designate healthcare proxy and alternates
  4. Have directive verified by attending physician
  5. Ensure documents are accessible to care team

Organ Donation Coordination

When patient has organ donation directive:

  1. Identify patients with directiveType: "organ-donation"
  2. Contact organ procurement organization
  3. Coordinate with family and healthcare proxy
  4. Honor specific instructions about organs/tissues

Directive Renewal

For directives approaching expiration:

  1. Query directives where expirationDate is approaching
  2. Notify patient to review and renew
  3. Mark old directive as superseded when replaced
  4. Create new directive with updated documentDate

Related Entities

EntityRelationshipDescription
PatientBelongs toThe patient who created this directive
PersonReferencesHealthcare proxy and alternate decision-makers
PractitionerReferencesProvider who verified the directive
DocumentContains manyScanned copies of signed directive documents

Enums

directiveType

ValueDescription
living-willInstructions for treatment if terminally ill or permanently unconscious
dnrDo Not Resuscitate order - no CPR if heart/breathing stops
healthcare-proxyDesignates a person to make healthcare decisions on patient's behalf
polstPhysician Orders for Life-Sustaining Treatment - portable medical order
mental-healthPsychiatric advance directive for mental health treatment preferences
organ-donationWishes regarding donation of organs and tissues after death
otherOther advance directive types not covered above

status

ValueDescription
activeDirective is currently in effect and should be followed
revokedPatient has officially withdrawn/cancelled this directive
expiredDirective has passed its expiration date
supersededDirective has been replaced by a newer version
12 properties
Schema

Properties

PropertyTypeModeDescriptionRequired
patientPatient
stored

Patient who created this directive

Required
directiveTypestring
stored

Type of advance directive

Values: living-will, dnr, healthcare-proxy, polst, mental-health, organ-donation, other

Example: "living-will"

Required
statusstring
stored

Current status of the directive

Values: active, revoked, expired, superseded

Example: "active"

Required
documentDateDate
stored

Date the directive was signed or created

Example: "2023-05-15"

Required
effectiveDateDate
stored

Date from which the directive becomes effective

Example: "2023-05-15"

Optional
expirationDateDate
stored

Date when the directive expires if applicable

Optional
healthcareProxyPerson
stored

Designated healthcare proxy who makes decisions on patient's behalf

Optional
alternateProxiesPerson[]
stored

Alternate healthcare proxies if primary is unavailable

Optional
instructionsstring
stored

Specific treatment instructions and wishes

Example: "No mechanical ventilation if terminal condition with no reasonable chance of recovery"

Optional
documentsDocument[]
calculated

Scanned or digital copies of the signed directive (polymorphic)

Optional
verifiedByPractitioner
stored

Healthcare practitioner who verified the directive

Optional
verifiedDateDate
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"
}