Revisions

A revision is a numbered snapshot of a proposal — its periods, inventory selection, prices, and discounts. Every proposal has at least one revision; the most recent revision is the one the user works with.

Creating a revision

A new revision can only be created when the current revision is in the Booked state. This enforces a strict lifecycle: propose, negotiate, book, then revise.

When a new revision is created:

  • All periods, inventory items, and prices are deep-copied from the booked revision into the new one.

  • The new revision receives the next sequential revision number.

  • The new revision starts in the Draft state.

  • The proposal now opens on the new revision.

The user then edits and advances the new revision through the same state transitions as any proposal — Draft, Pending Approval, Reserved, Booked.

See proposals for the state machine and allowed transitions.

Viewing historical revisions

All previous revisions remain available read-only from the Revisions tab. Selecting a historical revision displays its periods, items, and prices as they were when that revision was current.

To compare two revisions, open each one in its own browser tab.

Deleting a revision

Two constraints govern deletion:

  • A revision in the Booked state cannot be deleted.

  • The proposal’s only revision cannot be deleted — a proposal must always have at least one revision.

When the most recent revision is deleted, the proposal opens on the revision before it.

Revision and proposal state

The proposal state lives on the current revision. When a new revision is created, the booked revision retains its Booked state and the new revision starts as Draft.

This means the proposal effectively returns to an editable state without altering the historical record of what was booked.