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

2026-07-06T04:04:21Z

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

← Older revision		Revision as of 09:34, 6 July 2026
Line 442:		Line 442:
	* Discount/tax/invoice billing config is managed through <code>FacilityMonetaryCodeSpec</code> / <code>FacilityInvoiceExpressionSpec</code> and surfaced on <code>FacilityRetrieveSpec</code>; it's backed by [[References/Facility Config\|<code>FacilityMonetoryConfig</code>]].		* Discount/tax/invoice billing config is managed through <code>FacilityMonetaryCodeSpec</code> / <code>FacilityInvoiceExpressionSpec</code> and surfaced on <code>FacilityRetrieveSpec</code>; it's backed by [[References/Facility Config\|<code>FacilityMonetoryConfig</code>]].
	* <code>FacilityRetrieveSpec</code> also returns the requesting user's permissions and feature flags; flags come via <code>get_facility_flags()</code> rather than a row-by-row query.		* <code>FacilityRetrieveSpec</code> also returns the requesting user's permissions and feature flags; flags come via <code>get_facility_flags()</code> rather than a row-by-row query.

			{{Navbox facility}}

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

Admin: OHC identity seed

2026-07-04T22:45:04Z

OHC identity seed

New page

{{Doc header
|type=reference
|domain=facility
|title=Facility
|order=1
|introduced=3.0
|model=Facility
|reference=References/Device
}}

A <code>Facility</code> is a physical or virtual care site — hospital, clinic, lab, telemedicine endpoint — and the root of a deployment's administrative hierarchy. You create one before any patient, organization, or device can attach to it.

A <code>Facility</code> spans two layers. The Django model is the storage layer, where columns like <code>features</code> and <code>print_templates</code> are opaque blobs. The API contract — enums, validation, JSON-field shapes, and the read/write schema split — lives in the Pydantic resource specs. When the two disagree (a stored integer vs. a wire label, an object key vs. a resolved URL), the spec wins on the wire.

'''Source:'''

