@ingenx-io/valets-schema-mcp-server 0.1.4 → 0.1.5

package/data/static/llms.txt

@@ -30,6 +30,10 @@ Values: BOOKING, ORDER, PURCHASE
 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.
 Values: ON_SITE, PICK_UP, DELIVERY
 
+### DeploymentLinkType
+Category of a Site deployment link (D41). Used for UI icon/labelling and deep-link handling.
+Values: web, mobile, pwa, app-store, play-store, other
+
 ### EventStatus
 Ticketed event lifecycle (D32). Mobile-only today; Dashboard in Wave 4.
 Values: DRAFT, ACTIVE, CANCELLED, COMPLETED
@@ -70,6 +74,10 @@ Values: RETURN_REQUESTED, RETURN_PROCESSING, RETURNED, EXCHANGE_REQUESTED, EXCHA
 Per-date/per-slot booking session status (D19). Dashboard is sole writer; Mobile is read-only.
 Values: PENDING, CONFIRMED, CANCELLATION_REQUESTED, COMPLETED, NO_SHOW, CANCELLED
 
+### SiteStatus
+Lifecycle status for a Site (D41). Drives whether the site is reachable and whether analytics/payments flow.
+Values: ACTIVE, INACTIVE, EXPIRED, ARCHIVED
+
 ### TicketStatus
 Event ticket status (D32). VALID = active and unused.
 Values: VALID, USED, CANCELLED
@@ -108,6 +116,97 @@ Example:
 }
 ```
 
+### AnalyticsBackfill
+Fields: 12 (10 required)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| id | ['string', 'null'] | no | (Read-only) Firestore document ID, auto-generated. |
+| companyId | string | yes | (Immutable) FK → Company document ID. |
+| siteId | string | yes | (Immutable) FK → Site document ID (D40). |
+| status | enum(5) | yes | Run status. |
+| from | string | yes | (Immutable) Inclusive start date (`YYYY-MM-DD`, UTC). |
+| to | string | yes | (Immutable) Inclusive end date (`YYYY-MM-DD`, UTC). |
+| dryRun | boolean | yes | (Immutable) When true, rollup writes are skipped — only source counts are returned for diffing. |
+| processedDates | array<string> | yes | Ordered list of `YYYY-MM-DD` dates already processed by this run. |
+| errors | array<object> | yes | Per-date errors collected during the run. |
+| errors[].date | string | yes | `YYYY-MM-DD` date that failed. |
+| errors[].message | string | yes | Error message captured at failure. |
+| errors[].at | FirestoreTimestamp | yes | When the error occurred. |
+| triggeredBy | string | yes | (Immutable) UID of the admin who triggered the backfill. |
+| startedAt | FirestoreTimestamp | yes | (Read-only) When the run actually started. |
+| completedAt | any | no | (Read-only) When the run reached a terminal status. |
+
+Example:
+```json
+{
+  "id": null,
+  "companyId": "comp_xyz789",
+  "siteId": "sit_ref123",
+  "status": "pending",
+  "from": "from",
+  "to": "to",
+  "dryRun": true,
+  "processedDates": [
+    "example"
+  ],
+  "errors": [
+    {
+      "date": "2026-02-15",
+      "message": "message",
+      "at": "at"
+    }
+  ],
+  "triggeredBy": "triggeredBy",
+  "startedAt": "startedAt",
+  "completedAt": "completedAt"
+}
+```
+
+### AnalyticsDaily
+Fields: 16 (14 required)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| totalEvents | integer | yes | Total event count within the bucket. |
+| pageViews | integer | yes | Count of `page_view` + `screen_view` events. |
+| sessions | integer | yes | Distinct session count within the bucket (by `sessionId`). |
+| uniqueUsers | integer | yes | Distinct identified `userId` count. Anonymous sessions (userId=null) are excluded. |
+| anonymousSessions | integer | yes | Distinct session count where `userId` was null for the entire session. |
+| orders | integer | yes | Count of `order_submitted` events (or Order documents scoped to this site, D43) within the bucket. |
+| paymentsCompleted | integer | yes | Count of `payment_completed` events within the bucket. |
+| paymentsFailed | integer | yes | Count of `payment_failed` events within the bucket. |
+| errors | integer | yes | Count of `error_occurred` + `exception_caught` events within the bucket. |
+| eventCounts | record<string,integer> | yes | Per-event-name counts — key is the event name (canonical or custom), value is the count within the bucket. |
+| id | ['string', 'null'] | no | (Read-only) Firestore document ID = `YYYY-MM-DD`. |
+| companyId | string | yes | (Immutable) FK → Company document ID. |
+| siteId | string | yes | (Immutable) FK → Site document ID (D40). |
+| date | string | yes | (Immutable) `YYYY-MM-DD` UTC — matches document ID. |
+| computedAt | FirestoreTimestamp | yes | (Read-only) When this rollup was last (re)computed. Updated on every set/merge. |
+| sourceEventCount | ['integer', 'null'] | no | (Read-only, Optional) Total source events scanned when producing this rollup. Useful for dry-run diffing. |
+
+Example:
+```json
+{
+  "totalEvents": 0,
+  "pageViews": 0,
+  "sessions": 0,
+  "uniqueUsers": 0,
+  "anonymousSessions": 0,
+  "orders": 0,
+  "paymentsCompleted": 0,
+  "paymentsFailed": 0,
+  "errors": 0,
+  "eventCounts": {},
+  "id": null,
+  "companyId": "comp_xyz789",
+  "siteId": "sit_ref123",
+  "date": "2026-02-15",
+  "computedAt": "computedAt",
+  "sourceEventCount": null
+}
+```
+
 ### AnalyticsEvent
 Fields: 12 (10 required)
 
@@ -159,6 +258,52 @@ Example:
 }
 ```
 
