ProjectHelm
Home / Documentation / Workflow Stages & Approvals
Data Modeling

Workflow Stages & Approvals

State machine transitions, action buttons, required comments, approval permissions, and audit logs.

Updated September 2026 • 5 min read • .NET 10 & C#

Stages & State Badges

Give any entity a state machine lifecycle (e.g. Draft → UnderReview → Approved → Archived). Each stage carries an optional badge color and display label.

Transition Action Buttons

Buttons appear conditionally on records when they reside in the matching fromStageName. Transitions support:

  • Permission Guards: Restrict button visibility to users holding a specific role or permission (requiredPermission).
  • Condition Expressions: Ensure mandatory fields are populated before advancing stages.
  • Required Comments: Prompts the user for an approval or rejection reason.
  • Automated Notifications: Dispatches emails to specific roles or triggers external webhooks.