@happyvertical/smrt-commerce 0.55.6 → 0.55.8

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-commerce",
-  "packageVersion": "0.55.6",
+  "packageVersion": "0.55.8",
   "objects": {
     "@happyvertical/smrt-commerce:ContractCollection": {
       "name": "contractcollection",
@@ -3870,6 +3870,7 @@
       "className": "Contract",
       "qualifiedName": "@happyvertical/smrt-commerce:Contract",
       "collection": "contracts",
+      "description": "Contract is the base class for all commercial agreements.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/Contract.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -3902,6 +3903,10 @@
         "contractType": {
           "type": "text",
           "required": false,
+          "description": "The kind of contract: order, estimate, lease, agreement and so on.",
+          "_meta": {
+            "description": "The kind of contract: order, estimate, lease, agreement and so on."
+          },
           "enum": [
             "estimate",
             "order",
@@ -3979,7 +3984,10 @@
           "default": "USD",
           "description": "The currency of the amounts.",
           "_meta": {
-            "description": "The currency of the amounts."
+            "description": "The currency of the amounts.",
+            "ui": {
+              "widget": "currency"
+            }
           }
         },
         "issueDate": {
@@ -4021,7 +4029,10 @@
           "default": "",
           "description": "Anything worth remembering about this.",
           "_meta": {
-            "description": "Anything worth remembering about this."
+            "description": "Anything worth remembering about this.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "terms": {
@@ -4030,7 +4041,10 @@
           "default": "",
           "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
           "_meta": {
-            "description": "The conditions agreed, such as deposits, payment or delivery conditions."
+            "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "channelId": {
@@ -4313,6 +4327,7 @@
       "className": "Estimate",
       "qualifiedName": "@happyvertical/smrt-commerce:Estimate",
       "collection": "contracts",
+      "description": "Quote or proposal for a customer",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/Contract.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -4345,6 +4360,10 @@
         "contractType": {
           "type": "text",
           "required": false,
+          "description": "The kind of contract: order, estimate, lease, agreement and so on.",
+          "_meta": {
+            "description": "The kind of contract: order, estimate, lease, agreement and so on."
+          },
           "enum": [
             "estimate",
             "order",
@@ -4422,7 +4441,10 @@
           "default": "USD",
           "description": "The currency of the amounts.",
           "_meta": {
-            "description": "The currency of the amounts."
+            "description": "The currency of the amounts.",
+            "ui": {
+              "widget": "currency"
+            }
           }
         },
         "issueDate": {
@@ -4464,7 +4486,10 @@
           "default": "",
           "description": "Anything worth remembering about this.",
           "_meta": {
-            "description": "Anything worth remembering about this."
+            "description": "Anything worth remembering about this.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "terms": {
@@ -4473,7 +4498,10 @@
           "default": "",
           "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
           "_meta": {
-            "description": "The conditions agreed, such as deposits, payment or delivery conditions."
+            "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "channelId": {
@@ -4734,6 +4762,7 @@
       "className": "Order",
       "qualifiedName": "@happyvertical/smrt-commerce:Order",
       "collection": "contracts",
+      "description": "Customer purchase order",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/Contract.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -4766,6 +4795,10 @@
         "contractType": {
           "type": "text",
           "required": false,
+          "description": "The kind of contract: order, estimate, lease, agreement and so on.",
+          "_meta": {
+            "description": "The kind of contract: order, estimate, lease, agreement and so on."
+          },
           "enum": [
             "estimate",
             "order",
@@ -4843,7 +4876,10 @@
           "default": "USD",
           "description": "The currency of the amounts.",
           "_meta": {
-            "description": "The currency of the amounts."
+            "description": "The currency of the amounts.",
+            "ui": {
+              "widget": "currency"
+            }
           }
         },
         "issueDate": {
@@ -4885,7 +4921,10 @@
           "default": "",
           "description": "Anything worth remembering about this.",
           "_meta": {
-            "description": "Anything worth remembering about this."
+            "description": "Anything worth remembering about this.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "terms": {
@@ -4894,7 +4933,10 @@
           "default": "",
           "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
           "_meta": {
-            "description": "The conditions agreed, such as deposits, payment or delivery conditions."
+            "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "channelId": {
@@ -5155,6 +5197,7 @@
       "className": "Lease",
       "qualifiedName": "@happyvertical/smrt-commerce:Lease",
       "collection": "contracts",
+      "description": "Rental or lease agreement",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/Contract.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -5187,6 +5230,10 @@
         "contractType": {
           "type": "text",
           "required": false,
+          "description": "The kind of contract: order, estimate, lease, agreement and so on.",
+          "_meta": {
+            "description": "The kind of contract: order, estimate, lease, agreement and so on."
+          },
           "enum": [
             "estimate",
             "order",
@@ -5264,7 +5311,10 @@
           "default": "USD",
           "description": "The currency of the amounts.",
           "_meta": {
-            "description": "The currency of the amounts."
+            "description": "The currency of the amounts.",
+            "ui": {
+              "widget": "currency"
+            }
           }
         },
         "issueDate": {
@@ -5306,7 +5356,10 @@
           "default": "",
           "description": "Anything worth remembering about this.",
           "_meta": {
-            "description": "Anything worth remembering about this."
+            "description": "Anything worth remembering about this.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "terms": {
@@ -5315,7 +5368,10 @@
           "default": "",
           "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
           "_meta": {
-            "description": "The conditions agreed, such as deposits, payment or delivery conditions."
+            "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "channelId": {
@@ -5576,6 +5632,7 @@
       "className": "Agreement",
       "qualifiedName": "@happyvertical/smrt-commerce:Agreement",
       "collection": "contracts",
+      "description": "Service or maintenance agreement",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/Contract.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -5608,6 +5665,10 @@
         "contractType": {
           "type": "text",
           "required": false,
+          "description": "The kind of contract: order, estimate, lease, agreement and so on.",
+          "_meta": {
+            "description": "The kind of contract: order, estimate, lease, agreement and so on."
+          },
           "enum": [
             "estimate",
             "order",
@@ -5685,7 +5746,10 @@
           "default": "USD",
           "description": "The currency of the amounts.",
           "_meta": {
-            "description": "The currency of the amounts."
+            "description": "The currency of the amounts.",
+            "ui": {
+              "widget": "currency"
+            }
           }
         },
         "issueDate": {
@@ -5727,7 +5791,10 @@
           "default": "",
           "description": "Anything worth remembering about this.",
           "_meta": {
-            "description": "Anything worth remembering about this."
+            "description": "Anything worth remembering about this.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "terms": {
@@ -5736,7 +5803,10 @@
           "default": "",
           "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
           "_meta": {
-            "description": "The conditions agreed, such as deposits, payment or delivery conditions."
+            "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "channelId": {
@@ -5997,6 +6067,7 @@
       "className": "PurchaseOrder",
       "qualifiedName": "@happyvertical/smrt-commerce:PurchaseOrder",
       "collection": "contracts",
+      "description": "Order sent to vendor/supplier",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/Contract.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -6029,6 +6100,10 @@
         "contractType": {
           "type": "text",
           "required": false,
+          "description": "The kind of contract: order, estimate, lease, agreement and so on.",
+          "_meta": {
+            "description": "The kind of contract: order, estimate, lease, agreement and so on."
+          },
           "enum": [
             "estimate",
             "order",
@@ -6106,7 +6181,10 @@
           "default": "USD",
           "description": "The currency of the amounts.",
           "_meta": {
-            "description": "The currency of the amounts."
+            "description": "The currency of the amounts.",
+            "ui": {
+              "widget": "currency"
+            }
           }
         },
         "issueDate": {
@@ -6148,7 +6226,10 @@
           "default": "",
           "description": "Anything worth remembering about this.",
           "_meta": {
-            "description": "Anything worth remembering about this."
+            "description": "Anything worth remembering about this.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "terms": {
@@ -6157,7 +6238,10 @@
           "default": "",
           "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
           "_meta": {
-            "description": "The conditions agreed, such as deposits, payment or delivery conditions."
+            "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "channelId": {
@@ -6418,6 +6502,7 @@
       "className": "WholesaleOrder",
       "qualifiedName": "@happyvertical/smrt-commerce:WholesaleOrder",
       "collection": "contracts",
+      "description": "B2B order placed by a wholesale customer.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/Contract.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -6450,6 +6535,10 @@
         "contractType": {
           "type": "text",
           "required": false,
+          "description": "The kind of contract: order, estimate, lease, agreement and so on.",
+          "_meta": {
+            "description": "The kind of contract: order, estimate, lease, agreement and so on."
+          },
           "enum": [
             "estimate",
             "order",
@@ -6527,7 +6616,10 @@
           "default": "USD",
           "description": "The currency of the amounts.",
           "_meta": {
-            "description": "The currency of the amounts."
+            "description": "The currency of the amounts.",
+            "ui": {
+              "widget": "currency"
+            }
           }
         },
         "issueDate": {
@@ -6569,7 +6661,10 @@
           "default": "",
           "description": "Anything worth remembering about this.",
           "_meta": {
-            "description": "Anything worth remembering about this."
+            "description": "Anything worth remembering about this.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "terms": {
@@ -6578,7 +6673,10 @@
           "default": "",
           "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
           "_meta": {
-            "description": "The conditions agreed, such as deposits, payment or delivery conditions."
+            "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "channelId": {
@@ -6839,6 +6937,7 @@
       "className": "ProductionOrder",
       "qualifiedName": "@happyvertical/smrt-commerce:ProductionOrder",
       "collection": "contracts",
+      "description": "Instruction to commission goods from an internal or external factory.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/Contract.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -6871,6 +6970,10 @@
         "contractType": {
           "type": "text",
           "required": false,
+          "description": "The kind of contract: order, estimate, lease, agreement and so on.",
+          "_meta": {
+            "description": "The kind of contract: order, estimate, lease, agreement and so on."
+          },
           "enum": [
             "estimate",
             "order",
@@ -6948,7 +7051,10 @@
           "default": "USD",
           "description": "The currency of the amounts.",
           "_meta": {
-            "description": "The currency of the amounts."
+            "description": "The currency of the amounts.",
+            "ui": {
+              "widget": "currency"
+            }
           }
         },
         "issueDate": {
@@ -6990,7 +7096,10 @@
           "default": "",
           "description": "Anything worth remembering about this.",
           "_meta": {
-            "description": "Anything worth remembering about this."
+            "description": "Anything worth remembering about this.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "terms": {
@@ -6999,7 +7108,10 @@
           "default": "",
           "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
           "_meta": {
-            "description": "The conditions agreed, such as deposits, payment or delivery conditions."
+            "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "channelId": {
@@ -7276,6 +7388,7 @@
       "className": "Cart",
       "qualifiedName": "@happyvertical/smrt-commerce:Cart",
       "collection": "contracts",
+      "description": "Transient order-in-progress for a shopper.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/Contract.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -7308,6 +7421,10 @@
         "contractType": {
           "type": "text",
           "required": false,
+          "description": "The kind of contract: order, estimate, lease, agreement and so on.",
+          "_meta": {
+            "description": "The kind of contract: order, estimate, lease, agreement and so on."
+          },
           "enum": [
             "estimate",
             "order",
@@ -7385,7 +7502,10 @@
           "default": "USD",
           "description": "The currency of the amounts.",
           "_meta": {
-            "description": "The currency of the amounts."
+            "description": "The currency of the amounts.",
+            "ui": {
+              "widget": "currency"
+            }
           }
         },
         "issueDate": {
@@ -7427,7 +7547,10 @@
           "default": "",
           "description": "Anything worth remembering about this.",
           "_meta": {
-            "description": "Anything worth remembering about this."
+            "description": "Anything worth remembering about this.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "terms": {
@@ -7436,7 +7559,10 @@
           "default": "",
           "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
           "_meta": {
-            "description": "The conditions agreed, such as deposits, payment or delivery conditions."
+            "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "channelId": {
@@ -7697,6 +7823,7 @@
       "className": "LicenseSale",
       "qualifiedName": "@happyvertical/smrt-commerce:LicenseSale",
       "collection": "contracts",
+      "description": "Industry-neutral licensing primitive.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/Contract.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -7729,6 +7856,10 @@
         "contractType": {
           "type": "text",
           "required": false,
+          "description": "The kind of contract: order, estimate, lease, agreement and so on.",
+          "_meta": {
+            "description": "The kind of contract: order, estimate, lease, agreement and so on."
+          },
           "enum": [
             "estimate",
             "order",
@@ -7806,7 +7937,10 @@
           "default": "USD",
           "description": "The currency of the amounts.",
           "_meta": {
-            "description": "The currency of the amounts."
+            "description": "The currency of the amounts.",
+            "ui": {
+              "widget": "currency"
+            }
           }
         },
         "issueDate": {
@@ -7848,7 +7982,10 @@
           "default": "",
           "description": "Anything worth remembering about this.",
           "_meta": {
-            "description": "Anything worth remembering about this."
+            "description": "Anything worth remembering about this.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "terms": {
@@ -7857,7 +7994,10 @@
           "default": "",
           "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
           "_meta": {
-            "description": "The conditions agreed, such as deposits, payment or delivery conditions."
+            "description": "The conditions agreed, such as deposits, payment or delivery conditions.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "channelId": {
@@ -8254,6 +8394,7 @@
       "className": "ContractLineItem",
       "qualifiedName": "@happyvertical/smrt-commerce:ContractLineItem",
       "collection": "contractlineitems",
+      "description": "ContractLineItem represents a single line item on a contract.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/ContractLineItem.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -8286,22 +8427,38 @@
         "contractId": {
           "type": "foreignKey",
           "required": false,
-          "related": "Contract"
+          "related": "Contract",
+          "description": "The order, quote or agreement this line belongs to.",
+          "_meta": {
+            "description": "The order, quote or agreement this line belongs to."
+          }
         },
         "description": {
           "type": "text",
           "required": false,
-          "default": ""
+          "default": "",
+          "description": "What is being sold or bought on this line.",
+          "_meta": {
+            "description": "What is being sold or bought on this line."
+          }
         },
         "quantity": {
           "type": "decimal",
           "required": false,
-          "default": 1
+          "default": 1,
+          "description": "How many.",
+          "_meta": {
+            "description": "How many."
+          }
         },
         "unitPrice": {
           "type": "integer",
           "required": false,
-          "default": 0
+          "default": 0,
+          "description": "The price of one, before tax.",
+          "_meta": {
+            "description": "The price of one, before tax."
+          }
         },
         "discount": {
           "type": "integer",
@@ -8311,17 +8468,29 @@
         "taxRate": {
           "type": "decimal",
           "required": false,
-          "default": 0
+          "default": 0,
+          "description": "The tax rate for this line, as a percentage (5 means 5%).",
+          "_meta": {
+            "description": "The tax rate for this line, as a percentage (5 means 5%)."
+          }
         },
         "amount": {
           "type": "integer",
           "required": false,
-          "default": 0
+          "default": 0,
+          "description": "The line total.",
+          "_meta": {
+            "description": "The line total."
+          }
         },
         "productId": {
           "type": "crossPackageRef",
           "required": false,
-          "related": "@happyvertical/smrt-products:Product"
+          "related": "@happyvertical/smrt-products:Product",
+          "description": "The product this line is for, if it is one you list.",
+          "_meta": {
+            "description": "The product this line is for, if it is one you list."
+          }
         },
         "sku": {
           "type": "text",
@@ -8565,6 +8734,7 @@
       "className": "Customer",
       "qualifiedName": "@happyvertical/smrt-commerce:Customer",
       "collection": "customers",
+      "description": "Customer represents the customer role for a Profile.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/Customer.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -8680,7 +8850,10 @@
           "default": "",
           "description": "Anything worth remembering about this customer.",
           "_meta": {
-            "description": "Anything worth remembering about this customer."
+            "description": "Anything worth remembering about this customer.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         }
       },
@@ -8880,6 +9053,7 @@
       "className": "Fulfillment",
       "qualifiedName": "@happyvertical/smrt-commerce:Fulfillment",
       "collection": "fulfillments",
+      "description": "Fulfillment tracks the delivery or completion of contract items.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/Fulfillment.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -8904,11 +9078,19 @@
         "contractId": {
           "type": "foreignKey",
           "required": false,
-          "related": "Contract"
+          "related": "Contract",
+          "description": "The order being fulfilled.",
+          "_meta": {
+            "description": "The order being fulfilled."
+          }
         },
         "fulfillmentType": {
           "type": "text",
           "required": false,
+          "description": "How it gets to the customer: shipment, delivery, pickup, digital or service.",
+          "_meta": {
+            "description": "How it gets to the customer: shipment, delivery, pickup, digital or service."
+          },
           "enum": [
             "shipment",
             "delivery",
@@ -8920,6 +9102,10 @@
         "status": {
           "type": "text",
           "required": false,
+          "description": "Where it stands: pending, processing, shipped, delivered or cancelled.",
+          "_meta": {
+            "description": "Where it stands: pending, processing, shipped, delivered or cancelled."
+          },
           "enum": [
             "pending",
             "processing",
@@ -8931,12 +9117,20 @@
         "trackingNumber": {
           "type": "text",
           "required": false,
-          "default": ""
+          "default": "",
+          "description": "The carrier's tracking number.",
+          "_meta": {
+            "description": "The carrier's tracking number."
+          }
         },
         "carrier": {
           "type": "text",
           "required": false,
-          "default": ""
+          "default": "",
+          "description": "The company carrying it.",
+          "_meta": {
+            "description": "The company carrying it."
+          }
         },
         "shippingAddress": {
           "type": "json",
@@ -8944,11 +9138,19 @@
         },
         "shippedAt": {
           "type": "datetime",
-          "required": false
+          "required": false,
+          "description": "When it was dispatched.",
+          "_meta": {
+            "description": "When it was dispatched."
+          }
         },
         "deliveredAt": {
           "type": "datetime",
-          "required": false
+          "required": false,
+          "description": "When it arrived.",
+          "_meta": {
+            "description": "When it arrived."
+          }
         },
         "estimatedDelivery": {
           "type": "datetime",
@@ -8957,7 +9159,11 @@
         "notes": {
           "type": "text",
           "required": false,
-          "default": ""
+          "default": "",
+          "description": "Anything worth remembering about this shipment.",
+          "_meta": {
+            "description": "Anything worth remembering about this shipment."
+          }
         }
       },
       "methods": {
@@ -9197,6 +9403,7 @@
       "className": "FulfillmentLineItem",
       "qualifiedName": "@happyvertical/smrt-commerce:FulfillmentLineItem",
       "collection": "fulfillmentlineitems",
+      "description": "FulfillmentLineItem tracks which contract line items are included in a specific fulfillment and how much was fulfilled.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/FulfillmentLineItem.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -9221,17 +9428,29 @@
         "fulfillmentId": {
           "type": "foreignKey",
           "required": false,
-          "related": "Fulfillment"
+          "related": "Fulfillment",
+          "description": "The shipment this line belongs to.",
+          "_meta": {
+            "description": "The shipment this line belongs to."
+          }
         },
         "contractLineItemId": {
           "type": "foreignKey",
           "required": false,
-          "related": "ContractLineItem"
+          "related": "ContractLineItem",
+          "description": "The order line being sent.",
+          "_meta": {
+            "description": "The order line being sent."
+          }
         },
         "quantityFulfilled": {
           "type": "decimal",
           "required": false,
-          "default": 1
+          "default": 1,
+          "description": "How many of that line are in this shipment.",
+          "_meta": {
+            "description": "How many of that line are in this shipment."
+          }
         },
         "notes": {
           "type": "text",
@@ -9390,6 +9609,7 @@
       "className": "Invoice",
       "qualifiedName": "@happyvertical/smrt-commerce:Invoice",
       "collection": "invoices",
+      "description": "Invoice represents a bill sent to a customer for goods or services.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/Invoice.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -9414,17 +9634,29 @@
         "customerId": {
           "type": "foreignKey",
           "required": false,
-          "related": "Customer"
+          "related": "Customer",
+          "description": "The customer being billed.",
+          "_meta": {
+            "description": "The customer being billed."
+          }
         },
         "contractId": {
           "type": "foreignKey",
           "required": false,
-          "related": "Contract"
+          "related": "Contract",
+          "description": "The order or agreement this invoice bills for, if any.",
+          "_meta": {
+            "description": "The order or agreement this invoice bills for, if any."
+          }
         },
         "invoiceNumber": {
           "type": "text",
           "required": false,
-          "default": ""
+          "default": "",
+          "description": "The number printed on the invoice.",
+          "_meta": {
+            "description": "The number printed on the invoice."
+          }
         },
         "reference": {
           "type": "text",
@@ -9433,25 +9665,45 @@
         },
         "issueDate": {
           "type": "datetime",
-          "required": false
+          "required": false,
+          "description": "The date the invoice was issued.",
+          "_meta": {
+            "description": "The date the invoice was issued."
+          }
         },
         "dueDate": {
           "type": "datetime",
-          "required": false
+          "required": false,
+          "description": "The date payment is expected.",
+          "_meta": {
+            "description": "The date payment is expected."
+          }
         },
         "paidDate": {
           "type": "datetime",
-          "required": false
+          "required": false,
+          "description": "The date it was paid in full.",
+          "_meta": {
+            "description": "The date it was paid in full."
+          }
         },
         "subtotal": {
           "type": "integer",
           "required": false,
-          "default": 0
+          "default": 0,
+          "description": "The amount before tax.",
+          "_meta": {
+            "description": "The amount before tax."
+          }
         },
         "taxAmount": {
           "type": "integer",
           "required": false,
-          "default": 0
+          "default": 0,
+          "description": "The tax charged.",
+          "_meta": {
+            "description": "The tax charged."
+          }
         },
         "providerTaxAmount": {
           "type": "integer",
@@ -9461,21 +9713,40 @@
         "totalAmount": {
           "type": "integer",
           "required": false,
-          "default": 0
+          "default": 0,
+          "description": "What the customer owes in all, tax included.",
+          "_meta": {
+            "description": "What the customer owes in all, tax included."
+          }
         },
         "amountPaid": {
           "type": "integer",
           "required": false,
-          "default": 0
+          "default": 0,
+          "description": "How much of the total has been paid so far.",
+          "_meta": {
+            "description": "How much of the total has been paid so far."
+          }
         },
         "currency": {
           "type": "text",
           "required": false,
-          "default": "CAD"
+          "default": "CAD",
+          "description": "The currency of the invoice.",
+          "_meta": {
+            "description": "The currency of the invoice.",
+            "ui": {
+              "widget": "currency"
+            }
+          }
         },
         "status": {
           "type": "text",
           "required": false,
+          "description": "Where the invoice stands: draft, sent, viewed, paid, overdue or cancelled.",
+          "_meta": {
+            "description": "Where the invoice stands: draft, sent, viewed, paid, overdue or cancelled."
+          },
           "enum": [
             "draft",
             "sent",
@@ -9546,17 +9817,38 @@
         "notes": {
           "type": "text",
           "required": false,
-          "default": ""
+          "default": "",
+          "description": "Private notes, not shown to the customer.",
+          "_meta": {
+            "description": "Private notes, not shown to the customer.",
+            "ui": {
+              "widget": "textarea"
+            }
+          }
         },
         "customerNotes": {
           "type": "text",
           "required": false,
-          "default": ""
+          "default": "",
+          "description": "A message shown to the customer on the invoice.",
+          "_meta": {
+            "description": "A message shown to the customer on the invoice.",
+            "ui": {
+              "widget": "textarea"
+            }
+          }
         },
         "terms": {
           "type": "text",
           "required": false,
-          "default": ""
+          "default": "",
+          "description": "The payment conditions, such as Net 30.",
+          "_meta": {
+            "description": "The payment conditions, such as Net 30.",
+            "ui": {
+              "widget": "textarea"
+            }
+          }
         }
       },
       "methods": {
@@ -10006,6 +10298,7 @@
       "className": "InvoiceLineItem",
       "qualifiedName": "@happyvertical/smrt-commerce:InvoiceLineItem",
       "collection": "invoicelineitems",
+      "description": "InvoiceLineItem represents a single line item on an invoice.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/InvoiceLineItem.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -10030,12 +10323,20 @@
         "invoiceId": {
           "type": "foreignKey",
           "required": false,
-          "related": "Invoice"
+          "related": "Invoice",
+          "description": "The invoice this line belongs to.",
+          "_meta": {
+            "description": "The invoice this line belongs to."
+          }
         },
         "description": {
           "type": "text",
           "required": false,
-          "default": ""
+          "default": "",
+          "description": "What is being billed on this line.",
+          "_meta": {
+            "description": "What is being billed on this line."
+          }
         },
         "sku": {
           "type": "text",
@@ -10045,7 +10346,11 @@
         "quantity": {
           "type": "decimal",
           "required": false,
-          "default": 1
+          "default": 1,
+          "description": "How many.",
+          "_meta": {
+            "description": "How many."
+          }
         },
         "invoiceEditorStateJson": {
           "type": "text",
@@ -10055,7 +10360,11 @@
         "unitPrice": {
           "type": "integer",
           "required": false,
-          "default": 0
+          "default": 0,
+          "description": "The price of one, before tax.",
+          "_meta": {
+            "description": "The price of one, before tax."
+          }
         },
         "discount": {
           "type": "integer",
@@ -10065,12 +10374,20 @@
         "taxRate": {
           "type": "decimal",
           "required": false,
-          "default": 0
+          "default": 0,
+          "description": "The tax rate for this line, as a percentage (5 means 5%).",
+          "_meta": {
+            "description": "The tax rate for this line, as a percentage (5 means 5%)."
+          }
         },
         "amount": {
           "type": "integer",
           "required": false,
-          "default": 0
+          "default": 0,
+          "description": "The line total.",
+          "_meta": {
+            "description": "The line total."
+          }
         },
         "sourceType": {
           "type": "text",
@@ -10399,6 +10716,7 @@
       "className": "Payment",
       "qualifiedName": "@happyvertical/smrt-commerce:Payment",
       "collection": "payments",
+      "description": "Payment represents a financial transaction against a contract.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/Payment.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -10423,26 +10741,49 @@
         "contractId": {
           "type": "foreignKey",
           "required": false,
-          "related": "Contract"
+          "related": "Contract",
+          "description": "The order or agreement this payment is for, if any.",
+          "_meta": {
+            "description": "The order or agreement this payment is for, if any."
+          }
         },
         "customerId": {
           "type": "foreignKey",
           "required": false,
-          "related": "Customer"
+          "related": "Customer",
+          "description": "The customer who paid.",
+          "_meta": {
+            "description": "The customer who paid."
+          }
         },
         "amount": {
           "type": "integer",
           "required": false,
-          "default": 0
+          "default": 0,
+          "description": "How much was paid.",
+          "_meta": {
+            "description": "How much was paid."
+          }
         },
         "currency": {
           "type": "text",
           "required": false,
-          "default": "USD"
+          "default": "USD",
+          "description": "The currency of the payment.",
+          "_meta": {
+            "description": "The currency of the payment.",
+            "ui": {
+              "widget": "currency"
+            }
+          }
         },
         "method": {
           "type": "text",
           "required": false,
+          "description": "How it was paid: cash, check, card, bank transfer or other.",
+          "_meta": {
+            "description": "How it was paid: cash, check, card, bank transfer or other."
+          },
           "enum": [
             "cash",
             "check",
@@ -10455,6 +10796,10 @@
         "status": {
           "type": "text",
           "required": false,
+          "description": "Whether the payment is pending, completed, failed or refunded.",
+          "_meta": {
+            "description": "Whether the payment is pending, completed, failed or refunded."
+          },
           "enum": [
             "pending",
             "completed",
@@ -10471,7 +10816,11 @@
         "reference": {
           "type": "text",
           "required": false,
-          "default": ""
+          "default": "",
+          "description": "A reference note, such as a check number.",
+          "_meta": {
+            "description": "A reference note, such as a check number."
+          }
         },
         "journalId": {
           "type": "crossPackageRef",
@@ -10480,12 +10829,23 @@
         },
         "paidAt": {
           "type": "datetime",
-          "required": false
+          "required": false,
+          "description": "When the money was received.",
+          "_meta": {
+            "description": "When the money was received."
+          }
         },
         "notes": {
           "type": "text",
           "required": false,
-          "default": ""
+          "default": "",
+          "description": "Anything worth remembering about this payment.",
+          "_meta": {
+            "description": "Anything worth remembering about this payment.",
+            "ui": {
+              "widget": "textarea"
+            }
+          }
         },
         "externalId": {
           "type": "text",
@@ -10884,6 +11244,7 @@
       "className": "PaymentAllocation",
       "qualifiedName": "@happyvertical/smrt-commerce:PaymentAllocation",
       "collection": "paymentallocations",
+      "description": "PaymentAllocation tracks how payments are applied to invoices.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/PaymentAllocation.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -10908,21 +11269,37 @@
         "paymentId": {
           "type": "foreignKey",
           "required": false,
-          "related": "Payment"
+          "related": "Payment",
+          "description": "The payment being applied.",
+          "_meta": {
+            "description": "The payment being applied."
+          }
         },
         "invoiceId": {
           "type": "foreignKey",
           "required": false,
-          "related": "Invoice"
+          "related": "Invoice",
+          "description": "The invoice it settles.",
+          "_meta": {
+            "description": "The invoice it settles."
+          }
         },
         "amount": {
           "type": "integer",
           "required": false,
-          "default": 0
+          "default": 0,
+          "description": "How much of the payment goes to this invoice.",
+          "_meta": {
+            "description": "How much of the payment goes to this invoice."
+          }
         },
         "allocatedAt": {
           "type": "datetime",
-          "required": false
+          "required": false,
+          "description": "When it was applied.",
+          "_meta": {
+            "description": "When it was applied."
+          }
         },
         "allocatedBy": {
           "type": "text",
@@ -10932,7 +11309,11 @@
         "notes": {
           "type": "text",
           "required": false,
-          "default": ""
+          "default": "",
+          "description": "Anything worth remembering about this allocation.",
+          "_meta": {
+            "description": "Anything worth remembering about this allocation."
+          }
         }
       },
       "methods": {
@@ -11099,6 +11480,7 @@
       "className": "PaymentInstrument",
       "qualifiedName": "@happyvertical/smrt-commerce:PaymentInstrument",
       "collection": "paymentinstruments",
+      "description": "PaymentInstrument stores a reusable payment method a customer has saved with a payment backend (e.g. a card vaulted by Stripe), so it can be charged later without the customer present.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/PaymentInstrument.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -12302,6 +12684,7 @@
       "className": "Vendor",
       "qualifiedName": "@happyvertical/smrt-commerce:Vendor",
       "collection": "vendors",
+      "description": "Vendor represents the vendor/supplier role for a Profile.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/Vendor.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -12364,7 +12747,10 @@
           "default": "USD",
           "description": "The currency this vendor bills you in.",
           "_meta": {
-            "description": "The currency this vendor bills you in."
+            "description": "The currency this vendor bills you in.",
+            "ui": {
+              "widget": "currency"
+            }
           }
         },
         "defaultContactEmail": {
@@ -12373,7 +12759,10 @@
           "default": "",
           "description": "The email address you normally use to reach this vendor.",
           "_meta": {
-            "description": "The email address you normally use to reach this vendor."
+            "description": "The email address you normally use to reach this vendor.",
+            "ui": {
+              "widget": "email"
+            }
           }
         },
         "defaultContactPhone": {
@@ -12382,7 +12771,10 @@
           "default": "",
           "description": "The phone number you normally use to reach this vendor.",
           "_meta": {
-            "description": "The phone number you normally use to reach this vendor."
+            "description": "The phone number you normally use to reach this vendor.",
+            "ui": {
+              "widget": "phone"
+            }
           }
         },
         "status": {
@@ -12404,7 +12796,10 @@
           "default": "",
           "description": "Anything worth remembering about this vendor.",
           "_meta": {
-            "description": "Anything worth remembering about this vendor."
+            "description": "Anything worth remembering about this vendor.",
+            "ui": {
+              "widget": "textarea"
+            }
           }
         },
         "payoutAddresses": {
@@ -12673,6 +13068,7 @@
       "className": "BillingAccount",
       "qualifiedName": "@happyvertical/smrt-commerce:BillingAccount",
       "collection": "billingaccounts",
+      "description": "One payer's account with one seller: the commerce Customer invoices are issued to, the provider customer they are pushed to, and the payer's billing terms.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/billing.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -12939,6 +13335,7 @@
       "className": "BillingPeriodClose",
       "qualifiedName": "@happyvertical/smrt-commerce:BillingPeriodClose",
       "collection": "billingperiodcloses",
+      "description": "The idempotency anchor for one payer's invoice in one currency for one period. Its id is derived from that identity, so a retried close always resumes the same row, invoice, and provider invoice.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/billing.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -13310,6 +13707,7 @@
       "className": "BillingLineSource",
       "qualifiedName": "@happyvertical/smrt-commerce:BillingLineSource",
       "collection": "billinglinesources",
+      "description": "A claim that one billable source — a charge, an adjustment, or a window of a flat plan — is billed on exactly one period close.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/billing.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -13581,6 +13979,7 @@
       "className": "BillingPaymentAttempt",
       "qualifiedName": "@happyvertical/smrt-commerce:BillingPaymentAttempt",
       "collection": "billingpaymentattempts",
+      "description": "One payment attempt on a payment rail (#3138): a short-lived provider checkout (for example a BTCPay invoice) paying a credit purchase or an issued invoice.",
       "filePath": "/home/runner/work/smrt/smrt/packages/commerce/src/models/billing.ts",
       "packageName": "@happyvertical/smrt-commerce",
       "fields": {
@@ -14981,29 +15380,167 @@
   "moduleType": "smrt",
   "recipes": [
     {
-      "id": "commerce.customers",
-      "className": "CustomersRecipe",
-      "label": "Customers",
-      "summary": "Keep a list of the customers you sell to.",
+      "id": "commerce.agreements",
+      "className": "AgreementsRecipe",
+      "label": "General agreements",
+      "summary": "Keep signed agreements with customers, and see every contract in one list.",
       "synonyms": [
-        "clients",
-        "buyers",
-        "accounts"
+        "contracts",
+        "terms",
+        "deals"
       ],
       "models": [
-        "@happyvertical/smrt-commerce:Customer"
+        "@happyvertical/smrt-commerce:Agreement",
+        "@happyvertical/smrt-commerce:Contract",
+        "@happyvertical/smrt-commerce:ContractLineItem"
       ],
       "nav": [
         {
-          "label": "Customers",
-          "model": "@happyvertical/smrt-commerce:Customer"
+          "label": "Agreements",
+          "model": "@happyvertical/smrt-commerce:Agreement",
+          "icon": "fileText",
+          "description": "Signed deals and terms with your customers, in one place."
+        },
+        {
+          "label": "All contracts",
+          "model": "@happyvertical/smrt-commerce:Contract",
+          "icon": "fileText",
+          "description": "Every contract you hold, whoever it is with."
         }
       ],
-      "requires": [],
-      "help": {
-        "markdown": "## Overview\n\nCustomers is your address book for the people and businesses you sell to. Keep\none record for each customer so you can see who they are, how they like to pay\nand what you have agreed with them, then refer back to them whenever you take an\norder.\n\n## Tasks\n\n### Add a new customer\n\n1. Choose the **New** button above the list.\n2. Describe the customer with **{field:customerType}**: a direct shopper, a\n   wholesale buyer or a retail customer. Note in **{field:status}** whether you\n   are still dealing with them.\n3. Fill in the **{field:defaultShippingAddress}** and\n   **{field:defaultBillingAddress}** so you do not have to type them again on\n   every order.\n4. Add **{field:paymentTerms}**, for example \"Net 30\", if you give this\n   customer time to pay.\n5. Save. The customer is now on your list and ready to use on a sales order.\n\n### Keep track of what a customer can owe\n\n1. Open the customer from the list and choose Edit.\n2. Set **{field:creditLimit}** to the most you are comfortable letting them owe\n   you at one time.\n3. If you do not charge them sales tax, turn on **{field:taxExempt}**, and keep\n   their tax number on file.\n4. Use **{field:notes}** for anything the next person who deals with this\n   customer should know.\n\n### Find a customer\n\nScan the list for the customer you want, or open a record to see everything you\nhave on file. To stop dealing with someone without losing their history, change\ntheir **{field:status}** to inactive instead of deleting them.\n",
-        "fieldRefs": [
-          "creditLimit",
+      "requires": [
+        "commerce.customers"
+      ],
+      "group": {
+        "id": "agreements",
+        "label": "Agreements",
+        "summary": "Contracts with customers: general agreements, leases and licence sales."
+      },
+      "section": {
+        "id": "agreements",
+        "label": "Agreements",
+        "icon": "fileText",
+        "description": "Contracts, leases and licenses with customers."
+      },
+      "options": {
+        "@happyvertical/smrt-commerce:Agreement": {
+          "fields": {
+            "contractType": {
+              "default": "agreement",
+              "visibility": "hidden",
+              "locked": true
+            },
+            "customerId": {
+              "label": "Customer",
+              "order": 1,
+              "required": true
+            },
+            "vendorId": {
+              "visibility": "hidden"
+            },
+            "subtotal": {
+              "visibility": "hidden"
+            },
+            "taxAmount": {
+              "visibility": "hidden"
+            },
+            "channelId": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-commerce:ContractLineItem": {
+          "fields": {
+            "sku": {
+              "visibility": "hidden"
+            },
+            "startDate": {
+              "visibility": "hidden"
+            },
+            "endDate": {
+              "visibility": "hidden"
+            },
+            "billingPeriod": {
+              "visibility": "hidden"
+            },
+            "sortOrder": {
+              "visibility": "hidden"
+            },
+            "discount": {
+              "visibility": "hidden"
+            },
+            "taxRate": {
+              "help": "Type a percentage: 5 means 5%."
+            }
+          }
+        },
+        "@happyvertical/smrt-commerce:Contract": {
+          "fields": {
+            "channelId": {
+              "visibility": "hidden"
+            }
+          }
+        }
+      },
+      "help": {
+        "markdown": "## Overview\n\nAgreements are contracts you keep with customers. General agreements live here;\nleases and licence sales are separate recipes in the same group.\n**All contracts** lists every kind together, including orders and quotes.\n\n## Tasks\n\n### Record an agreement\n\n1. Create a new agreement.\n2. Pick the **{field:customerId}**.\n3. Set the **{field:issueDate}** and **{field:expiryDate}**.\n4. Put the conditions in **{field:terms}** and save.\n\n### Follow it\n\n1. Update **{field:status}** from draft to accepted to completed.\n2. Check **{field:expiryDate}** to spot agreements about to lapse.\n",
+        "fieldRefs": [
+          "customerId",
+          "expiryDate",
+          "issueDate",
+          "status",
+          "terms"
+        ]
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package does not build for a browser: @happyvertical/payments btcpay (node:crypto); core migrations (node:os). The jobs runner edge (#3615) is reported on smrt-jobs; and its package depends on @happyvertical/smrt-jobs, @happyvertical/smrt-ledgers, @happyvertical/smrt-subscriptions, @happyvertical/smrt-tenancy, which do not build for a browser (#3615, #3624, #3626, #3627)."
+        ]
+      }
+    },
+    {
+      "id": "commerce.customers",
+      "className": "CustomersRecipe",
+      "label": "Customers",
+      "summary": "Keep a list of the people and companies you sell to.",
+      "synonyms": [
+        "clients",
+        "buyers",
+        "accounts"
+      ],
+      "models": [
+        "@happyvertical/smrt-commerce:Customer"
+      ],
+      "nav": [
+        {
+          "label": "Customers",
+          "model": "@happyvertical/smrt-commerce:Customer",
+          "icon": "users",
+          "description": "The people and companies you sell to, with how to reach them."
+        }
+      ],
+      "requires": [],
+      "section": {
+        "id": "sales",
+        "label": "Sales",
+        "icon": "shoppingBag",
+        "description": "Customers, orders and quotes: everything you sell."
+      },
+      "options": {
+        "@happyvertical/smrt-commerce:Customer": {
+          "fields": {
+            "profileId": {
+              "label": "Name",
+              "order": -1
+            }
+          }
+        }
+      },
+      "help": {
+        "markdown": "## Overview\n\nCustomers is your address book for the people and businesses you sell to. Keep\none record for each customer so you can see who they are, how they like to pay\nand what you have agreed with them, then refer back to them whenever you take an\norder.\n\n## Tasks\n\n### Add a new customer\n\n1. Choose the **New** button above the list.\n2. Describe the customer with **{field:customerType}**: a direct shopper, a\n   wholesale buyer or a retail customer. Note in **{field:status}** whether you\n   are still dealing with them.\n3. Fill in the **{field:defaultShippingAddress}** and\n   **{field:defaultBillingAddress}** so you do not have to type them again on\n   every order.\n4. Add **{field:paymentTerms}**, for example \"Net 30\", if you give this\n   customer time to pay.\n5. Save. The customer is now on your list and ready to use on a sales order.\n\n### Keep track of what a customer can owe\n\n1. Open the customer from the list and choose Edit.\n2. Set **{field:creditLimit}** to the most you are comfortable letting them owe\n   you at one time.\n3. If you do not charge them sales tax, turn on **{field:taxExempt}**, and keep\n   their tax number on file.\n4. Use **{field:notes}** for anything the next person who deals with this\n   customer should know.\n\n### Find a customer\n\nScan the list for the customer you want, or open a record to see everything you\nhave on file. To stop dealing with someone without losing their history, change\ntheir **{field:status}** to inactive instead of deleting them.\n",
+        "fieldRefs": [
+          "creditLimit",
           "customerType",
           "defaultBillingAddress",
           "defaultShippingAddress",
@@ -15012,30 +15549,621 @@
           "status",
           "taxExempt"
         ]
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package does not build for a browser: @happyvertical/payments btcpay (node:crypto); core migrations (node:os). The jobs runner edge (#3615) is reported on smrt-jobs; and its package depends on @happyvertical/smrt-jobs, @happyvertical/smrt-ledgers, @happyvertical/smrt-subscriptions, @happyvertical/smrt-tenancy, which do not build for a browser (#3615, #3624, #3626, #3627)."
+        ]
+      }
+    },
+    {
+      "id": "commerce.estimates",
+      "className": "EstimatesRecipe",
+      "label": "Estimates",
+      "summary": "Send customers a price quote before they commit.",
+      "synonyms": [
+        "quotes",
+        "quotations",
+        "proposals",
+        "bids"
+      ],
+      "models": [
+        "@happyvertical/smrt-commerce:Estimate",
+        "@happyvertical/smrt-commerce:ContractLineItem"
+      ],
+      "nav": [
+        {
+          "label": "Estimates",
+          "model": "@happyvertical/smrt-commerce:Estimate",
+          "icon": "fileText",
+          "description": "Price quotes you have sent to customers."
+        }
+      ],
+      "requires": [
+        "commerce.customers"
+      ],
+      "section": {
+        "id": "sales",
+        "label": "Sales",
+        "icon": "shoppingBag",
+        "description": "Customers, orders and quotes: everything you sell."
+      },
+      "options": {
+        "@happyvertical/smrt-commerce:Estimate": {
+          "fields": {
+            "contractType": {
+              "default": "estimate",
+              "visibility": "hidden",
+              "locked": true
+            },
+            "vendorId": {
+              "visibility": "hidden",
+              "locked": true
+            },
+            "customerId": {
+              "label": "Customer",
+              "order": 1,
+              "required": true
+            },
+            "channelId": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-commerce:ContractLineItem": {
+          "fields": {
+            "sku": {
+              "visibility": "hidden"
+            },
+            "startDate": {
+              "visibility": "hidden"
+            },
+            "endDate": {
+              "visibility": "hidden"
+            },
+            "billingPeriod": {
+              "visibility": "hidden"
+            },
+            "sortOrder": {
+              "visibility": "hidden"
+            },
+            "discount": {
+              "visibility": "hidden"
+            },
+            "taxRate": {
+              "help": "Type a percentage: 5 means 5%."
+            }
+          }
+        }
+      },
+      "help": {
+        "markdown": "## Overview\n\nEstimates are price quotes you send before a customer commits. Each one belongs\nto a customer, lists its line items and shows how long the price is good for.\n\n## Tasks\n\n### Write an estimate\n\n1. Create a new estimate.\n2. Pick the **{field:customerId}** the quote is for.\n3. Add the line items, then check the **{field:totalAmount}**.\n4. Set **{field:expiryDate}** to the last day the price is good for.\n5. Put your conditions in **{field:terms}** and save.\n\n### Follow it up\n\n1. Set **{field:status}** to sent once it goes out.\n2. Move it to accepted or declined when the customer answers.\n",
+        "fieldRefs": [
+          "customerId",
+          "expiryDate",
+          "status",
+          "terms",
+          "totalAmount"
+        ]
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package does not build for a browser: @happyvertical/payments btcpay (node:crypto); core migrations (node:os). The jobs runner edge (#3615) is reported on smrt-jobs; and its package depends on @happyvertical/smrt-jobs, @happyvertical/smrt-ledgers, @happyvertical/smrt-subscriptions, @happyvertical/smrt-tenancy, which do not build for a browser (#3615, #3624, #3626, #3627)."
+        ]
+      }
+    },
+    {
+      "id": "commerce.fulfillment",
+      "className": "FulfillmentRecipe",
+      "label": "Shipping",
+      "summary": "Pack, ship and deliver orders, with tracking.",
+      "synonyms": [
+        "fulfillment",
+        "delivery",
+        "shipments",
+        "tracking"
+      ],
+      "models": [
+        "@happyvertical/smrt-commerce:Fulfillment",
+        "@happyvertical/smrt-commerce:FulfillmentLineItem"
+      ],
+      "nav": [
+        {
+          "label": "Shipments",
+          "model": "@happyvertical/smrt-commerce:Fulfillment",
+          "icon": "truck",
+          "description": "What has gone out the door and where it is now."
+        }
+      ],
+      "requires": [],
+      "requiresAny": [
+        [
+          "commerce.sales",
+          "commerce.wholesale"
+        ]
+      ],
+      "group": {
+        "id": "billing",
+        "label": "Billing & shipping",
+        "summary": "Invoice your customers, record what they pay and ship what they ordered."
+      },
+      "section": {
+        "id": "operations",
+        "label": "Operations",
+        "icon": "wrench",
+        "description": "Fulfillment and the day-to-day work behind an order."
+      },
+      "options": {
+        "@happyvertical/smrt-commerce:Fulfillment": {
+          "fields": {
+            "estimatedDelivery": {
+              "visibility": "hidden"
+            },
+            "shippingAddress": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-commerce:FulfillmentLineItem": {
+          "fields": {
+            "notes": {
+              "visibility": "hidden"
+            }
+          }
+        }
+      },
+      "help": {
+        "markdown": "## Overview\n\nShipping tracks how an order gets to the customer. Each shipment belongs to an\norder and lists which line items are in it, so an order can go out in parts.\n\n## Tasks\n\n### Ship an order\n\n1. Create a new shipment.\n2. Pick the order in **{field:contractId}** and choose the\n   **{field:fulfillmentType}**.\n3. Enter the **{field:carrier}** and **{field:trackingNumber}**.\n4. List the items and quantities in the shipment.\n5. Set **{field:status}** to shipped and record **{field:shippedAt}**.\n\n### Confirm delivery\n\n1. Open the shipment and set **{field:status}** to delivered.\n2. Record **{field:deliveredAt}**.\n",
+        "fieldRefs": [
+          "carrier",
+          "contractId",
+          "deliveredAt",
+          "fulfillmentType",
+          "shippedAt",
+          "status",
+          "trackingNumber"
+        ]
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package does not build for a browser: @happyvertical/payments btcpay (node:crypto); core migrations (node:os). The jobs runner edge (#3615) is reported on smrt-jobs; and its package depends on @happyvertical/smrt-jobs, @happyvertical/smrt-ledgers, @happyvertical/smrt-subscriptions, @happyvertical/smrt-tenancy, which do not build for a browser (#3615, #3624, #3626, #3627)."
+        ]
+      }
+    },
+    {
+      "id": "commerce.invoicing",
+      "className": "InvoicingRecipe",
+      "label": "Invoicing",
+      "summary": "Bill customers and record the payments that come in.",
+      "synonyms": [
+        "invoices",
+        "billing",
+        "payments",
+        "receivables"
+      ],
+      "models": [
+        "@happyvertical/smrt-commerce:Invoice",
+        "@happyvertical/smrt-commerce:InvoiceLineItem",
+        "@happyvertical/smrt-commerce:Payment",
+        "@happyvertical/smrt-commerce:PaymentAllocation"
+      ],
+      "nav": [
+        {
+          "label": "Invoices",
+          "model": "@happyvertical/smrt-commerce:Invoice",
+          "icon": "receipt",
+          "description": "Bills you have sent and which ones are still waiting to be paid."
+        },
+        {
+          "label": "Payments",
+          "model": "@happyvertical/smrt-commerce:Payment",
+          "icon": "creditCard",
+          "description": "Money received, matched to the invoices it paid."
+        }
+      ],
+      "requires": [
+        "commerce.customers"
+      ],
+      "group": {
+        "id": "billing",
+        "label": "Billing & shipping",
+        "summary": "Invoice your customers, record what they pay and ship what they ordered."
+      },
+      "section": {
+        "id": "billing",
+        "label": "Billing",
+        "icon": "receipt",
+        "description": "Invoices and the payments against them."
+      },
+      "options": {
+        "@happyvertical/smrt-commerce:Invoice": {
+          "fields": {
+            "providerTaxAmount": {
+              "visibility": "hidden"
+            },
+            "arJournalId": {
+              "visibility": "hidden"
+            },
+            "revenueJournalId": {
+              "visibility": "hidden"
+            },
+            "externalId": {
+              "visibility": "hidden"
+            },
+            "customerExternalId": {
+              "visibility": "hidden"
+            },
+            "externalProvider": {
+              "visibility": "hidden"
+            },
+            "syncedAt": {
+              "visibility": "hidden"
+            },
+            "collectionMethod": {
+              "visibility": "hidden"
+            },
+            "sentAt": {
+              "visibility": "hidden"
+            },
+            "viewedAt": {
+              "visibility": "hidden"
+            },
+            "remindersSent": {
+              "visibility": "hidden"
+            },
+            "lastReminderAt": {
+              "visibility": "hidden"
+            },
+            "reference": {
+              "visibility": "hidden"
+            },
+            "customerId": {
+              "required": true
+            }
+          }
+        },
+        "@happyvertical/smrt-commerce:InvoiceLineItem": {
+          "fields": {
+            "invoiceEditorStateJson": {
+              "visibility": "hidden"
+            },
+            "sourceType": {
+              "visibility": "hidden"
+            },
+            "sourceId": {
+              "visibility": "hidden"
+            },
+            "periodStart": {
+              "visibility": "hidden"
+            },
+            "periodEnd": {
+              "visibility": "hidden"
+            },
+            "revenueAccountId": {
+              "visibility": "hidden"
+            },
+            "sortOrder": {
+              "visibility": "hidden"
+            },
+            "sku": {
+              "visibility": "hidden"
+            },
+            "discount": {
+              "visibility": "hidden"
+            },
+            "taxRate": {
+              "help": "Type a percentage: 5 means 5%."
+            }
+          }
+        },
+        "@happyvertical/smrt-commerce:Payment": {
+          "fields": {
+            "journalId": {
+              "visibility": "hidden"
+            },
+            "externalId": {
+              "visibility": "hidden"
+            },
+            "externalProvider": {
+              "visibility": "hidden"
+            },
+            "syncedAt": {
+              "visibility": "hidden"
+            },
+            "backendId": {
+              "visibility": "hidden"
+            },
+            "backendTxRef": {
+              "visibility": "hidden"
+            },
+            "nativeAmount": {
+              "visibility": "hidden"
+            },
+            "nativeCurrency": {
+              "visibility": "hidden"
+            },
+            "usdAtQuote": {
+              "visibility": "hidden"
+            },
+            "usdAtConfirmation": {
+              "visibility": "hidden"
+            },
+            "transactionId": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-commerce:PaymentAllocation": {
+          "fields": {
+            "allocatedBy": {
+              "visibility": "hidden"
+            }
+          }
+        }
+      },
+      "help": {
+        "markdown": "## Overview\n\nInvoicing bills your customers and records what they pay. An invoice lists its\nline items; a payment can be spread across one or more invoices.\n\n## Tasks\n\n### Send an invoice\n\n1. Create a new invoice.\n2. Pick the **{field:customerId}** and add the line items.\n3. Check the **{field:totalAmount}** and set the **{field:dueDate}**.\n4. Set **{field:status}** to sent once it goes out.\n\n### Record a payment\n\n1. Create a new payment.\n2. Pick the **{field:customerId}**, then enter the **{field:Payment.amount}** and the\n   **{field:method}** used.\n3. Set **{field:Payment.status}** to completed once the money has arrived.\n4. Apply it to the invoices it settles; each one shows what is still owed.\n",
+        "fieldRefs": [
+          "Payment.amount",
+          "Payment.status",
+          "customerId",
+          "dueDate",
+          "method",
+          "status",
+          "totalAmount"
+        ]
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package does not build for a browser: @happyvertical/payments btcpay (node:crypto); core migrations (node:os). The jobs runner edge (#3615) is reported on smrt-jobs; and its package depends on @happyvertical/smrt-jobs, @happyvertical/smrt-ledgers, @happyvertical/smrt-subscriptions, @happyvertical/smrt-tenancy, which do not build for a browser (#3615, #3624, #3626, #3627)."
+        ]
+      }
+    },
+    {
+      "id": "commerce.leases",
+      "className": "LeasesRecipe",
+      "label": "Leases",
+      "summary": "Rent things out and track the term and the payments due.",
+      "synonyms": [
+        "rentals",
+        "renting",
+        "hire"
+      ],
+      "models": [
+        "@happyvertical/smrt-commerce:Lease",
+        "@happyvertical/smrt-commerce:ContractLineItem"
+      ],
+      "nav": [
+        {
+          "label": "Leases",
+          "model": "@happyvertical/smrt-commerce:Lease",
+          "icon": "home",
+          "description": "Rentals you give or take, with terms and dates."
+        }
+      ],
+      "requires": [
+        "commerce.customers"
+      ],
+      "group": {
+        "id": "agreements",
+        "label": "Agreements",
+        "summary": "Contracts with customers: general agreements, leases and licence sales."
+      },
+      "section": {
+        "id": "agreements",
+        "label": "Agreements",
+        "icon": "fileText",
+        "description": "Contracts, leases and licenses with customers."
+      },
+      "options": {
+        "@happyvertical/smrt-commerce:Lease": {
+          "fields": {
+            "contractType": {
+              "default": "lease",
+              "visibility": "hidden",
+              "locked": true
+            },
+            "customerId": {
+              "label": "Customer",
+              "order": 1,
+              "required": true
+            },
+            "vendorId": {
+              "visibility": "hidden"
+            },
+            "subtotal": {
+              "visibility": "hidden"
+            },
+            "taxAmount": {
+              "visibility": "hidden"
+            },
+            "channelId": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-commerce:ContractLineItem": {
+          "fields": {
+            "sku": {
+              "visibility": "hidden"
+            },
+            "startDate": {
+              "visibility": "hidden"
+            },
+            "endDate": {
+              "visibility": "hidden"
+            },
+            "billingPeriod": {
+              "visibility": "hidden"
+            },
+            "sortOrder": {
+              "visibility": "hidden"
+            },
+            "discount": {
+              "visibility": "hidden"
+            },
+            "taxRate": {
+              "help": "Type a percentage: 5 means 5%."
+            }
+          }
+        }
+      },
+      "help": {
+        "markdown": "## Overview\n\nLeases are agreements where a customer rents something from you for a period.\nEach lease keeps its own line items and dates.\n\n## Tasks\n\n### Record a lease\n\n1. Create a new lease.\n2. Pick the **{field:customerId}** renting from you.\n3. Set the **{field:issueDate}** it starts and the **{field:expiryDate}** it ends.\n4. Add a line item for each thing rented, then save.\n\n### Keep an eye on it\n\n1. Update **{field:status}** as the lease goes from draft to accepted to\n   completed.\n2. Check **{field:expiryDate}** to see which leases end soon.\n",
+        "fieldRefs": [
+          "customerId",
+          "expiryDate",
+          "issueDate",
+          "status"
+        ]
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package does not build for a browser: @happyvertical/payments btcpay (node:crypto); core migrations (node:os). The jobs runner edge (#3615) is reported on smrt-jobs; and its package depends on @happyvertical/smrt-jobs, @happyvertical/smrt-ledgers, @happyvertical/smrt-subscriptions, @happyvertical/smrt-tenancy, which do not build for a browser (#3615, #3624, #3626, #3627)."
+        ]
+      }
+    },
+    {
+      "id": "commerce.licenses",
+      "className": "LicensesRecipe",
+      "label": "Licence sales",
+      "summary": "Sell licences to software, content or other rights.",
+      "synonyms": [
+        "licenses",
+        "licensing",
+        "subscriptions"
+      ],
+      "models": [
+        "@happyvertical/smrt-commerce:LicenseSale",
+        "@happyvertical/smrt-commerce:ContractLineItem"
+      ],
+      "nav": [
+        {
+          "label": "Licence sales",
+          "model": "@happyvertical/smrt-commerce:LicenseSale",
+          "icon": "shoppingBag",
+          "description": "Licences you have sold and who holds them."
+        }
+      ],
+      "requires": [
+        "commerce.customers"
+      ],
+      "group": {
+        "id": "agreements",
+        "label": "Agreements",
+        "summary": "Contracts with customers: general agreements, leases and licence sales."
+      },
+      "section": {
+        "id": "agreements",
+        "label": "Agreements",
+        "icon": "fileText",
+        "description": "Contracts, leases and licenses with customers."
+      },
+      "options": {
+        "@happyvertical/smrt-commerce:LicenseSale": {
+          "fields": {
+            "contractType": {
+              "default": "license_sale",
+              "visibility": "hidden",
+              "locked": true
+            },
+            "customerId": {
+              "label": "Customer",
+              "order": 1,
+              "required": true
+            },
+            "vendorId": {
+              "visibility": "hidden"
+            },
+            "subtotal": {
+              "visibility": "hidden"
+            },
+            "taxAmount": {
+              "visibility": "hidden"
+            },
+            "channelId": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-commerce:ContractLineItem": {
+          "fields": {
+            "sku": {
+              "visibility": "hidden"
+            },
+            "startDate": {
+              "visibility": "hidden"
+            },
+            "endDate": {
+              "visibility": "hidden"
+            },
+            "billingPeriod": {
+              "visibility": "hidden"
+            },
+            "sortOrder": {
+              "visibility": "hidden"
+            },
+            "discount": {
+              "visibility": "hidden"
+            },
+            "taxRate": {
+              "help": "Type a percentage: 5 means 5%."
+            }
+          }
+        }
+      },
+      "help": {
+        "markdown": "## Overview\n\nLicence sales record selling the right to use something, such as software or\ncontent, rather than a physical item.\n\n## Tasks\n\n### Record a licence sale\n\n1. Create a new licence sale.\n2. Pick the **{field:customerId}** who bought the licence.\n3. Add a line item for what is licensed and check the **{field:totalAmount}**.\n4. Set the **{field:expiryDate}** if the licence runs out, then save.\n\n### Follow it\n\n1. Update **{field:status}** when the customer accepts or the sale completes.\n",
+        "fieldRefs": [
+          "customerId",
+          "expiryDate",
+          "status",
+          "totalAmount"
+        ]
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package does not build for a browser: @happyvertical/payments btcpay (node:crypto); core migrations (node:os). The jobs runner edge (#3615) is reported on smrt-jobs; and its package depends on @happyvertical/smrt-jobs, @happyvertical/smrt-ledgers, @happyvertical/smrt-subscriptions, @happyvertical/smrt-tenancy, which do not build for a browser (#3615, #3624, #3626, #3627)."
+        ]
       }
     },
     {
       "id": "commerce.purchases",
       "className": "PurchasesRecipe",
       "label": "Purchases",
-      "summary": "Place orders with vendors and track them.",
+      "summary": "Order from your vendors and track what you have bought.",
       "synonyms": [
         "purchase orders",
         "buying",
         "procurement"
       ],
       "models": [
-        "@happyvertical/smrt-commerce:PurchaseOrder"
+        "@happyvertical/smrt-commerce:PurchaseOrder",
+        "@happyvertical/smrt-commerce:ContractLineItem"
       ],
       "nav": [
         {
-          "label": "Purchase Orders",
-          "model": "@happyvertical/smrt-commerce:PurchaseOrder"
+          "label": "Purchase orders",
+          "model": "@happyvertical/smrt-commerce:PurchaseOrder",
+          "icon": "truck",
+          "description": "What you have ordered from your suppliers and when it arrives."
         }
       ],
       "requires": [
         "commerce.vendors"
       ],
+      "section": {
+        "id": "purchasing",
+        "label": "Purchasing",
+        "icon": "truck",
+        "description": "Vendors and purchase orders: everything you buy."
+      },
       "options": {
         "@happyvertical/smrt-commerce:PurchaseOrder": {
           "fields": {
@@ -15051,6 +16179,37 @@
             "vendorId": {
               "label": "Vendor",
               "order": 1
+            },
+            "channelId": {
+              "visibility": "hidden"
+            },
+            "expiryDate": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-commerce:ContractLineItem": {
+          "fields": {
+            "sku": {
+              "visibility": "hidden"
+            },
+            "startDate": {
+              "visibility": "hidden"
+            },
+            "endDate": {
+              "visibility": "hidden"
+            },
+            "billingPeriod": {
+              "visibility": "hidden"
+            },
+            "sortOrder": {
+              "visibility": "hidden"
+            },
+            "discount": {
+              "visibility": "hidden"
+            },
+            "taxRate": {
+              "help": "Type a percentage: 5 means 5%."
             }
           }
         }
@@ -15070,6 +16229,12 @@
           "totalAmount",
           "vendorId"
         ]
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package does not build for a browser: @happyvertical/payments btcpay (node:crypto); core migrations (node:os). The jobs runner edge (#3615) is reported on smrt-jobs; and its package depends on @happyvertical/smrt-jobs, @happyvertical/smrt-ledgers, @happyvertical/smrt-subscriptions, @happyvertical/smrt-tenancy, which do not build for a browser (#3615, #3624, #3626, #3627)."
+        ]
       }
     },
     {
@@ -15083,17 +16248,26 @@
         "customer orders"
       ],
       "models": [
-        "@happyvertical/smrt-commerce:Order"
+        "@happyvertical/smrt-commerce:Order",
+        "@happyvertical/smrt-commerce:ContractLineItem"
       ],
       "nav": [
         {
-          "label": "Sales Orders",
-          "model": "@happyvertical/smrt-commerce:Order"
+          "label": "Sales orders",
+          "model": "@happyvertical/smrt-commerce:Order",
+          "icon": "shoppingBag",
+          "description": "Orders from your customers, from placed to delivered."
         }
       ],
       "requires": [
         "commerce.customers"
       ],
+      "section": {
+        "id": "sales",
+        "label": "Sales",
+        "icon": "shoppingBag",
+        "description": "Customers, orders and quotes: everything you sell."
+      },
       "options": {
         "@happyvertical/smrt-commerce:Order": {
           "fields": {
@@ -15108,7 +16282,39 @@
             },
             "customerId": {
               "label": "Customer",
-              "order": 1
+              "order": 1,
+              "required": true
+            },
+            "channelId": {
+              "visibility": "hidden"
+            },
+            "expiryDate": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-commerce:ContractLineItem": {
+          "fields": {
+            "sku": {
+              "visibility": "hidden"
+            },
+            "startDate": {
+              "visibility": "hidden"
+            },
+            "endDate": {
+              "visibility": "hidden"
+            },
+            "billingPeriod": {
+              "visibility": "hidden"
+            },
+            "sortOrder": {
+              "visibility": "hidden"
+            },
+            "discount": {
+              "visibility": "hidden"
+            },
+            "taxRate": {
+              "help": "Type a percentage: 5 means 5%."
             }
           }
         }
@@ -15128,13 +16334,19 @@
           "terms",
           "totalAmount"
         ]
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package does not build for a browser: @happyvertical/payments btcpay (node:crypto); core migrations (node:os). The jobs runner edge (#3615) is reported on smrt-jobs; and its package depends on @happyvertical/smrt-jobs, @happyvertical/smrt-ledgers, @happyvertical/smrt-subscriptions, @happyvertical/smrt-tenancy, which do not build for a browser (#3615, #3624, #3626, #3627)."
+        ]
       }
     },
     {
       "id": "commerce.vendors",
       "className": "VendorsRecipe",
       "label": "Vendors",
-      "summary": "Keep a list of the vendors and suppliers you buy from.",
+      "summary": "Keep a list of the suppliers you buy from.",
       "synonyms": [
         "suppliers",
         "sellers"
@@ -15145,10 +16357,28 @@
       "nav": [
         {
           "label": "Vendors",
-          "model": "@happyvertical/smrt-commerce:Vendor"
+          "model": "@happyvertical/smrt-commerce:Vendor",
+          "icon": "briefcase",
+          "description": "The suppliers you buy from, with terms and contacts."
         }
       ],
       "requires": [],
+      "section": {
+        "id": "purchasing",
+        "label": "Purchasing",
+        "icon": "truck",
+        "description": "Vendors and purchase orders: everything you buy."
+      },
+      "options": {
+        "@happyvertical/smrt-commerce:Vendor": {
+          "fields": {
+            "profileId": {
+              "label": "Name",
+              "order": -1
+            }
+          }
+        }
+      },
       "help": {
         "markdown": "## Overview\n\nVendors is your list of the suppliers you buy from. Each record holds who they\nare, how to reach them and the terms you have agreed, so you can order from them\nquickly and keep track of what you have bought.\n\n## Tasks\n\n### Add a vendor\n\n1. Choose the **New** button above the list.\n2. Enter **{field:defaultContactEmail}** and **{field:defaultContactPhone}** for\n   the person you normally deal with.\n3. Set the **{field:currency}** they bill you in and your **{field:paymentTerms}**,\n   for example \"Net 30\".\n4. Save. The vendor is now on your list and ready to use on a purchase order.\n\n### Note how a vendor likes to work\n\n1. Open the vendor from the list and choose Edit.\n2. Enter **{field:leadTimeDays}**, the number of days they usually need between\n   your order and delivery, so you can plan ahead.\n3. Enter **{field:minimumOrderAmount}** if they will not accept small orders.\n4. Use **{field:notes}** for anything else worth remembering, such as the best\n   time to call.\n\n### Keep payment details in one place\n\n1. Open the vendor and choose Edit.\n2. Record where payments to this vendor should be sent, so it is all in one\n   place.\n3. Set **{field:status}** to show whether you still buy from them: active,\n   inactive or suspended.\n",
         "fieldRefs": [
@@ -15161,9 +16391,127 @@
           "paymentTerms",
           "status"
         ]
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package does not build for a browser: @happyvertical/payments btcpay (node:crypto); core migrations (node:os). The jobs runner edge (#3615) is reported on smrt-jobs; and its package depends on @happyvertical/smrt-jobs, @happyvertical/smrt-ledgers, @happyvertical/smrt-subscriptions, @happyvertical/smrt-tenancy, which do not build for a browser (#3615, #3624, #3626, #3627)."
+        ]
+      }
+    },
+    {
+      "id": "commerce.wholesale",
+      "className": "WholesaleRecipe",
+      "label": "Wholesale orders",
+      "summary": "Take bulk orders from trade customers.",
+      "synonyms": [
+        "bulk orders",
+        "trade orders",
+        "b2b"
+      ],
+      "models": [
+        "@happyvertical/smrt-commerce:WholesaleOrder",
+        "@happyvertical/smrt-commerce:ContractLineItem"
+      ],
+      "nav": [
+        {
+          "label": "Wholesale orders",
+          "model": "@happyvertical/smrt-commerce:WholesaleOrder",
+          "icon": "shoppingBag",
+          "description": "Bulk orders from cafes, shops and other businesses."
+        }
+      ],
+      "requires": [
+        "commerce.customers"
+      ],
+      "section": {
+        "id": "sales",
+        "label": "Sales",
+        "icon": "shoppingBag",
+        "description": "Customers, orders and quotes: everything you sell."
+      },
+      "options": {
+        "@happyvertical/smrt-commerce:WholesaleOrder": {
+          "fields": {
+            "contractType": {
+              "default": "wholesale_order",
+              "visibility": "hidden",
+              "locked": true
+            },
+            "vendorId": {
+              "visibility": "hidden",
+              "locked": true
+            },
+            "customerId": {
+              "label": "Customer",
+              "order": 1
+            },
+            "channelId": {
+              "visibility": "hidden"
+            },
+            "expiryDate": {
+              "visibility": "hidden"
+            }
+          }
+        },
+        "@happyvertical/smrt-commerce:ContractLineItem": {
+          "fields": {
+            "sku": {
+              "visibility": "hidden"
+            },
+            "startDate": {
+              "visibility": "hidden"
+            },
+            "endDate": {
+              "visibility": "hidden"
+            },
+            "billingPeriod": {
+              "visibility": "hidden"
+            },
+            "sortOrder": {
+              "visibility": "hidden"
+            },
+            "discount": {
+              "visibility": "hidden"
+            },
+            "taxRate": {
+              "help": "Type a percentage: 5 means 5%."
+            }
+          }
+        }
+      },
+      "help": {
+        "markdown": "## Overview\n\nWholesale orders are bulk orders from trade customers. They work like sales\norders, with a list of line items, but are kept in their own list so trade and\nretail sales stay apart.\n\n## Tasks\n\n### Take a wholesale order\n\n1. Create a new wholesale order.\n2. Pick the **{field:customerId}** placing the order.\n3. Add the line items and check the **{field:totalAmount}**.\n4. Set the **{field:dueDate}** for payment and save.\n\n### Track it\n\n1. Update **{field:status}** as the order moves from draft to completed.\n2. Use **{field:reference}** for the buyer's own order number.\n",
+        "fieldRefs": [
+          "customerId",
+          "dueDate",
+          "reference",
+          "status",
+          "totalAmount"
+        ]
+      },
+      "demo": {
+        "mode": "server",
+        "reasons": [
+          "Needs a server because its package does not build for a browser: @happyvertical/payments btcpay (node:crypto); core migrations (node:os). The jobs runner edge (#3615) is reported on smrt-jobs; and its package depends on @happyvertical/smrt-jobs, @happyvertical/smrt-ledgers, @happyvertical/smrt-subscriptions, @happyvertical/smrt-tenancy, which do not build for a browser (#3615, #3624, #3626, #3627)."
+        ]
       }
     }
   ],
+  "uiSelectors": {
+    "customer-select": {
+      "slotId": "customer-select",
+      "selects": "@happyvertical/smrt-commerce:Customer",
+      "label": "Customer Select",
+      "description": "Searchable customer picker for relation fields; the caller supplies the lookup"
+    },
+    "vendor-select": {
+      "slotId": "vendor-select",
+      "selects": "@happyvertical/smrt-commerce:Vendor",
+      "label": "Vendor Select",
+      "description": "Searchable vendor picker for relation fields; the caller supplies the lookup"
+    }
+  },
   "smrtDependencies": [
     "@happyvertical/smrt-core",
     "@happyvertical/smrt-jobs",
@@ -15171,5 +16519,21 @@
     "@happyvertical/smrt-subscriptions",
     "@happyvertical/smrt-tenancy"
   ],
+  "browser": {
+    "status": "server-only",
+    "issues": [
+      "#3615",
+      "#3624",
+      "#3626",
+      "#3627"
+    ],
+    "reason": "@happyvertical/payments btcpay (node:crypto); core migrations (node:os). The jobs runner edge (#3615) is reported on smrt-jobs",
+    "via": [
+      "@happyvertical/smrt-jobs",
+      "@happyvertical/smrt-ledgers",
+      "@happyvertical/smrt-subscriptions",
+      "@happyvertical/smrt-tenancy"
+    ]
+  },
   "stampsConstructors": true
 }