+### AnalyticsHourly
+Fields: 17 (15 required)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| totalEvents | integer | yes | Total event count within the bucket. |
+| pageViews | integer | yes | Count of `page_view` + `screen_view` events. |
+| sessions | integer | yes | Distinct session count within the bucket (by `sessionId`). |
+| uniqueUsers | integer | yes | Distinct identified `userId` count. Anonymous sessions (userId=null) are excluded. |
+| anonymousSessions | integer | yes | Distinct session count where `userId` was null for the entire session. |
+| orders | integer | yes | Count of `order_submitted` events (or Order documents scoped to this site, D43) within the bucket. |
+| paymentsCompleted | integer | yes | Count of `payment_completed` events within the bucket. |
+| paymentsFailed | integer | yes | Count of `payment_failed` events within the bucket. |
+| errors | integer | yes | Count of `error_occurred` + `exception_caught` events within the bucket. |
+| eventCounts | record<string,integer> | yes | Per-event-name counts — key is the event name (canonical or custom), value is the count within the bucket. |
+| id | ['string', 'null'] | no | (Read-only) Firestore document ID = `YYYY-MM-DD-HH`. |
+| companyId | string | yes | (Immutable) FK → Company document ID. |
+| siteId | string | yes | (Immutable) FK → Site document ID (D40). |
+| date | string | yes | (Immutable) `YYYY-MM-DD` UTC for the bucket day. |
+| hour | integer | yes | (Immutable) UTC hour of day, 0–23. |
+| computedAt | FirestoreTimestamp | yes | (Read-only) When this rollup was last (re)computed. |
+| sourceEventCount | ['integer', 'null'] | no | (Read-only, Optional) Total source events scanned when producing this rollup. |
+
+Example:
+```json
+{
+  "totalEvents": 0,
+  "pageViews": 0,
+  "sessions": 0,
+  "uniqueUsers": 0,
+  "anonymousSessions": 0,
+  "orders": 0,
+  "paymentsCompleted": 0,
+  "paymentsFailed": 0,
+  "errors": 0,
+  "eventCounts": {},
+  "id": null,
+  "companyId": "comp_xyz789",
+  "siteId": "sit_ref123",
+  "date": "2026-02-15",
+  "hour": 0,
+  "computedAt": "computedAt",
+  "sourceEventCount": null
+}
+```
+
 ### Booking
 Fields: 52 (7 required)
 
@@ -908,13 +1053,14 @@ Example:
 ```
 
 ### Order
-Fields: 47 (8 required)
+Fields: 48 (8 required)
 
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
 | id | string | yes | (Read-only) Firestore document ID. Note: some models also have uid; see ID conventions. |
 | uid | string | yes | (Read-only) Entity UID. Often mirrors id. |
 | companyId | string | yes | (Immutable) FK → Company document ID. Scopes all queries. |
+| siteId | ['string', 'null'] | no | (Immutable, Optional) FK → Site document ID (D43 / ADR-003). null = company-wide. |
 | orderNumber | string | yes | (Read-only) Server-generated order number. |
 | status | OrderStatus | yes | Core lifecycle status (D34, MIG-11). See OrderStatus enum for the legacy value migration mapping. |
 | paymentStatus | any | no | Payment lifecycle (D34). Null until payment is initiated. |
@@ -966,6 +1112,7 @@ Example:
   "id": "bk_abc123def456",
   "uid": "user_u8x92kqm",
   "companyId": "comp_xyz789",
+  "siteId": null,
   "orderNumber": "ORD-2026-0042",
   "status": "status",
   "paymentStatus": "paymentStatus",
@@ -1085,6 +1232,56 @@ Example:
 }
 ```
 
+### Site
+Fields: 14 (6 required)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| id | ['string', 'null'] | no | (Read-only) Firestore document ID, auto-generated. |
+| companyId | string | yes | (Immutable) FK → Company document ID. Scopes all site sub-collections. |
+| name | string | yes | Human-readable site name shown in dashboards. |
+| description | ['string', 'null'] | no | Optional freeform description. |
+| status | SiteStatus | yes | Lifecycle status (D41). Clients filter by ACTIVE. |
+| deploymentLinks | array<object> | yes | Ordered list of deployment URLs (web, mobile, PWA, store links). |
+| deploymentLinks[].label | string | yes | Human-readable label shown in dashboards (e.g. "Production", "Staging"). |
+| deploymentLinks[].url | string | yes | Absolute URL or store link. |
+| deploymentLinks[].type | DeploymentLinkType | yes | Link category — drives icon/handler selection. |
+| deploymentLinks[].isPrimary | boolean | no | If true, this link is used as the canonical deployment URL for the Site. |
+| expiresAt | any | no | Optional expiration timestamp. When set and elapsed, `isExpired` flips true and status typically moves to EXPIRED. |
+| isExpired | ['boolean', 'null'] | no | (Read-only) Derived — true when `expiresAt` is in the past. Maintained by server trigger. |
+| createdAt | any | no | (Read-only) Server-generated creation timestamp. |
+| updatedAt | any | no | (Read-only) Server-generated update timestamp. |
+| createdBy | string | yes | (Immutable) FK → User/staff UID who created the site. |
+| analyticsEnabled | boolean | yes | Feature flag — when false, clients should not emit analytics events for this site. |
+| lastAnalyticsSync | any | no | (Read-only) Last time the analytics rollup pipeline refreshed `cachedMetrics`. |
+| cachedMetrics | ['object', 'null'] | no | (Read-only, Denormalized) Cached metrics snapshot for quick dashboard rendering. |
+
+Example:
+```json
+{
+  "id": null,
+  "companyId": "comp_xyz789",
+  "name": "Amadou Diallo",
+  "description": null,
+  "status": "status",
+  "deploymentLinks": [
+    {
+      "label": "label",
+      "url": "https://storage.example.com/url.jpg",
+      "type": "phone"
+    }
+  ],
+  "expiresAt": "expiresAt",
+  "isExpired": null,
+  "createdAt": "createdAt",
+  "updatedAt": "updatedAt",
+  "createdBy": "staff_k0f1",
+  "analyticsEnabled": true,
+  "lastAnalyticsSync": "lastAnalyticsSync",
+  "cachedMetrics": null
+}
+```
+
 ### SitePayment
 Fields: 10 (9 required)