@ingenx-io/valets-schema-mcp-server 0.1.1 → 0.1.3

package/data/static/schemas.json

@@ -0,0 +1,4055 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "description": "@valets/schema \u2014 consolidated schema bundle",
+  "generated": "2026-04-06T19:27:48.749605+00:00",
+  "schemas": {
+    "booking": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) Firestore document ID."
+        },
+        "uid": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) Entity UID. Often mirrors id."
+        },
+        "companyId": {
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Company document ID. Note: optional in current schema \u2014 should be required (see ID consistency audit).",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "status": {
+          "$ref": "#/definitions/booking-status",
+          "description": "Booking lifecycle status. COMPLETED_MIXED = some sessions completed, others cancelled/no-show."
+        },
+        "totalAmount": {
+          "type": "number",
+          "x-note": "Booking uses `totalAmount`; Order uses `amount` for the equivalent field (D05 locked `amount` as canonical for orders). Pending cross-model alignment.",
+          "x-see": {
+            "decisions": [
+              "D05"
+            ]
+          }
+        },
+        "bookingDates": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "date": {
+                "type": "string"
+              },
+              "selectedTimeSlots": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "number"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "timeRange": {
+                      "type": "string"
+                    },
+                    "price": {
+                      "type": "number",
+                      "description": "Canonical price field (D11). Replaces legacy standardPrice/fullPrice (MIG-08)."
+                    },
+                    "notMainPurposePrice": {
+                      "type": "number",
+                      "description": "Price when slot is not the main purpose (D11). Canonical name; replaces legacy aliases (MIG-08)."
+                    },
+                    "hours": {
+                      "type": "string"
+                    },
+                    "startTime": {
+                      "type": "string"
+                    },
+                    "endTime": {
+                      "type": "string"
+                    },
+                    "isNightSlot": {
+                      "type": "boolean"
+                    },
+                    "isNotMainPurpose": {
+                      "type": "boolean"
+                    },
+                    "isNotMainPurposeReason": {
+                      "type": "string"
+                    },
+                    "isNotMainPurposeOtherReason": {
+                      "type": "string"
+                    },
+                    "_deleted": {
+                      "description": "Soft-delete flag. Dashboard writes; Mobile filters (IG-6).",
+                      "type": "boolean"
+                    },
+                    "_deletedAt": {
+                      "$ref": "#/definitions/firestore-timestamp",
+                      "description": "Firestore Timestamp serialized representation"
+                    },
+                    "_deletedBy": {
+                      "description": "FK \u2192 User/staff UID who soft-deleted this item.",
+                      "type": "string"
+                    },
+                    "_lastModifiedAt": {
+                      "$ref": "#/definitions/firestore-timestamp",
+                      "description": "Firestore Timestamp serialized representation"
+                    },
+                    "_lastModifiedBy": {
+                      "description": "FK \u2192 User/staff UID who last modified this item.",
+                      "type": "string"
+                    },
+                    "_version": {
+                      "description": "Monotonic version counter for conflict detection.",
+                      "type": "number"
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "name",
+                    "timeRange",
+                    "price",
+                    "notMainPurposePrice",
+                    "hours",
+                    "startTime",
+                    "endTime"
+                  ],
+                  "additionalProperties": false,
+                  "description": "Selected time slot within a BookingDate. Carries CRDT metadata for conflict-free editing."
+                }
+              },
+              "slotKitTypes": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string"
+                },
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "description": "Kit type per slot (IG-11). Firebase parity gap \u2014 exists in Firestore but Firebase type lacked it."
+              },
+              "slotAddOns": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string"
+                },
+                "additionalProperties": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "description": "Add-on IDs per slot. Numeric IDs to be normalized to descriptive names (MIG-07/D10)."
+              },
+              "extraHours": {
+                "type": "number"
+              },
+              "status": {
+                "$ref": "#/definitions/session-status",
+                "description": "Per-date session status (D19). Dashboard is sole writer; Mobile is read-only."
+              },
+              "statusUpdatedAt": {
+                "$ref": "#/definitions/firestore-timestamp",
+                "readOnly": true,
+                "description": "(Read-only) Timestamp of last status change."
+              },
+              "statusUpdatedBy": {
+                "description": "FK \u2192 User/staff UID who updated this date status.",
+                "type": "string"
+              },
+              "slotStatuses": {
+                "description": "Per-slot session statuses (D19). Keyed by slot ID string.",
+                "type": "object",
+                "propertyNames": {
+                  "type": "string"
+                },
+                "additionalProperties": {
+                  "$ref": "#/definitions/session-status",
+                  "description": "Per-date/per-slot booking session status (D19). Dashboard is sole writer; Mobile is read-only."
+                }
+              },
+              "slotStatusUpdatedAt": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string"
+                },
+                "additionalProperties": {
+                  "$ref": "#/definitions/firestore-timestamp",
+                  "description": "Firestore Timestamp serialized representation"
+                }
+              },
+              "slotStatusUpdatedBy": {
+                "type": "object",
+                "propertyNames": {
+                  "type": "string"
+                },
+                "additionalProperties": {
+                  "type": "string"
+                }
+              },
+              "_deleted": {
+                "description": "Soft-delete flag. Dashboard writes; Mobile filters (IG-6).",
+                "type": "boolean"
+              },
+              "_deletedAt": {
+                "$ref": "#/definitions/firestore-timestamp",
+                "description": "Firestore Timestamp serialized representation"
+              },
+              "_deletedBy": {
+                "description": "FK \u2192 User/staff UID who soft-deleted this item.",
+                "type": "string"
+              },
+              "_lastModifiedAt": {
+                "$ref": "#/definitions/firestore-timestamp",
+                "description": "Firestore Timestamp serialized representation"
+              },
+              "_lastModifiedBy": {
+                "description": "FK \u2192 User/staff UID who last modified this item.",
+                "type": "string"
+              },
+              "_version": {
+                "description": "Monotonic version counter for conflict detection.",
+                "type": "number"
+              }
+            },
+            "required": [
+              "date",
+              "selectedTimeSlots",
+              "slotKitTypes",
+              "slotAddOns",
+              "extraHours"
+            ],
+            "additionalProperties": false,
+            "description": "Single date entry within a Booking. Contains time slots, session statuses (D19), and CRDT metadata."
+          }
+        },
+        "customerId": {
+          "description": "FK \u2192 Customer.id (Firestore doc ID). Links booking to customer record.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "client": {
+          "denormalized": true,
+          "description": "(Denormalized) Embedded client snapshot from Customer at write time.",
+          "type": [
+            "object",
+            "null"
+          ],
+          "properties": {
+            "firstName": {
+              "type": "string"
+            },
+            "lastName": {
+              "type": "string"
+            },
+            "email": {
+              "type": "string"
+            },
+            "phone": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        },
+        "customerName": {
+          "denormalized": true,
+          "description": "(Denormalized) From Customer.name at write time. Canonical field per D24.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customerEmail": {
+          "denormalized": true,
+          "description": "(Denormalized) From Customer.email at write time. Canonical field per D24.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customerPhone": {
+          "denormalized": true,
+          "description": "(Denormalized) From Customer.phone at write time. Canonical field per D24.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "clientName": {
+          "denormalized": true,
+          "deprecated": true,
+          "x-replaced-by": "customerName",
+          "description": "(Denormalized) Legacy \u2014 use `customerName`. D24 standardized to customer* prefix.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "clientReference": {
+          "type": "string"
+        },
+        "clientEmail": {
+          "denormalized": true,
+          "deprecated": true,
+          "x-replaced-by": "customerEmail",
+          "description": "(Denormalized) Legacy \u2014 use `customerEmail`. D24 standardized to customer* prefix.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "clientPhone": {
+          "denormalized": true,
+          "deprecated": true,
+          "x-replaced-by": "customerPhone",
+          "description": "(Denormalized) Legacy \u2014 use `customerPhone`. D24 standardized to customer* prefix.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "service": {
+          "type": [
+            "object",
+            "null"
+          ],
+          "properties": {
+            "name": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        },
+        "serviceId": {
+          "description": "FK \u2192 Service document ID.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "serviceName": {
+          "denormalized": true,
+          "description": "(Denormalized) From Service.name at write time.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "timeSlot": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "date": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "startDate": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "endDate": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "startTime": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "endTime": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "notes": {
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "readOnly": true,
+                "description": "(Read-only) Note ID."
+              },
+              "text": {
+                "type": "string"
+              },
+              "createdAt": {
+                "$ref": "#/definitions/firestore-timestamp",
+                "description": "(Read-only) Firestore Timestamp serialized representation.",
+                "readOnly": true
+              },
+              "createdBy": {
+                "x-immutable": true,
+                "description": "(Immutable) FK \u2192 User/staff UID who created this note.",
+                "type": "string"
+              },
+              "createdByName": {
+                "denormalized": true,
+                "description": "(Denormalized) From User display name at write time.",
+                "type": "string"
+              },
+              "_deleted": {
+                "description": "Soft-delete flag. Dashboard writes; Mobile filters (IG-6).",
+                "type": "boolean"
+              },
+              "_deletedAt": {
+                "$ref": "#/definitions/firestore-timestamp",
+                "description": "Firestore Timestamp serialized representation"
+              },
+              "_deletedBy": {
+                "description": "FK \u2192 User/staff UID who soft-deleted this item.",
+                "type": "string"
+              },
+              "_lastModifiedAt": {
+                "$ref": "#/definitions/firestore-timestamp",
+                "description": "Firestore Timestamp serialized representation"
+              },
+              "_lastModifiedBy": {
+                "description": "FK \u2192 User/staff UID who last modified this item.",
+                "type": "string"
+              },
+              "_version": {
+                "description": "Monotonic version counter for conflict detection.",
+                "type": "number"
+              }
+            },
+            "required": [
+              "id",
+              "text",
+              "createdAt"
+            ],
+            "additionalProperties": false,
+            "description": "Timestamped note attached to a Booking. Carries CRDT metadata."
+          }
+        },
+        "technicalInfo": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "paymentStatus": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/payment-status"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Payment lifecycle status (D01 amended). Used by Order, Sale/Purchase, Booking."
+        },
+        "amountPaid": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "amountRefunded": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "amountPending": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "purchaseId": {
+          "description": "FK \u2192 Sale.id. Link to associated Sale document.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "paymentStatusChangeReason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "paymentStatusChangedBy": {
+          "description": "FK \u2192 User/staff UID who changed payment status.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "paymentStatusChangedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Firestore Timestamp serialized representation"
+        },
+        "paymentProofUrl": {
+          "description": "URL to uploaded payment proof image/document.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "paymentProofStatus": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/payment-proof-status"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Payment proof review status. Used by Order and Booking payment proof workflows."
+        },
+        "paymentProofAddedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Firestore Timestamp serialized representation"
+        },
+        "paymentProofAddedBy": {
+          "description": "FK \u2192 User/staff UID who uploaded the payment proof.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "paymentProofReviewedBy": {
+          "description": "FK \u2192 User/staff UID who reviewed the payment proof.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "paymentProofReviewedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Firestore Timestamp serialized representation"
+        },
+        "paymentProofRejectionReason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "cancellationRequestedById": {
+          "description": "FK \u2192 User/staff UID who requested cancellation.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "cancellationRequestReason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "cancellationProcessedById": {
+          "description": "FK \u2192 User/staff UID who processed the cancellation.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "cancellationProcessedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Firestore Timestamp serialized representation"
+        },
+        "cancelledByRole": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "cancellationReason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "createdAt": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Read-only) Server-generated creation timestamp.",
+          "readOnly": true
+        },
+        "updatedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Server-generated update timestamp."
+        },
+        "createdBy": {
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 User/staff UID who created this booking.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "updatedBy": {
+          "description": "FK \u2192 User/staff UID who last updated this booking.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "createdFromBackend": {
+          "description": "When true, suppresses Firebase notification triggers (D20/IG-8).",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "uid",
+        "status",
+        "totalAmount",
+        "bookingDates",
+        "clientReference",
+        "createdAt"
+      ],
+      "additionalProperties": false,
+      "description": "Booking model. Collection: companies/{companyId}/bookings/{bookingId}. All platforms. Uses BookingStatus (6 values) and SessionStatus (D19) for per-date/slot tracking.",
+      "example": {
+        "id": "bk_abc123def456",
+        "uid": "user_u8x92kqm",
+        "companyId": null,
+        "status": "status",
+        "totalAmount": 45000,
+        "bookingDates": [
+          {
+            "date": "2026-02-15",
+            "selectedTimeSlots": [
+              {
+                "id": 0,
+                "name": "Morning Full Session",
+                "timeRange": "09:00 - 11:00",
+                "price": 15000,
+                "notMainPurposePrice": 10000,
+                "hours": "2h",
+                "startTime": "09:00",
+                "endTime": "11:00"
+              }
+            ],
+            "slotKitTypes": {},
+            "slotAddOns": {},
+            "extraHours": 0
+          }
+        ],
+        "customerId": null,
+        "client": null,
+        "customerName": null,
+        "customerEmail": null,
+        "customerPhone": null,
+        "clientName": null,
+        "clientReference": "CLI-2026-0017",
+        "clientEmail": null,
+        "clientPhone": null,
+        "service": null,
+        "serviceId": null,
+        "serviceName": null,
+        "timeSlot": null,
+        "date": null,
+        "startDate": null,
+        "endDate": null,
+        "startTime": null,
+        "endTime": null,
+        "notes": null,
+        "technicalInfo": null,
+        "paymentStatus": "paymentStatus",
+        "amountPaid": null,
+        "amountRefunded": null,
+        "amountPending": null,
+        "purchaseId": null,
+        "paymentStatusChangeReason": null,
+        "paymentStatusChangedBy": null,
+        "paymentStatusChangedAt": "paymentStatusChangedAt",
+        "paymentProofUrl": null,
+        "paymentProofStatus": "paymentProofStatus",
+        "paymentProofAddedAt": "paymentProofAddedAt",
+        "paymentProofAddedBy": null,
+        "paymentProofReviewedBy": null,
+        "paymentProofReviewedAt": "paymentProofReviewedAt",
+        "paymentProofRejectionReason": null,
+        "cancellationRequestedById": null,
+        "cancellationRequestReason": null,
+        "cancellationProcessedById": null,
+        "cancellationProcessedAt": "cancellationProcessedAt",
+        "cancelledByRole": null,
+        "cancellationReason": null,
+        "createdAt": "createdAt",
+        "updatedAt": "updatedAt",
+        "createdBy": null,
+        "updatedBy": null,
+        "createdFromBackend": null
+      }
+    },
+    "booking-status": {
+      "type": "string",
+      "enum": [
+        "PENDING",
+        "CONFIRMED",
+        "COMPLETED",
+        "CANCELLED",
+        "CANCELLATION_REQUESTED",
+        "COMPLETED_MIXED"
+      ],
+      "description": "Booking lifecycle status. COMPLETED_MIXED = some sessions completed, others cancelled/no-show."
+    },
+    "booking-version": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) Firestore document ID. Server-generated version record."
+        },
+        "bookingId": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Booking.id. Parent booking this version records."
+        },
+        "companyId": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Company document ID. Denormalized for direct queries."
+        },
+        "changeType": {
+          "type": "string",
+          "enum": [
+            "CREATE",
+            "UPDATE",
+            "DELETE"
+          ],
+          "x-immutable": true,
+          "x-note": "DELETE versions are written when a booking is soft-deleted (CRDT _deleted flag). Hard deletes bypass this trail.",
+          "description": "(Immutable) What caused this version record: CREATE, UPDATE, or DELETE."
+        },
+        "changedAt": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Read-only) Timestamp of the write that created this version. Server-set.",
+          "readOnly": true
+        },
+        "changedBy": {
+          "x-immutable": true,
+          "x-note": "Null when the write originated from a Firebase trigger, CLI script, or unknown source.",
+          "description": "(Immutable) FK \u2192 User/staff UID who made the change. Null for server-originated writes.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "changedByRole": {
+          "x-immutable": true,
+          "x-note": "Populated by the Firebase trigger from the write context. Helps distinguish client vs. server writes.",
+          "description": "(Immutable) Which platform/context made the write: DASHBOARD, MOBILE, FIREBASE (trigger), CLI (migration script), or UNKNOWN. SCREAMING_SNAKE per D04.",
+          "type": [
+            "string",
+            "null"
+          ],
+          "enum": [
+            "DASHBOARD",
+            "MOBILE",
+            "FIREBASE",
+            "CLI",
+            "UNKNOWN"
+          ]
+        },
+        "fieldsChanged": {
+          "x-immutable": true,
+          "readOnly": true,
+          "x-note": "Dot-notation paths for nested fields (e.g. \"bookingDates.0.status\"). Populated by diff in Firebase trigger. Null for CREATE versions.",
+          "description": "(Immutable, Read-only) List of field paths that changed in this write. Populated by the Firebase trigger diff. Null for CREATE records.",
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "type": "string"
+          }
+        },
+        "snapshot": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string"
+          },
+          "additionalProperties": {},
+          "x-immutable": true,
+          "readOnly": true,
+          "x-note": "Full Booking document at the time of write. Typed as a string-keyed record to avoid circular schema reference. Consumers cast to Booking at runtime.",
+          "x-see": {
+            "decisions": [
+              "D18"
+            ]
+          },
+          "description": "(Immutable, Read-only) Full snapshot of the Booking document immediately after the write. Untyped to avoid circular schema dependency \u2014 cast to Booking at runtime."
+        }
+      },
+      "required": [
+        "id",
+        "bookingId",
+        "companyId",
+        "changeType",
+        "changedAt",
+        "snapshot"
+      ],
+      "additionalProperties": false,
+      "description": "BookingVersion model (D18). Collection: companies/{companyId}/bookings/{bookingId}/versions/{versionId}. Server-owned audit trail written by Firebase trigger on every Booking mutation. Captures writes from all clients.",
+      "example": {
+        "id": "bk_abc123def456",
+        "bookingId": "boo_ref123",
+        "companyId": "comp_xyz789",
+        "changeType": "CREATE",
+        "changedAt": "changedAt",
+        "changedBy": null,
+        "changedByRole": "DASHBOARD",
+        "fieldsChanged": null,
+        "snapshot": {}
+      }
+    },
+    "customer": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) Firestore document ID. This is the canonical FK target \u2014 other models reference Customer via this field."
+        },
+        "uid": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) Entity UID. Often mirrors id."
+        },
+        "name": {
+          "type": "string"
+        },
+        "email": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "phone": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "address": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "notes": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "tags": {
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "type": "string"
+          }
+        },
+        "communicationEntries": {
+          "description": "Embedded CRM log (D25). Stays as array, not subcollection.",
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "type": "object",
+            "properties": {
+              "timestamp": {
+                "$ref": "#/definitions/firestore-timestamp",
+                "description": "Firestore Timestamp serialized representation"
+              },
+              "type": {
+                "type": "string",
+                "description": "Communication channel (e.g. phone, email, meeting)."
+              },
+              "summary": {
+                "type": "string"
+              },
+              "staffMember": {
+                "description": "Staff member name involved in this communication.",
+                "type": "string"
+              }
+            },
+            "required": [
+              "timestamp",
+              "type",
+              "summary"
+            ],
+            "additionalProperties": false,
+            "description": "CRM communication log entry (D25). Embedded array on Customer document."
+          }
+        },
+        "createdAt": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Read-only) Server-generated creation timestamp.",
+          "readOnly": true
+        },
+        "lastOrderDate": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Updated by server when orders are placed."
+        },
+        "balance": {
+          "readOnly": true,
+          "description": "(Read-only) Outstanding balance. Dashboard-originated, server-calculated.",
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "creditLimit": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "lastPaymentDate": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Updated by server when payments are recorded."
+        },
+        "totalPaid": {
+          "readOnly": true,
+          "description": "(Read-only) Server-calculated total paid amount.",
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "totalOwed": {
+          "readOnly": true,
+          "description": "(Read-only) Server-calculated total owed amount.",
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "loyaltyPoints": {
+          "denormalized": true,
+          "readOnly": true,
+          "description": "(Read-only, Denormalized) Derived summary from loyalty/status subcollection (D08). Source of truth is LoyaltyStatus.pointsBalance.",
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "uid",
+        "name",
+        "createdAt"
+      ],
+      "additionalProperties": false,
+      "description": "Customer model. Collection: companies/{companyId}/customers/{customerId}. Canonical across all platforms.",
+      "example": {
+        "id": "bk_abc123def456",
+        "uid": "user_u8x92kqm",
+        "name": "Amadou Diallo",
+        "email": null,
+        "phone": null,
+        "address": null,
+        "notes": null,
+        "tags": null,
+        "communicationEntries": null,
+        "createdAt": "createdAt",
+        "lastOrderDate": "lastOrderDate",
+        "balance": null,
+        "creditLimit": null,
+        "lastPaymentDate": "lastPaymentDate",
+        "totalPaid": null,
+        "totalOwed": null,
+        "loyaltyPoints": null
+      }
+    },
+    "customer-payment": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "description": "(Read-only) Firestore document ID. Note: optional in current schema \u2014 some legacy docs may lack this field.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "companyId": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Company document ID. Scopes all queries."
+        },
+        "customerId": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Customer.id (Firestore doc ID). Links payment to customer. Set at creation."
+        },
+        "customerName": {
+          "denormalized": true,
+          "description": "(Denormalized) From Customer.name at write time.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "amount": {
+          "type": "number"
+        },
+        "currency": {
+          "type": "string",
+          "const": "XOF",
+          "description": "Currency code. Locked to XOF (West African CFA franc) for now."
+        },
+        "paymentDate": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "Firestore Timestamp serialized representation"
+        },
+        "paymentMethod": {
+          "$ref": "#/definitions/payment-method",
+          "description": "Unified payment method set with African + global methods (D02)."
+        },
+        "referenceNumber": {
+          "type": "string",
+          "description": "Unique payment reference (receipt number, transaction ID, etc.)."
+        },
+        "allocatedAmount": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Total amount allocated to bookings/orders/purchases via allocations. Server-calculated."
+        },
+        "unappliedAmount": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Remaining unallocated amount (amount - allocatedAmount). Server-calculated."
+        },
+        "status": {
+          "$ref": "#/definitions/customer-payment-status",
+          "description": "Customer payment lifecycle status (D22). Tracks allocation progress of received payments."
+        },
+        "notes": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "recordedBy": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 User/staff UID who recorded the payment. Required audit field (D22/IG-7)."
+        },
+        "recordedByName": {
+          "x-immutable": true,
+          "denormalized": true,
+          "description": "(Immutable, Denormalized) From User display name at creation time.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "createdAt": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Read-only) Server-generated creation timestamp.",
+          "readOnly": true
+        },
+        "updatedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Server-generated update timestamp."
+        }
+      },
+      "required": [
+        "companyId",
+        "customerId",
+        "amount",
+        "currency",
+        "paymentDate",
+        "paymentMethod",
+        "referenceNumber",
+        "allocatedAmount",
+        "unappliedAmount",
+        "status",
+        "recordedBy",
+        "createdAt"
+      ],
+      "additionalProperties": false,
+      "description": "CustomerPayment model (D22). Collection: companies/{companyId}/customerPayments/{paymentId}. Dashboard-only today; Mobile read in Wave 2, write in Wave 4 (trusted-party workflow).",
+      "example": {
+        "id": null,
+        "companyId": "comp_xyz789",
+        "customerId": "cus_ref123",
+        "customerName": null,
+        "amount": 45000,
+        "currency": "XOF",
+        "paymentDate": "paymentDate",
+        "paymentMethod": "paymentMethod",
+        "referenceNumber": "PAY-2026-0099",
+        "allocatedAmount": 30000,
+        "unappliedAmount": 15000,
+        "status": "status",
+        "notes": null,
+        "recordedBy": "staff_k0f1",
+        "recordedByName": null,
+        "createdAt": "createdAt",
+        "updatedAt": "updatedAt"
+      }
+    },
+    "customer-payment-allocation": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "description": "(Read-only) Firestore document ID. Note: optional in current schema.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "companyId": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Company document ID."
+        },
+        "paymentId": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 CustomerPayment.id. Parent payment this allocation draws from."
+        },
+        "customerId": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Customer.id (Firestore doc ID)."
+        },
+        "targetId": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Booking.id, Order.id, or Sale.id (polymorphic). See targetType for discriminator."
+        },
+        "targetType": {
+          "$ref": "#/definitions/customer-payment-target-type",
+          "description": "(Immutable) Discriminator for targetId: BOOKING, ORDER, or PURCHASE.",
+          "x-immutable": true
+        },
+        "targetReference": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "allocatedAmount": {
+          "type": "number",
+          "x-immutable": true,
+          "description": "(Immutable) Amount allocated in this allocation. Set at creation."
+        },
+        "transferredToAllocationId": {
+          "description": "FK \u2192 CustomerPaymentAllocation.id. Self-reference for transfer chains.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "transferredFromAllocationId": {
+          "description": "FK \u2192 CustomerPaymentAllocation.id. Self-reference for transfer chains.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "transferredAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Firestore Timestamp serialized representation"
+        },
+        "createdBy": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 User/staff UID who created this allocation."
+        },
+        "createdByName": {
+          "x-immutable": true,
+          "denormalized": true,
+          "description": "(Immutable, Denormalized) From User display name at creation time.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "createdAt": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Read-only) Server-generated creation timestamp.",
+          "readOnly": true
+        }
+      },
+      "required": [
+        "companyId",
+        "paymentId",
+        "customerId",
+        "targetId",
+        "targetType",
+        "allocatedAmount",
+        "createdBy",
+        "createdAt"
+      ],
+      "additionalProperties": false,
+      "description": "CustomerPaymentAllocation model. Collection: companies/{companyId}/customerPaymentAllocations/{allocId}. Links customer payments to bookings, orders, or purchases.",
+      "example": {
+        "id": null,
+        "companyId": "comp_xyz789",
+        "paymentId": "pay_ref123",
+        "customerId": "cus_ref123",
+        "targetId": "tar_ref123",
+        "targetType": "targetType",
+        "targetReference": null,
+        "allocatedAmount": 30000,
+        "transferredToAllocationId": null,
+        "transferredFromAllocationId": null,
+        "transferredAt": "transferredAt",
+        "createdBy": "staff_k0f1",
+        "createdByName": null,
+        "createdAt": "createdAt"
+      }
+    },
+    "customer-payment-status": {
+      "type": "string",
+      "enum": [
+        "PENDING",
+        "CONFIRMED",
+        "PARTIALLY_APPLIED",
+        "FULLY_APPLIED",
+        "REFUNDED",
+        "CANCELLED"
+      ],
+      "description": "Customer payment lifecycle status (D22). Tracks allocation progress of received payments."
+    },
+    "customer-payment-target-type": {
+      "type": "string",
+      "enum": [
+        "BOOKING",
+        "ORDER",
+        "PURCHASE"
+      ],
+      "description": "Target document type for customer payment allocation."
+    },
+    "delivery-type": {
+      "type": "string",
+      "enum": [
+        "ON_SITE",
+        "PICK_UP",
+        "DELIVERY"
+      ],
+      "description": "Fulfillment channel for an order. Determines whether the customer comes to the business (ON_SITE), collects their order themselves (PICK_UP), or receives a physical delivery (DELIVERY). Drives whether fulfillmentStatus is relevant."
+    },
+    "event": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) Firestore document ID. Note: Event does not have a uid field."
+        },
+        "companyId": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Company document ID. Scopes all queries."
+        },
+        "name": {
+          "type": "string"
+        },
+        "description": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "location": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "startDate": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "Firestore Timestamp serialized representation"
+        },
+        "endDate": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Firestore Timestamp serialized representation"
+        },
+        "status": {
+          "$ref": "#/definitions/event-status",
+          "description": "Event lifecycle status (D32). SCREAMING_SNAKE per D04. MIG-09 migrates legacy lowercase values."
+        },
+        "maxTickets": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "ticketsSold": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Counter: total tickets sold. Updated by Firebase triggers (D28)."
+        },
+        "ticketsUsed": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Counter: tickets scanned/used. Updated by Firebase triggers (D28)."
+        },
+        "ticketPrice": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "createdAt": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Read-only) Server-generated creation timestamp.",
+          "readOnly": true
+        },
+        "updatedAt": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Read-only) Server-generated update timestamp.",
+          "readOnly": true
+        },
+        "createdBy": {
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 User/staff UID who created this event.",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "companyId",
+        "name",
+        "startDate",
+        "status",
+        "ticketsSold",
+        "ticketsUsed",
+        "createdAt",
+        "updatedAt"
+      ],
+      "additionalProperties": false,
+      "description": "Event model (D26, D32). Collection: companies/{companyId}/events/{eventId}. Mobile-only today; Dashboard in Wave 4.",
+      "example": {
+        "id": "bk_abc123def456",
+        "companyId": "comp_xyz789",
+        "name": "Amadou Diallo",
+        "description": null,
+        "location": null,
+        "startDate": "2026-02-15",
+        "endDate": "2026-02-20",
+        "status": "status",
+        "maxTickets": null,
+        "ticketsSold": 47,
+        "ticketsUsed": 12,
+        "ticketPrice": null,
+        "createdAt": "createdAt",
+        "updatedAt": "updatedAt",
+        "createdBy": null
+      }
+    },
+    "event-status": {
+      "type": "string",
+      "enum": [
+        "DRAFT",
+        "ACTIVE",
+        "CANCELLED",
+        "COMPLETED"
+      ],
+      "description": "Ticketed event lifecycle (D32). Mobile-only today; Dashboard in Wave 4."
+    },
+    "fulfillment-status": {
+      "type": "string",
+      "enum": [
+        "PREPARING",
+        "PARTIALLY_SHIPPED",
+        "SHIPPED",
+        "IN_TRANSIT",
+        "DELIVERED",
+        "PICKED_UP"
+      ],
+      "description": "Delivery/fulfillment lifecycle (D34). Optional \u2014 null for in-person orders."
+    },
+    "loyalty-config": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "description": "(Read-only) Firestore document ID. Singleton doc \u2014 typically \"config\".",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "isEnabled": {
+          "type": "boolean"
+        },
+        "pointSystem": {
+          "type": "string",
+          "enum": [
+            "SPENDING",
+            "PRODUCT",
+            "VISIT"
+          ],
+          "description": "How points are earned: SPENDING (per currency spent), PRODUCT (per product purchased), or VISIT (per visit). SCREAMING_SNAKE per D04."
+        },
+        "pointsPerCurrency": {
+          "description": "[Deprecated alias: pointsPerCurrencyUnit \u2014 renamed by MIG-06]",
+          "deprecated": true,
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "pointsPerVisit": {
+          "description": "Points earned per visit (when pointSystem is visit).",
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "pointValue": {
+          "description": "Monetary value of one point for redemption.",
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "minimumRedeemPoints": {
+          "description": "Minimum points balance required before redemption is allowed.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "welcomeBonusPoints": {
+          "description": "One-time points bonus for new loyalty enrollees.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "pointsExpirationDays": {
+          "description": "[Deprecated alias: pointsExpiryMonths \u2014 renamed and converted months*30 to days by MIG-06]",
+          "deprecated": true,
+          "anyOf": [
+            {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "createdAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Server-generated creation timestamp."
+        },
+        "updatedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Server-generated update timestamp."
+        }
+      },
+      "required": [
+        "isEnabled",
+        "pointSystem"
+      ],
+      "additionalProperties": false,
+      "description": "LoyaltyConfig model (D21). Collection: companies/{companyId}/loyaltySettings/config. 1 doc per company. Uses canonical field names per D21 (MIG-06 renames legacy aliases).",
+      "example": {
+        "id": null,
+        "isEnabled": true,
+        "pointSystem": "SPENDING",
+        "pointsPerCurrency": null,
+        "pointsPerVisit": null,
+        "pointValue": null,
+        "minimumRedeemPoints": null,
+        "welcomeBonusPoints": null,
+        "pointsExpirationDays": "pointsExpirationDays",
+        "createdAt": "createdAt",
+        "updatedAt": "updatedAt"
+      }
+    },
+    "loyalty-reward": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) Firestore document ID."
+        },
+        "name": {
+          "type": "string"
+        },
+        "description": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "pointsRequired": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "description": "Points cost to redeem this reward."
+        },
+        "isActive": {
+          "type": "boolean",
+          "description": "Whether this reward is currently available for redemption."
+        },
+        "imageUrl": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "rewardType": {
+          "description": "Category of reward (e.g. discount, free_item, service).",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "discountValue": {
+          "description": "Discount amount when rewardType is discount.",
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "productId": {
+          "description": "FK \u2192 Product.id. Linked product when rewardType is free_item.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "createdAt": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Read-only) Server-generated creation timestamp.",
+          "readOnly": true
+        },
+        "updatedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Server-generated update timestamp."
+        }
+      },
+      "required": [
+        "id",
+        "name",
+        "pointsRequired",
+        "isActive",
+        "createdAt"
+      ],
+      "additionalProperties": false,
+      "description": "LoyaltyReward model. Collection: companies/{companyId}/loyaltyRewards/{rewardId}. Reward catalog for point redemption (IG-10).",
+      "example": {
+        "id": "bk_abc123def456",
+        "name": "Free Braiding Session",
+        "description": null,
+        "pointsRequired": 200,
+        "isActive": true,
+        "imageUrl": null,
+        "rewardType": null,
+        "discountValue": null,
+        "productId": null,
+        "createdAt": "createdAt",
+        "updatedAt": "updatedAt"
+      }
+    },
+    "loyalty-status": {
+      "type": "object",
+      "properties": {
+        "customerId": {
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Customer.id. Note: optional despite being in customer subcollection (path already contains custId).",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "pointsBalance": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Current available points balance. Canonical name (D08). Dashboard: pointsBalance, Mobile: currentPoints. Updated by transaction triggers."
+        },
+        "totalPointsEarned": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Lifetime total points earned. Canonical name (D08). Dashboard: totalPointsEarned, Mobile: lifetimePoints. Updated by transaction triggers."
+        },
+        "redeemedPoints": {
+          "readOnly": true,
+          "description": "(Read-only) Total redeemed points. Updated by transaction triggers.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "lastActivityDate": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Last earn/redeem activity. Canonical name (D08). Mobile alias: lastEarnedAt."
+        },
+        "lastRedeemedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Last redemption timestamp."
+        },
+        "tier": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "createdAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Server-generated creation timestamp."
+        },
+        "updatedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Server-generated update timestamp."
+        }
+      },
+      "required": [
+        "pointsBalance",
+        "totalPointsEarned"
+      ],
+      "additionalProperties": false,
+      "description": "LoyaltyStatus model (D08). Collection: companies/{companyId}/customers/{custId}/loyalty/status. Source of truth for customer points. Customer doc loyaltyPoints is a derived summary only.",
+      "example": {
+        "customerId": null,
+        "pointsBalance": 340,
+        "totalPointsEarned": 1200,
+        "redeemedPoints": null,
+        "lastActivityDate": "lastActivityDate",
+        "lastRedeemedAt": "lastRedeemedAt",
+        "tier": null,
+        "createdAt": "createdAt",
+        "updatedAt": "updatedAt"
+      }
+    },
+    "loyalty-transaction": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) Firestore document ID."
+        },
+        "customerId": {
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Customer.id. Note: optional despite being in customer subcollection.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "type": {
+          "$ref": "#/definitions/loyalty-transaction-type",
+          "description": "(Immutable) Transaction type (D07). SCREAMING_SNAKE per D04. MIG-05 migrates legacy lowercase values.",
+          "x-immutable": true
+        },
+        "pointsChange": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "x-immutable": true,
+          "description": "(Immutable) Points delta (+/-). Canonical name (D07). Dashboard: pointsChange, Mobile: points."
+        },
+        "description": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "reason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "relatedPurchaseId": {
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Sale.id. Linked sale that triggered this transaction.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "relatedOrderId": {
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Order.id. Linked order that triggered this transaction.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "relatedRewardId": {
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 LoyaltyReward.id. Reward redeemed in this transaction.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "orderId": {
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Order.id. Note: may overlap with relatedOrderId \u2014 naming inconsistency from Mobile.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "sessionId": {
+          "description": "Session/booking reference. Context-dependent identifier.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "orderAmount": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "transactionDate": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Immutable) When the transaction occurred. Canonical name (D07). Dashboard: transactionDate, Mobile: createdAt.",
+          "x-immutable": true
+        },
+        "pointsBalanceAfter": {
+          "readOnly": true,
+          "description": "(Read-only) Running balance after this transaction. Canonical name (D07). Dashboard: pointsBalanceAfter, Mobile: balanceAfter. Server-calculated.",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991
+        },
+        "createdBy": {
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 User/staff UID who created this transaction.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "createdByName": {
+          "x-immutable": true,
+          "denormalized": true,
+          "description": "(Immutable, Denormalized) From User display name at creation time.",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "type",
+        "pointsChange",
+        "transactionDate"
+      ],
+      "additionalProperties": false,
+      "description": "LoyaltyTransaction model (D07). Collection: companies/{companyId}/customers/{custId}/loyaltyTransactions/{txId}. Type values use SCREAMING_SNAKE per D04 (MIG-05 migrates lowercase).",
+      "example": {
+        "id": "bk_abc123def456",
+        "customerId": null,
+        "type": "phone",
+        "pointsChange": 50,
+        "description": null,
+        "reason": null,
+        "relatedPurchaseId": null,
+        "relatedOrderId": null,
+        "relatedRewardId": null,
+        "orderId": null,
+        "sessionId": null,
+        "orderAmount": null,
+        "transactionDate": "transactionDate",
+        "pointsBalanceAfter": null,
+        "createdBy": null,
+        "createdByName": null
+      }
+    },
+    "loyalty-transaction-type": {
+      "type": "string",
+      "enum": [
+        "EARNED",
+        "REDEEMED",
+        "ADJUSTED",
+        "EXPIRED",
+        "BONUS",
+        "REFUND"
+      ],
+      "description": "Loyalty point transaction type (D07). SCREAMING_SNAKE past tense."
+    },
+    "metrics-current": {
+      "type": "object",
+      "properties": {
+        "todayOrdersCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Orders created today (UTC). Resets at midnight."
+        },
+        "pendingOrdersCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Orders currently in PENDING status (all-time cumulative). Corrected by full recalc on order updates."
+        },
+        "orderCompletionRate30d": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Percentage of orders completed or delivered in the last 30 days. Always full recalc."
+        },
+        "todayPurchasesCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Purchases created today (UTC). Resets at midnight."
+        },
+        "todayPurchasesSum": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Total value of purchases created today (UTC). Resets at midnight."
+        },
+        "averagePurchaseAmount": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Average purchase value across last 200 purchases (rolling, not time-windowed)."
+        },
+        "monthlyRevenue": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Total purchase value in the current calendar month (UTC)."
+        },
+        "monthlyPurchasesCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Number of purchases in the current calendar month (UTC)."
+        },
+        "todayBookingsCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Bookings with date == today AND status in [PENDING, CONFIRMED]. Resets at midnight."
+        },
+        "bookingsCreatedToday": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Bookings with createdAt today (all statuses). Resets at midnight."
+        },
+        "todayBookingsConfirmedAmount": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of totalAmount for bookings created today with status CONFIRMED or COMPLETED. Resets at midnight."
+        },
+        "monthlyBookingsConfirmedAmount": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of totalAmount for bookings created this month with status CONFIRMED or COMPLETED."
+        },
+        "todayCollectedAmount": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of totalAmount for bookings where PAYMENT_PAID_AT is today. Resets at midnight."
+        },
+        "todayRevenue": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of totalAmount for COMPLETED bookings where startDate == endDate == today (numeric YYYYMMDD). Resets at midnight."
+        },
+        "bookingsPendingPaymentVerification": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Bookings with status PENDING/CANCELLATION_REQUESTED and a payment proof uploaded but not yet verified. Current state, always full recalc."
+        },
+        "bookingsPendingValidation": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) PENDING bookings with startDate within \u00b130 days of today. Rolling window, always full recalc."
+        },
+        "bookingsPendingValidation24h": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) PENDING bookings created in the last 24h with startDate >= tomorrow. Always full recalc."
+        },
+        "customersCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Total customer count (all-time cumulative)."
+        },
+        "newCustomersThisMonth": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Customers with createdAt in the current calendar month (UTC)."
+        },
+        "averageRating": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Average rating from the last 200 reviews (rolling). Always full recalc."
+        },
+        "lowStockItemsCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Active stock items where currentQuantity <= minimumQuantity. Current state, always full recalc."
+        },
+        "activeRecurringPaymentsCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Recurring payments with status ACTIVE. Current state, always full recalc."
+        },
+        "monthlyRecurringRevenue": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of amount for ACTIVE + MONTHLY recurring payments. Always full recalc."
+        },
+        "computedForDay": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) YYYY-MM-DD string indicating which day these metrics reflect. Used to detect day boundaries and trigger midnight resets."
+        },
+        "generatedAt": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Read-only) Server timestamp of the last metrics write.",
+          "readOnly": true
+        }
+      },
+      "required": [
+        "todayOrdersCount",
+        "pendingOrdersCount",
+        "orderCompletionRate30d",
+        "todayPurchasesCount",
+        "todayPurchasesSum",
+        "averagePurchaseAmount",
+        "monthlyRevenue",
+        "monthlyPurchasesCount",
+        "todayBookingsCount",
+        "bookingsCreatedToday",
+        "todayBookingsConfirmedAmount",
+        "monthlyBookingsConfirmedAmount",
+        "todayCollectedAmount",
+        "todayRevenue",
+        "bookingsPendingPaymentVerification",
+        "bookingsPendingValidation",
+        "bookingsPendingValidation24h",
+        "customersCount",
+        "newCustomersThisMonth",
+        "averageRating",
+        "lowStockItemsCount",
+        "activeRecurringPaymentsCount",
+        "monthlyRecurringRevenue",
+        "computedForDay",
+        "generatedAt"
+      ],
+      "additionalProperties": false,
+      "description": "Server-computed company metrics. Collection: companies/{companyId}/metrics/current (singleton). All fields are server-set \u2014 clients must never write to this collection. See also MetricsDaily and MetricsMonthly for historical snapshots.",
+      "example": {
+        "todayOrdersCount": 2,
+        "pendingOrdersCount": 2,
+        "orderCompletionRate30d": 0,
+        "todayPurchasesCount": 2,
+        "todayPurchasesSum": 0,
+        "averagePurchaseAmount": 15000,
+        "monthlyRevenue": 0,
+        "monthlyPurchasesCount": 2,
+        "todayBookingsCount": 2,
+        "bookingsCreatedToday": 0,
+        "todayBookingsConfirmedAmount": 15000,
+        "monthlyBookingsConfirmedAmount": 15000,
+        "todayCollectedAmount": 15000,
+        "todayRevenue": 0,
+        "bookingsPendingPaymentVerification": 0,
+        "bookingsPendingValidation": 0,
+        "bookingsPendingValidation24h": 0,
+        "customersCount": 2,
+        "newCustomersThisMonth": 0,
+        "averageRating": 0,
+        "lowStockItemsCount": 2,
+        "activeRecurringPaymentsCount": 2,
+        "monthlyRecurringRevenue": 0,
+        "computedForDay": "computedForDay",
+        "generatedAt": "generatedAt"
+      }
+    },
+    "metrics-daily": {
+      "type": "object",
+      "properties": {
+        "todayOrdersCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Orders created today (UTC). Resets at midnight."
+        },
+        "pendingOrdersCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Orders currently in PENDING status (all-time cumulative). Corrected by full recalc on order updates."
+        },
+        "orderCompletionRate30d": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Percentage of orders completed or delivered in the last 30 days. Always full recalc."
+        },
+        "todayPurchasesCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Purchases created today (UTC). Resets at midnight."
+        },
+        "todayPurchasesSum": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Total value of purchases created today (UTC). Resets at midnight."
+        },
+        "averagePurchaseAmount": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Average purchase value across last 200 purchases (rolling, not time-windowed)."
+        },
+        "monthlyRevenue": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Total purchase value in the current calendar month (UTC)."
+        },
+        "monthlyPurchasesCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Number of purchases in the current calendar month (UTC)."
+        },
+        "todayBookingsCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Bookings with date == today AND status in [PENDING, CONFIRMED]. Resets at midnight."
+        },
+        "bookingsCreatedToday": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Bookings with createdAt today (all statuses). Resets at midnight."
+        },
+        "todayBookingsConfirmedAmount": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of totalAmount for bookings created today with status CONFIRMED or COMPLETED. Resets at midnight."
+        },
+        "monthlyBookingsConfirmedAmount": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of totalAmount for bookings created this month with status CONFIRMED or COMPLETED."
+        },
+        "todayCollectedAmount": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of totalAmount for bookings where PAYMENT_PAID_AT is today. Resets at midnight."
+        },
+        "todayRevenue": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of totalAmount for COMPLETED bookings where startDate == endDate == today (numeric YYYYMMDD). Resets at midnight."
+        },
+        "bookingsPendingPaymentVerification": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Bookings with status PENDING/CANCELLATION_REQUESTED and a payment proof uploaded but not yet verified. Current state, always full recalc."
+        },
+        "bookingsPendingValidation": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) PENDING bookings with startDate within \u00b130 days of today. Rolling window, always full recalc."
+        },
+        "bookingsPendingValidation24h": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) PENDING bookings created in the last 24h with startDate >= tomorrow. Always full recalc."
+        },
+        "customersCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Total customer count (all-time cumulative)."
+        },
+        "newCustomersThisMonth": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Customers with createdAt in the current calendar month (UTC)."
+        },
+        "averageRating": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Average rating from the last 200 reviews (rolling). Always full recalc."
+        },
+        "lowStockItemsCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Active stock items where currentQuantity <= minimumQuantity. Current state, always full recalc."
+        },
+        "activeRecurringPaymentsCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Recurring payments with status ACTIVE. Current state, always full recalc."
+        },
+        "monthlyRecurringRevenue": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of amount for ACTIVE + MONTHLY recurring payments. Always full recalc."
+        },
+        "computedForDay": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) YYYY-MM-DD string indicating which day these metrics reflect. Used to detect day boundaries and trigger midnight resets."
+        },
+        "generatedAt": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Read-only) Server timestamp of the last metrics write.",
+          "readOnly": true
+        },
+        "date": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) YYYY-MM-DD document ID repeated as a field. Identifies the day this snapshot covers."
+        }
+      },
+      "required": [
+        "todayOrdersCount",
+        "pendingOrdersCount",
+        "orderCompletionRate30d",
+        "todayPurchasesCount",
+        "todayPurchasesSum",
+        "averagePurchaseAmount",
+        "monthlyRevenue",
+        "monthlyPurchasesCount",
+        "todayBookingsCount",
+        "bookingsCreatedToday",
+        "todayBookingsConfirmedAmount",
+        "monthlyBookingsConfirmedAmount",
+        "todayCollectedAmount",
+        "todayRevenue",
+        "bookingsPendingPaymentVerification",
+        "bookingsPendingValidation",
+        "bookingsPendingValidation24h",
+        "customersCount",
+        "newCustomersThisMonth",
+        "averageRating",
+        "lowStockItemsCount",
+        "activeRecurringPaymentsCount",
+        "monthlyRecurringRevenue",
+        "computedForDay",
+        "generatedAt",
+        "date"
+      ],
+      "additionalProperties": false,
+      "description": "Daily metrics snapshot. Collection: companies/{companyId}/metrics_daily/{YYYY-MM-DD}. Same fields as MetricsCurrent plus `date`. Written by computeDailyCompanyMetrics cron (02:00 UTC) and inline after full recalcs.",
+      "example": {
+        "todayOrdersCount": 2,
+        "pendingOrdersCount": 2,
+        "orderCompletionRate30d": 0,
+        "todayPurchasesCount": 2,
+        "todayPurchasesSum": 0,
+        "averagePurchaseAmount": 15000,
+        "monthlyRevenue": 0,
+        "monthlyPurchasesCount": 2,
+        "todayBookingsCount": 2,
+        "bookingsCreatedToday": 0,
+        "todayBookingsConfirmedAmount": 15000,
+        "monthlyBookingsConfirmedAmount": 15000,
+        "todayCollectedAmount": 15000,
+        "todayRevenue": 0,
+        "bookingsPendingPaymentVerification": 0,
+        "bookingsPendingValidation": 0,
+        "bookingsPendingValidation24h": 0,
+        "customersCount": 2,
+        "newCustomersThisMonth": 0,
+        "averageRating": 0,
+        "lowStockItemsCount": 2,
+        "activeRecurringPaymentsCount": 2,
+        "monthlyRecurringRevenue": 0,
+        "computedForDay": "computedForDay",
+        "generatedAt": "generatedAt",
+        "date": "2026-02-15"
+      }
+    },
+    "metrics-monthly": {
+      "type": "object",
+      "properties": {
+        "todayOrdersCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Orders created today (UTC). Resets at midnight."
+        },
+        "pendingOrdersCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Orders currently in PENDING status (all-time cumulative). Corrected by full recalc on order updates."
+        },
+        "orderCompletionRate30d": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Percentage of orders completed or delivered in the last 30 days. Always full recalc."
+        },
+        "todayPurchasesCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Purchases created today (UTC). Resets at midnight."
+        },
+        "todayPurchasesSum": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Total value of purchases created today (UTC). Resets at midnight."
+        },
+        "averagePurchaseAmount": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Average purchase value across last 200 purchases (rolling, not time-windowed)."
+        },
+        "monthlyRevenue": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Total purchase value in the current calendar month (UTC)."
+        },
+        "monthlyPurchasesCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Number of purchases in the current calendar month (UTC)."
+        },
+        "todayBookingsCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Bookings with date == today AND status in [PENDING, CONFIRMED]. Resets at midnight."
+        },
+        "bookingsCreatedToday": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Bookings with createdAt today (all statuses). Resets at midnight."
+        },
+        "todayBookingsConfirmedAmount": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of totalAmount for bookings created today with status CONFIRMED or COMPLETED. Resets at midnight."
+        },
+        "monthlyBookingsConfirmedAmount": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of totalAmount for bookings created this month with status CONFIRMED or COMPLETED."
+        },
+        "todayCollectedAmount": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of totalAmount for bookings where PAYMENT_PAID_AT is today. Resets at midnight."
+        },
+        "todayRevenue": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of totalAmount for COMPLETED bookings where startDate == endDate == today (numeric YYYYMMDD). Resets at midnight."
+        },
+        "bookingsPendingPaymentVerification": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Bookings with status PENDING/CANCELLATION_REQUESTED and a payment proof uploaded but not yet verified. Current state, always full recalc."
+        },
+        "bookingsPendingValidation": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) PENDING bookings with startDate within \u00b130 days of today. Rolling window, always full recalc."
+        },
+        "bookingsPendingValidation24h": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) PENDING bookings created in the last 24h with startDate >= tomorrow. Always full recalc."
+        },
+        "customersCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Total customer count (all-time cumulative)."
+        },
+        "newCustomersThisMonth": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Customers with createdAt in the current calendar month (UTC)."
+        },
+        "averageRating": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Average rating from the last 200 reviews (rolling). Always full recalc."
+        },
+        "lowStockItemsCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Active stock items where currentQuantity <= minimumQuantity. Current state, always full recalc."
+        },
+        "activeRecurringPaymentsCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Recurring payments with status ACTIVE. Current state, always full recalc."
+        },
+        "monthlyRecurringRevenue": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of amount for ACTIVE + MONTHLY recurring payments. Always full recalc."
+        },
+        "computedForDay": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) YYYY-MM-DD string indicating which day these metrics reflect. Used to detect day boundaries and trigger midnight resets."
+        },
+        "generatedAt": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Read-only) Server timestamp of the last metrics write.",
+          "readOnly": true
+        },
+        "month": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) YYYY-MM document ID repeated as a field. Identifies the month this rollup covers."
+        }
+      },
+      "required": [
+        "todayOrdersCount",
+        "pendingOrdersCount",
+        "orderCompletionRate30d",
+        "todayPurchasesCount",
+        "todayPurchasesSum",
+        "averagePurchaseAmount",
+        "monthlyRevenue",
+        "monthlyPurchasesCount",
+        "todayBookingsCount",
+        "bookingsCreatedToday",
+        "todayBookingsConfirmedAmount",
+        "monthlyBookingsConfirmedAmount",
+        "todayCollectedAmount",
+        "todayRevenue",
+        "bookingsPendingPaymentVerification",
+        "bookingsPendingValidation",
+        "bookingsPendingValidation24h",
+        "customersCount",
+        "newCustomersThisMonth",
+        "averageRating",
+        "lowStockItemsCount",
+        "activeRecurringPaymentsCount",
+        "monthlyRecurringRevenue",
+        "computedForDay",
+        "generatedAt",
+        "month"
+      ],
+      "additionalProperties": false,
+      "description": "Monthly metrics rollup. Collection: companies/{companyId}/metrics_monthly/{YYYY-MM}. Same fields as MetricsCurrent plus `month`. Written alongside daily snapshots; reflects state at last full recalc within the month.",
+      "example": {
+        "todayOrdersCount": 2,
+        "pendingOrdersCount": 2,
+        "orderCompletionRate30d": 0,
+        "todayPurchasesCount": 2,
+        "todayPurchasesSum": 0,
+        "averagePurchaseAmount": 15000,
+        "monthlyRevenue": 0,
+        "monthlyPurchasesCount": 2,
+        "todayBookingsCount": 2,
+        "bookingsCreatedToday": 0,
+        "todayBookingsConfirmedAmount": 15000,
+        "monthlyBookingsConfirmedAmount": 15000,
+        "todayCollectedAmount": 15000,
+        "todayRevenue": 0,
+        "bookingsPendingPaymentVerification": 0,
+        "bookingsPendingValidation": 0,
+        "bookingsPendingValidation24h": 0,
+        "customersCount": 2,
+        "newCustomersThisMonth": 0,
+        "averageRating": 0,
+        "lowStockItemsCount": 2,
+        "activeRecurringPaymentsCount": 2,
+        "monthlyRecurringRevenue": 0,
+        "computedForDay": "computedForDay",
+        "generatedAt": "generatedAt",
+        "month": "month"
+      }
+    },
+    "order": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) Firestore document ID. Note: some models also have uid; see ID conventions."
+        },
+        "uid": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) Entity UID. Often mirrors id."
+        },
+        "companyId": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Company document ID. Scopes all queries."
+        },
+        "orderNumber": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) Server-generated order number."
+        },
+        "status": {
+          "$ref": "#/definitions/order-status",
+          "description": "Core lifecycle status (D34, MIG-11). See OrderStatus enum for the legacy value migration mapping.",
+          "x-migration": {
+            "source": "Dashboard flat 20-value OrderStatus",
+            "migration": "MIG-11",
+            "note": "REFUND_PROCESSING and REFUNDED map to paymentStatus, not returnStatus \u2014 an order can be refunded without a physical return.",
+            "mapping": [
+              {
+                "old": "PENDING",
+                "status": "PENDING"
+              },
+              {
+                "old": "CONFIRMED",
+                "status": "CONFIRMED"
+              },
+              {
+                "old": "PROCESSING",
+                "status": "PROCESSING"
+              },
+              {
+                "old": "READY",
+                "status": "READY"
+              },
+              {
+                "old": "COMPLETED",
+                "status": "COMPLETED"
+              },
+              {
+                "old": "CANCELLED",
+                "status": "CANCELLED"
+              },
+              {
+                "old": "EXPIRED",
+                "status": "EXPIRED"
+              },
+              {
+                "old": "AWAITING_PAYMENT",
+                "status": "PENDING",
+                "paymentStatus": "PENDING"
+              },
+              {
+                "old": "SHIPPED",
+                "status": "PROCESSING",
+                "fulfillmentStatus": "SHIPPED"
+              },
+              {
+                "old": "PARTIALLY_SHIPPED",
+                "status": "PROCESSING",
+                "fulfillmentStatus": "PARTIALLY_SHIPPED"
+              },
+              {
+                "old": "ON_THE_WAY",
+                "status": "PROCESSING",
+                "fulfillmentStatus": "IN_TRANSIT"
+              },
+              {
+                "old": "DELIVERED",
+                "status": "COMPLETED",
+                "fulfillmentStatus": "DELIVERED"
+              },
+              {
+                "old": "PICKED_UP",
+                "status": "COMPLETED",
+                "fulfillmentStatus": "PICKED_UP"
+              },
+              {
+                "old": "RETURN_REQUESTED",
+                "status": "COMPLETED",
+                "returnStatus": "RETURN_REQUESTED"
+              },
+              {
+                "old": "RETURN_PROCESSING",
+                "status": "COMPLETED",
+                "returnStatus": "RETURN_PROCESSING"
+              },
+              {
+                "old": "RETURNED",
+                "status": "COMPLETED",
+                "returnStatus": "RETURNED"
+              },
+              {
+                "old": "EXCHANGE_REQUESTED",
+                "status": "COMPLETED",
+                "returnStatus": "EXCHANGE_REQUESTED"
+              },
+              {
+                "old": "EXCHANGE_PROCESSING",
+                "status": "COMPLETED",
+                "returnStatus": "EXCHANGE_PROCESSING"
+              },
+              {
+                "old": "EXCHANGE_COMPLETED",
+                "status": "COMPLETED",
+                "returnStatus": "EXCHANGE_COMPLETED"
+              },
+              {
+                "old": "REFUND_PROCESSING",
+                "status": "COMPLETED",
+                "paymentStatus": "REFUND_PROCESSING"
+              },
+              {
+                "old": "REFUNDED",
+                "status": "COMPLETED",
+                "paymentStatus": "REFUNDED"
+              }
+            ]
+          }
+        },
+        "paymentStatus": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/payment-status"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Payment lifecycle (D34). Null until payment is initiated."
+        },
+        "fulfillmentStatus": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/fulfillment-status"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "x-when": "Null for ON_SITE and PICK_UP orders. Set when deliveryType is DELIVERY and a physical shipment or pickup is involved.",
+          "x-see": {
+            "decisions": [
+              "D34"
+            ]
+          },
+          "description": "Delivery/fulfillment lifecycle (D34)."
+        },
+        "returnStatus": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/return-status"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Return/exchange lifecycle (D34). Null until a return or exchange is initiated."
+        },
+        "deliveryType": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/delivery-type"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "x-note": "Drives whether fulfillmentStatus is relevant. ON_SITE and PICK_UP orders typically have no fulfillmentStatus.",
+          "description": "Fulfillment channel for this order (ON_SITE, PICK_UP, DELIVERY)."
+        },
+        "paymentMethod": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/payment-method"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Unified payment method set with African + global methods (D02)."
+        },
+        "invoiceId": {
+          "description": "FK \u2192 Invoice document ID.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customerId": {
+          "description": "FK \u2192 Customer.id (Firestore doc ID). Used to resolve customer details.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customerName": {
+          "denormalized": true,
+          "description": "(Denormalized) From Customer.name at write time.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customerEmail": {
+          "denormalized": true,
+          "description": "(Denormalized) From Customer.email at write time. Canonical field per D24.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customerPhone": {
+          "denormalized": true,
+          "description": "(Denormalized) From Customer.phone at write time. Canonical field per D24.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "clientEmail": {
+          "denormalized": true,
+          "deprecated": true,
+          "x-replaced-by": "customerEmail",
+          "description": "(Denormalized) Legacy \u2014 use `customerEmail`. D24 standardized to customer* prefix.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "clientPhoneNumber": {
+          "denormalized": true,
+          "deprecated": true,
+          "x-replaced-by": "customerPhone",
+          "description": "(Denormalized) Legacy \u2014 use `customerPhone`. D24 standardized to customer* prefix.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "items": {
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "$ref": "#/definitions/order-item",
+            "description": "Line item within an Order or Sale/Purchase. Canonical fields: name, quantity, price, productId. Optional commerce fields (increment, variantId, supplierId, supplierName) and kitchen tracking fields (sentAt, startedCookingAt, readyAt, servedAt) are TBD/WIP pending cross-platform alignment."
+          }
+        },
+        "amount": {
+          "type": "number",
+          "description": "Total order amount. Canonical field for the order total."
+        },
+        "amountPaid": {
+          "description": "Amount of `amount` paid to date. Derived from payment allocations.",
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "total": {
+          "deprecated": true,
+          "x-replaced-by": "amount",
+          "x-note": "Sent by Mobile only. Mirrors `amount`. Use `amount` for all new writes. Pending deduplication cleanup.",
+          "description": "Mobile-only legacy total field. Deprecated \u2014 use `amount`.",
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "createdAt": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Read-only) Server-generated creation timestamp.",
+          "readOnly": true
+        },
+        "orderDate": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "Firestore Timestamp serialized representation"
+        },
+        "PROCESSING_ON": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "x-note": "Never write this field directly. The server sets it automatically on status transition to PROCESSING.",
+          "x-see": {
+            "decisions": [
+              "D04"
+            ],
+            "migrations": [
+              "MIG-01"
+            ]
+          },
+          "description": "(Read-only) Timestamp when order entered PROCESSING (D04 SCREAMING_SNAKE). MIG-01 renames from camelCase."
+        },
+        "COMPLETED_ON": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Timestamp when order completed (D04 SCREAMING_SNAKE). MIG-01 renames from camelCase."
+        },
+        "CANCELLED_ON": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Timestamp when order cancelled (D04 SCREAMING_SNAKE). MIG-01 renames from camelCase."
+        },
+        "cancellationReason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "shippingCarrier": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "trackingNumber": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "estimatedDeliveryDate": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Firestore Timestamp serialized representation"
+        },
+        "shippingCost": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "paymentProofUrl": {
+          "description": "URL to uploaded payment proof image/document.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "paymentProofStatus": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/payment-proof-status"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Payment proof review status."
+        },
+        "paymentProofAddedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Timestamp when proof was uploaded."
+        },
+        "paymentProofAddedBy": {
+          "description": "FK \u2192 User/staff UID who uploaded the payment proof.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "paymentProofReviewedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Timestamp when proof was reviewed."
+        },
+        "paymentProofReviewedBy": {
+          "description": "FK \u2192 User/staff UID who reviewed the payment proof.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "paymentProofRejectionReason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "paymentStatusChangeReason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "paymentStatusChangedBy": {
+          "description": "FK \u2192 User/staff UID who changed payment status.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "paymentStatusChangedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Timestamp of last payment status change."
+        },
+        "payments": {
+          "x-note": "Shape and sync rules are TBD pending IG-4 resolution. Do not build production logic against this field until IG-4 is closed.",
+          "x-see": {
+            "issues": [
+              "IG-4"
+            ]
+          },
+          "description": "[TBD/WIP \u2014 IG-4] Denormalized snapshots of CustomerPayments allocated to this order. Sync rules pending IG-4 resolution.",
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "type": "object",
+            "properties": {
+              "paymentId": {
+                "type": "string",
+                "x-immutable": true,
+                "description": "(Immutable) FK \u2192 CustomerPayment.id. Source document for this snapshot."
+              },
+              "amount": {
+                "type": "number",
+                "description": "Total payment amount."
+              },
+              "currency": {
+                "type": "string",
+                "const": "XOF",
+                "description": "Currency code. Locked to XOF."
+              },
+              "paymentMethod": {
+                "$ref": "#/definitions/payment-method",
+                "description": "Payment method used (D02)."
+              },
+              "paymentDate": {
+                "$ref": "#/definitions/firestore-timestamp",
+                "description": "Firestore Timestamp serialized representation"
+              },
+              "referenceNumber": {
+                "description": "Payment reference (receipt number, transaction ID, etc.).",
+                "type": "string"
+              },
+              "status": {
+                "$ref": "#/definitions/customer-payment-status",
+                "description": "Payment status at time of snapshot. May lag CustomerPayment.status until re-synced."
+              }
+            },
+            "required": [
+              "paymentId",
+              "amount",
+              "currency",
+              "paymentMethod",
+              "paymentDate",
+              "status"
+            ],
+            "additionalProperties": false,
+            "description": "[TBD/WIP \u2014 IG-4] Denormalized payment snapshot. Subset of CustomerPayment (D22), written when a payment is allocated to this order. Sync rules pending IG-4 resolution."
+          }
+        },
+        "totalOverridden": {
+          "x-when": "Set only by the mobile app when the user manually edits the order total. Dashboard and Cloud Functions should treat this field as read-only.",
+          "x-see": {
+            "decisions": [
+              "D14"
+            ]
+          },
+          "description": "Mobile-only. When true, total was manually overridden by user (D14).",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "notes": {
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "readOnly": true,
+                "description": "(Read-only) Note ID. Server-generated."
+              },
+              "text": {
+                "type": "string"
+              },
+              "createdAt": {
+                "$ref": "#/definitions/firestore-timestamp",
+                "description": "(Read-only) Firestore Timestamp serialized representation.",
+                "readOnly": true
+              },
+              "createdBy": {
+                "x-immutable": true,
+                "description": "(Immutable) FK \u2192 User/staff UID who created this note.",
+                "type": "string"
+              },
+              "createdByName": {
+                "denormalized": true,
+                "description": "(Denormalized) From User display name at write time.",
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "text",
+              "createdAt"
+            ],
+            "additionalProperties": false,
+            "description": "Timestamped note attached to an Order."
+          }
+        },
+        "additionalInfo": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "appliedDiscountCode": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "purchaseId": {
+          "description": "FK \u2192 Sale.id. Link to associated Sale document.",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "uid",
+        "companyId",
+        "orderNumber",
+        "status",
+        "amount",
+        "createdAt",
+        "orderDate"
+      ],
+      "additionalProperties": false,
+      "description": "Order model (D34). Collection: companies/{companyId}/orders/{orderId}. Status decomposed into 4 orthogonal fields per D34: status (OrderStatus), paymentStatus, fulfillmentStatus, returnStatus. deliveryType determines the fulfillment channel. MIG-11 migrates the old flat 20-value enum.",
+      "example": {
+        "id": "bk_abc123def456",
+        "uid": "user_u8x92kqm",
+        "companyId": "comp_xyz789",
+        "orderNumber": "ORD-2026-0042",
+        "status": "status",
+        "paymentStatus": "paymentStatus",
+        "fulfillmentStatus": "fulfillmentStatus",
+        "returnStatus": "returnStatus",
+        "deliveryType": "deliveryType",
+        "paymentMethod": "paymentMethod",
+        "invoiceId": null,
+        "customerId": null,
+        "customerName": null,
+        "customerEmail": null,
+        "customerPhone": null,
+        "clientEmail": null,
+        "clientPhoneNumber": null,
+        "items": null,
+        "amount": 45000,
+        "amountPaid": null,
+        "total": null,
+        "createdAt": "createdAt",
+        "orderDate": "orderDate",
+        "PROCESSING_ON": "PROCESSING_ON",
+        "COMPLETED_ON": "COMPLETED_ON",
+        "CANCELLED_ON": "CANCELLED_ON",
+        "cancellationReason": null,
+        "shippingCarrier": null,
+        "trackingNumber": null,
+        "estimatedDeliveryDate": "estimatedDeliveryDate",
+        "shippingCost": null,
+        "paymentProofUrl": null,
+        "paymentProofStatus": "paymentProofStatus",
+        "paymentProofAddedAt": "paymentProofAddedAt",
+        "paymentProofAddedBy": null,
+        "paymentProofReviewedAt": "paymentProofReviewedAt",
+        "paymentProofReviewedBy": null,
+        "paymentProofRejectionReason": null,
+        "paymentStatusChangeReason": null,
+        "paymentStatusChangedBy": null,
+        "paymentStatusChangedAt": "paymentStatusChangedAt",
+        "payments": null,
+        "totalOverridden": null,
+        "notes": null,
+        "additionalInfo": null,
+        "appliedDiscountCode": null,
+        "purchaseId": null
+      }
+    },
+    "order-item": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Display name of the product or service."
+        },
+        "quantity": {
+          "type": "number",
+          "description": "Number of units ordered."
+        },
+        "price": {
+          "type": "number",
+          "description": "Unit price. Canonical name per D11."
+        },
+        "productId": {
+          "description": "FK \u2192 Product document ID.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "increment": {
+          "x-note": "TBD/WIP \u2014 Dashboard/Firebase only. Canonical status pending cross-platform alignment.",
+          "description": "Quantity step for bundle/bulk items (e.g. 5 for a 5-pack). Dashboard/Firebase only.",
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "variantId": {
+          "x-note": "TBD/WIP \u2014 Dashboard/Firebase only. Canonical status pending cross-platform alignment.",
+          "description": "FK \u2192 ProductVariant ID within the product. Dashboard/Firebase only.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "supplierId": {
+          "x-note": "TBD/WIP \u2014 B2B orders only. Canonical status pending cross-platform alignment.",
+          "description": "FK \u2192 Supplier document ID. B2B orders only.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "supplierName": {
+          "denormalized": true,
+          "x-note": "TBD/WIP \u2014 B2B orders only. Canonical status pending cross-platform alignment.",
+          "description": "(Denormalized) From Supplier.name at write time. B2B orders only.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "sentAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "x-note": "TBD/WIP \u2014 Originally from the archived Couchbase Lite (CBL) restaurant flow. Canonical inclusion in Firestore model is pending review.",
+          "description": "(Read-only) Timestamp when the item was sent to the kitchen. TBD/WIP \u2014 archived CBL flow."
+        },
+        "startedCookingAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "x-note": "TBD/WIP \u2014 Originally from the archived Couchbase Lite (CBL) restaurant flow. Canonical inclusion in Firestore model is pending review.",
+          "description": "(Read-only) Timestamp when the kitchen started preparing this item. TBD/WIP \u2014 archived CBL flow."
+        },
+        "readyAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "x-note": "TBD/WIP \u2014 Originally from the archived Couchbase Lite (CBL) restaurant flow. Canonical inclusion in Firestore model is pending review.",
+          "description": "(Read-only) Timestamp when the item was ready for pickup or service. TBD/WIP \u2014 archived CBL flow."
+        },
+        "servedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "x-note": "TBD/WIP \u2014 Originally from the archived Couchbase Lite (CBL) restaurant flow. Canonical inclusion in Firestore model is pending review.",
+          "description": "(Read-only) Timestamp when the item was served to the customer. TBD/WIP \u2014 archived CBL flow."
+        }
+      },
+      "required": [
+        "name",
+        "quantity",
+        "price"
+      ],
+      "additionalProperties": false,
+      "description": "Line item within an Order or Sale/Purchase. Canonical fields: name, quantity, price, productId. Optional commerce fields (increment, variantId, supplierId, supplierName) and kitchen tracking fields (sentAt, startedCookingAt, readyAt, servedAt) are TBD/WIP pending cross-platform alignment.",
+      "example": {
+        "name": "Shea Butter Body Lotion",
+        "quantity": 3,
+        "price": 15000,
+        "productId": null,
+        "increment": null,
+        "variantId": null,
+        "supplierId": null,
+        "supplierName": null,
+        "sentAt": "sentAt",
+        "startedCookingAt": "startedCookingAt",
+        "readyAt": "readyAt",
+        "servedAt": "servedAt"
+      }
+    },
+    "order-status": {
+      "type": "string",
+      "enum": [
+        "PENDING",
+        "CONFIRMED",
+        "PROCESSING",
+        "READY",
+        "COMPLETED",
+        "CANCELLED",
+        "EXPIRED"
+      ],
+      "description": "Core order lifecycle status (D03, D34). Universal across all business types. Replaces the Dashboard's legacy 20-value flat enum (MIG-11).",
+      "x-migration": {
+        "source": "Dashboard flat 20-value OrderStatus",
+        "migration": "MIG-11",
+        "note": "REFUND_PROCESSING and REFUNDED map to paymentStatus, not returnStatus \u2014 an order can be refunded without a physical return.",
+        "mapping": [
+          {
+            "old": "PENDING",
+            "status": "PENDING"
+          },
+          {
+            "old": "CONFIRMED",
+            "status": "CONFIRMED"
+          },
+          {
+            "old": "PROCESSING",
+            "status": "PROCESSING"
+          },
+          {
+            "old": "READY",
+            "status": "READY"
+          },
+          {
+            "old": "COMPLETED",
+            "status": "COMPLETED"
+          },
+          {
+            "old": "CANCELLED",
+            "status": "CANCELLED"
+          },
+          {
+            "old": "EXPIRED",
+            "status": "EXPIRED"
+          },
+          {
+            "old": "AWAITING_PAYMENT",
+            "status": "PENDING",
+            "paymentStatus": "PENDING"
+          },
+          {
+            "old": "SHIPPED",
+            "status": "PROCESSING",
+            "fulfillmentStatus": "SHIPPED"
+          },
+          {
+            "old": "PARTIALLY_SHIPPED",
+            "status": "PROCESSING",
+            "fulfillmentStatus": "PARTIALLY_SHIPPED"
+          },
+          {
+            "old": "ON_THE_WAY",
+            "status": "PROCESSING",
+            "fulfillmentStatus": "IN_TRANSIT"
+          },
+          {
+            "old": "DELIVERED",
+            "status": "COMPLETED",
+            "fulfillmentStatus": "DELIVERED"
+          },
+          {
+            "old": "PICKED_UP",
+            "status": "COMPLETED",
+            "fulfillmentStatus": "PICKED_UP"
+          },
+          {
+            "old": "RETURN_REQUESTED",
+            "status": "COMPLETED",
+            "returnStatus": "RETURN_REQUESTED"
+          },
+          {
+            "old": "RETURN_PROCESSING",
+            "status": "COMPLETED",
+            "returnStatus": "RETURN_PROCESSING"
+          },
+          {
+            "old": "RETURNED",
+            "status": "COMPLETED",
+            "returnStatus": "RETURNED"
+          },
+          {
+            "old": "EXCHANGE_REQUESTED",
+            "status": "COMPLETED",
+            "returnStatus": "EXCHANGE_REQUESTED"
+          },
+          {
+            "old": "EXCHANGE_PROCESSING",
+            "status": "COMPLETED",
+            "returnStatus": "EXCHANGE_PROCESSING"
+          },
+          {
+            "old": "EXCHANGE_COMPLETED",
+            "status": "COMPLETED",
+            "returnStatus": "EXCHANGE_COMPLETED"
+          },
+          {
+            "old": "REFUND_PROCESSING",
+            "status": "COMPLETED",
+            "paymentStatus": "REFUND_PROCESSING"
+          },
+          {
+            "old": "REFUNDED",
+            "status": "COMPLETED",
+            "paymentStatus": "REFUNDED"
+          }
+        ]
+      }
+    },
+    "payment-method": {
+      "type": "string",
+      "enum": [
+        "CASH",
+        "CREDIT_CARD",
+        "ORANGE_MONEY",
+        "WAVE",
+        "MTN_MONEY",
+        "MOOV_MONEY",
+        "BANK_TRANSFER",
+        "PAYPAL",
+        "STRIPE",
+        "OTHER"
+      ],
+      "description": "Unified payment method set with African + global methods (D02)."
+    },
+    "payment-proof-status": {
+      "type": "string",
+      "enum": [
+        "PENDING",
+        "APPROVED",
+        "REJECTED"
+      ],
+      "description": "Payment proof review status. Used by Order and Booking payment proof workflows."
+    },
+    "payment-status": {
+      "type": "string",
+      "enum": [
+        "PENDING",
+        "PAID",
+        "PARTIALLY_PAID",
+        "FAILED",
+        "REFUND_PROCESSING",
+        "REFUNDED",
+        "PARTIALLY_REFUNDED"
+      ],
+      "description": "Payment lifecycle status (D01 amended). Used by Order, Sale/Purchase, Booking."
+    },
+    "return-status": {
+      "type": "string",
+      "enum": [
+        "RETURN_REQUESTED",
+        "RETURN_PROCESSING",
+        "RETURNED",
+        "EXCHANGE_REQUESTED",
+        "EXCHANGE_PROCESSING",
+        "EXCHANGE_COMPLETED"
+      ],
+      "description": "Post-sale return/exchange lifecycle (D34). Optional \u2014 null until return or exchange initiated."
+    },
+    "sale": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "description": "(Read-only) Firestore document ID. Note: optional in current schema \u2014 some legacy docs may lack this field.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "companyId": {
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Company document ID. Note: optional in current schema \u2014 should be required (see ID consistency audit).",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customerId": {
+          "description": "FK \u2192 Customer.id (Firestore doc ID).",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customerName": {
+          "denormalized": true,
+          "description": "(Denormalized) From Customer.name at write time.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "amount": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "items": {
+          "description": "Line items. Reuses Order item schema.",
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "$ref": "#/definitions/order-item",
+            "description": "Line item within an Order or Sale/Purchase. Canonical fields: name, quantity, price, productId. Optional commerce fields (increment, variantId, supplierId, supplierName) and kitchen tracking fields (sentAt, startedCookingAt, readyAt, servedAt) are TBD/WIP pending cross-platform alignment."
+          }
+        },
+        "imageUrl": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "notes": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "orderId": {
+          "description": "FK \u2192 Order.id. Link to associated Order document.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "bookingId": {
+          "description": "FK \u2192 Booking.id. Link to associated Booking document (IG-12).",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "purchaseDate": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "Firestore Timestamp serialized representation"
+        },
+        "createdAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Server-generated creation timestamp."
+        }
+      },
+      "required": [
+        "purchaseDate"
+      ],
+      "additionalProperties": false,
+      "description": "Sale/Purchase model (D06). Collection: companies/{companyId}/purchases/{purchaseId}. Code alias: SalesService. [Deprecated path: customers/{custId}/purchases/{purchaseId} \u2014 migrate to company-wide path per MIG-04/IG-5]",
+      "example": {
+        "id": null,
+        "companyId": null,
+        "customerId": null,
+        "customerName": null,
+        "amount": null,
+        "items": null,
+        "imageUrl": null,
+        "notes": null,
+        "orderId": null,
+        "bookingId": null,
+        "purchaseDate": "purchaseDate",
+        "createdAt": "createdAt"
+      }
+    },
+    "session-status": {
+      "type": "string",
+      "enum": [
+        "PENDING",
+        "CONFIRMED",
+        "CANCELLATION_REQUESTED",
+        "COMPLETED",
+        "NO_SHOW",
+        "CANCELLED"
+      ],
+      "description": "Per-date/per-slot booking session status (D19). Dashboard is sole writer; Mobile is read-only."
+    },
+    "ticket": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) Firestore document ID. Note: Ticket does not have a uid field."
+        },
+        "eventId": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Event.id. Parent event this ticket belongs to. Set at creation."
+        },
+        "companyId": {
+          "type": "string",
+          "x-immutable": true,
+          "denormalized": true,
+          "description": "(Immutable, Denormalized) FK \u2192 Company document ID. Denormalized from parent Event for direct queries."
+        },
+        "customerId": {
+          "x-see": {
+            "decisions": [
+              "D29"
+            ]
+          },
+          "x-note": "Added additively per D29. Denormalized customerName/email/phone are kept for backwards compatibility. Null on tickets created before D29 was applied.",
+          "description": "FK \u2192 Customer.id. Optional structured link to Customer document (D29). Added additively alongside denormalized fields.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customerName": {
+          "denormalized": true,
+          "description": "(Denormalized) From Customer.name at write time.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customerEmail": {
+          "denormalized": true,
+          "description": "(Denormalized) From Customer.email at write time.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customerPhone": {
+          "denormalized": true,
+          "description": "(Denormalized) From Customer.phone at write time.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "status": {
+          "$ref": "#/definitions/ticket-status",
+          "description": "Ticket lifecycle (D32). SCREAMING_SNAKE per D04. MIG-10 migrates legacy lowercase values."
+        },
+        "usedAt": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/firestore-timestamp"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "readOnly": true,
+          "description": "(Read-only) Timestamp when ticket was scanned/used. Set by scan operation."
+        },
+        "usedBy": {
+          "readOnly": true,
+          "description": "(Read-only) FK \u2192 User/staff UID who scanned the ticket.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "usedByName": {
+          "readOnly": true,
+          "denormalized": true,
+          "description": "(Read-only, Denormalized) From User display name at scan time.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "price": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "notes": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "createdAt": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Read-only) Server-generated creation timestamp.",
+          "readOnly": true
+        },
+        "updatedAt": {
+          "$ref": "#/definitions/firestore-timestamp",
+          "description": "(Read-only) Server-generated update timestamp.",
+          "readOnly": true
+        },
+        "createdBy": {
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 User/staff UID who created this ticket.",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "eventId",
+        "companyId",
+        "status",
+        "createdAt",
+        "updatedAt"
+      ],
+      "additionalProperties": false,
+      "description": "Ticket model (D32). Collection: companies/{companyId}/events/{eventId}/tickets/{ticketId}. Mobile-only today; Dashboard in Wave 4.",
+      "example": {
+        "id": "bk_abc123def456",
+        "eventId": "eve_ref123",
+        "companyId": "comp_xyz789",
+        "customerId": null,
+        "customerName": null,
+        "customerEmail": null,
+        "customerPhone": null,
+        "status": "status",
+        "usedAt": "usedAt",
+        "usedBy": null,
+        "usedByName": null,
+        "price": null,
+        "notes": null,
+        "createdAt": "createdAt",
+        "updatedAt": "updatedAt",
+        "createdBy": null
+      }
+    },
+    "ticket-status": {
+      "type": "string",
+      "enum": [
+        "VALID",
+        "USED",
+        "CANCELLED"
+      ],
+      "description": "Event ticket status (D32). VALID = active and unused."
+    },
+    "attention-status": {
+      "type": "string",
+      "enum": [
+        "ACTIVE",
+        "STALE",
+        "ON_HOLD",
+        "ESCALATED"
+      ],
+      "description": "Operational attention status for Order and Booking (D39). Controls home-page queue assignment. Server-owned \u2014 set via triggers or callable fn only.",
+      "x-note": "ACTIVE = normal urgent queue (default). STALE = idle past threshold, moved to review queue \u2014 excluded from pendingOrdersCount. ON_HOLD = intentionally paused by manager via callable fn. ESCALATED = ignored past second threshold.",
+      "x-see": {
+        "decisions": [
+          "D39"
+        ]
+      },
+      "x-when": "Set by server automation or callable fn. Mobile and Dashboard read this field; never write it directly. ON_HOLD is the only human-initiated transition \u2014 goes through a dedicated callable function.",
+      "x-status": "proposed"
+    },
+    "payment-summary": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "(Read-only) Firestore document ID. Matches the period key (e.g. \"2026-03-09\" for DAILY, \"2026-03\" for MONTHLY)."
+        },
+        "companyId": {
+          "type": "string",
+          "x-immutable": true,
+          "description": "(Immutable) FK \u2192 Company document ID. Scopes all queries."
+        },
+        "period": {
+          "type": "string",
+          "x-note": "Document ID matches this value. Format: YYYY-MM-DD (DAILY), YYYY-Www (WEEKLY), YYYY-MM (MONTHLY).",
+          "description": "Period key. Determines the document ID and the time window covered."
+        },
+        "periodType": {
+          "type": "string",
+          "enum": [
+            "DAILY",
+            "WEEKLY",
+            "MONTHLY"
+          ],
+          "description": "Granularity of this summary document."
+        },
+        "paymentsByMethod": {
+          "type": "object",
+          "propertyNames": {
+            "type": "string",
+            "enum": [
+              "CASH",
+              "CREDIT_CARD",
+              "ORANGE_MONEY",
+              "WAVE",
+              "MTN_MONEY",
+              "MOOV_MONEY",
+              "BANK_TRANSFER",
+              "PAYPAL",
+              "STRIPE",
+              "OTHER"
+            ]
+          },
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "total": {
+                "type": "number",
+                "description": "Sum of payment amounts for this method in the period. Updated via FieldValue.increment()."
+              },
+              "count": {
+                "type": "integer",
+                "minimum": -9007199254740991,
+                "maximum": 9007199254740991,
+                "description": "Number of individual payments for this method in the period. Updated via FieldValue.increment()."
+              }
+            },
+            "required": [
+              "total",
+              "count"
+            ],
+            "additionalProperties": false
+          },
+          "required": [
+            "CASH",
+            "CREDIT_CARD",
+            "ORANGE_MONEY",
+            "WAVE",
+            "MTN_MONEY",
+            "MOOV_MONEY",
+            "BANK_TRANSFER",
+            "PAYPAL",
+            "STRIPE",
+            "OTHER"
+          ],
+          "x-note": "Keys are PaymentMethod enum values (CASH, WAVE, ORANGE_MONEY, etc.). Missing keys imply zero for that method. Updated incrementally via FieldValue.increment().",
+          "x-see": {
+            "decisions": [
+              "D02",
+              "D12"
+            ]
+          },
+          "description": "Payment totals broken down by PaymentMethod. Each entry holds the total amount and transaction count for the period."
+        },
+        "grandTotal": {
+          "type": "number",
+          "readOnly": true,
+          "description": "(Read-only) Sum of all paymentsByMethod[*].total. Server-calculated."
+        },
+        "totalCount": {
+          "type": "integer",
+          "minimum": -9007199254740991,
+          "maximum": 9007199254740991,
+          "readOnly": true,
+          "description": "(Read-only) Sum of all paymentsByMethod[*].count. Server-calculated."
+        },
+        "currency": {
+          "type": "string",
+          "const": "XOF",
+          "description": "Currency code. Locked to XOF (West African CFA franc)."
+        },
+        "lastUpdatedAt": {
+          "readOnly": true,
+          "description": "(Read-only) Server timestamp of the last increment write.",
+          "type": "object",
+          "properties": {
+            "_seconds": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "_nanoseconds": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "_seconds",
+            "_nanoseconds"
+          ],
+          "additionalProperties": false
+        },
+        "createdAt": {
+          "type": "object",
+          "properties": {
+            "_seconds": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            },
+            "_nanoseconds": {
+              "type": "integer",
+              "minimum": -9007199254740991,
+              "maximum": 9007199254740991
+            }
+          },
+          "required": [
+            "_seconds",
+            "_nanoseconds"
+          ],
+          "additionalProperties": false,
+          "description": "(Read-only) Server-generated creation timestamp.",
+          "readOnly": true
+        }
+      },
+      "required": [
+        "id",
+        "companyId",
+        "period",
+        "periodType",
+        "paymentsByMethod",
+        "grandTotal",
+        "totalCount",
+        "currency",
+        "createdAt"
+      ],
+      "additionalProperties": false,
+      "description": "Aggregated payment totals by method for a given period. Collection: companies/{companyId}/paymentSummaries/{period}. Server-owned \u2014 all fields are set by Cloud Function triggers on Order.payments[] and CustomerPayment writes. Clients must never write to this collection.",
+      "x-status": "proposed"
+    },
+    "pending-issue": {
+      "type": "string",
+      "enum": [
+        "PAYMENT_PROOF_PENDING",
+        "PAYMENT_PROOF_REJECTED",
+        "AMOUNT_DISCREPANCY",
+        "RETURN_UNRESOLVED",
+        "OVERDUE_DELIVERY",
+        "SESSION_OVERDUE",
+        "PAYMENT_INCOMPLETE",
+        "CANCELLATION_REQUESTED",
+        "UNREFUNDED_CANCELLATION",
+        "UPCOMING_UNPAID",
+        "NO_SHOW_UNRESOLVED"
+      ],
+      "description": "Specific detected conditions on an Order or Booking requiring human action (D39). Stored as an array \u2014 multiple issues can be active simultaneously. Server-owned.",
+      "x-note": "Shared: PAYMENT_PROOF_PENDING (proof uploaded, awaiting review), PAYMENT_PROOF_REJECTED (proof rejected, needs resubmission), AMOUNT_DISCREPANCY (amountPaid does not reconcile with amount/paymentStatus). Order-only: RETURN_UNRESOLVED (return/exchange stuck), OVERDUE_DELIVERY (estimatedDeliveryDate past, not yet delivered). Booking-only: SESSION_OVERDUE (session date passed, status not updated), PAYMENT_INCOMPLETE (sessions completed but payment not recorded), CANCELLATION_REQUESTED (cancellation not actioned), UNREFUNDED_CANCELLATION (cancelled with amountPaid > 0 and no refund), UPCOMING_UNPAID (session within 48h, payment not recorded), NO_SHOW_UNRESOLVED (no-show without follow-up).",
+      "x-see": {
+        "decisions": [
+          "D39"
+        ]
+      },
+      "x-when": "Set and cleared by server automation or triggers. Never affects pendingOrdersCount or pendingBookingsCount \u2014 orthogonal to urgency. Multiple values can be active at once (stored as PendingIssue[] on Order/Booking).",
+      "x-status": "proposed"
+    }
+  }
+}