* Model: [<nowiki/>https://github.com/ohcnetwork/care/blob/develop/care/facility/models/facility.py <code>care/facility/models/facility.py</code>]
* Resource specs: [<nowiki/>https://github.com/ohcnetwork/care/blob/develop/care/emr/resources/facility/spec.py <code>care/emr/resources/facility/spec.py</code>]
* Base resource: [<nowiki/>https://github.com/ohcnetwork/care/blob/develop/care/emr/resources/base.py <code>care/emr/resources/base.py</code>]
* Common types: [<nowiki/>https://github.com/ohcnetwork/care/blob/develop/care/emr/resources/common/coding.py <code>coding.py</code>], [<nowiki/>https://github.com/ohcnetwork/care/blob/develop/care/emr/resources/common/monetary_component.py <code>monetary_component.py</code>]

== Models ==

{| class="wikitable"
|-
! Model
! Purpose
|-
| <code>Facility</code>
| A care site and the root of a deployment's administrative org hierarchy
|-
| <code>FacilityMonetoryConfig</code>
| Per-facility billing config (one-to-one): discount codes, discount monetary components, discount configuration, invoice-number expression. Backs the discount/invoice fields of <code>FacilityRetrieveSpec</code>. See [[References/Facility Config
|}

<code>Facility</code> extends [[References/Base models & conventions|<code>BaseModel</code>]], not <code>EMRBaseModel</code>. It gets <code>external_id</code>, <code>created_date</code>/<code>modified_date</code>, and soft-delete via <code>deleted</code>, but none of the <code>EMRBaseModel</code> audit/history/meta machinery: it declares its own <code>created_by</code> FK and has no <code>updated_by</code>, <code>history</code>, or <code>meta</code> columns. <code>FacilityMonetoryConfig</code> does extend <code>EMRBaseModel</code>.

The choice sets and enums it uses are defined alongside the model — see [[#choices--enums|Choices & enums]].

== <code>Facility</code> fields ==

The '''Type''' column is the Django storage type. '''Spec / Notes''' records where the API representation, validation, or bound enum from the Pydantic specs diverges from storage.

=== Identity & classification ===

{| class="wikitable"
|-
! Field
! Type
! Spec / Notes
{{Field|model=Facility|section=Identity & classification|name=name|type=CharField(1000)|notes=Required (<code>blank=False, null=False</code>). Spec enforces case-insensitive uniqueness across all facilities (<code>Lower(Trim(name))</code>); on update the current row is excluded.}}
{{Field|model=Facility|section=Identity & classification|name=description|type=TextField|notes=<code>blank=True, null=False</code>; defaults to empty string. Required (<code>str</code>) in <code>FacilityBaseSpec</code>.}}
{{Field|model=Facility|section=Identity & classification|name=facility_type|type=IntegerField|notes=Required; choices from <code>FACILITY_TYPES</code> (see below). Wire format is the label string, not the integer: create validates the label against <code>REVERSE_REVERSE_FACILITY_TYPES</code> then maps to the int; read maps the int back to the label via <code>REVERSE_FACILITY_TYPES</code>.}}
{{Field|model=Facility|section=Identity & classification|name=features|type=ArrayField[SmallIntegerField]|notes=Nullable; each element a <code>FacilityFeature</code> choice. Spec type <code>list[int]</code>.}}
{{Field|model=Facility|section=Identity & classification|name=is_active|type=BooleanField|notes=<code>default=True</code>. Server-managed; the specs don't expose it.}}
{{Field|model=Facility|section=Identity & classification|name=verified|type=BooleanField|notes=<code>default=False</code>. Server-managed; the specs don't expose it.}}
{{Field|model=Facility|section=Identity & classification|name=is_public|type=BooleanField|notes=<code>default=False</code>; controls public visibility. Exposed as <code>bool</code> on <code>FacilityBaseSpec</code>.}}
|}

=== Location & contact ===

{| class="wikitable"
|-
! Field
! Type
! Spec / Notes
{{Field|model=Facility|section=Location & contact|name=address|type=TextField|notes=Free-text address. Required (<code>str</code>).}}
{{Field|model=Facility|section=Location & contact|name=pincode|type=IntegerField|notes=<code>default=None, null=True</code> on the model; required <code>int</code> in <code>FacilityBaseSpec</code>.}}
{{Field|model=Facility|section=Location & contact|name=longitude|type=DecimalField(22, 16)|notes=Nullable. Spec type <code>Longitude | None</code> (<code>pydantic_extra_types</code>, range −180…180).}}
{{Field|model=Facility|section=Location & contact|name=latitude|type=DecimalField(22, 16)|notes=Nullable. Spec type <code>Latitude | None</code> (<code>pydantic_extra_types</code>, range −90…90).}}
{{Field|model=Facility|section=Location & contact|name=phone_number|type=CharField(14)|notes=<code>blank=True</code>; validated with <code>mobile_or_landline_number_validator</code>. Spec type <code>str</code>.}}
{{Field|model=Facility|section=Location & contact|name=middleware_address|type=CharField(200)|notes=Nullable, <code>default=None</code>. Hostname of an external device/middleware integration. Spec type <code>str | None</code>.}}
|}

=== Organization links & caches ===

{| class="wikitable"
|-
! Field
! Type
! Spec / Notes
{{Field|model=Facility|section=Organization links & caches|name=geo_organization|type=FK → emr.Organization|notes=<code>on_delete=SET_NULL</code>, nullable. Geographic/administrative org placement. On write (<code>FacilityCreateSpec</code>): a required <code>UUID4</code> (the org's <code>external_id</code>), resolved on deserialization to an <code>Organization</code> with <code>org_type="govt"</code>. On read: a nested <code>OrganizationReadSpec</code> dict (empty <code>{}</code> when unset).}}
{{Field|model=Facility|section=Organization links & caches|name=geo_organization_cache|type=ArrayField[int]|notes=<code>default=list</code>. Denormalized cache of <code>geo_organization</code>'s <code>parent_cache</code> chain plus its own id; rebuilt by <code>sync_cache()</code>. Not exposed by specs.}}
{{Field|model=Facility|section=Organization links & caches|name=default_internal_organization|type=FK → emr.FacilityOrganization|notes=<code>on_delete=SET_NULL</code>, nullable, <code>related_name="default_facilities"</code>. The auto-created root <code>Administration</code> org. Not exposed by specs.}}
{{Field|model=Facility|section=Organization links & caches|name=internal_organization_cache|type=ArrayField[int]|notes=<code>default=list</code>. Denormalized cache of all <code>FacilityOrganization</code> ids (with parent chains) under this facility; rebuilt by <code>sync_cache()</code>. Not exposed by specs.}}
|}

Both cache fields are platform-maintained denormalizations, rebuilt on every <code>save()</code> so org-scoped filtering avoids deep joins. Never write them directly. See [[#methods--save-behaviour|Methods & save behaviour]].

=== Media & presentation ===

{| class="wikitable"
|-
! Field
! Type
! Spec / Notes
{{Field|model=Facility|section=Media & presentation|name=cover_image_url|type=CharField(500)|notes=Nullable, <code>default=None</code>. Stores an object key, not a URL. Read specs expose both the raw <code>cover_image_url</code> and a resolved <code>read_cover_image_url</code> (full URL via <code>read_cover_image_url()</code>).}}
{{Field|model=Facility|section=Media & presentation|name=print_templates|type=JSONField|notes=<code>default=list</code>. Opaque on the model; the real shape is <code>list[PrintTemplate]</code> (see [[#printtemplate-json-shape}}
|}

=== Integration & audit ===

{| class="wikitable"
|-
! Field
! Type
! Spec / Notes
{{Field|model=Facility|section=Integration & audit|name=created_by|type=FK → users.User|notes=<code>on_delete=SET_NULL</code>, nullable. Set to the facility administrator when the root org is provisioned. Read specs expose it as a nested <code>UserSpec</code> dict (cache-backed), <code>None</code> when unset.}}
|}

== Choices & enums ==

These choice sets live in the model module and are consumed by <code>Facility</code> and related code.

=== <code>FacilityFeature</code> (<code>IntegerChoices</code>) ===

{| class="wikitable"
|-
! Value
! Name
! Label
|-
| 1
| <code>CT_SCAN_FACILITY</code>
| CT Scan Facility
|-
| 2
| <code>MATERNITY_CARE</code>
| Maternity Care
|-
| 3
| <code>X_RAY_FACILITY</code>
| X-Ray Facility
|-
| 4
| <code>NEONATAL_CARE</code>
| Neonatal Care
|-
| 5
| <code>OPERATION_THEATER</code>
| Operation Theater
|-
| 6
| <code>BLOOD_BANK</code>
| Blood Bank
|}

=== <code>HubRelationship</code> (<code>IntegerChoices</code>) ===

{| class="wikitable"
|-
! Value
! Name
! Label
|-
| 1
| <code>REGULAR_HUB</code>
| Regular Hub
|-
| 2
| <code>TELE_ICU_HUB</code>
| Tele ICU Hub
|}

=== <code>FACILITY_TYPES</code> ===

A list of <code>(int code, label)</code>. Codes are sparse and namespaced (8xx govt hospitals/health centres, 9xx labs/cooperatives, 10xx–16xx COVID-era centres, 3xxx/4xxx NGO/CBO). Commented-out legacy codes (<code>8</code>, <code>801</code>, <code>820</code>, <code>831</code>, <code>850</code>, <code>950</code>, <code>1000</code>) survive in source as historical mapping notes and are not valid. The API binds on the label, not the code.

{| class="wikitable"
|-
! Code
! Label
! Code
! Label
|-
| 1
| Educational Inst
| 870
| Govt Medical College Hospitals
|-
| 2
| Private Hospital
| 900
| Co-operative hospitals
|-
| 3
| Other
| 910
| Autonomous healthcare facility
|-
| 4
| Hostel
| 1010
| COVID-19 Domiciliary Care Center
|-
| 5
| Hotel
| 1100
| First Line Treatment Centre
|-
| 6
| Lodge
| 1200
| Second Line Treatment Center
|-
| 7
| TeleMedicine
| 1300
| Shifting Centre
|-
| 9
| Govt Labs
| 1400
| Covid Management Center
|-
| 10
| Private Labs
| 1500
| Request Approving Center
|-
| 800
| Primary Health Centres
| 1510
| Request Fulfilment Center
|-
| 802
| Family Health Centres
| 1600
| District War Room
|-
| 803
| Community Health Centres
| 3000
| Clinical Non Governmental Organization
|-
| 830
| Taluk Hospitals
| 3001
| Non Clinical Non Governmental Organization
|-
| 840
| Women and Child Health Centres
| 4000
| Community Based Organization
|-
| 860
| District Hospitals
|
|
|}

<code>REVERSE_FACILITY_TYPES</code> (code → label) and <code>REVERSE_REVERSE_FACILITY_TYPES</code> (label → code) are derived from <code>FACILITY_TYPES</code> via <code>reverse_choices</code>. Create validates against the label set and stores the code; read maps the code back to the label.

=== <code>DOCTOR_TYPES</code> ===

A list of <code>(int, label)</code> covering 64 medical specialties (<code>1</code> General Medicine, <code>2</code> Pulmonology, <code>8</code> Cardiologist, <code>48</code> Nurse, <code>64</code> Critical Care Physician, etc.). Defined in this module but not referenced by the <code>Facility</code> model or facility specs.

=== <code>MonetaryComponentType</code> (str enum, from <code>monetary_component.py</code>) ===

Used by the discount monetary components in <code>FacilityMonetaryCodeSpec</code> / <code>FacilityRetrieveSpec</code>.

{| class="wikitable"
|-
! Value
|-
| <code>base</code>
|-
| <code>surcharge</code>
|-
| <code>discount</code>
|-
| <code>tax</code>
|-
| <code>informational</code>
|}

=== <code>DiscountApplicability</code> (str enum, from <code>monetary_component.py</code>) ===

{| class="wikitable"
|-
! Value
|-
| <code>total_asc</code>
|-
| <code>total_desc</code>
|}

== Nested JSON shapes ==

These Pydantic models define the real structure behind the model's JSON/array fields and the discount config.

=== <code>PrintTemplate</code> JSON shape ===

Element type of the <code>print_templates</code> field.

<syntaxhighlight lang="text">PrintTemplate {
slug: str (required)
page: PageConfig | null
print_setup: PrintSetupConfig | null
branding: BrandingConfig | null
watermark: WatermarkConfig | null
}
PageConfig { size: "A4"|"A5"|"Letter"|"Legal" | null,
orientation: "portrait"|"landscape" | null,
margin: PageMargin | null }
PageMargin { top: float≥0, bottom: float≥0, left: float≥0, right: float≥0 } # all required
PrintSetupConfig { auto_print: bool | null }
BrandingConfig { logo: LogoConfig | null, header_image: HeaderImageConfig | null,
footer_image: FooterImageConfig | null }
LogoConfig { url: str (required), width: float | null, height: float | null,
alignment: "left"|"center"|"right" (required) }
HeaderImageConfig { url: str (required), height: float | null }
FooterImageConfig { url: str | null, height: float | null }
WatermarkConfig { enabled: bool | null, text: str | null,
opacity: float | null (0…1), rotation: float | null }</syntaxhighlight>
=== Discount config shapes (<code>FacilityMonetaryCodeSpec</code> / <code>FacilityMonetoryConfig</code>) ===

<syntaxhighlight lang="text">discount_codes: list[Coding] # see Coding below
discount_monetary_components: list[MonetaryComponentDefinition]
discount_configuration: DiscountConfiguration | null

Coding { system: str|null, version: str|null, code: str (required), display: str|null } # extra="forbid"

MonetaryComponentDefinition (extends MonetaryComponent) {
title: str (required)
monetary_component_type: MonetaryComponentType # base not allowed in a definition
code: Coding | null
factor: Decimal | null (max_digits=20, decimal_places=6)
amount: Decimal | null (max_digits=20, decimal_places=6)
tax_included_amount: Decimal | null (base component only)
global_component: bool = false
conditions: list[EvaluatorConditionSpec] = []
}
EvaluatorConditionSpec { metric: str, operation: str, value: dict|str } # metric validated against EvaluatorMetricsRegistry
DiscountConfiguration { max_applicable: int≥0 (required), applicability_order: DiscountApplicability (required) }</syntaxhighlight>
<code>PeriodSpec</code> (<code>base.py</code>) is the shared period shape used across EMR resources. <code>Facility</code> doesn't use it directly; it's here for reference: <code>{ start: datetime|null, end: datetime|null }</code>, both must be timezone-aware, and <code>start ≤ end</code>.

== Resource specs (API schema) ==

Every spec subclasses <code>EMRResource</code> (<code>base.py</code>), which supplies <code>serialize</code> (DB object → Pydantic), <code>de_serialize</code> (Pydantic → DB object), and the <code>perform_extra_serialization</code> / <code>perform_extra_deserialization</code> hooks. <code>__exclude__</code> lists fields skipped during (de)serialization; <code>__store_metadata__</code> (default <code>False</code>) controls whether unknown fields land in the model's <code>meta</code>.

The hierarchy is <code>FacilityBareMinimumSpec → FacilityBaseSpec → {FacilityCreateSpec, FacilityReadSpec → FacilityRetrieveSpec, FacilityMinimalReadSpec}</code>. There is no separate <code>UpdateSpec</code>: <code>FacilityCreateSpec</code> handles both create and update, with its validators reading <code>is_update</code>/<code>object</code> from the serializer context.

{| class="wikitable"
|-
! Spec class
! Role
! Key fields / behaviour
|-
| <code>FacilityBareMinimumSpec</code>
| shared base (<code>@cacheable</code>, base manager)
| <code>id: UUID4</code>, <code>name</code>. <code>__exclude__=["geo_organization"]</code>. Cacheable, fetchable via <code>model_from_cache</code>.
|-
| <code>FacilityBaseSpec</code>
| shared base
| Adds <code>description</code>, <code>longitude</code>, <code>latitude</code>, <code>pincode</code>, <code>address</code>, <code>phone_number</code>, <code>middleware_address</code>, <code>facility_type</code>, <code>is_public</code>.
|-
| <code>FacilityCreateSpec</code>
| write · create & update
| Adds <code>geo_organization: UUID4</code>, <code>features: list[int]</code>, <code>print_templates: list[PrintTemplate] = []</code>. Validates the <code>facility_type</code> label and case-insensitive <code>name</code> uniqueness. <code>perform_extra_deserialization</code> resolves <code>geo_organization</code> (must be <code>org_type="govt"</code>) and maps the <code>facility_type</code> label → int.
|-
| <code>FacilityReadSpec</code>
| read · list
| <code>FacilityBaseSpec</code> + <code>features</code>, <code>cover_image_url</code>, <code>read_cover_image_url</code>, <code>geo_organization: dict</code>, <code>created_by: dict|null</code>. <code>perform_extra_serialization</code> sets <code>id=external_id</code>, resolves the cover image URL, maps <code>facility_type</code> int → label, serializes <code>geo_organization</code> via <code>OrganizationReadSpec</code>, and resolves <code>created_by</code> via cached <code>UserSpec</code>.
|-
| <code>FacilityRetrieveSpec</code>
| read · detail
| Extends <code>FacilityReadSpec</code> + <code>FacilityPermissionsMixin</code>. Adds <code>flags</code> (from <code>get_facility_flags()</code>), facility + instance discount/tax/informational code lists, patient identifier configs, <code>invoice_number_expression</code>, and <code>print_templates: list[dict]</code>. The permissions mixin adds <code>permissions</code>, <code>root_org_permissions</code>, <code>child_org_permissions</code>. Discount/invoice fields come from <code>FacilityMonetoryConfig.get_monetory_config()</code>; instance-level lists come from Django <code>settings</code>.
|-
| <code>FacilityMinimalReadSpec</code>
| read · minimal
| <code>FacilityBaseSpec</code> + <code>features</code>, <code>cover_image_url</code>, <code>read_cover_image_url</code>, <code>geo_organization: dict</code>. Same serialization as <code>FacilityReadSpec</code> minus <code>created_by</code>.
|-
| <code>FacilityMonetaryCodeSpec</code>
| write · billing config
| Bound to <code>FacilityMonetoryConfig</code>. Validates ≤ 100 discount codes and ≤ 100 monetary components, forbids duplicate / system-redefining codes, and requires every monetary-component code to be a defined facility or system code.
|-
| <code>FacilityInvoiceExpressionSpec</code>
| write · invoice config
| <code>invoice_number_expression: str</code>, validated by <code>evaluate_invoice_dummy_expression</code> (raises "Invalid Expression").
|}

=== Validation & server-side behaviour ===

* '''<code>name</code>''' — unique case-insensitively (<code>Lower(Trim(name))</code>); on update the current object (from context) is excluded from the check.
* '''<code>facility_type</code>''' — write accepts the label; an unknown label is rejected with the sorted valid-label list. Stored as the integer code; read maps it back to the label.
* '''<code>geo_organization</code>''' — write is a <code>UUID4</code> resolved to an <code>Organization</code> filtered by <code>org_type="govt"</code>, falling to <code>None</code> if no match. Read embeds the full <code>OrganizationReadSpec</code>.
* '''<code>features</code>''' — <code>list[int]</code>; each int should correspond to a <code>FacilityFeature</code> value.
* '''Bound value sets / coded fields''' — discount/tax/informational components use <code>Coding</code> (<code>extra="forbid"</code>); <code>MonetaryComponentDefinition</code> enforces no <code>base</code> type, the single-base rules inherited from <code>MonetaryComponent</code>, and amount/factor mutual exclusion.
* '''<code>cover_image_url</code>''' — stores an object key; <code>read_cover_image_url</code> is the resolved URL, present only on read specs.
* '''Permissions''' — <code>FacilityRetrieveSpec</code> computes them per requesting user from facility root and sub-org roles (<code>FacilityAccess</code>); <code>can_update_facility</code> is excluded from <code>child_org_permissions</code>.

== Related models ==

<code>Facility</code>'s relationships resolve through models in adjacent modules:

<syntaxhighlight lang="text">geo_organization → FK emr.Organization (SET_NULL) # write: UUID4 of a govt org
default_internal_organization → FK emr.FacilityOrganization (SET_NULL) # auto-provisioned root org
created_by → FK users.User (SET_NULL)
FacilityMonetoryConfig → OneToOne facility.Facility (CASCADE) # billing/discount config</syntaxhighlight>
On creation, <code>save()</code> provisions a root [[References/Organization|<code>FacilityOrganization</code>]] named <code>Administration</code> (<code>org_type="root"</code>, <code>system_generated=True</code>) and a <code>FacilityOrganizationUser</code> linking <code>created_by</code> to it with the <code>FACILITY_ADMIN_ROLE</code>. Feature flags live in [[References/Facility Flag|<code>FacilityFlag</code>]] and surface via <code>get_facility_flags()</code>.

== Methods & save behaviour ==

<code>Facility</code> overrides <code>save()</code> and adds a few helpers.

{| class="wikitable"
|-
! Member
! Behaviour
|-
| <code>save()</code>
| On '''create''' only: persists the row, then creates the root <code>Administration</code> <code>FacilityOrganization</code>, sets it as <code>default_internal_organization</code> (an extra write), and creates a <code>FacilityOrganizationUser</code> granting <code>created_by</code> the <code>FACILITY_ADMIN_ROLE</code>. On '''every''' save: calls <code>sync_cache()</code>.
|-
| <code>sync_cache()</code>
| Rebuilds <code>geo_organization_cache</code> (parent chain of <code>geo_organization</code> + its id) and <code>internal_organization_cache</code> (all <code>FacilityOrganization</code> parent chains + ids, de-duplicated), then persists only those two fields via <code>update_fields</code>.
|-
| <code>read_cover_image_url()</code>
| Resolves <code>cover_image_url</code> to a full URL via <code>settings.FACILITY_CDN</code>, else the S3 external endpoint/bucket; returns <code>None</code> when unset.
|-
| <code>get_facility_flags()</code>
| Delegates to <code>FacilityFlag.get_all_flags(self.id)</code> (cache-backed).
|-
| <code>__str__()</code>
| Returns <code>name</code>.
|}

Creating a facility through the ORM costs three write passes: the initial insert, the <code>default_internal_organization</code> update, and the <code>sync_cache()</code> write of the two cache columns.

Deletes are soft (inherited <code>BaseModel.delete()</code> sets <code>deleted=True</code>); the row and its child organizations are retained.

== API integration notes ==

* <code>external_id</code> (UUID) is the public identifier, exposed as <code>id</code> by every read spec — the integer <code>pk</code> stays internal.
* <code>facility_type</code> crosses the wire as the label string (e.g. <code>"Private Hospital"</code>), validated against <code>REVERSE_REVERSE_FACILITY_TYPES</code>; the integer code is storage-only.
* <code>features</code> are integer <code>FacilityFeature</code> codes; map them to labels client-side.
* <code>geo_organization</code> is written as the org's UUID (must be a <code>govt</code> org) and read as an embedded <code>OrganizationReadSpec</code> object.
* <code>print_templates</code> follows the typed [[#printtemplate-json-shape|<code>PrintTemplate</code>]] shape on write and comes back as <code>list[dict]</code> on retrieve.
* <code>geo_organization_cache</code> / <code>internal_organization_cache</code> are platform-maintained — never set them from clients; they rebuild on every save.
* Creating a facility automatically provisions its root <code>Administration</code> organization and an admin membership for <code>created_by</code>; don't create these manually.
* <code>cover_image_url</code> stores an object key; render <code>read_cover_image_url</code> instead.
* Discount/tax/invoice billing config is managed through <code>FacilityMonetaryCodeSpec</code> / <code>FacilityInvoiceExpressionSpec</code> and surfaced on <code>FacilityRetrieveSpec</code>; it's backed by [[References/Facility Config|<code>FacilityMonetoryConfig</code>]].
* <code>FacilityRetrieveSpec</code> also returns the requesting user's permissions and feature flags; flags come via <code>get_facility_flags()</code> rather than a row-by-row query.

{{Related}}

References/Facility - Revision history

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

Admin: OHC identity seed