Skip to content
ContractSpec
Start here

reference

Campaign compensation terms versions and preview

Draft, owner-confirmed immutable campaign compensation terms versions, their supersession lineage and a nonbinding preview.

field.key.label
docs.tech.creator.compensation-terms-versions
field.version.label
field.type.label
field.title.label
Campaign compensation terms versions and preview
field.tags.label
creator,compensation,terms
field.owners.label
field.stability.label
public

FINANCE-01i, after the creator platform donor (creator-platform-ugc @ f4cb617b) compensation-terms-server.ts, migration 0136 and bundles/compensation-preview (TK-014, TK-015).

  • compensation.terms.save (owner, admin, member): {commandId, expectedVersion, expectedRevision, terms}, only while the campaign is draft (CREATOR_CAMPAIGN_NOT_DRAFT). The head must be exactly (expectedVersion, expectedRevision), (0, 0) without a head. A draft head is revised in place (revision + 1); no head or a confirmed head opens version + 1 at revision 1. At most one draft per campaign; confirmed versions never change.
  • compensation.terms.confirm (organization owner only): {commandId, version, revision, fingerprint, confirmation: 'confirm_exact_terms'}. The stored draft is re-validated and its fingerprint recomputed before it becomes binding. Returns the accepted-terms block. Confirming version N after a confirmed version M writes one immutable compensationTermsSupersession (M -> N; a target addition, the donor relies on history only).
  • Save and confirm replay per (actor, commandId) after authority is rechecked; another payload or kind conflicts.
  • compensation.terms.view: editors get {current, confirmed, history (latest 20), historyLimit: 20}; a creator gets only the published summary of the current confirmed version.
  • Status is chosen confirmed-first then by version: a pending newer draft keeps the latest confirmed version offerable. agreement.accept v2 binds exactly that version; superseded, unconfirmed and not adopted refuse.
  • compensation.terms.preview runs the real calculator on one synthetic publication and returns illustrative: true, payable: false. It persists nothing. Valid or confirmed terms authorize no payment.