Skip to content

feat: milestone-linked partial collateral release as milestones complete #475

Description

@shakurJJ

Summary

Supplier collateral is locked in full at shipment creation and only ever released at cancellation/completion. This proposes releasing collateral incrementally as milestones confirm, proportional to shipment completion.

Proposed Behaviour

  • When a milestone confirms, release a proportional share of the locked collateral back to the supplier based on that milestone's percentage of the shipment.
  • Any remaining collateral is released (or forfeited per existing dispute-resolution rules) at final completion/cancellation, unchanged from today.
  • Opt-in via a shipment-level flag so existing shipments and integrations are unaffected by default.

Acceptance Criteria

  • Collateral release is proportional to confirmed milestone percentage when the flag is enabled
  • Default (flag disabled) behaviour is unchanged from today
  • Disputed milestones do not trigger early collateral release
  • Tests cover partial release across multiple milestones and the disabled-flag path

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions