@ingenx-io/valets-schema-mcp-server 0.2.2 → 0.2.4

package/data/docs/models/site-payment.md

@@ -1,7 +1,7 @@
 ---
 title: "SitePayment"
 sidebar_label: "SitePayment"
-sidebar_position: 24
+sidebar_position: 25
 ---
 
 # SitePayment
@@ -197,4 +197,4 @@ Set at creation only. This field cannot be modified after the document is create
 | **Maximum**  | ≤ 9007199254740991  |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:05 +0000

package/data/docs/models/site.md

@@ -1,7 +1,7 @@
 ---
 title: "Site"
 sidebar_label: "Site"
-sidebar_position: 23
+sidebar_position: 24
 ---
 
 # Site
@@ -546,7 +546,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** Timestamp of the most recent analytics event seen for this site.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:05 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/stocktake-item.md

@@ -1,7 +1,7 @@
 ---
 title: "StocktakeItem"
 sidebar_label: "StocktakeItem"
-sidebar_position: 26
+sidebar_position: 27
 ---
 
 # StocktakeItem
@@ -497,4 +497,4 @@ Read-time hint snapshot of the verifier's display name (GH#29 §3 / Q10).
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:05 +0000

package/data/docs/models/stocktake.md

@@ -1,7 +1,7 @@
 ---
 title: "Stocktake"
 sidebar_label: "Stocktake"
-sidebar_position: 25
+sidebar_position: 26
 ---
 
 # Stocktake
@@ -642,7 +642,7 @@ Read-time hint snapshot of the completer's display name (GH#29 §3 / Q10).
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:05 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/ticket.md

@@ -1,7 +1,7 @@
 ---
 title: "Ticket"
 sidebar_label: "Ticket"
-sidebar_position: 27
+sidebar_position: 28
 ---
 
 # Ticket
@@ -388,7 +388,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Immutable) FK → User/staff UID who created this ticket.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:05 +0000
 
 :::info Immutable
 Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.

package/data/docs/models/whatsapp-inbound-message.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappInboundMessage"
 sidebar_label: "WhatsappInboundMessage"
-sidebar_position: 28
+sidebar_position: 29
 ---
 
 # WhatsappInboundMessage
@@ -366,4 +366,4 @@ Do not include in write requests. This field is set exclusively by the server (F
 Specific value: `true`
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:05 +0000

package/data/docs/models/whatsapp-outbound-lifecycle-event.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappOutboundLifecycleEvent"
 sidebar_label: "WhatsappOutboundLifecycleEvent"
-sidebar_position: 29
+sidebar_position: 30
 ---
 
 # WhatsappOutboundLifecycleEvent
@@ -303,7 +303,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Read-only) Raw Meta error object(s).
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:06 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/whatsapp-outbound-message.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappOutboundMessage"
 sidebar_label: "WhatsappOutboundMessage"
-sidebar_position: 30
+sidebar_position: 31
 ---
 
 # WhatsappOutboundMessage
@@ -582,7 +582,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 | **Required** | No     |
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:06 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/docs/models/whatsapp-template.md

@@ -1,7 +1,7 @@
 ---
 title: "WhatsappTemplate"
 sidebar_label: "WhatsappTemplate"
-sidebar_position: 31
+sidebar_position: 32
 ---
 
 # WhatsappTemplate
