Admin: Automated edit (via update-page on MediaWiki MCP Server)

2026-07-06T03:59:35Z

Automated edit (via update-page on MediaWiki MCP Server)

← Older revision		Revision as of 09:29, 6 July 2026
Line 101:		Line 101:

	Roles are granted to users through their organization, facility, and patient memberships, and permissions cascade down the organization tree — a role held at a parent organization applies to the facilities and encounters beneath it.		Roles are granted to users through their organization, facility, and patient memberships, and permissions cascade down the organization tree — a role held at a parent organization applies to the facilities and encounters beneath it.

			{{Navbox clinical}}

	{{Related}}		{{Related}}
			Wiki: ohcnwiki.tellmey.fyi

Admin: OHC identity seed

2026-07-04T22:43:11Z

OHC identity seed

New page

{{Doc header
|type=concept
|domain=clinical
|title=Encounter
|order=2
|introduced=3.0
|fhir=Encounter
|concept=Concepts/Clinical Notes
|reference=References/Encounter
}}

An '''encounter''' is a single episode of care between a patient and a facility — an outpatient visit, an admission, an emergency presentation, or a virtual consultation. It is the working context for clinical activity: while an encounter is open, the orders, observations, medications, and notes recorded for the patient are gathered under it.

== What it represents ==

In Care's FHIR-aligned model, an encounter maps to the '''Encounter''' resource. It answers four questions about one episode: what kind of interaction it is, where and when it happens, who is on the care team, and — for admissions — how the patient arrived and left.

An encounter is not the patient and not the whole medical record. One patient accumulates many encounters over time; each encounter is the bounded slice of activity for a single episode, and the [[Concepts/Patient|patient]] record is the thread that ties them together. Think of the patient as the chart and each encounter as a dated chapter within it.

== Lifecycle ==

An encounter carries a status that reflects where the episode stands. It opens as <code>planned</code> or <code>in_progress</code>, runs through active care, and ends in exactly one terminal state. Care records every transition in a status history, so the journey stays auditable.

<syntaxhighlight lang="text">planned ──▶ in_progress ──▶ discharged ──▶ completed
▲ │
└───┘ on_hold (pause, then resume)</syntaxhighlight>
* '''planned''' — the episode is scheduled or expected but has not started
* '''in_progress''' — the patient is actively being seen or treated
* '''on_hold''' — care is temporarily paused (for example, awaiting results or a bed), then resumes
* '''discharged''' — the patient has left the facility; closing paperwork may still be in flight
* '''completed''' — the episode is finished and finalized

An episode can also end early without reaching <code>completed</code>: '''cancelled''' (called off before meaningful care), '''discontinued''' (stopped and will not resume), or '''entered_in_error''' (created by mistake and voided). These, along with <code>completed</code>, are the terminal states — once an encounter reaches one, it stops accumulating new clinical activity.

== Classification ==

Two independent axes describe an encounter. '''Class''' answers "what kind of visit is this?" and '''priority''' answers "how urgent is it?". The two are set separately, so an inpatient admission can be routine and an outpatient visit can be an emergency.

{| class="wikitable"
|-
! Class
! Meaning
|-
| <code>imp</code>
| Inpatient — admitted to a bed
|-
| <code>amb</code>
| Ambulatory — outpatient or clinic visit
|-
| <code>emer</code>
| Emergency — emergency department presentation
|-
| <code>obsenc</code>
| Observation — short-stay monitoring
|-
| <code>vr</code>
| Virtual — teleconsultation
|-
| <code>hh</code>
| Home health — care delivered at the patient's home
|}

Priority runs from <code>routine</code> through <code>urgent</code>, <code>emergency</code>, <code>ASAP</code>, and <code>stat</code>, with workflow values such as <code>elective</code> and <code>preop</code> for scheduled care. As with status, a change in class is recorded in its own history.

== How it connects ==

The encounter is the hub that most clinical work hangs off:

* '''Patient''' — every encounter belongs to exactly one [[Concepts/Patient|patient]], set when it is created and never changed.
* '''Facility and location''' — it is anchored to a [[References/Facility|facility]] and tracks the [[References/Location|location]] the patient currently occupies within it, with a full location history behind that.
* '''Booking''' — an encounter can originate from a scheduling [[References/Booking|booking]], linking the appointment that brought the patient in to the episode that followed.
* '''Organizations''' — each encounter is associated with one or more facility [[References/Organization|organizations]], and that association is what drives who can see and act on it.
* '''Clinical records''' — [[Concepts/Condition|conditions]], [[Concepts/Observation|observations]], [[Concepts/Service Request|service requests]], medication orders, and [[Concepts/Clinical Notes|notes]] are all recorded in the context of an encounter.

== Permissions ==

Access to encounters is permission-controlled, and every action on the encounter endpoint is reserved for clinical roles. Listing and retrieving an encounter is also granted when the user can view the underlying patient.

{| class="wikitable"
|-
! Permission
! Description
! System Roles
|-
| <code>can_create_encounter</code>
| Open a new encounter for a patient under a facility
| Admin, Doctor, Nurse, Facility Admin
|-
| <code>can_list_encounter</code>
| List encounters within a facility (clinical data is not exposed through this permission)
| Admin, Doctor, Nurse, Facility Admin
|-
| <code>can_read_encounter</code>
| Retrieve an encounter's non-clinical details
| Admin, Doctor, Nurse, Facility Admin
|-
| <code>can_write_encounter</code>
| Update an encounter, manage its organizations, set facility identifiers, assign care-team members, and restart a completed encounter
| Admin, Doctor, Nurse, Facility Admin
|}

Roles are granted to users through their organization, facility, and patient memberships, and permissions cascade down the organization tree — a role held at a parent organization applies to the facilities and encounters beneath it.

{{Related}}

Concepts/Encounter - Revision history

Admin: Automated edit (via update-page on MediaWiki MCP Server)

Admin: OHC identity seed