Contract Schema

Auto-renewal extension length in days (day-precise, replaces extensionMonths)

deprecated — migrated to extensionDays; kept for backward compatibility

Reference frame for cancellation period (weclapp: cancellationPeriodSoftframe)

Legacy coverage type — kept for backwards-compat. New code reads `coverageMode` (see below).

Defines what counts as a contract-covered service. ALL_WITH_EXCLUSIONS: all services except the excluded* lists. ONLY_SPECIFIC: only the included* lists. ONLY_EXPLICIT_ASSIGNMENTS: only matches via explicit assignments[]. Falls back to coverageType mapping when unset.

Subject of the assignment. ASSET = concrete asset; ASSET_TYPE = curated asset-type bucket (see `assetTypeKey`); PARTY = concrete customer employee; ALL_ASSETS = default coverage for any asset under the contract; ALL_PARTIES = default coverage for any customer employee; LOCATION = matches when `asset.locationId === assignment.locationId` (ADR 0151 Phase B). SERVICE_TYPE is legacy.

Curated asset-type bucket key for `assignmentType: ASSET_TYPE`. Each key maps to a set of asset.schema discriminator patterns (see `asset-type-keys.ts`).

Reference to a Location entity. Required when `assignmentType === "LOCATION"` (ADR 0151 Phase B); the resolver matches assets whose `asset.locationId` equals this value at Specificity 2.5 (between ASSET_TYPE and SERVICE_TYPE).

Optional link to a contract.items[].id — when set, billing is driven by the position and the assignment-level monthlyPrice/discountPercent are ignored by the UI.

Convenience field: when set, the save-helper synthesises a `targetsOverride.stages[]` entry with `kind=time_to_first_response` and this duration. Read back from the same stage.

Convenience field: when set, the save-helper synthesises a `targetsOverride.stages[]` entry with `kind=time_to_close` and this duration. Read back from the same stage.

Lower clamp for a datasource-resolved quantity (ADR 0357). Ignored for static quantities.

Upper clamp for a datasource-resolved quantity (ADR 0357).

Next billing date for this specific item

Last time this item was billed

Group ID for splitting items across multiple invoices

Optional link to a Codemeta catalog article

When true, this item is a sales bill of material with sub-items

BOM pricing: when true, unitPrice mirrors the sum of subItems; else own price

Dynamic quantity source — resolved at billing time

How surcharges combine when several apply to the same minute (ADR 0431). ADDITIVE (default) sums them (1 + Σ pct/100) — the long-standing behaviour; MAX lets the single highest surcharge win (collective-agreement practice). Unset = fall back to service_type.billing.surchargeStackingMode, then ADDITIVE.

Per-service-type rate schedule (overrides service-type.billing.pricing). Multiple entries per serviceTypeId are allowed: each may carry a validFrom date; an entry without validFrom is the baseline. For a given booking date the effective entry is the one with the latest validFrom <= date. To change a rate, ADD a new entry (do not overwrite an existing one) so historical bookings keep their old rate.

Arrival/departure travel costs: per-km rate, flat per-trip fee, vehicle base fee.

Overtime / evening / weekend / holiday surcharges applied multiplicatively to the service rate when the time-of-day + day-of-week (+ optional service-type / holiday) match.

Per-service-type rounding overrides. Unset fields fall back to service-type.billing.{roundingMinutes,roundingMode,minimumMinutes,billingUnitMinutes}.

Optional Tiptap-rendered HTML with mention spans (`<span data-mention-id data-mention-type>...</span>`). Falls back to `text` when not set.

Structured sidecar: every @-user or #-ticket mention extracted from `textHtml` at save time. Server-side resolvers can pick this up without parsing HTML.

Manually overridden own unit price (may be negative, e.g. discount positions). Replaces the weclapp article price as billing basis; unchangedUnitPrice keeps the fetched article price as revert target.

ISO-8601 billing period for this position (P1Y = yearly, P1M = monthly)

Activation UUID (stable key, used in generated tickets’ sourceRef).

The contract_ticket_rule this activation executes.

items[].id or licensePositions[].uuid this activation is bound to; null = manual activation without a position.

Which position array positionId refers to — the two stay separate models (ADR 0357). null when positionId is null.

First due date, chosen at activation. The UI prevents past dates; the server tolerates them (sweep creates exactly one ticket, then continues from the next future occurrence).

Cursor: next due date (initially = startDate). Advanced by the sweep.

Derived scan key: nextDueDate minus the rule’s leadDays. The sweep creates the ticket when nextCreateDate <= today.

Due date of the most recently generated ticket.

Id of the most recently generated ticket.

Paused activations are skipped by the sweep but stay documented on the contract.