References/Patient: Difference between revisions

|title=Patient (reference)

|summary=Technical reference for the Patient module in Care EMR — models, fields, relationships, and save behaviour.

|source=care/emr/models/patient.py

! Model !! Purpose

| <code>Patient</code> || Core patient record

| <code>PatientOrganization</code> || Links a patient to an <code>Organization</code>

| <code>PatientUser</code> || Grants a <code>User</code> access to a patient with a <code>RoleModel</code>

| <code>PatientIdentifierConfig</code> || Defines identifier types (instance-wide or per-facility)

| <code>PatientIdentifier</code> || Stores an identifier value for a patient

! Field !! Type !! Notes

=== Contact & address ===

! Field !! Type !! Notes

{{Field|model=Patient|section=Contact & address|name=phone_number|type=CharField(14)|notes=Validated with <code>mobile_or_landline_number_validator</code>}}

{{Field|model=Patient|section=Contact & address|name=emergency_phone_number|type=CharField(14)|notes=Same validator}}

{{Field|model=Patient|section=Contact & address|name=address|type=TextField|notes=Current address}}

{{Field|model=Patient|section=Contact & address|name=permanent_address|type=TextField|notes=}}

{{Field|model=Patient|section=Contact & address|name=pincode|type=IntegerField|notes=Nullable}}

=== Organization & access caches ===

! Field !! Type !! Notes

{{Field|model=Patient|section=Organization & access caches|name=geo_organization|type=FK → Organization|notes=Geographic/administrative org assignment}}

{{Field|model=Patient|section=Organization & access caches|name=organization_cache|type=ArrayField[int]|notes=Rebuilt by <code>rebuild_organization_cache()</code> — includes <code>geo_organization</code> parent chain and all linked <code>PatientOrganization</code> orgs}}

{{Field|model=Patient|section=Organization & access caches|name=users_cache|type=ArrayField[int]|notes=Rebuilt by <code>rebuild_users_cache()</code> — user IDs from <code>PatientUser</code> rows}}

=== Identifiers & tags ===

! Field !! Type !! Notes

{{Field|model=Patient|section=Identifiers & tags|name=instance_identifiers|type=JSONField|notes=List of <code>{config, value}</code> built from <code>PatientIdentifier</code> rows (instance-scoped configs)}}

{{Field|model=Patient|section=Identifiers & tags|name=facility_identifiers|type=JSONField|notes=Dict keyed by <code>facility_id</code> → list of <code>{config, value}</code>}}

{{Field|model=Patient|section=Identifiers & tags|name=instance_tags|type=ArrayField[int]|notes=Instance-level tag IDs}}

{{Field|model=Patient|section=Identifiers & tags|name=facility_tags|type=JSONField|notes=Dict keyed by facility → tag IDs}}

{{Field|model=Patient|section=Identifiers & tags|name=extensions|type=JSONField|notes=Open extension bag for deployment-specific metadata}}

<syntaxhighlight lang="text">

patient → FK Patient

organization → FK Organization

</syntaxhighlight>

<syntaxhighlight lang="text">

user → FK User

role → FK RoleModel (PROTECT)

</syntaxhighlight>

<syntaxhighlight lang="text">

patient → FK Patient

value → CharField(1024), indexed

</syntaxhighlight>

== Methods & save behaviour ==

# A second <code>save(update_fields=["organization_cache", "users_cache"])</code> persists the caches