Saltar al contenido principal

ADR-035 — Legal Guardian Fields in Patient

Status: Approved | Date: 2026-06-20 | Scope: ObelioCore (Patient model) + all plugins that handle consents or signatures

Context

Spanish healthcare law requires that minors, legally incapacitated persons, persons with dementia, and other patients who cannot consent for themselves must have a legal guardian who can sign informed consents and clinical documents on their behalf.

Relevant regulations:

  • Ley 41/2002 — Patient autonomy and rights (informed consent)
  • LO 1/1996 — Legal protection of minors (updated by LO 8/2021)
  • RGPD / LOPDGDD — Consent requirements for data processing

Decision

ObelioCore's obelio_core_patient table includes 12 legal guardian fields:

FieldTypePurpose
requires_legal_guardianTINYINT(1)Flag: this patient needs a guardian to sign
legal_guardian_first_nameVARCHAR(100)Guardian given name
legal_guardian_last_nameVARCHAR(150)Guardian family name
legal_guardian_nifVARCHAR(20)Guardian national ID
legal_guardian_relationshipVARCHAR(50)Relationship to patient (parent, spouse, etc.)
legal_guardian_phoneVARCHAR(20)Guardian contact phone
legal_guardian_emailVARCHAR(255)Guardian contact email
legal_guardian_addressTEXTGuardian postal address
legal_guardian_sinceDATEDate guardianship started
legal_guardian_untilDATEDate guardianship ends (null = indefinite)
guardianship_document_refVARCHAR(100)Reference to uploaded guardianship document
guardianship_notesTEXTFree-text notes for clinical staff

Plugins affected

Any plugin that handles signatures or consent must check requires_legal_guardian and route signing to the guardian when true:

  • ObelioConsents — consent forms must be signed by guardian
  • ObelioDocs — clinical documents may require guardian countersignature
  • ObelioComms — reminders and notifications go to guardian contact fields
  • ObelioScheduling — appointment confirmations copy the guardian
  • ObelioAudit — audit events record who actually signed (patient or guardian)
  • ObelioForms — form submissions require guardian acknowledgement when applicable

Audit event requirement

When a guardian signs instead of a patient, the audit event must record:

{
"actor_type": "legal_guardian",
"guardian_nif": "12345678A",
"guardian_relationship": "parent",
"patient_id": 1234
}

Consequences

  • ObelioCore data model is the single source of guardian information
  • All plugins read this data from ObelioCore rather than duplicating it
  • UI must clearly indicate when a patient requires guardian presence
  • Forms must not allow patient signature when requires_legal_guardian = true