@@ -287,7 +287,7 @@ Do not include in write requests. This field is set exclusively by the server (F
 **Description:** (Read-only) Rendered preview text for display in the dashboard picker.
 
 ----------------------------------------------------------------------------------------------------------------------------
-Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 14:03:20 +0000
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-05-27 at 15:51:06 +0000
 
 :::warning Server-set
 Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.

package/data/static/cookbook.json

@@ -0,0 +1,150 @@
+{
+  "version": "1",
+  "recipes": [
+    {
+      "slug": "write-model-code",
+      "title": "Writing code that touches a model",
+      "summary": "How to look up a model's schema, identify field constraints, and avoid writing to server-set or immutable fields.",
+      "steps": [
+        {
+          "step": 1,
+          "tool": "schema_overview",
+          "args": {},
+          "note": "Start here to see all available models and enums. Identify the model(s) your code will read or write."
+        },
+        {
+          "step": 2,
+          "tool": "get_schema",
+          "args": { "name": "<model-name>" },
+          "note": "Fetch the full JSON Schema for the model. Inspect each field for constraint extensions: readOnly, x-immutable, deprecated, x-note, x-when."
+        },
+        {
+          "step": 3,
+          "tool": "get_openapi",
+          "args": { "component": "<ModelCreate>" },
+          "note": "Use the Create variant (PascalCase + 'Create', e.g. 'OrderCreate') to determine the correct write shape. readOnly and deprecated fields are excluded from required[] here."
+        },
+        {
+          "step": 4,
+          "tool": "get_openapi",
+          "args": { "component": "<ModelUpdate>" },
+          "note": "For PATCH operations use the Update variant. All fields become optional and readOnly / x-immutable fields are excluded entirely."
+        },
+        {
+          "step": 5,
+          "tool": "get_doc",
+          "args": { "slug": "models/<model-name>" },
+          "note": "Read the human-readable doc page for callout blocks: server-set warnings, immutable notices, deprecation alerts, and implementation tips."
+        }
+      ],
+      "field_constraint_cheatsheet": {
+        "readOnly: true": "Set by Firestore trigger or Admin SDK only — never write from client or backend application code.",
+        "x-immutable: true": "Set exactly once at document creation. Any subsequent write to this field is a bug.",
+        "deprecated: true": "Do not write in new code. Check x-replaced-by for the replacement field.",
+        "x-internal: true": "Backend-only collection — consumers must not depend on this model's shape."
+      },
+      "tips": [
+        "Field descriptions often contain '(GH#N)' or '(D-id)' references — use get_decision to trace rationale.",
+        "If a field is absent from ModelCreate, it is either readOnly (server-sets it) or deprecated.",
+        "Run get_schema on related enums (e.g. 'payment-status') to understand the allowed values for enum fields."
+      ]
+    },
+    {
+      "slug": "field-history",
+      "title": "Understanding a field's history or rationale",
+      "summary": "How to trace why a field exists, what decision or issue drove it, and whether it has been migrated or superseded.",
+      "steps": [
+        {
+          "step": 1,
+          "tool": "search_docs",
+          "args": { "query": "<fieldName>" },
+          "note": "Find every doc page that mentions the field. This surfaces the model page, any decision pages, and migration docs."
+        },
+        {
+          "step": 2,
+          "tool": "get_schema",
+          "args": { "name": "<model-name>" },
+          "note": "Read the field's 'description' value directly. It typically includes a GH# issue reference or a D-id decision reference."
+        },
+        {
+          "step": 3,
+          "tool": "list_decisions",
+          "args": {},
+          "note": "Scan all decisions for ones related to the model or field. Look at 'status': accepted decisions are live; superseded ones have been replaced."
+        },
+        {
+          "step": 4,
+          "tool": "get_decision",
+          "args": { "id": "<D-id>" },
+          "note": "Get full context: rationale, migration path, affected models, and implementation status."
+        },
+        {
+          "step": 5,
+          "tool": "get_doc",
+          "args": { "slug": "decisions/migrations" },
+          "note": "Check the migrations page for a changelog of field-level changes and the order in which they must be applied."
+        }
+      ],
+      "tips": [
+        "If a field has 'x-replaced-by', check that replacement field's schema and the decision that drove the change.",
+        "A decision with status 'pending' means the change is not yet live — do not depend on the new shape yet.",
+        "search_docs with the GH# (e.g. 'GH#48') will surface all docs that reference that issue."
+      ]
+    },
+    {
+      "slug": "whatsapp-conversation-display",
+      "title": "Displaying WhatsApp conversation history for an order",
+      "summary": "Current workaround for rendering a per-order WhatsApp thread using NotificationRecord documents. There is no dedicated WhatsApp conversation model yet; outbound messages are reconstructed from the notification audit log.",
+      "workaround_notice": "This is a temporary workaround (GH#48). NotificationRecord captures outbound messages only. Inbound customer replies are not stored in Firestore. A proper WhatsApp conversation model is a future concern.",
+      "steps": [
+        {
+          "step": 1,
+          "tool": "get_schema",
+          "args": { "name": "notification-record" },
+          "note": "Understand the full NotificationRecord shape. Note: every field is readOnly — this is a backend-written audit log, consumers read only."
+        },
+        {
+          "step": 2,
+          "tool": "get_doc",
+          "args": { "slug": "collections/firestore-paths" },
+          "note": "Review the two notification collection paths: company-wide (always written) and order-scoped (dual-write when relatedEntity.type === 'order')."
+        },
+        {
+          "step": 3,
+          "action": "query",
+          "collection": "companies/{companyId}/orders/{orderId}/notifications",
+          "filter": "type == 'whatsapp'",
+          "sort": "sentAt ASC",
+          "note": "Use the order-scoped subcollection for O(1) per-order lookup. Filter to type='whatsapp' to exclude email/sms/push records."
+        },
+        {
+          "step": 4,
+          "action": "render",
+          "fields": {
+            "message_content": "templateParams — filled-in template variable values at send time; reconstruct the message text without calling the Meta API.",
+            "delivery_status": "status — 'sent' | 'failed' | 'pending'",
+            "failure_reason": "error — present only when status === 'failed'",
+            "timestamp": "sentAt — Firestore Timestamp; convert to local time for display",
+            "meta_message_id": "wamid — WhatsApp message ID from Meta; use for deduplication if querying both collection paths"
+          },
+          "note": "All display fields are reconstructable from the NotificationRecord alone — no Meta API call needed."
+        },
+        {
+          "step": 5,
+          "action": "deduplicate",
+          "note": "If you query both companies/{cid}/notifications (filtered by relatedEntity.id === orderId) AND the order-scoped subcollection, deduplicate by 'id' — both paths write the same document ID."
+        }
+      ],
+      "related_models": {
+        "notification-record": "GH#48 — the model used in this workaround",
+        "whatsapp-outbound-message": "GH#43 — dashboard-initiated WhatsApp sends. Separate from backend-automated NotificationRecords but both appear in the conversation thread. Query this collection too for a complete view."
+      },
+      "tips": [
+        "notification-record covers ALL channels (email, whatsapp, sms, push). Always filter by type='whatsapp'.",
+        "metadata field may contain 'templateName', 'senderPhoneId', 'orderNumber' — useful for display headers.",
+        "The order-scoped subcollection only exists if at least one notification with relatedEntity.type='order' was sent. Check for its absence gracefully.",
+        "For a company-wide WhatsApp audit (not order-scoped), query companies/{cid}/notifications filtered by type='whatsapp'."
+      ]
+    }
+  ]
+}

package/data/static/llms.txt

@@ -46,6 +46,18 @@ Values: PREPARING, PARTIALLY_SHIPPED, SHIPPED, IN_TRANSIT, DELIVERED, PICKED_UP
 Loyalty point transaction type (D07). SCREAMING_SNAKE past tense.
 Values: EARNED, REDEEMED, ADJUSTED, EXPIRED, BONUS, REFUND
 
+### NotificationChannel
+Delivery channel of a NotificationRecord (GH#48).
+Values: email, whatsapp, sms, push
+
+### NotificationEntityType
+Type of entity a NotificationRecord relates to. When `order`, the record is dual-written to the order-scoped subcollection (GH#48).
+Values: order, booking, customer, digest, magic_link, other
+
+### NotificationStatus
+Delivery status of a NotificationRecord, set by the Cloud Function after a send attempt (GH#48).
+Values: sent, failed, pending
+
 ### OrderStatus
 Core order lifecycle status (D03, D34). Universal across all business types. Replaces the Dashboard's legacy 20-value flat enum (MIG-11).
 Values: PENDING, CONFIRMED, PROCESSING, READY, COMPLETED, CANCELLED, EXPIRED
@@ -1092,6 +1104,66 @@ Example:
 }
 ```
 
+### NotificationRecord
+Fields: 12 (6 required)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| id | ['string', 'null'] | no | (Read-only) Firestore document ID, auto-generated. Same ID is used in both the company-wide and order-scoped copies. |
+| type | NotificationChannel | yes | (Read-only) Delivery channel. |
+| status | NotificationStatus | yes | (Read-only) Delivery status after the send attempt. |
+| subject | ['string', 'null'] | no | (Read-only) Subject line. Present for email notifications only. |
+| recipients | object | yes | (Read-only) Recipients of the notification. |
+| recipients.to | array<object> | yes | Primary recipients. |
+| recipients.to[].email | string | no | Recipient email address. Present for email notifications. |
+| recipients.to[].phone | string | no | Recipient phone number (E.164). Present for whatsapp/sms notifications. |
+| recipients.to[].name | string | no | Recipient display name. |
+| recipients.to[].role | string | no | Recipient role (e.g. organizer, customer). |
+| recipients.cc | array<object> | no | CC recipients (email). |
+| recipients.cc[].email | string | no | Recipient email address. Present for email notifications. |
+| recipients.cc[].phone | string | no | Recipient phone number (E.164). Present for whatsapp/sms notifications. |
+| recipients.cc[].name | string | no | Recipient display name. |
+| recipients.cc[].role | string | no | Recipient role (e.g. organizer, customer). |
+| recipients.bcc | array<object> | no | BCC recipients (email). |
+| recipients.bcc[].email | string | no | Recipient email address. Present for email notifications. |
+| recipients.bcc[].phone | string | no | Recipient phone number (E.164). Present for whatsapp/sms notifications. |
+| recipients.bcc[].name | string | no | Recipient display name. |
+| recipients.bcc[].role | string | no | Recipient role (e.g. organizer, customer). |
+| relatedEntity | object | yes | (Read-only) Entity that triggered the notification. type=order triggers the dual-write to the order subcollection. |
+| relatedEntity.type | NotificationEntityType | yes | Entity type this notification relates to. |
+| relatedEntity.id | string | yes | Entity document ID (e.g. orderId when type=order). |
+| wamid | ['string', 'null'] | no | (Read-only) WhatsApp message ID from the Meta API response. Present on successful whatsapp sends only. |
+| templateParams | ['object', 'null'] | no | (Read-only) Filled-in template variable values at send time. Allows reconstructing the sent message without fetching from Meta. |
+| metadata | ['object', 'null'] | no | (Read-only) Channel-specific extras (e.g. senderPhoneId, templateName, orderNumber). |
+| error | ['string', 'null'] | no | (Read-only) Failure reason. Present on status=failed. |
+| sentAt | FirestoreTimestamp | yes | (Read-only) When the send was attempted. |
+| createdAt | FirestoreTimestamp | yes | (Read-only) When the record was created. |
+
+Example:
+```json
+{
+  "id": null,
+  "type": "phone",
+  "status": "status",
+  "subject": null,
+  "recipients": {
+    "to": [
+      {}
+    ]
+  },
+  "relatedEntity": {
+    "type": "phone",
+    "id": "bk_abc123def456"
+  },
+  "wamid": null,
+  "templateParams": null,
+  "metadata": null,
+  "error": null,
+  "sentAt": "sentAt",
+  "createdAt": "createdAt"
+}
+```
+
 ### Order
 Fields: 48 (8 required)
 

package/data/static/openapi.yaml

@@ -110,6 +110,33 @@ components:
       - BONUS
       - REFUND
       description: Loyalty point transaction type (D07). SCREAMING_SNAKE past tense.
+    NotificationChannel:
+      type: string
+      enum:
+      - email
+      - whatsapp
+      - sms
+      - push
+      description: Delivery channel of a NotificationRecord (GH#48).
+    NotificationEntityType:
+      type: string
+      enum:
+      - order
+      - booking
+      - customer
+      - digest
+      - magic_link
+      - other
+      description: Type of entity a NotificationRecord relates to. When `order`, the
+        record is dual-written to the order-scoped subcollection (GH#48).
+    NotificationStatus:
+      type: string
+      enum:
+      - sent
+      - failed
+      - pending
+      description: Delivery status of a NotificationRecord, set by the Cloud Function
+        after a send attempt (GH#48).
     OrderStatus:
       type: string
       enum:
@@ -3074,6 +3101,171 @@ components:
       description: Write payload for partial update (PATCH) of a MetricsMonthly document.
         All fields optional. Fields marked `readOnly` or `x-immutable` must not be
         sent.
+    NotificationRecord:
+      type: object
+      properties:
+        id:
+          readOnly: true
+          description: (Read-only) Firestore document ID, auto-generated. Same ID
+            is used in both the company-wide and order-scoped copies.
+          type:
+          - string
+          - 'null'
+        type:
+          $ref: '#/components/schemas/NotificationChannel'
+          description: (Read-only) Delivery channel.
+          readOnly: true
+        status:
+          $ref: '#/components/schemas/NotificationStatus'
+          description: (Read-only) Delivery status after the send attempt.
+          readOnly: true
+        subject:
+          readOnly: true
+          description: (Read-only) Subject line. Present for email notifications only.
+          type:
+          - string
+          - 'null'
+        recipients:
+          type: object
+          properties:
+            to:
+              type: array
+              items:
+                type: object
+                properties:
+                  email:
+                    description: Recipient email address. Present for email notifications.
+                    type: string
+                  phone:
+                    description: Recipient phone number (E.164). Present for whatsapp/sms
+                      notifications.
+                    type: string
+                  name:
+                    description: Recipient display name.
+                    type: string
+                  role:
+                    description: Recipient role (e.g. organizer, customer).
+                    type: string
+                additionalProperties: false
+                description: A notification recipient (GH#48).
+              description: Primary recipients.
+            cc:
+              description: CC recipients (email).
+              type: array
+              items:
+                type: object
+                properties:
+                  email:
+                    description: Recipient email address. Present for email notifications.
+                    type: string
+                  phone:
+                    description: Recipient phone number (E.164). Present for whatsapp/sms
+                      notifications.
+                    type: string
+                  name:
+                    description: Recipient display name.
+                    type: string
+                  role:
+                    description: Recipient role (e.g. organizer, customer).
+                    type: string
+                additionalProperties: false
+                description: A notification recipient (GH#48).
+            bcc:
+              description: BCC recipients (email).
+              type: array
+              items:
+                type: object
+                properties:
+                  email:
+                    description: Recipient email address. Present for email notifications.
+                    type: string
+                  phone:
+                    description: Recipient phone number (E.164). Present for whatsapp/sms
+                      notifications.
+                    type: string
+                  name:
+                    description: Recipient display name.
+                    type: string
+                  role:
+                    description: Recipient role (e.g. organizer, customer).
+                    type: string
+                additionalProperties: false
+                description: A notification recipient (GH#48).
+          required:
+          - to
+          additionalProperties: false
+          readOnly: true
+          description: (Read-only) Recipients of the notification.
+        relatedEntity:
+          type: object
+          properties:
+            type:
+              $ref: '#/components/schemas/NotificationEntityType'
+              description: Entity type this notification relates to.
+            id:
+              type: string
+              description: Entity document ID (e.g. orderId when type=order).
+          required:
+          - type
+          - id
+          additionalProperties: false
+          readOnly: true
+          description: (Read-only) Entity that triggered the notification. type=order
+            triggers the dual-write to the order subcollection.
+        wamid:
+          readOnly: true
+          description: (Read-only) WhatsApp message ID from the Meta API response.
+            Present on successful whatsapp sends only.
+          type:
+          - string
+          - 'null'
+        templateParams:
+          readOnly: true
+          description: (Read-only) Filled-in template variable values at send time.
+            Allows reconstructing the sent message without fetching from Meta.
+          type:
+          - object
+          - 'null'
+          propertyNames:
+            type: string
+          additionalProperties:
+            type: string
+        metadata:
+          readOnly: true
+          description: (Read-only) Channel-specific extras (e.g. senderPhoneId, templateName,
+            orderNumber).
+          type:
+          - object
+          - 'null'
+          propertyNames:
+            type: string
+          additionalProperties: {}
+        error:
+          readOnly: true
+          description: (Read-only) Failure reason. Present on status=failed.
+          type:
+          - string
+          - 'null'
+        sentAt:
+          $ref: '#/components/schemas/FirestoreTimestamp'
+          description: (Read-only) When the send was attempted.
+          readOnly: true
+        createdAt:
+          $ref: '#/components/schemas/FirestoreTimestamp'
+          description: (Read-only) When the record was created.
+          readOnly: true
+      required:
+      - type
+      - status
+      - recipients
+      - relatedEntity
+      - sentAt
+      - createdAt
+      additionalProperties: false
+      description: 'NotificationRecord — backend-written, multi-channel notification
+        audit log (GH#48). Paths: companies/{cid}/notifications/{id} (always) and
+        companies/{cid}/orders/{oid}/notifications/{id} (dual-write when relatedEntity.type=order).
+        Consumers read only. Distinct from WhatsappOutboundMessage (GH#43).'
     Order:
       type: object
       properties: