@mj-biz-apps/sales-server 6.18.0 → 6.20.0

package/dist/generated/graphql-schemas/__mj_BizAppsSales.js

@@ -689,7 +689,7 @@ __decorate([
     __metadata("design:type", Array)
 ], mjBizAppsSalesDealContactRole_.prototype, "ReadableFields___", void 0);
 mjBizAppsSalesDealContactRole_ = __decorate([
-    ObjectType({ description: "The buying committee on the CUSTOMER side: which contact plays which role on this deal. A junction rather than a field on SalesContact because one contact holds different roles on different deals." })
+    ObjectType({ description: "The customer's buying team: which contact plays which role on a deal." })
 ], mjBizAppsSalesDealContactRole_);
 export { mjBizAppsSalesDealContactRole_ };
 //****************************************************************************
@@ -931,7 +931,7 @@ __decorate([
     __metadata("design:type", Date)
 ], mjBizAppsSalesDealPaymentSchedule_.prototype, "PaymentDate", void 0);
 __decorate([
-    Field(() => Float, { nullable: true, description: "The instalment amount as agreed. Unconstrained in sign: a refund or credit instalment is legitimately negative, and this table records what was agreed rather than asserting a shape for it." }),
+    Field(() => Float, { nullable: true, description: "The instalment amount as agreed. Can be negative for a refund or credit." }),
     __metadata("design:type", Number)
 ], mjBizAppsSalesDealPaymentSchedule_.prototype, "Amount", void 0);
 __decorate([
@@ -940,7 +940,7 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesDealPaymentSchedule_.prototype, "Description", void 0);
 __decorate([
-    Field(() => Int, { nullable: true, description: "Explicit ordering, because instalment order is not always date order — \"on execution\" and \"on signature of SOW 2\" can share a date or have none yet. Server-maintained and re-sequenced on every save, mirroring how accounting re-sequences JournalEntryLine.LineNumber." }),
+    Field(() => Int, { nullable: true, description: "Position of the instalment in the schedule, for instalments that share a date or have none yet." }),
     __metadata("design:type", Number)
 ], mjBizAppsSalesDealPaymentSchedule_.prototype, "DisplayOrder", void 0);
 __decorate([
@@ -961,7 +961,7 @@ __decorate([
     __metadata("design:type", Array)
 ], mjBizAppsSalesDealPaymentSchedule_.prototype, "ReadableFields___", void 0);
 mjBizAppsSalesDealPaymentSchedule_ = __decorate([
-    ObjectType({ description: "The EXCEPTION payment schedule for a deal. THE ABSENCE OF ROWS IS THE COMMON CASE and that is the design: the standard term is 100% payable on execution, so a deal on standard terms carries no rows here and rows exist only where something else was negotiated. Storing the default on every deal would let a later change to \"default\" silently rewrite history, and would turn \"did this deal negotiate payment terms?\" into arithmetic instead of a row count. This app does NOT check that the schedule sums to the deal amount — that is computing money, and the authoritative total lives in orders." })
+    ObjectType({ description: "Payment instalments agreed for a deal when they differ from the standard terms. A deal on standard terms has no rows here." })
 ], mjBizAppsSalesDealPaymentSchedule_);
 export { mjBizAppsSalesDealPaymentSchedule_ };
 //****************************************************************************
@@ -1208,11 +1208,11 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesDealRole_.prototype, "Description", void 0);
 __decorate([
-    Field(() => Boolean, { nullable: true, description: "Identifies the role that DEFINES ownership. Exactly one team member per deal may hold a role with this flag, enforced server-side, and Deal.OwnerEmployeeID is the denormalized stamp of whoever does." }),
+    Field(() => Boolean, { nullable: true, description: "Marks the role that owns the deal. Only one team member per deal can hold it, and that person is shown as the deal's owner." }),
     __metadata("design:type", Boolean)
 ], mjBizAppsSalesDealRole_.prototype, "IsOwnerRole", void 0);
 __decorate([
-    Field(() => Boolean, { nullable: true, description: "Whether two people may hold this role on one deal. Two sales engineers, yes; two owners, no. Enforced server-side FROM THIS FLAG, never hardcoded against a role name." }),
+    Field(() => Boolean, { nullable: true, description: "Whether more than one person can hold this role on the same deal, for example two sales engineers." }),
     __metadata("design:type", Boolean)
 ], mjBizAppsSalesDealRole_.prototype, "AllowsMultiplePerDeal", void 0);
 __decorate([
@@ -1755,7 +1755,7 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesDealStageEvent_.prototype, "ChangedByUserID", void 0);
 __decorate([
-    Field({ nullable: true, description: "The ORIGINAL time of the transition, not the row's insert time. A distinct column rather than a reliance on __mj_CreatedAt because the HubSpot import must preserve historical timestamps — a 2023 transition has to land as 2023." }),
+    Field({ nullable: true, description: "When the stage change happened. For imported deals this is the original date, not the import date." }),
     __metadata("design:type", Date)
 ], mjBizAppsSalesDealStageEvent_.prototype, "ChangedAt", void 0);
 __decorate([
@@ -1763,11 +1763,11 @@ __decorate([
     __metadata("design:type", Number)
 ], mjBizAppsSalesDealStageEvent_.prototype, "DaysInPreviousStage", void 0);
 __decorate([
-    Field(() => Float, { nullable: true, description: "Deal.Amount as it stood at this transition. Point-in-time truth: \"what did we think the forecast was on the 1st\" is unanswerable from Deal alone once amounts change." }),
+    Field(() => Float, { nullable: true, description: "The deal amount at the time of this stage change." }),
     __metadata("design:type", Number)
 ], mjBizAppsSalesDealStageEvent_.prototype, "AmountAtTransition", void 0);
 __decorate([
-    Field(() => Boolean, { nullable: true, description: "Whether AmountAtTransition came from the orders engine (1) or was stated by a person (0). NULL means the transition was recorded before this was tracked — it is not backfillable, because Deal.AmountIsComputed describes the deal as it is now, not as it was at the close." }),
+    Field(() => Boolean, { nullable: true, description: "On when the amount at this stage change was the order total, off when it was entered by hand. Empty for changes recorded before this was tracked." }),
     __metadata("design:type", Boolean)
 ], mjBizAppsSalesDealStageEvent_.prototype, "AmountAtTransitionIsComputed", void 0);
 __decorate([
@@ -1821,7 +1821,7 @@ __decorate([
     __metadata("design:type", Array)
 ], mjBizAppsSalesDealStageEvent_.prototype, "ReadableFields___", void 0);
 mjBizAppsSalesDealStageEvent_ = __decorate([
-    ObjectType({ description: "APPEND-ONLY transition log, never edited. The source for stage conversion, velocity, dwell time, slippage and skipped-stage analysis. Stamping the amount and probability AT each transition is what lets historical roll-ups reconstruct correctly after a deal's amount changes." })
+    ObjectType({ description: "A record of a deal moving from one stage to another, with the amount and probability at that moment. These rows are never edited." })
 ], mjBizAppsSalesDealStageEvent_);
 export { mjBizAppsSalesDealStageEvent_ };
 //****************************************************************************
@@ -2013,7 +2013,7 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesDealStatusType_.prototype, "ID", void 0);
 __decorate([
-    Field({ nullable: true, description: "Stable identifier the engine and metadata seeds key on. Renaming Name is cosmetic; renaming Code changes an identifier." }),
+    Field({ nullable: true, description: "Short fixed identifier for the status. Renaming the status is safe; changing its code is not." }),
     MaxLength(40),
     __metadata("design:type", String)
 ], mjBizAppsSalesDealStatusType_.prototype, "Code", void 0);
@@ -2043,7 +2043,7 @@ __decorate([
     __metadata("design:type", Boolean)
 ], mjBizAppsSalesDealStatusType_.prototype, "IsLost", void 0);
 __decorate([
-    Field(() => Boolean, { nullable: true, description: "When 1, a deal in this status FREEZES: the header (except Description and NextStep), its lines and its team members become immutable, enforced in DealEntityServer.Save() — not in the UI, so an Action, an agent or a raw BaseEntity.Save() hits the same wall. Mirrors journal-entry immutability in accounting, and for the same reason: the deal is now the provenance of a contract and an order." }),
+    Field(() => Boolean, { nullable: true, description: "When on, a deal in this status is locked until it is reopened: its lines, payment schedule, team and every field except Description and Next Step become read-only." }),
     __metadata("design:type", Boolean)
 ], mjBizAppsSalesDealStatusType_.prototype, "LocksDeal", void 0);
 __decorate([
@@ -2067,7 +2067,7 @@ __decorate([
     __metadata("design:type", Array)
 ], mjBizAppsSalesDealStatusType_.prototype, "ReadableFields___", void 0);
 mjBizAppsSalesDealStatusType_ = __decorate([
-    ObjectType({ description: "The OUTCOME vocabulary for deals (Open, Won, Lost, Abandoned, On Hold ...). Behaviour comes from the flags on this row, NEVER from the Name — Sales.CloseDeal is named for the outcome type rather than a hardcoded \"won\" precisely so it can resolve everything from IsWon/IsLost/LocksDeal. Renaming a status is a metadata change with no code impact." })
+    ObjectType({ description: "The outcomes a deal can be in, such as Open, Won, Lost or On Hold. The flags on each status decide how a deal in it behaves." })
 ], mjBizAppsSalesDealStatusType_);
 export { mjBizAppsSalesDealStatusType_ };
 //****************************************************************************
@@ -2345,12 +2345,12 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesDealTeamMember_.prototype, "DealID", void 0);
 __decorate([
-    Field({ nullable: true, description: "The internal rep, as an MJ Employee. Exactly one of EmployeeID / PersonID is set. Employee is the common case." }),
+    Field({ nullable: true, description: "The team member, when they are an employee. Set this or Person, not both." }),
     MaxLength(36),
     __metadata("design:type", String)
 ], mjBizAppsSalesDealTeamMember_.prototype, "EmployeeID", void 0);
 __decorate([
-    Field({ nullable: true, description: "A NON-EMPLOYEE team member — a partner rep or contractor — as a common.Person. Exactly one of EmployeeID / PersonID is set (D-6). Needed because Partner Manager is a seeded DealRole and an Employee row cannot express someone outside the company." }),
+    Field({ nullable: true, description: "The team member, when they are not an employee, such as a partner rep. Set this or Employee, not both." }),
     MaxLength(36),
     __metadata("design:type", String)
 ], mjBizAppsSalesDealTeamMember_.prototype, "PersonID", void 0);
@@ -2412,7 +2412,7 @@ __decorate([
     __metadata("design:type", Array)
 ], mjBizAppsSalesDealTeamMember_.prototype, "ReadableFields___", void 0);
 mjBizAppsSalesDealTeamMember_ = __decorate([
-    ObjectType({ description: "The internal people on a deal and the role each holds — the SINGLE SOURCE OF TRUTH for deal membership, INCLUDING the owner (the member whose DealRole has IsOwnerRole = 1). WATCH THE ATTRIBUTION DOUBLE-COUNT: a deal with an AE, an SE and an SDR has three rows, so summing Deal.Amount across this table triple-counts the deal. Every by-rep rollup must either filter to the owner role or weight by AttributionPct." })
+    ObjectType({ description: "The internal people on a deal and the role each holds, including the owner. Totals by rep must count only the owner role or weight by attribution, or a deal is counted once per member." })
 ], mjBizAppsSalesDealTeamMember_);
 export { mjBizAppsSalesDealTeamMember_ };
 //****************************************************************************
@@ -3026,26 +3026,26 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesDeal_.prototype, "PrimaryContactID", void 0);
 __decorate([
-    Field({ nullable: true, description: "The contact who receives the invoice, which is routinely NOT the person negotiating. NULL means the billing contact IS the primary contact — a real default, not \"unknown\" — so an AD never types the same name twice and changing the primary contact leaves no stale billing copy." }),
+    Field({ nullable: true, description: "The contact who receives the invoice. Leave empty to use the primary contact." }),
     MaxLength(36),
     __metadata("design:type", String)
 ], mjBizAppsSalesDeal_.prototype, "BillingContactID", void 0);
 __decorate([
-    Field({ nullable: true, description: "The SELLING company. Must match Pipeline.CompanyID; enforced by the entity server, since a CHECK cannot reach across the FK to compare them. FK to __mj.Company." }),
+    Field({ nullable: true, description: "The company selling the deal. It must match the pipeline's company." }),
     MaxLength(36),
     __metadata("design:type", String)
 ], mjBizAppsSalesDeal_.prototype, "CompanyID", void 0);
 __decorate([
-    Field({ nullable: true, description: "DENORMALIZED, SERVER-MAINTAINED. The Employee holding the role where DealRole.IsOwnerRole = 1, written by DealEntityServer.Save() whenever team membership changes. DealTeamMember is the source of truth; this exists so \"my deals\" and per-rep boards need no join. NEVER SET THIS DIRECTLY — it will diverge." }),
+    Field({ nullable: true, description: "The deal owner: the team member in the owner role. Updated automatically from the deal team." }),
     MaxLength(36),
     __metadata("design:type", String)
 ], mjBizAppsSalesDeal_.prototype, "OwnerEmployeeID", void 0);
 __decorate([
-    Field(() => Float, { nullable: true, description: "The deal value. A CACHED ANSWER returned by Orders.PreviewOrder for this deal's line set — NOT computed here. For a simple (header-only) deal it is hand-entered and AmountIsComputed is 0. Never sum the order's lines into this column; sales does no arithmetic." }),
+    Field(() => Float, { nullable: true, description: "The deal value. For a deal with product lines it is the order total calculated by Orders; for a deal without lines it is entered by hand." }),
     __metadata("design:type", Number)
 ], mjBizAppsSalesDeal_.prototype, "Amount", void 0);
 __decorate([
-    Field(() => Boolean, { nullable: true, description: "1 when Amount came from Orders.PreviewOrder; 0 when a human typed it (a simple, header-only deal). Distinguishes a traceable figure from a stated one." }),
+    Field(() => Boolean, { nullable: true, description: "On when Amount is the order total calculated by Orders; off when it was entered by hand." }),
     __metadata("design:type", Boolean)
 ], mjBizAppsSalesDeal_.prototype, "AmountIsComputed", void 0);
 __decorate([
@@ -3053,7 +3053,7 @@ __decorate([
     __metadata("design:type", Date)
 ], mjBizAppsSalesDeal_.prototype, "AmountComputedAt", void 0);
 __decorate([
-    Field({ nullable: true, description: "Fingerprint of the embedded order's line set Amount was computed from. Compare it against the current lines to detect a STALE amount, so the UI can say the products changed after the amount was calculated, instead of showing a number nobody can trace. Without this column Amount becomes a hand-edited field within a month." }),
+    Field({ nullable: true, description: "Fingerprint of the order lines the amount was calculated from, used to tell when the amount is out of date." }),
     MaxLength(128),
     __metadata("design:type", String)
 ], mjBizAppsSalesDeal_.prototype, "AmountSourceHash", void 0);
@@ -3075,15 +3075,15 @@ __decorate([
     __metadata("design:type", Number)
 ], mjBizAppsSalesDeal_.prototype, "TermMonths", void 0);
 __decorate([
-    Field(() => Int, { nullable: true, description: "Estimated project timeline in WEEKS, from the SOW template. A separate column from TermMonths on purpose: a subscription term is a COMMITMENT that drives renewal dates and escalation, a project estimate is a FORECAST that drives neither. One column plus a unit flag would force every consumer to branch on the unit before using the number." }),
+    Field(() => Int, { nullable: true, description: "Estimated project length in weeks, from the statement of work. It does not affect the term or renewal dates." }),
     __metadata("design:type", Number)
 ], mjBizAppsSalesDeal_.prototype, "EstimatedProjectWeeks", void 0);
 __decorate([
-    Field({ nullable: true, description: "The date the agreement was signed. Deliberately NOT constrained against StartDate: work that begins before signature is common and legitimate, so ordering the two would reject real deals." }),
+    Field({ nullable: true, description: "The date the agreement was signed. It can be after the start date when work begins before signature." }),
     __metadata("design:type", Date)
 ], mjBizAppsSalesDeal_.prototype, "ExecutionDate", void 0);
 __decorate([
-    Field({ nullable: true, description: "The date service or the subscription actually begins (order-form / SOW start). May precede ExecutionDate for backdated work — see that column." }),
+    Field({ nullable: true, description: "The date the service or subscription begins. It can be before the execution date." }),
     __metadata("design:type", Date)
 ], mjBizAppsSalesDeal_.prototype, "StartDate", void 0);
 __decorate([
@@ -3123,12 +3123,12 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesDeal_.prototype, "CampaignID", void 0);
 __decorate([
-    Field({ nullable: true, description: "SOFT reference (no FK) to a bizapps-contracts Contract. The link points DOWN the dependency graph; there is deliberately no Contract.DealID, because it is ONE contract to MANY deals — the original sale, every renewal, every expansion." }),
+    Field({ nullable: true, description: "The contract this deal belongs to, in BizApps Contracts." }),
     MaxLength(36),
     __metadata("design:type", String)
 ], mjBizAppsSalesDeal_.prototype, "ContractID", void 0);
 __decorate([
-    Field({ nullable: true, description: "SOFT reference (no FK) to the contract this deal RENEWS. What makes the renewal chain navigable from the sales side without contracts knowing anything about it. Required when DealType.RequiresRenewalSource is set." }),
+    Field({ nullable: true, description: "The contract this deal renews. Required for deal types that are renewals." }),
     MaxLength(36),
     __metadata("design:type", String)
 ], mjBizAppsSalesDeal_.prototype, "RenewsContractID", void 0);
@@ -3137,24 +3137,24 @@ __decorate([
     __metadata("design:type", Boolean)
 ], mjBizAppsSalesDeal_.prototype, "AutoRenew", void 0);
 __decorate([
-    Field(() => Float, { nullable: true, description: "An OVERRIDE, and NULL is meaningful: it means \"use the standard annual increase\", whose default (5%) lives on the contracts ContractType, not here. That is a different fact from \"we negotiated a number that happens to equal today's standard\", and only the NULL survives a later change to policy. Copying the default in at write time would freeze this year's terms into next year's renewals silently." }),
+    Field(() => Float, { nullable: true, description: "Annual price increase agreed for this deal, as a percent. Leave empty to use the contract type's standard increase." }),
     __metadata("design:type", Number)
 ], mjBizAppsSalesDeal_.prototype, "AnnualIncreasePctOverride", void 0);
 __decorate([
-    Field(() => Int, { nullable: true, description: "An OVERRIDE of the standard cancellation-notice period (default 90 days, owned by the contracts ContractType). NULL means \"use the standard\" — see AnnualIncreasePctOverride for why that distinction is load-bearing." }),
+    Field(() => Int, { nullable: true, description: "Cancellation notice period agreed for this deal, in days. Leave empty to use the contract type's standard notice period." }),
     __metadata("design:type", Number)
 ], mjBizAppsSalesDeal_.prototype, "CancellationNoticeDaysOverride", void 0);
 __decorate([
-    Field({ nullable: true, description: "PLACEHOLDER LABEL (default ACH), and a string only for as long as nothing branches on it. Payment method becomes vocabulary the moment code cares — ACH and card differ in settlement timing and fees — but ORDERS owns that concept and will expose PaymentType. Pointing at orders' vocabulary later beats standing up a competing copy here and reconciling two. No code may branch on this value." }),
+    Field({ nullable: true, description: "How the customer expects to pay, for example ACH. For reference only." }),
     MaxLength(50),
     __metadata("design:type", String)
 ], mjBizAppsSalesDeal_.prototype, "PaymentMethod", void 0);
 __decorate([
-    Field(() => Boolean, { nullable: true, description: "Did this deal move off the standard agreement? Asserted by the rep at deal creation, defaulting to no. Copied onto the contract as HasModifications at Closed Won, where it routes finance's review: a true flag means capture each deviation, a false one still means read the document because the rep may have forgotten. NOT derived from ContractVariances — an empty variances field means nothing was written down, which is a different claim from nothing being negotiated." }),
+    Field(() => Boolean, { nullable: true, description: "Whether the deal moved off the standard agreement. Copied to the contract when the deal is won, where it tells finance to review the changes." }),
     __metadata("design:type", Boolean)
 ], mjBizAppsSalesDeal_.prototype, "StandardAgreementModified", void 0);
 __decorate([
-    Field({ nullable: true, description: "Free-text summary of what this deal negotiated AWAY from standard terms — the red-line list, in the AD's own words. The input to a human legal review; nothing should attempt to parse it." }),
+    Field({ nullable: true, description: "Summary of the terms negotiated away from the standard agreement, for legal review." }),
     __metadata("design:type", String)
 ], mjBizAppsSalesDeal_.prototype, "ContractVariances", void 0);
 __decorate([
@@ -3312,7 +3312,7 @@ __decorate([
     __metadata("design:type", Array)
 ], mjBizAppsSalesDeal_.prototype, "ReadableFields___", void 0);
 mjBizAppsSalesDeal_ = __decorate([
-    ObjectType({ description: "A deal (opportunity). Amount is a CACHED answer from Orders.PreviewOrder carrying its own provenance, never a locally computed total — this app performs no pricing arithmetic of any kind. Closing a deal is a transaction that CREATES a contract and/or orders, not a notification that someone should." })
+    ObjectType({ description: "A sales opportunity with an account. Its amount comes from the deal's order, and winning it follows the pipeline's close-won policy." })
 ], mjBizAppsSalesDeal_);
 export { mjBizAppsSalesDeal_ };
 //****************************************************************************
@@ -3927,7 +3927,7 @@ __decorate([
     __metadata("design:type", Array)
 ], mjBizAppsSalesForecastCategoryType_.prototype, "ReadableFields___", void 0);
 mjBizAppsSalesForecastCategoryType_ = __decorate([
-    ObjectType({ description: "How a deal rolls into the forecast (Omitted, Pipeline, Best Case, Commit, Closed). The Include* flags are read directly by the forecast measures; a query that compared a category NAME would be exactly the violation the CI grep exists to catch." })
+    ObjectType({ description: "How a deal counts in the forecast: Omitted, Pipeline, Best Case, Commit or Closed. The Include flags on each category decide which forecast totals it adds to." })
 ], mjBizAppsSalesForecastCategoryType_);
 export { mjBizAppsSalesForecastCategoryType_ };
 //****************************************************************************
@@ -4211,7 +4211,7 @@ __decorate([
     __metadata("design:type", Date)
 ], mjBizAppsSalesForecastSnapshot_.prototype, "CapturedAt", void 0);
 __decorate([
-    Field(() => Float, { nullable: true, description: "Total of deals in forecast categories flagged IncludeInCommit as at CapturedAt. Named CommitAmount rather than the plan's Commit because COMMIT is a reserved word in both T-SQL and PostgreSQL, and production is PostgreSQL." }),
+    Field(() => Float, { nullable: true, description: "Total of deals in commit forecast categories when the snapshot was taken." }),
     __metadata("design:type", Number)
 ], mjBizAppsSalesForecastSnapshot_.prototype, "CommitAmount", void 0);
 __decorate([
@@ -4227,7 +4227,7 @@ __decorate([
     __metadata("design:type", Number)
 ], mjBizAppsSalesForecastSnapshot_.prototype, "ClosedAmount", void 0);
 __decorate([
-    Field({ nullable: true, description: "The full breakdown behind the four bucket totals, so a snapshot can be interrogated rather than merely displayed." }),
+    Field({ nullable: true, description: "The detail behind the snapshot's totals, stored as JSON." }),
     __metadata("design:type", String)
 ], mjBizAppsSalesForecastSnapshot_.prototype, "SnapshotJSON", void 0);
 __decorate([
@@ -4258,7 +4258,7 @@ __decorate([
     __metadata("design:type", Array)
 ], mjBizAppsSalesForecastSnapshot_.prototype, "ReadableFields___", void 0);
 mjBizAppsSalesForecastSnapshot_ = __decorate([
-    ObjectType({ description: "A point-in-time capture of the forecast, written by a Scheduled Job. Snapshots matter more than the live number: \"what did we think on the first of the month\" is the question a forecast review actually asks, and it is unanswerable after the fact without them. The live figure reads Deal; the historical one reads this table." })
+    ObjectType({ description: "The forecast for a pipeline and owner as captured on a given day, so past forecasts can be compared with today's." })
 ], mjBizAppsSalesForecastSnapshot_);
 export { mjBizAppsSalesForecastSnapshot_ };
 //****************************************************************************
@@ -4888,7 +4888,7 @@ __decorate([
     __metadata("design:type", Array)
 ], mjBizAppsSalesLifecycleStageType_.prototype, "ReadableFields___", void 0);
 mjBizAppsSalesLifecycleStageType_ = __decorate([
-    ObjectType({ description: "Where a Person or Organization sits on the journey from stranger to evangelist. This table is what makes \"Lead\" a STAGE rather than an entity: a lead is a common.Person carrying a LifecycleStageTypeID, not a second identity table for humans." })
+    ObjectType({ description: "Where a person or organization is in the customer journey, from Subscriber to Customer. A lead is a contact at the Lead stage, not a separate record." })
 ], mjBizAppsSalesLifecycleStageType_);
 export { mjBizAppsSalesLifecycleStageType_ };
 //****************************************************************************
@@ -5164,7 +5164,7 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesLossReason_.prototype, "Category", void 0);
 __decorate([
-    Field(() => Boolean, { nullable: true, description: "When 1, Sales.CloseDeal refuses a close against this reason unless Deal.LossNotes is supplied." }),
+    Field(() => Boolean, { nullable: true, description: "When on, a deal closed as lost with this reason must also have loss notes." }),
     __metadata("design:type", Boolean)
 ], mjBizAppsSalesLossReason_.prototype, "RequiresNotes", void 0);
 __decorate([
@@ -5192,7 +5192,7 @@ __decorate([
     __metadata("design:type", Array)
 ], mjBizAppsSalesLossReason_.prototype, "ReadableFields___", void 0);
 mjBizAppsSalesLossReason_ = __decorate([
-    ObjectType({ description: "Why a deal was lost. Loss reason is this app's ONLY mandatory field and the friction is deliberate: loss reasons are the highest-value and most consistently-skipped data in any CRM." })
+    ObjectType({ description: "Why a deal was lost. Closing a deal as lost requires one." })
 ], mjBizAppsSalesLossReason_);
 export { mjBizAppsSalesLossReason_ };
 //****************************************************************************
@@ -5477,7 +5477,7 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesPipelineStage_.prototype, "ForecastCategoryTypeID", void 0);
 __decorate([
-    Field({ nullable: true, description: "The status a deal takes on when it ENTERS this stage. The stage names the vocabulary; the status carries the behaviour flags." }),
+    Field({ nullable: true, description: "The status a deal takes on when it enters this stage." }),
     MaxLength(36),
     __metadata("design:type", String)
 ], mjBizAppsSalesPipelineStage_.prototype, "DealStatusTypeID", void 0);
@@ -5495,7 +5495,7 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesPipelineStage_.prototype, "EntryCriteria", void 0);
 __decorate([
-    Field({ nullable: true, description: "Declarative JSON predicate evaluated SERVER-SIDE before a deal may leave this stage. A stage that cannot be exited without a signed mutual action plan is a config row, not a code branch." }),
+    Field({ nullable: true, description: "Conditions for leaving this stage, stored as JSON for reference. The app does not check them." }),
     __metadata("design:type", String)
 ], mjBizAppsSalesPipelineStage_.prototype, "ExitCriteria", void 0);
 __decorate([
@@ -5503,7 +5503,7 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesPipelineStage_.prototype, "RequiredFields", void 0);
 __decorate([
-    Field({ nullable: true, description: "\"What good looks like at this stage\", shown in the deal workspace. Sales enablement as a config field." }),
+    Field({ nullable: true, description: "Guidance for reps on what a deal should have at this stage, in Markdown." }),
     __metadata("design:type", String)
 ], mjBizAppsSalesPipelineStage_.prototype, "GuidanceMarkdown", void 0);
 __decorate([
@@ -5538,7 +5538,7 @@ __decorate([
     __metadata("design:type", Array)
 ], mjBizAppsSalesPipelineStage_.prototype, "ReadableFields___", void 0);
 mjBizAppsSalesPipelineStage_ = __decorate([
-    ObjectType({ description: "An ordered stage within a pipeline. Stages carry NO IsWon/IsClosed of their own — they point at a DealStatusType that does. That indirection is what makes \"Closed Won\" a label rather than a behaviour, and lets a pipeline call its winning stage Signed, Booked or Enrolled with no code aware of the difference." })
+    ObjectType({ description: "An ordered stage within a pipeline. Each stage sets the status a deal takes on when it enters the stage." })
 ], mjBizAppsSalesPipelineStage_);
 export { mjBizAppsSalesPipelineStage_ };
 //****************************************************************************
@@ -5843,7 +5843,7 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesPipeline_.prototype, "ID", void 0);
 __decorate([
-    Field({ nullable: true, description: "The owning company. NOT NULL by design — this is what makes every forecast and bookings rollup sliceable by company for free, and every deal inherits it. FK to __mj.Company." }),
+    Field({ nullable: true, description: "The company that owns this pipeline. Every deal in the pipeline belongs to this company." }),
     MaxLength(36),
     __metadata("design:type", String)
 ], mjBizAppsSalesPipeline_.prototype, "CompanyID", void 0);
@@ -5853,7 +5853,7 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesPipeline_.prototype, "Name", void 0);
 __decorate([
-    Field({ nullable: true, description: "Stable identifier, unique PER COMPANY rather than globally: two operating companies may each run a pipeline they both call NEWBIZ." }),
+    Field({ nullable: true, description: "Short identifier for the pipeline, unique within its company." }),
     MaxLength(40),
     __metadata("design:type", String)
 ], mjBizAppsSalesPipeline_.prototype, "Code", void 0);
@@ -5872,11 +5872,11 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesPipeline_.prototype, "DefaultForecastCategoryTypeID", void 0);
 __decorate([
-    Field(() => Boolean, { nullable: true, description: "Pipeline-level default for whether deals carry catalog lines (priced mode) or are header-only with a hand-entered Amount (simple mode). Overridable per deal. Partner-referral and sponsorship pipelines may never carry lines." }),
+    Field(() => Boolean, { nullable: true, description: "Whether deals in this pipeline carry product lines priced by Orders, or a single amount entered by hand." }),
     __metadata("design:type", Boolean)
 ], mjBizAppsSalesPipeline_.prototype, "RequiresDealLines", void 0);
 __decorate([
-    Field({ nullable: true, description: "JSON declaring the DEFAULT outcome of winning a deal in this pipeline: whether to create a contract, which contract type, where subscription lines go, where one-time lines go, and what state the resulting order lands in. A deal may override it; one remote operation (Sales.CloseDeal) reads and executes it. JSON rather than columns because the policy shape is still being learned." }),
+    Field({ nullable: true, description: "What happens when a deal in this pipeline is won, stored as JSON: whether a contract is created and of which type, and which follow-up tasks are raised." }),
     __metadata("design:type", String)
 ], mjBizAppsSalesPipeline_.prototype, "CloseWonPolicy", void 0);
 __decorate([
@@ -6207,7 +6207,7 @@ export { mjBizAppsSalesPipelineResolver };
 let mjBizAppsSalesSalesAccount_ = class mjBizAppsSalesSalesAccount_ {
 };
 __decorate([
-    Field({ description: "Same value as the parent __mj_BizAppsCommon.Organization.ID. The primary key IS the foreign key; this is not a separate surrogate identity." }),
+    Field({ description: "The account's ID, the same as its organization's ID." }),
     MaxLength(36),
     __metadata("design:type", String)
 ], mjBizAppsSalesSalesAccount_.prototype, "ID", void 0);
@@ -6232,7 +6232,7 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesSalesAccount_.prototype, "LeadSourceTypeID", void 0);
 __decorate([
-    Field({ nullable: true, description: "A LABEL, not a routing engine. Territory assignment as a rules engine is a product in its own right and is on the not-doing list." }),
+    Field({ nullable: true, description: "Sales territory label for the account. It is not used to route or assign accounts." }),
     MaxLength(100),
     __metadata("design:type", String)
 ], mjBizAppsSalesSalesAccount_.prototype, "Territory", void 0);
@@ -6251,12 +6251,12 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesSalesAccount_.prototype, "IndustryCode", void 0);
 __decorate([
-    Field({ nullable: true, description: "A BAND, not a number, for the same reason as AnnualRevenueBand." }),
+    Field({ nullable: true, description: "Approximate number of employees as a range, for example 50-200." }),
     MaxLength(50),
     __metadata("design:type", String)
 ], mjBizAppsSalesSalesAccount_.prototype, "EmployeeCountBand", void 0);
 __decorate([
-    Field({ nullable: true, description: "A BAND, not a number (\"$1M-$5M\"), on purpose. A rep's guess stored as an exact figure is false precision that later gets treated as fact." }),
+    Field({ nullable: true, description: "Approximate annual revenue as a range, for example $1M-$5M." }),
     MaxLength(50),
     __metadata("design:type", String)
 ], mjBizAppsSalesSalesAccount_.prototype, "AnnualRevenueBand", void 0);
@@ -6383,7 +6383,7 @@ __decorate([
     __metadata("design:type", Array)
 ], mjBizAppsSalesSalesAccount_.prototype, "ReadableFields___", void 0);
 mjBizAppsSalesSalesAccount_ = __decorate([
-    ObjectType({ description: "CRM attributes for an organization we sell to. An IsA extension of __mj_BizAppsCommon.Organization sharing its UUID — the account and the organization ARE one record, so a customer that is also a vendor and a member stays one row in the Organization graph." })
+    ObjectType({ description: "Sales details for an organization you sell to. The account and its organization are one record." })
 ], mjBizAppsSalesSalesAccount_);
 export { mjBizAppsSalesSalesAccount_ };
 //****************************************************************************
@@ -6787,7 +6787,7 @@ export { mjBizAppsSalesSalesAccountResolver };
 let mjBizAppsSalesSalesContact_ = class mjBizAppsSalesSalesContact_ {
 };
 __decorate([
-    Field({ description: "Same value as the parent __mj_BizAppsCommon.Person.ID. The primary key IS the foreign key." }),
+    Field({ description: "The contact's ID, the same as its person's ID." }),
     MaxLength(36),
     __metadata("design:type", String)
 ], mjBizAppsSalesSalesContact_.prototype, "ID", void 0);
@@ -6802,7 +6802,7 @@ __decorate([
     __metadata("design:type", String)
 ], mjBizAppsSalesSalesContact_.prototype, "LifecycleStageTypeID", void 0);
 __decorate([
-    Field({ nullable: true, description: "The contact's DEFAULT buying role. The role that matters per-deal lives on DealContactRole, because one contact holds different roles on different deals." }),
+    Field({ nullable: true, description: "The contact's usual buying role. The role on a particular deal is set in that deal's buying team." }),
     MaxLength(36),
     __metadata("design:type", String)
 ], mjBizAppsSalesSalesContact_.prototype, "BuyingRoleTypeID", void 0);
@@ -6944,7 +6944,7 @@ __decorate([
     __metadata("design:type", Array)
 ], mjBizAppsSalesSalesContact_.prototype, "ReadableFields___", void 0);
 mjBizAppsSalesSalesContact_ = __decorate([
-    ObjectType({ description: "CRM attributes for a person we sell to. An IsA extension of __mj_BizAppsCommon.Person sharing its UUID. There is deliberately no Lead entity — a lead is a Person at a lifecycle stage." })
+    ObjectType({ description: "Sales details for a person you sell to. The contact and its person are one record." })
 ], mjBizAppsSalesSalesContact_);
 export { mjBizAppsSalesSalesContact_ };
 //****************************************************************************