workflow

(require '[boundary.workflow.core.machine :refer [defworkflow]])

(defworkflow order-workflow
  {:id             :order-workflow
   :initial-state  :pending
   :description    "E-commerce order lifecycle"
   :states         #{:pending :paid :shipped :delivered :cancelled}
   :state-config   {:pending   {:label "Awaiting Payment"}
                    :paid      {:label "Payment Received"}
                    :shipped   {:label "In Transit"}
                    :delivered {:label "Delivered"}
                    :cancelled {:label "Cancelled"}}
   :hooks          {:on-enter-paid    (fn [instance] (notify-finance! instance))
                    :on-any-transition (fn [instance] (sync-external! instance))}
   :transitions    [{:from :pending :to :paid
                     :label "Mark as Paid"
                     :required-permissions [:finance :admin]}
                    {:from :paid    :to :shipped
                     :guard :payment-confirmed}
                    {:from :shipped :to :delivered
                     :label "Confirm Delivery"}
                    {:from :pending :to :cancelled
                     :auto?        true
                     :side-effects [:notify-cancellation]}]})

POST /api/workflows/:type/start    # Start a workflow instance
POST /api/workflows/:id/transition # Perform a state transition
GET  /api/workflows/:id/state      # Get current state
GET  /api/workflows/:id/audit      # Get audit trail

(require '[boundary.workflow.core.transitions :as transitions])

;; Returns all transitions with :enabled? flag
(transitions/available-transitions-with-status order-workflow :paid user-permissions)
;=> [{:from :paid :to :shipped :label "Ship Order" :enabled? true}
;    {:from :paid :to :cancelled :label "Cancel" :enabled? false :reason "Missing permission"}]

clojure -M:test:db/h2 :workflow