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

package/data/docs/models/loyalty-status.md

@@ -0,0 +1,328 @@
+---
+title: "LoyaltyStatus"
+sidebar_label: "LoyaltyStatus"
+sidebar_position: 9
+---
+
+# LoyaltyStatus
+
+<details>
+<summary>Example JSON</summary>
+
+```json
+{
+  "customerId": null,
+  "pointsBalance": 340,
+  "totalPointsEarned": 1200,
+  "redeemedPoints": null,
+  "lastActivityDate": "lastActivityDate",
+  "lastRedeemedAt": "lastRedeemedAt",
+  "tier": null,
+  "createdAt": "createdAt",
+  "updatedAt": "updatedAt"
+}
+```
+
+</details>
+
+
+- [1. Property `customerId`](#customerId)
+- [2. Property `pointsBalance`](#pointsBalance)
+- [3. Property `totalPointsEarned`](#totalPointsEarned)
+- [4. Property `redeemedPoints`](#redeemedPoints)
+- [5. Property `lastActivityDate`](#lastActivityDate)
+  - [5.1. Property `firestore-timestamp`](#lastActivityDate_anyOf_i0)
+    - [5.1.1. Property `_seconds`](#lastActivityDate_anyOf_i0__seconds)
+    - [5.1.2. Property `_nanoseconds`](#lastActivityDate_anyOf_i0__nanoseconds)
+  - [5.2. Property `item 1`](#lastActivityDate_anyOf_i1)
+- [6. Property `lastRedeemedAt`](#lastRedeemedAt)
+  - [6.1. Property `firestore-timestamp`](#lastRedeemedAt_anyOf_i0)
+  - [6.2. Property `item 1`](#lastRedeemedAt_anyOf_i1)
+- [7. Property `tier`](#tier)
+- [8. Property `createdAt`](#createdAt)
+  - [8.1. Property `firestore-timestamp`](#createdAt_anyOf_i0)
+  - [8.2. Property `item 1`](#createdAt_anyOf_i1)
+- [9. Property `updatedAt`](#updatedAt)
+  - [9.1. Property `firestore-timestamp`](#updatedAt_anyOf_i0)
+  - [9.2. Property `item 1`](#updatedAt_anyOf_i1)
+
+|                           |                              |
+| ------------------------- | ---------------------------- |
+| **Type**                  | `object`                     |
+| **Required**              | No                           |
+| **Additional properties** | Not allowed                  |
+| **Defined in**            | #/definitions/loyalty-status |
+
+**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.
+
+| Property                                   | Pattern | Type            | Deprecated | Definition | Title/Description                                                                                                                                      |
+| ------------------------------------------ | ------- | --------------- | ---------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| - [customerId](#customerId )               | No      | string or null  | No         | -          | (Immutable) FK → Customer.id. Note: optional despite being in customer subcollection (path already contains custId).                                   |
+| + [pointsBalance](#pointsBalance )         | No      | integer         | No         | -          | (Read-only) Current available points balance. Canonical name (D08). Dashboard: pointsBalance, Mobile: currentPoints. Updated by transaction triggers.  |
+| + [totalPointsEarned](#totalPointsEarned ) | No      | integer         | No         | -          | (Read-only) Lifetime total points earned. Canonical name (D08). Dashboard: totalPointsEarned, Mobile: lifetimePoints. Updated by transaction triggers. |
+| - [redeemedPoints](#redeemedPoints )       | No      | integer or null | No         | -          | (Read-only) Total redeemed points. Updated by transaction triggers.                                                                                    |
+| - [lastActivityDate](#lastActivityDate )   | No      | Combination     | No         | -          | (Read-only) Last earn/redeem activity. Canonical name (D08). Mobile alias: lastEarnedAt.                                                               |
+| - [lastRedeemedAt](#lastRedeemedAt )       | No      | Combination     | No         | -          | (Read-only) Last redemption timestamp.                                                                                                                 |
+| - [tier](#tier )                           | No      | string or null  | No         | -          | -                                                                                                                                                      |
+| - [createdAt](#createdAt )                 | No      | Combination     | No         | -          | (Read-only) Server-generated creation timestamp.                                                                                                       |
+| - [updatedAt](#updatedAt )                 | No      | Combination     | No         | -          | (Read-only) Server-generated update timestamp.                                                                                                         |
+
+## <a name="customerId"></a>1. Property `customerId`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** (Immutable) FK → Customer.id. Note: optional despite being in customer subcollection (path already contains custId).
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="pointsBalance"></a>2. Property `pointsBalance`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+**Description:** (Read-only) Current available points balance. Canonical name (D08). Dashboard: pointsBalance, Mobile: currentPoints. Updated by transaction triggers.
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::
+
+## <a name="totalPointsEarned"></a>3. Property `totalPointsEarned`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+**Description:** (Read-only) Lifetime total points earned. Canonical name (D08). Dashboard: totalPointsEarned, Mobile: lifetimePoints. Updated by transaction triggers.
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::
+
+## <a name="redeemedPoints"></a>4. Property `redeemedPoints`
+
+|              |                   |
+| ------------ | ----------------- |
+| **Type**     | `integer or null` |
+| **Required** | No                |
+
+**Description:** (Read-only) Total redeemed points. Updated by transaction triggers.
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::
+
+## <a name="lastActivityDate"></a>5. Property `lastActivityDate`
+
+|                           |                  |
+| ------------------------- | ---------------- |
+| **Type**                  | `combining`      |
+| **Required**              | No               |
+| **Additional properties** | Any type allowed |
+
+**Description:** (Read-only) Last earn/redeem activity. Canonical name (D08). Mobile alias: lastEarnedAt.
+
+| Any of(Option)                                    |
+| ------------------------------------------------- |
+| [firestore-timestamp](#lastActivityDate_anyOf_i0) |
+| [item 1](#lastActivityDate_anyOf_i1)              |
+
+### <a name="lastActivityDate_anyOf_i0"></a>5.1. Property `firestore-timestamp`
+
+|                           |                                   |
+| ------------------------- | --------------------------------- |
+| **Type**                  | `object`                          |
+| **Required**              | No                                |
+| **Additional properties** | Not allowed                       |
+| **Defined in**            | #/definitions/firestore-timestamp |
+
+**Description:** Firestore Timestamp serialized representation
+
+| Property                                                   | Pattern | Type    | Deprecated | Definition | Title/Description |
+| ---------------------------------------------------------- | ------- | ------- | ---------- | ---------- | ----------------- |
+| + [_seconds](#lastActivityDate_anyOf_i0__seconds )         | No      | integer | No         | -          | -                 |
+| + [_nanoseconds](#lastActivityDate_anyOf_i0__nanoseconds ) | No      | integer | No         | -          | -                 |
+
+#### <a name="lastActivityDate_anyOf_i0__seconds"></a>5.1.1. Property `_seconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+#### <a name="lastActivityDate_anyOf_i0__nanoseconds"></a>5.1.2. Property `_nanoseconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+### <a name="lastActivityDate_anyOf_i1"></a>5.2. Property `item 1`
+
+|              |        |
+| ------------ | ------ |
+| **Type**     | `null` |
+| **Required** | No     |
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::
+
+## <a name="lastRedeemedAt"></a>6. Property `lastRedeemedAt`
+
+|                           |                  |
+| ------------------------- | ---------------- |
+| **Type**                  | `combining`      |
+| **Required**              | No               |
+| **Additional properties** | Any type allowed |
+
+**Description:** (Read-only) Last redemption timestamp.
+
+| Any of(Option)                                  |
+| ----------------------------------------------- |
+| [firestore-timestamp](#lastRedeemedAt_anyOf_i0) |
+| [item 1](#lastRedeemedAt_anyOf_i1)              |
+
+### <a name="lastRedeemedAt_anyOf_i0"></a>6.1. Property `firestore-timestamp`
+
+|                           |                                                         |
+| ------------------------- | ------------------------------------------------------- |
+| **Type**                  | `object`                                                |
+| **Required**              | No                                                      |
+| **Additional properties** | Not allowed                                             |
+| **Same definition as**    | [lastActivityDate_anyOf_i0](#lastActivityDate_anyOf_i0) |
+
+**Description:** Firestore Timestamp serialized representation
+
+### <a name="lastRedeemedAt_anyOf_i1"></a>6.2. Property `item 1`
+
+|              |        |
+| ------------ | ------ |
+| **Type**     | `null` |
+| **Required** | No     |
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::
+
+## <a name="tier"></a>7. Property `tier`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+## <a name="createdAt"></a>8. Property `createdAt`
+
+|                           |                  |
+| ------------------------- | ---------------- |
+| **Type**                  | `combining`      |
+| **Required**              | No               |
+| **Additional properties** | Any type allowed |
+
+**Description:** (Read-only) Server-generated creation timestamp.
+
+| Any of(Option)                             |
+| ------------------------------------------ |
+| [firestore-timestamp](#createdAt_anyOf_i0) |
+| [item 1](#createdAt_anyOf_i1)              |
+
+### <a name="createdAt_anyOf_i0"></a>8.1. Property `firestore-timestamp`
+
+|                           |                                                         |
+| ------------------------- | ------------------------------------------------------- |
+| **Type**                  | `object`                                                |
+| **Required**              | No                                                      |
+| **Additional properties** | Not allowed                                             |
+| **Same definition as**    | [lastActivityDate_anyOf_i0](#lastActivityDate_anyOf_i0) |
+
+**Description:** Firestore Timestamp serialized representation
+
+### <a name="createdAt_anyOf_i1"></a>8.2. Property `item 1`
+
+|              |        |
+| ------------ | ------ |
+| **Type**     | `null` |
+| **Required** | No     |
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::
+
+## <a name="updatedAt"></a>9. Property `updatedAt`
+
+|                           |                  |
+| ------------------------- | ---------------- |
+| **Type**                  | `combining`      |
+| **Required**              | No               |
+| **Additional properties** | Any type allowed |
+
+**Description:** (Read-only) Server-generated update timestamp.
+
+| Any of(Option)                             |
+| ------------------------------------------ |
+| [firestore-timestamp](#updatedAt_anyOf_i0) |
+| [item 1](#updatedAt_anyOf_i1)              |
+
+### <a name="updatedAt_anyOf_i0"></a>9.1. Property `firestore-timestamp`
+
+|                           |                                                         |
+| ------------------------- | ------------------------------------------------------- |
+| **Type**                  | `object`                                                |
+| **Required**              | No                                                      |
+| **Additional properties** | Not allowed                                             |
+| **Same definition as**    | [lastActivityDate_anyOf_i0](#lastActivityDate_anyOf_i0) |
+
+**Description:** Firestore Timestamp serialized representation
+
+### <a name="updatedAt_anyOf_i1"></a>9.2. Property `item 1`
+
+|              |        |
+| ------------ | ------ |
+| **Type**     | `null` |
+| **Required** | No     |
+
+----------------------------------------------------------------------------------------------------------------------------
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::
+
+## Related Decisions
+
+| Decision | Title |
+|---|---|
+| **D08** | Canonical location for customer points |

package/data/docs/models/loyalty-transaction.md

@@ -0,0 +1,326 @@
+---
+title: "LoyaltyTransaction"
+sidebar_label: "LoyaltyTransaction"
+sidebar_position: 10
+---
+
+# LoyaltyTransaction
+
+<details>
+<summary>Example JSON</summary>
+
+```json
+{
+  "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
+}
+```
+
+</details>
+
+
+- [1. Property `id`](#id)
+- [2. Property `customerId`](#customerId)
+- [3. Property `type`](#type)
+- [4. Property `pointsChange`](#pointsChange)
+- [5. Property `description`](#description)
+- [6. Property `reason`](#reason)
+- [7. Property `relatedPurchaseId`](#relatedPurchaseId)
+- [8. Property `relatedOrderId`](#relatedOrderId)
+- [9. Property `relatedRewardId`](#relatedRewardId)
+- [10. Property `orderId`](#orderId)
+- [11. Property `sessionId`](#sessionId)
+- [12. Property `orderAmount`](#orderAmount)
+- [13. Property `transactionDate`](#transactionDate)
+  - [13.1. Property `_seconds`](#transactionDate__seconds)
+  - [13.2. Property `_nanoseconds`](#transactionDate__nanoseconds)
+- [14. Property `pointsBalanceAfter`](#pointsBalanceAfter)
+- [15. Property `createdBy`](#createdBy)
+- [16. Property `createdByName`](#createdByName)
+
+|                           |                                   |
+| ------------------------- | --------------------------------- |
+| **Type**                  | `object`                          |
+| **Required**              | No                                |
+| **Additional properties** | Not allowed                       |
+| **Defined in**            | #/definitions/loyalty-transaction |
+
+**Description:** LoyaltyTransaction model (D07). Collection: companies/\{companyId\}/customers/\{custId\}/loyaltyTransactions/\{txId\}. Type values use SCREAMING_SNAKE per D04 (MIG-05 migrates lowercase).
+
+| Property                                     | Pattern | Type             | Deprecated | Definition                                | Title/Description                                                                                                                                 |
+| -------------------------------------------- | ------- | ---------------- | ---------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| + [id](#id )                                 | No      | string           | No         | -                                         | (Read-only) Firestore document ID.                                                                                                                |
+| - [customerId](#customerId )                 | No      | string or null   | No         | -                                         | (Immutable) FK → Customer.id. Note: optional despite being in customer subcollection.                                                             |
+| + [type](#type )                             | No      | enum (of string) | No         | In #/definitions/loyalty-transaction-type | (Immutable) Transaction type (D07). SCREAMING_SNAKE per D04. MIG-05 migrates legacy lowercase values.                                             |
+| + [pointsChange](#pointsChange )             | No      | integer          | No         | -                                         | (Immutable) Points delta (+/-). Canonical name (D07). Dashboard: pointsChange, Mobile: points.                                                    |
+| - [description](#description )               | No      | string or null   | No         | -                                         | -                                                                                                                                                 |
+| - [reason](#reason )                         | No      | string or null   | No         | -                                         | -                                                                                                                                                 |
+| - [relatedPurchaseId](#relatedPurchaseId )   | No      | string or null   | No         | -                                         | (Immutable) FK → Sale.id. Linked sale that triggered this transaction.                                                                            |
+| - [relatedOrderId](#relatedOrderId )         | No      | string or null   | No         | -                                         | (Immutable) FK → Order.id. Linked order that triggered this transaction.                                                                          |
+| - [relatedRewardId](#relatedRewardId )       | No      | string or null   | No         | -                                         | (Immutable) FK → LoyaltyReward.id. Reward redeemed in this transaction.                                                                           |
+| - [orderId](#orderId )                       | No      | string or null   | No         | -                                         | (Immutable) FK → Order.id. Note: may overlap with relatedOrderId — naming inconsistency from Mobile.                                              |
+| - [sessionId](#sessionId )                   | No      | string or null   | No         | -                                         | Session/booking reference. Context-dependent identifier.                                                                                          |
+| - [orderAmount](#orderAmount )               | No      | number or null   | No         | -                                         | -                                                                                                                                                 |
+| + [transactionDate](#transactionDate )       | No      | object           | No         | In #/definitions/firestore-timestamp      | (Immutable) When the transaction occurred. Canonical name (D07). Dashboard: transactionDate, Mobile: createdAt.                                   |
+| - [pointsBalanceAfter](#pointsBalanceAfter ) | No      | integer or null  | No         | -                                         | (Read-only) Running balance after this transaction. Canonical name (D07). Dashboard: pointsBalanceAfter, Mobile: balanceAfter. Server-calculated. |
+| - [createdBy](#createdBy )                   | No      | string or null   | No         | -                                         | (Immutable) FK → User/staff UID who created this transaction.                                                                                     |
+| - [createdByName](#createdByName )           | No      | string or null   | No         | -                                         | (Immutable, Denormalized) From User display name at creation time.                                                                                |
+
+## <a name="id"></a>1. Property `id`
+
+|              |          |
+| ------------ | -------- |
+| **Type**     | `string` |
+| **Required** | Yes      |
+
+**Description:** (Read-only) Firestore document ID.
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::
+
+## <a name="customerId"></a>2. Property `customerId`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** (Immutable) FK → Customer.id. Note: optional despite being in customer subcollection.
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="type"></a>3. Property `type`
+
+|                |                                        |
+| -------------- | -------------------------------------- |
+| **Type**       | `enum (of string)`                     |
+| **Required**   | Yes                                    |
+| **Defined in** | #/definitions/loyalty-transaction-type |
+
+**Description:** (Immutable) Transaction type (D07). SCREAMING_SNAKE per D04. MIG-05 migrates legacy lowercase values.
+
+Must be one of:
+* "EARNED"
+* "REDEEMED"
+* "ADJUSTED"
+* "EXPIRED"
+* "BONUS"
+* "REFUND"
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="pointsChange"></a>4. Property `pointsChange`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+**Description:** (Immutable) Points delta (+/-). Canonical name (D07). Dashboard: pointsChange, Mobile: points.
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="description"></a>5. Property `description`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+## <a name="reason"></a>6. Property `reason`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+## <a name="relatedPurchaseId"></a>7. Property `relatedPurchaseId`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** (Immutable) FK → Sale.id. Linked sale that triggered this transaction.
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="relatedOrderId"></a>8. Property `relatedOrderId`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** (Immutable) FK → Order.id. Linked order that triggered this transaction.
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="relatedRewardId"></a>9. Property `relatedRewardId`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** (Immutable) FK → LoyaltyReward.id. Reward redeemed in this transaction.
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="orderId"></a>10. Property `orderId`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** (Immutable) FK → Order.id. Note: may overlap with relatedOrderId — naming inconsistency from Mobile.
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="sessionId"></a>11. Property `sessionId`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** Session/booking reference. Context-dependent identifier.
+
+## <a name="orderAmount"></a>12. Property `orderAmount`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `number or null` |
+| **Required** | No               |
+
+## <a name="transactionDate"></a>13. Property `transactionDate`
+
+|                           |                                   |
+| ------------------------- | --------------------------------- |
+| **Type**                  | `object`                          |
+| **Required**              | Yes                               |
+| **Additional properties** | Not allowed                       |
+| **Defined in**            | #/definitions/firestore-timestamp |
+
+**Description:** (Immutable) When the transaction occurred. Canonical name (D07). Dashboard: transactionDate, Mobile: createdAt.
+
+| Property                                         | Pattern | Type    | Deprecated | Definition | Title/Description |
+| ------------------------------------------------ | ------- | ------- | ---------- | ---------- | ----------------- |
+| + [_seconds](#transactionDate__seconds )         | No      | integer | No         | -          | -                 |
+| + [_nanoseconds](#transactionDate__nanoseconds ) | No      | integer | No         | -          | -                 |
+
+### <a name="transactionDate__seconds"></a>13.1. Property `_seconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+### <a name="transactionDate__nanoseconds"></a>13.2. Property `_nanoseconds`
+
+|              |           |
+| ------------ | --------- |
+| **Type**     | `integer` |
+| **Required** | Yes       |
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="pointsBalanceAfter"></a>14. Property `pointsBalanceAfter`
+
+|              |                   |
+| ------------ | ----------------- |
+| **Type**     | `integer or null` |
+| **Required** | No                |
+
+**Description:** (Read-only) Running balance after this transaction. Canonical name (D07). Dashboard: pointsBalanceAfter, Mobile: balanceAfter. Server-calculated.
+
+| Restrictions |                        |
+| ------------ | ---------------------- |
+| **Minimum**  | &ge; -9007199254740991 |
+| **Maximum**  | &le; 9007199254740991  |
+
+:::warning Server-set
+Do not include in write requests. This field is set exclusively by the server (Firestore trigger or Admin SDK). Clients that send it will have the value silently ignored or may receive a validation error.
+:::
+
+## <a name="createdBy"></a>15. Property `createdBy`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** (Immutable) FK → User/staff UID who created this transaction.
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## <a name="createdByName"></a>16. Property `createdByName`
+
+|              |                  |
+| ------------ | ---------------- |
+| **Type**     | `string or null` |
+| **Required** | No               |
+
+**Description:** (Immutable, Denormalized) From User display name at creation time.
+
+----------------------------------------------------------------------------------------------------------------------------
+Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-06 at 19:27:48 +0000
+
+:::info Immutable
+Set at creation only. This field cannot be modified after the document is created. Include it in CREATE payloads; omit it (or leave unchanged) in UPDATE payloads.
+:::
+
+## Related Decisions
+
+| Decision | Title |
+|---|---|
+| **D23** | Firebase loyalty automation |