approval

type ActionLog struct {
	orm.BaseModel `bun:"table:apv_action_log,alias:aal"`
	orm.Model
	orm.CreationTrackedModel

	InstanceID               string           `json:"instanceId" bun:"instance_id"`
	NodeID                   *string          `json:"nodeId" bun:"node_id,nullzero"`
	TaskID                   *string          `json:"taskId" bun:"task_id,nullzero"`
	Action                   ActionType       `json:"action" bun:"action"`
	OperatorID               string           `json:"operatorId" bun:"operator_id"`
	OperatorName             string           `json:"operatorName" bun:"operator_name"`
	OperatorDepartmentID     *string          `json:"operatorDepartmentId" bun:"operator_department_id,nullzero"`
	OperatorDepartmentName   *string          `json:"operatorDepartmentName" bun:"operator_department_name,nullzero"`
	IPAddress                *string          `json:"ipAddress" bun:"ip_address,nullzero"`
	UserAgent                *string          `json:"userAgent" bun:"user_agent,nullzero"`
	Opinion                  *string          `json:"opinion" bun:"opinion,nullzero"`
	TransferToID             *string          `json:"transferToId" bun:"transfer_to_id,nullzero"`
	TransferToName           *string          `json:"transferToName" bun:"transfer_to_name,nullzero"`
	TransferToDepartmentID   *string          `json:"transferToDepartmentId" bun:"transfer_to_department_id,nullzero"`
	TransferToDepartmentName *string          `json:"transferToDepartmentName" bun:"transfer_to_department_name,nullzero"`
	RollbackToNodeID         *string          `json:"rollbackToNodeId" bun:"rollback_to_node_id,nullzero"`
	AddAssigneeType          *AddAssigneeType `json:"addAssigneeType" bun:"add_assignee_type,nullzero"`
	AddedAssignees           []UserInfo       `json:"addedAssignees" bun:"added_assignees,type:jsonb"`
	RemovedAssignees         []UserInfo       `json:"removedAssignees" bun:"removed_assignees,type:jsonb"`
	CCUsers                  []UserInfo       `json:"ccUsers" bun:"cc_users,type:jsonb"`
	Attachments              []string         `json:"attachments" bun:"attachments,type:jsonb,nullzero"`
	Meta                     map[string]any   `json:"meta" bun:"meta,type:jsonb,nullzero"`
}

type ActionType string

type Activity struct {
	Action             string         `json:"action"`
	Operator           UserInfo       `json:"operator"`
	Opinion            *string        `json:"opinion,omitempty"`
	Attachments        []string       `json:"attachments,omitempty"`
	TransferTo         *UserInfo      `json:"transferTo,omitempty"`
	Target             *UserInfo      `json:"target,omitempty"`
	RollbackToNodeID   *string        `json:"rollbackToNodeId,omitempty"`
	RollbackToNodeName *string        `json:"rollbackToNodeName,omitempty"`
	AddedAssignees     []UserInfo     `json:"addedAssignees,omitempty"`
	RemovedAssignees   []UserInfo     `json:"removedAssignees,omitempty"`
	CCUsers            []UserInfo     `json:"ccUsers,omitempty"`
	CreatedAt          timex.DateTime `json:"createdAt"`
}

type AddAssigneeType string

type AggregateKind string

type Aggregator interface {
	// Kind returns the aggregate kind this implementation folds.
	Kind() AggregateKind
	// Fold reduces the extracted column values (for column aggregates) or
	// the row count (for row aggregates such as count) into the comparison
	// operand. matchable=false means the aggregate has no defined value for
	// the input — e.g. avg over zero rows — and the condition must not
	// match, mirroring SQL NULL comparison semantics.
	Fold(values []float64, rowCount int) (result float64, matchable bool)
}

type ApprovalMethod string

type ApprovalNodeData struct {
	BaseNodeData
	TaskNodeData

	ApprovalMethod            ApprovalMethod            `json:"approvalMethod,omitempty"`
	PassRule                  PassRule                  `json:"passRule,omitempty"`
	PassRatio                 decimal.Decimal           `json:"passRatio"`
	SameApplicantAction       SameApplicantAction       `json:"sameApplicantAction,omitempty"`
	ConsecutiveApproverAction ConsecutiveApproverAction `json:"consecutiveApproverAction,omitempty"`
	RollbackType              RollbackType              `json:"rollbackType,omitempty"`
	RollbackDataStrategy      RollbackDataStrategy      `json:"rollbackDataStrategy,omitempty"`
	RollbackTargetKeys        []string                  `json:"rollbackTargetKeys,omitempty"`
	IsRollbackAllowed         *bool                     `json:"isRollbackAllowed,omitempty"`
	IsAddAssigneeAllowed      *bool                     `json:"isAddAssigneeAllowed,omitempty"`
	AddAssigneeTypes          []AddAssigneeType         `json:"addAssigneeTypes,omitempty"`
	IsRemoveAssigneeAllowed   *bool                     `json:"isRemoveAssigneeAllowed,omitempty"`
	IsManualCCAllowed         *bool                     `json:"isManualCcAllowed,omitempty"`
}

type AssigneeDefinition struct {
	Kind      AssigneeKind `json:"kind"`
	IDs       []string     `json:"ids,omitempty"`
	FormField *string      `json:"formField,omitempty"`
	SortOrder int          `json:"sortOrder"`
}

type AssigneeKind string

type AssigneeService interface {
	// GetSuperior returns the direct superior's user info for the given user.
	GetSuperior(ctx context.Context, userID string) (*UserInfo, error)
	// GetDepartmentLeaders returns the leader user info for the given department.
	GetDepartmentLeaders(ctx context.Context, departmentID string) ([]UserInfo, error)
	// GetRoleUsers returns all user info for users that have the given role.
	GetRoleUsers(ctx context.Context, roleID string) ([]UserInfo, error)
}

type AssigneesAddedEvent struct {
	TaskEventBase

	AddType   AddAssigneeType `json:"addType"`
	Assignees []UserInfo      `json:"assignees"`
}

type AssigneesRemovedEvent struct {
	TaskEventBase

	Assignees []UserInfo `json:"assignees"`
}

type BaseNodeData struct {
	Name        string  `json:"name,omitempty"`
	Description *string `json:"description,omitempty"`
}

type BindingMode string

type BindingProjectionStatus string

type BindingTrigger string

type BusinessBindingConfig struct {
	TableName    string   `json:"tableName"`
	KeyColumns   []string `json:"keyColumns"`
	StatusColumn string   `json:"statusColumn"`
	// InstanceIDColumn is mandatory for business bindings. The projector uses
	// it as a compare-and-set fence so a stale instance cannot overwrite the
	// state owned by a newer approval round.
	InstanceIDColumn *string `json:"instanceIdColumn,omitempty"`
	StartedAtColumn  *string `json:"startedAtColumn,omitempty"`
	FinishedAtColumn *string `json:"finishedAtColumn,omitempty"`
	// StatusMapping translates approval instance statuses into host business
	// status values. Missing entries fall back to the InstanceStatus string.
	StatusMapping map[InstanceStatus]string `json:"statusMapping,omitempty"`
}

type BusinessProjection struct {
	orm.BaseModel `bun:"table:apv_business_projection,alias:abp"`
	orm.FullAuditedModel

	TenantID               string                            `json:"tenantId" bun:"tenant_id"`
	FlowID                 string                            `json:"flowId" bun:"flow_id"`
	FlowVersionID          string                            `json:"flowVersionId" bun:"flow_version_id"`
	OwnerInstanceID        string                            `json:"ownerInstanceId" bun:"owner_instance_id"`
	AppliedOwnerInstanceID *string                           `json:"appliedOwnerInstanceId,omitempty" bun:"applied_owner_instance_id,nullzero"`
	TargetHash             string                            `json:"targetHash" bun:"target_hash"`
	Consistency            config.ApprovalBindingConsistency `json:"consistency" bun:"consistency"`
	Binding                *BusinessBindingConfig            `json:"binding" bun:"binding,type:jsonb"`
	RecordKey              json.RawMessage                   `json:"recordKey" bun:"record_key,type:jsonb"`
	DesiredStatus          InstanceStatus                    `json:"desiredStatus" bun:"desired_status"`
	DesiredStartedAt       timex.DateTime                    `json:"desiredStartedAt" bun:"desired_started_at"`
	DesiredFinishedAt      *timex.DateTime                   `json:"desiredFinishedAt,omitempty" bun:"desired_finished_at,nullzero"`
	DesiredRevision        int64                             `json:"desiredRevision" bun:"desired_revision"`
	AppliedRevision        int64                             `json:"appliedRevision" bun:"applied_revision"`
	Status                 BindingProjectionStatus           `json:"status" bun:"status"`
	AttemptCount           int                               `json:"attemptCount" bun:"attempt_count"`
	NextAttemptAt          *timex.DateTime                   `json:"nextAttemptAt,omitempty" bun:"next_attempt_at,nullzero"`
	LeaseUntil             *timex.DateTime                   `json:"leaseUntil,omitempty" bun:"lease_until,nullzero"`
	LastError              *string                           `json:"lastError,omitempty" bun:"last_error,nullzero"`
	AppliedAt              *timex.DateTime                   `json:"appliedAt,omitempty" bun:"applied_at,nullzero"`
}

type BusinessRecordKey map[string]any

type BusinessRefProvider interface {
	// OnInstanceCreated resolves or creates the business row bound to the
	// instance and returns its reference (see Instance.BusinessRef for the
	// shape contract). Returning an empty string indicates the host has
	// nothing to bind — e.g. the caller already supplied businessRef in the
	// start parameters. Runs inside the start_instance transaction; an
	// error rolls back instance creation.
	OnInstanceCreated(ctx context.Context, db orm.DB, flow *Flow, instance *Instance) (businessRef string, err error)
}

type BusinessRefResolver interface {
	// ResolveRecordKey extracts the configured business record key from
	// businessRef. Returning an error fails the write-back for this instance.
	ResolveRecordKey(ctx context.Context, flow *Flow, businessRef string) (BusinessRecordKey, error)
}

type CCDefinition struct {
	Kind      CCKind   `json:"kind"`
	IDs       []string `json:"ids,omitempty"`
	FormField *string  `json:"formField,omitempty"`
	Timing    CCTiming `json:"timing,omitempty"`
}

type CCKind string

type CCNodeData struct {
	BaseNodeData

	CCs                   []CCDefinition        `json:"ccs,omitempty"`
	IsReadConfirmRequired bool                  `json:"isReadConfirmRequired,omitempty"`
	FieldPermissions      map[string]Permission `json:"fieldPermissions,omitempty"`
}

type CCNotifiedEvent struct {
	InstanceEventBase

	NodeID     string     `json:"nodeId"`
	NodeName   string     `json:"nodeName"`
	Recipients []UserInfo `json:"recipients"`
	IsManual   bool       `json:"isManual"`
}

type CCRecipient struct {
	User   UserInfo        `json:"user"`
	ReadAt *timex.DateTime `json:"readAt,omitempty"`
}

type CCRecord struct {
	orm.BaseModel `bun:"table:apv_cc_record,alias:acr"`
	orm.Model
	orm.CreationTrackedModel

	InstanceID string  `json:"instanceId" bun:"instance_id"`
	NodeID     *string `json:"nodeId" bun:"node_id,nullzero"`
	// VisitID scopes the record to one node traversal: a rollback redo gets
	// its own notification and read-confirm cycle instead of being silently
	// satisfied by a prior round's records. Nil only for instance-level
	// records that are not anchored to a node.
	VisitID              *string         `json:"visitId" bun:"visit_id,nullzero"`
	TaskID               *string         `json:"taskId" bun:"task_id,nullzero"`
	CCUserID             string          `json:"ccUserId" bun:"cc_user_id"`
	CCUserName           string          `json:"ccUserName" bun:"cc_user_name"`
	CCUserDepartmentID   *string         `json:"ccUserDepartmentId" bun:"cc_user_department_id,nullzero"`
	CCUserDepartmentName *string         `json:"ccUserDepartmentName" bun:"cc_user_department_name,nullzero"`
	IsManual             bool            `json:"isManual" bun:"is_manual"`
	ReadAt               *timex.DateTime `json:"readAt" bun:"read_at,nullzero"`
}

type CCTiming string

type CallerContext struct {
	// TenantID is the caller's resolved tenant. Empty for super-admin or
	// for system-internal callers; must be non-empty for every authenticated
	// API request.
	TenantID string
	// IsSuperAdmin grants cross-tenant access regardless of TenantID.
	IsSuperAdmin bool
	// IsSystemInternal marks a caller without an HTTP / RPC principal whose
	// scope is established by other means, so Authorize passes
	// unconditionally. Resource paths must NEVER populate this. In the
	// current tree only test fixtures set it (the in-tree system paths —
	// timeout scanner, projection worker — act directly on already-loaded,
	// trusted rows and never construct a CallerContext); it remains the
	// intended marker for any host or future in-process system code that
	// legitimately needs to bypass tenant scoping.
	IsSystemInternal bool
}

type ColumnDataType string

type Condition struct {
	Kind    ConditionKind `json:"kind"`
	Subject string        `json:"subject"`
	// Aggregate, when set, evaluates the condition over a detail-table
	// field's rows instead of a scalar subject: Subject names the table
	// field, Column the numeric column to fold (sum / avg; count works on
	// rows and must leave Column empty). Structured on purpose — no string
	// DSL to parse, and the designer offers it as table → column → aggregate.
	Aggregate  AggregateKind     `json:"aggregate,omitempty"`
	Column     string            `json:"column,omitempty"`
	Operator   ConditionOperator `json:"operator"`
	Value      any               `json:"value"`
	Expression string            `json:"expression"`
}

type ConditionBranch struct {
	ID              string           `json:"id"`
	Label           string           `json:"label"`
	ConditionGroups []ConditionGroup `json:"conditionGroups,omitempty"`
	IsDefault       bool             `json:"isDefault,omitempty"`
	Priority        int              `json:"priority"`
}

type ConditionEvaluator interface {
	// Kind returns the condition kind this evaluator handles.
	Kind() ConditionKind
	// Evaluate evaluates a single condition against the given evaluation context.
	Evaluate(ctx context.Context, cond Condition, ec *EvaluationContext) (bool, error)
}

type ConditionGroup struct {
	Conditions []Condition `json:"conditions"`
}

type ConditionKind string

type ConditionNodeData struct {
	BaseNodeData

	Branches []ConditionBranch `json:"branches,omitempty"`
}

type ConditionOperator string

type ConsecutiveApproverAction string

type Delegation struct {
	orm.BaseModel `bun:"table:apv_delegation,alias:ad"`
	orm.FullAuditedModel

	DelegatorID    string         `json:"delegatorId" bun:"delegator_id"`
	DelegateeID    string         `json:"delegateeId" bun:"delegatee_id"`
	FlowCategoryID *string        `json:"flowCategoryId" bun:"flow_category_id,nullzero"`
	FlowID         *string        `json:"flowId" bun:"flow_id,nullzero"`
	StartTime      timex.DateTime `json:"startTime" bun:"start_time"`
	EndTime        timex.DateTime `json:"endTime" bun:"end_time"`
	IsActive       bool           `json:"isActive" bun:"is_active"`
	Reason         *string        `json:"reason" bun:"reason,nullzero"`
}

type DomainEvent interface {
	// EventType returns the unique event identifier (e.g., "approval.instance.created").
	EventType() string
}

type EdgeDefinition struct {
	ID           string         `json:"id"`
	Source       string         `json:"source"`
	Target       string         `json:"target"`
	SourceHandle *string        `json:"sourceHandle,omitempty"`
	Data         map[string]any `json:"data,omitempty"`
}

type EmptyAssigneeAction string

type EndNodeData struct {
	BaseNodeData
}

type EvaluationContext struct {
	FormData              FormData
	ApplicantID           string
	ApplicantDepartmentID *string
	// Globals carries host-supplied global variables snapshotted at instance
	// start (Instance.Globals). Field conditions resolve a subject against
	// Globals before form data — the same shadowing the built-in applicant
	// subjects apply — and expression conditions see each entry as a top-level
	// binding (the built-in formData / applicantId / applicantDepartmentId
	// bindings always win a name collision).
	Globals map[string]any
}

type ExecutionType string

type FieldKind string

type FieldOption struct {
	Label string `json:"label"`
	Value any    `json:"value"`
}

type Flow struct {
	orm.BaseModel `bun:"table:apv_flow,alias:af"`
	orm.FullAuditedModel

	TenantID               string                 `json:"tenantId" bun:"tenant_id"`
	CategoryID             string                 `json:"categoryId" bun:"category_id"`
	Code                   string                 `json:"code" bun:"code"`
	Name                   string                 `json:"name" bun:"name"`
	Icon                   *string                `json:"icon" bun:"icon,nullzero"`
	Description            *string                `json:"description" bun:"description,nullzero"`
	BindingMode            BindingMode            `json:"bindingMode" bun:"binding_mode"`
	BusinessBinding        *BusinessBindingConfig `json:"businessBinding,omitempty" bun:"business_binding,type:jsonb,nullzero"`
	AdminUserIDs           []string               `json:"adminUserIds" bun:"admin_user_ids,type:jsonb"`
	IsAllInitiationAllowed bool                   `json:"isAllInitiationAllowed" bun:"is_all_initiation_allowed"`
	InstanceTitleTemplate  string                 `json:"instanceTitleTemplate" bun:"instance_title_template"`
	IsActive               bool                   `json:"isActive" bun:"is_active"`
	CurrentVersion         int                    `json:"currentVersion" bun:"current_version"`
}

type FlowCategory struct {
	orm.BaseModel `bun:"table:apv_flow_category,alias:afc"`
	orm.FullAuditedModel

	TenantID  string         `json:"tenantId" bun:"tenant_id"`
	Code      string         `json:"code" bun:"code"`
	Name      string         `json:"name" bun:"name"`
	Icon      *string        `json:"icon" bun:"icon,nullzero"`
	ParentID  *string        `json:"parentId" bun:"parent_id,nullzero"`
	SortOrder int            `json:"sortOrder" bun:"sort_order"`
	IsActive  bool           `json:"isActive" bun:"is_active"`
	Remark    *string        `json:"remark" bun:"remark,nullzero"`
	Children  []FlowCategory `json:"children,omitempty" bun:"-"`
}

type FlowCreatedEvent struct {
	FlowEventBase

	CategoryID string `json:"categoryId"`
}

type FlowDefinition struct {
	Nodes []NodeDefinition `json:"nodes"`
	Edges []EdgeDefinition `json:"edges"`
}

type FlowDeployedEvent struct {
	FlowEventBase

	VersionID string `json:"versionId"`
	Version   int    `json:"version"`
}

type FlowEdge struct {
	orm.BaseModel `bun:"table:apv_flow_edge,alias:afe"`
	orm.Model

	FlowVersionID string  `json:"flowVersionId" bun:"flow_version_id"`
	Key           string  `json:"key" bun:"key,nullzero"`
	SourceNodeID  string  `json:"sourceNodeId" bun:"source_node_id"`
	SourceNodeKey string  `json:"sourceNodeKey" bun:"source_node_key"`
	TargetNodeID  string  `json:"targetNodeId" bun:"target_node_id"`
	TargetNodeKey string  `json:"targetNodeKey" bun:"target_node_key"`
	SourceHandle  *string `json:"sourceHandle" bun:"source_handle,nullzero"`
}

type FlowEventBase struct {
	FlowID       string         `json:"flowId"`
	TenantID     string         `json:"tenantId"`
	Code         string         `json:"code"`
	Name         string         `json:"name"`
	OccurredTime timex.DateTime `json:"occurredTime"`
}

type FlowGraphEdge struct {
	ID           string  `json:"id"`
	Source       string  `json:"source"`
	Target       string  `json:"target"`
	SourceHandle *string `json:"sourceHandle,omitempty"`
}

type FlowGraphNode struct {
	ID       string            `json:"id"`
	NodeID   string            `json:"nodeId"`
	Kind     NodeKind          `json:"kind"`
	Position Position          `json:"position"`
	Data     FlowGraphNodeData `json:"data"`
}

type FlowGraphNodeData struct {
	Name           string             `json:"name"`
	Status         NodeProgressStatus `json:"status"`
	ExecutionType  string             `json:"executionType,omitempty"`
	ApprovalMethod string             `json:"approvalMethod,omitempty"`
	PassRule       string             `json:"passRule,omitempty"`
	PassRatio      *decimal.Decimal   `json:"passRatio,omitempty"`
	Participants   []NodeParticipant  `json:"participants,omitempty"`
	CCRecipients   []CCRecipient      `json:"ccRecipients,omitempty"`
	Activities     []Activity         `json:"activities,omitempty"`
	StartedAt      *timex.DateTime    `json:"startedAt,omitempty"`
	FinishedAt     *timex.DateTime    `json:"finishedAt,omitempty"`
}

type FlowInitiator struct {
	orm.BaseModel `bun:"table:apv_flow_initiator,alias:afi"`
	orm.Model

	FlowID string        `json:"flowId" bun:"flow_id"`
	Kind   InitiatorKind `json:"kind" bun:"kind"`
	IDs    []string      `json:"ids" bun:"ids,type:jsonb"`
}

type FlowNode struct {
	orm.BaseModel `bun:"table:apv_flow_node,alias:afn"`
	orm.FullAuditedModel

	FlowVersionID             string                    `json:"flowVersionId" bun:"flow_version_id"`
	Key                       string                    `json:"key" bun:"key"`
	Kind                      NodeKind                  `json:"kind" bun:"kind"`
	Name                      string                    `json:"name" bun:"name"`
	Description               *string                   `json:"description" bun:"description,nullzero"`
	ExecutionType             ExecutionType             `json:"executionType" bun:"execution_type"`
	ApprovalMethod            ApprovalMethod            `json:"approvalMethod" bun:"approval_method"`
	PassRule                  PassRule                  `json:"passRule" bun:"pass_rule"`
	PassRatio                 decimal.Decimal           `json:"passRatio" bun:"pass_ratio,type:numeric(5,2)"`
	EmptyAssigneeAction       EmptyAssigneeAction       `json:"emptyAssigneeAction" bun:"empty_assignee_action"`
	FallbackUserIDs           []string                  `json:"fallbackUserIds" bun:"fallback_user_ids,type:jsonb"`
	AdminUserIDs              []string                  `json:"adminUserIds" bun:"admin_user_ids,type:jsonb"`
	SameApplicantAction       SameApplicantAction       `json:"sameApplicantAction" bun:"same_applicant_action"`
	IsRollbackAllowed         bool                      `json:"isRollbackAllowed" bun:"is_rollback_allowed"`
	RollbackType              RollbackType              `json:"rollbackType" bun:"rollback_type"`
	RollbackDataStrategy      RollbackDataStrategy      `json:"rollbackDataStrategy" bun:"rollback_data_strategy"`
	RollbackTargetKeys        []string                  `json:"rollbackTargetKeys" bun:"rollback_target_keys,type:jsonb,nullzero"`
	IsAddAssigneeAllowed      bool                      `json:"isAddAssigneeAllowed" bun:"is_add_assignee_allowed"`
	AddAssigneeTypes          []AddAssigneeType         `json:"addAssigneeTypes" bun:"add_assignee_types,type:jsonb"`
	IsRemoveAssigneeAllowed   bool                      `json:"isRemoveAssigneeAllowed" bun:"is_remove_assignee_allowed"`
	FieldPermissions          map[string]Permission     `json:"fieldPermissions" bun:"field_permissions,type:jsonb"`
	IsManualCCAllowed         bool                      `json:"isManualCcAllowed" bun:"is_manual_cc_allowed"`
	IsTransferAllowed         bool                      `json:"isTransferAllowed" bun:"is_transfer_allowed"`
	IsOpinionRequired         bool                      `json:"isOpinionRequired" bun:"is_opinion_required"`
	TimeoutHours              int                       `json:"timeoutHours" bun:"timeout_hours"`
	TimeoutAction             TimeoutAction             `json:"timeoutAction" bun:"timeout_action"`
	TimeoutNotifyBeforeHours  int                       `json:"timeoutNotifyBeforeHours" bun:"timeout_notify_before_hours"`
	UrgeCooldownMinutes       int                       `json:"urgeCooldownMinutes" bun:"urge_cooldown_minutes"`
	ConsecutiveApproverAction ConsecutiveApproverAction `json:"consecutiveApproverAction" bun:"consecutive_approver_action"`
	IsReadConfirmRequired     bool                      `json:"isReadConfirmRequired" bun:"is_read_confirm_required"`
	Branches                  []ConditionBranch         `json:"branches" bun:"branches,type:jsonb,nullzero"`
}

type FlowNodeAssignee struct {
	orm.BaseModel `bun:"table:apv_flow_node_assignee,alias:afna"`
	orm.Model

	NodeID    string       `json:"nodeId" bun:"node_id"`
	Kind      AssigneeKind `json:"kind" bun:"kind"`
	IDs       []string     `json:"ids" bun:"ids,type:jsonb"`
	FormField *string      `json:"formField" bun:"form_field,nullzero"`
	SortOrder int          `json:"sortOrder" bun:"sort_order"`
}

type FlowNodeCC struct {
	orm.BaseModel `bun:"table:apv_flow_node_cc,alias:afnc"`
	orm.Model

	NodeID    string   `json:"nodeId" bun:"node_id"`
	Kind      CCKind   `json:"kind" bun:"kind"`
	IDs       []string `json:"ids" bun:"ids,type:jsonb"`
	FormField *string  `json:"formField" bun:"form_field,nullzero"`
	Timing    CCTiming `json:"timing" bun:"timing"`
}

type FlowPublishedEvent struct {
	FlowEventBase

	VersionID string `json:"versionId"`
}

type FlowToggledEvent struct {
	FlowEventBase

	IsActive bool `json:"isActive"`
}

type FlowUpdatedEvent struct {
	FlowEventBase
}

type FlowVersion struct {
	orm.BaseModel `bun:"table:apv_flow_version,alias:afv"`
	orm.FullAuditedModel

	FlowID      string          `json:"flowId" bun:"flow_id"`
	Version     int             `json:"version" bun:"version"`
	Status      VersionStatus   `json:"status" bun:"status"`
	Description *string         `json:"description" bun:"description,nullzero"`
	StorageMode StorageMode     `json:"storageMode" bun:"storage_mode"`
	FlowSchema  *FlowDefinition `json:"flowSchema" bun:"flow_schema,type:jsonb,nullzero"`
	// FormSchema is the host-owned form designer document, stored and returned
	// as semantically equal JSON: the jsonb column normalizes formatting and
	// key order, while numeric precision is preserved end-to-end. The
	// framework never interprets it (see FormSchemaParser).
	FormSchema json.RawMessage `json:"formSchema" bun:"form_schema,type:jsonb,nullzero"`
	// FormFields is the flat field list derived from FormSchema at deploy —
	// the only form shape the framework itself consumes.
	FormFields  []FormFieldDefinition `json:"formFields" bun:"form_fields,type:jsonb,nullzero"`
	PublishedAt *timex.DateTime       `json:"publishedAt" bun:"published_at,nullzero"`
	PublishedBy *string               `json:"publishedBy" bun:"published_by,nullzero"`
	// BusinessBinding is the immutable binding snapshot captured when the
	// version is deployed. Runtime instances never read the mutable Flow copy.
	BusinessBinding *BusinessBindingConfig `json:"businessBinding,omitempty" bun:"business_binding,type:jsonb,nullzero"`
}

type FormData map[string]any

type FormFieldDefinition struct {
	// Key is the unique identifier for this field (used in form data keys).
	Key string `json:"key"`
	// Kind is the field type (e.g., "input", "textarea", "select", "number", "date", "upload", "table").
	Kind FieldKind `json:"kind"`
	// Label is the display label.
	Label string `json:"label"`
	// Placeholder is the input placeholder text.
	Placeholder string `json:"placeholder,omitempty"`
	// DefaultValue is the default value for this field.
	DefaultValue any `json:"defaultValue,omitempty"`
	// IsRequired indicates whether this field is required.
	IsRequired bool `json:"isRequired,omitempty"`
	// Options is the list of selectable options (for select, radio, checkbox, etc.).
	Options []FieldOption `json:"options,omitempty"`
	// Validation contains validation rules.
	Validation *ValidationRule `json:"validation,omitempty"`
	// Props contains additional component-specific properties.
	Props map[string]any `json:"props,omitempty"`
	// SortOrder controls the display order.
	SortOrder int `json:"sortOrder"`
	// ColumnType is the dialect-independent logical column type used when the
	// flow version's StorageMode is StorageTable. Empty falls back to a coarse
	// type derived from Kind (back-compat with schemas authored before this field).
	ColumnType ColumnDataType `json:"columnType,omitempty"`
	// Scale is the number of fractional digits for a ColumnDecimal column (the
	// DECIMAL/NUMERIC scale). Nil means an integer-shaped decimal (scale 0).
	Scale *int `json:"scale,omitempty"`
	// Columns defines the row shape of a table field (Kind == FieldTable):
	// each column is itself a field definition and reuses the same kinds and
	// validation rules, except that a column must not be another table —
	// detail tables are single-level by design. For a table field itself,
	// Validation.MinLength / MaxLength bound the ROW COUNT, and IsRequired
	// means "at least one row".
	Columns []FormFieldDefinition `json:"columns,omitempty"`
}

type FormSchemaParser interface {
	// ParseFormFields extracts the flat field definitions from the raw form
	// schema document. A nil or empty schema yields (nil, nil) — a flow
	// without a form. Errors abort the deploy.
	//
	// ctx carries the deploy request's deadline and cancellation. The built-in
	// parser is pure and ignores it, but a host parser may perform I/O (resolving
	// remote option sources, calling an external validation service) while
	// deriving fields, and must honor ctx cancellation on those paths.
	ParseFormFields(ctx context.Context, schema json.RawMessage) ([]FormFieldDefinition, error)
}

type FormSnapshot struct {
	orm.BaseModel `bun:"table:apv_form_snapshot,alias:afs"`
	orm.Model
	orm.CreationTrackedModel

	InstanceID string         `json:"instanceId" bun:"instance_id"`
	NodeID     string         `json:"nodeId" bun:"node_id"`
	FormData   map[string]any `json:"formData" bun:"form_data,type:jsonb"`
}

type FormTable struct {
	orm.BaseModel `bun:"table:apv_form_table,alias:aft"`
	orm.CreationAuditedModel

	FlowID            string `json:"flowId" bun:"flow_id"`
	VersionID         string `json:"versionId" bun:"version_id"`
	PhysicalTableName string `json:"physicalTableName" bun:"physical_table_name"`
	// SourceFieldKey names the detail-table field this child table projects;
	// empty for the version's main projection table.
	SourceFieldKey string `json:"sourceFieldKey" bun:"source_field_key"`
}

type FormTableColumn struct {
	orm.BaseModel `bun:"table:apv_form_table_column,alias:aftc"`
	orm.CreationAuditedModel

	FormTableID    string  `json:"formTableId" bun:"form_table_id"`
	ColumnName     string  `json:"columnName" bun:"column_name"`
	ColumnType     string  `json:"columnType" bun:"column_type"`
	IsNullable     bool    `json:"isNullable" bun:"is_nullable"`
	SourceFieldKey *string `json:"sourceFieldKey" bun:"source_field_key,nullzero"`
	SortOrder      int     `json:"sortOrder" bun:"sort_order"`
}

type HandleNodeData struct {
	BaseNodeData
	TaskNodeData
}

type InitiatorKind string

type Instance struct {
	orm.BaseModel `bun:"table:apv_instance,alias:ai"`
	orm.FullAuditedModel

	TenantID string `json:"tenantId" bun:"tenant_id"`
	FlowID   string `json:"flowId" bun:"flow_id"`
	// FlowCode snapshots the flow's business code at instance creation, like
	// the applicant fields. Flow codes are immutable (update_flow never
	// touches code), so the snapshot cannot drift; carrying it here lets
	// every event and projection self-describe without joining apv_flow.
	FlowCode                string          `json:"flowCode" bun:"flow_code"`
	FlowVersionID           string          `json:"flowVersionId" bun:"flow_version_id"`
	Title                   string          `json:"title" bun:"title"`
	InstanceNo              string          `json:"instanceNo" bun:"instance_no"`
	ApplicantID             string          `json:"applicantId" bun:"applicant_id"`
	ApplicantName           string          `json:"applicantName" bun:"applicant_name"`
	ApplicantDepartmentID   *string         `json:"applicantDepartmentId" bun:"applicant_department_id,nullzero"`
	ApplicantDepartmentName *string         `json:"applicantDepartmentName" bun:"applicant_department_name,nullzero"`
	Status                  InstanceStatus  `json:"status" bun:"status"`
	CurrentNodeID           *string         `json:"currentNodeId" bun:"current_node_id,nullzero"`
	FinishedAt              *timex.DateTime `json:"finishedAt" bun:"finished_at,nullzero"`
	// BusinessRef is the opaque reference to the bound business record. The
	// engine only parses the default single-key / composite-JSON shapes — hosts
	// remain free to choose another shape (business number, encoded tuple, …)
	// by registering BusinessRefResolver.
	BusinessRef *string        `json:"businessRef" bun:"business_ref,nullzero"`
	FormData    map[string]any `json:"formData" bun:"form_data,type:jsonb,nullzero"`
	// Globals is the host-supplied global-variable snapshot taken at instance
	// start (tenant attributes, applicant roles, business limits, …). Condition
	// evaluation resolves field subjects and expression bindings against it, so
	// routing stays deterministic across re-evaluation — like the applicant
	// department, it reflects the world at initiation, not live state.
	Globals map[string]any `json:"globals" bun:"globals,type:jsonb,nullzero"`
	// BusinessProjectionID identifies the durable target state claimed at
	// instance start. Every later transition writes through that state so flow
	// edits and stale workers cannot redirect or overwrite the binding.
	BusinessProjectionID *string `json:"businessProjectionId,omitempty" bun:"business_projection_id,nullzero"`
}

type InstanceBindingFailedEvent struct {
	InstanceEventBase

	// Trigger is the lifecycle moment represented by the failed desired state.
	Trigger BindingTrigger `json:"trigger"`
	// Status is the instance status the write-back attempted to persist into
	// the business status column at that moment.
	Status        InstanceStatus `json:"status"`
	BusinessTable string         `json:"businessTable"`
	ErrorMessage  string         `json:"errorMessage"`
}

type InstanceCompletedEvent struct {
	InstanceEventBase

	// FinalStatus is always one of the IsFinal() statuses — approved,
	// rejected, or terminated. Paused states (returned / withdrawn) never
	// fire this event.
	FinalStatus InstanceStatus `json:"finalStatus"`
	FinishedAt  timex.DateTime `json:"finishedAt"`

	// Reason is the administrator's stated reason when FinalStatus is
	// terminated; nil for approved / rejected completions, whose deciding
	// opinions live on the task events.
	Reason *string `json:"reason,omitempty"`
}

type InstanceCreatedEvent struct {
	InstanceEventBase
}

type InstanceEvent interface {
	event.Event
	// contains filtered or unexported methods
}

type InstanceEventBase struct {
	InstanceID   string         `json:"instanceId"`
	InstanceNo   string         `json:"instanceNo"`
	TenantID     string         `json:"tenantId"`
	Title        string         `json:"title"`
	FlowID       string         `json:"flowId"`
	FlowCode     string         `json:"flowCode"`
	BusinessRef  *string        `json:"businessRef,omitempty"`
	Applicant    UserInfo       `json:"applicant"`
	OccurredTime timex.DateTime `json:"occurredTime"`
}

type InstanceFilter struct {
	FlowCodes []string
	TenantIDs []string
}

type InstanceFlowGraph struct {
	Nodes []FlowGraphNode `json:"nodes"`
	Edges []FlowGraphEdge `json:"edges"`
}

type InstanceGlobalsResolver interface {
	// Resolve returns the global-variable snapshot for an instance the given
	// principal is starting on the given flow. A nil map means "no globals".
	Resolve(ctx context.Context, principal *security.Principal, flowCode string) (map[string]any, error)
}

type InstanceLifecycleHook interface {
	// OnInstanceCreated runs after the instance row is persisted and the
	// initial action log is written, but before the engine advances to
	// the first node. Returning an error rolls back start_instance.
	OnInstanceCreated(ctx context.Context, db orm.DB, instance *Instance) error
	// OnInstanceTransition runs inside the same transaction as every
	// instance status transition — completion (to.IsFinal()), return,
	// withdrawal, resubmission, termination — after the engine-owned
	// business projection has recorded (and, in synchronous mode, applied)
	// the new state, so the hook observes the business table as the
	// transition leaves it. instance.Status already carries to. Returning
	// an error rolls back the whole transition. For side effects that need
	// no transactional coupling, subscribe to the corresponding instance
	// events (or bridge them into commands via BindCommand) instead.
	OnInstanceTransition(ctx context.Context, db orm.DB, instance *Instance, from, to InstanceStatus) error
}

type InstanceNoGenerator interface {
	// Generate creates a unique instance number for a flow identified by flowCode.
	Generate(ctx context.Context, flowCode string) (string, error)
}

type InstanceResubmittedEvent struct {
	InstanceEventBase

	Operator UserInfo `json:"operator"`
}

type InstanceReturnedEvent struct {
	InstanceEventBase

	FromNodeID   string   `json:"fromNodeId"`
	FromNodeName string   `json:"fromNodeName"`
	ToNodeID     string   `json:"toNodeId"`
	ToNodeName   string   `json:"toNodeName"`
	Operator     UserInfo `json:"operator"`

	// Opinion is the rollback opinion provided by the operator, if any.
	Opinion *string `json:"opinion,omitempty"`
}

type InstanceRolledBackEvent struct {
	InstanceEventBase

	FromNodeID   string   `json:"fromNodeId"`
	FromNodeName string   `json:"fromNodeName"`
	ToNodeID     string   `json:"toNodeId"`
	ToNodeName   string   `json:"toNodeName"`
	Operator     UserInfo `json:"operator"`

	// Opinion is the rollback opinion provided by the operator, if any.
	Opinion *string `json:"opinion,omitempty"`
}

type InstanceStatus string

type InstanceSubscribeOption interface {
	// contains filtered or unexported methods
}

type InstanceWithdrawnEvent struct {
	InstanceEventBase

	Operator UserInfo `json:"operator"`

	// Reason is the applicant's stated withdrawal reason, when provided.
	Reason *string `json:"reason,omitempty"`
}

type NodeAutoPassedEvent struct {
	InstanceEventBase

	NodeID   string `json:"nodeId"`
	NodeName string `json:"nodeName"`
	Reason   string `json:"reason"`
}

type NodeData interface {
	// Kind returns the node kind (start, end, approval, handle, cc, condition).
	Kind() NodeKind
	// GetName returns the display name of the node.
	GetName() string
	// GetDescription returns the optional description of the node.
	GetDescription() *string
	// ApplyTo applies this node data's configuration to the given FlowNode,
	// resolving omitted optional fields to their documented defaults so the
	// persisted node always carries complete, valid configuration.
	ApplyTo(node *FlowNode)
}

type NodeDefinition struct {
	ID       string          `json:"id"`
	Kind     NodeKind        `json:"kind"`
	Position Position        `json:"position"`
	Data     json.RawMessage `json:"data,omitempty"`
}

type NodeKind string

type NodeParticipant struct {
	TaskID      string          `json:"taskId"`
	User        UserInfo        `json:"user"`
	Delegator   *UserInfo       `json:"delegator,omitempty"`
	Status      string          `json:"status"`
	Deadline    *timex.DateTime `json:"deadline,omitempty"`
	IsTimeout   bool            `json:"isTimeout,omitempty"`
	Opinion     *string         `json:"opinion,omitempty"`
	Attachments []string        `json:"attachments,omitempty"`
	ActionTime  *timex.DateTime `json:"actionTime,omitempty"`
	TransferTo  *UserInfo       `json:"transferTo,omitempty"`
}

type NodeProgressStatus string

type NodeVisit struct {
	orm.BaseModel `bun:"table:apv_node_visit,alias:anv"`
	orm.CreationAuditedModel

	TenantID   string          `json:"tenantId" bun:"tenant_id"`
	InstanceID string          `json:"instanceId" bun:"instance_id"`
	NodeID     string          `json:"nodeId" bun:"node_id"`
	Sequence   int             `json:"sequence" bun:"sequence"`
	Status     NodeVisitStatus `json:"status" bun:"status"`
	FinishedAt *timex.DateTime `json:"finishedAt" bun:"finished_at,nullzero"`
}

type NodeVisitStatus string

type PassRule string

type PassRuleContext struct {
	ApprovedCount int
	RejectedCount int
	TotalCount    int
	PassRatio     float64
}

type PassRuleResult int

type PassRuleStrategy interface {
	// Rule returns the pass rule this strategy handles.
	Rule() PassRule
	// Evaluate determines the pass/reject/pending outcome based on task approval counts.
	Evaluate(ctx PassRuleContext) PassRuleResult
}

type Permission string

type Position struct {
	X float64 `json:"x"`
	Y float64 `json:"y"`
}

type PrincipalDepartmentResolver interface {
	// Resolve extracts the department ID and name from the given security principal.
	Resolve(ctx context.Context, principal *security.Principal) (departmentID, departmentName *string, err error)
}

type PrincipalTenantResolver interface {
	// Resolve returns the tenant identifier for the given principal.
	Resolve(ctx context.Context, principal *security.Principal) (string, error)
}

type ResolvedAssignee struct {
	User      UserInfo
	Delegator *UserInfo
}

type RoleMembershipChecker interface {
	// UserHasRole reports whether the user currently holds the role.
	UserHasRole(ctx context.Context, userID, roleID string) (bool, error)
}

type RollbackDataStrategy string

type RollbackType string

type SameApplicantAction string

type StartNodeData struct {
	BaseNodeData
}

type StorageMode string

type Task struct {
	orm.BaseModel `bun:"table:apv_task,alias:at"`
	orm.FullAuditedModel

	TenantID                string           `json:"tenantId" bun:"tenant_id"`
	InstanceID              string           `json:"instanceId" bun:"instance_id"`
	NodeID                  string           `json:"nodeId" bun:"node_id"`
	VisitID                 string           `json:"visitId" bun:"visit_id"`
	AssigneeID              string           `json:"assigneeId" bun:"assignee_id"`
	AssigneeName            string           `json:"assigneeName" bun:"assignee_name"`
	AssigneeDepartmentID    *string          `json:"assigneeDepartmentId" bun:"assignee_department_id,nullzero"`
	AssigneeDepartmentName  *string          `json:"assigneeDepartmentName" bun:"assignee_department_name,nullzero"`
	DelegatorID             *string          `json:"delegatorId" bun:"delegator_id,nullzero"`
	DelegatorName           *string          `json:"delegatorName" bun:"delegator_name,nullzero"`
	DelegatorDepartmentID   *string          `json:"delegatorDepartmentId" bun:"delegator_department_id,nullzero"`
	DelegatorDepartmentName *string          `json:"delegatorDepartmentName" bun:"delegator_department_name,nullzero"`
	SortOrder               int              `json:"sortOrder" bun:"sort_order"`
	Status                  TaskStatus       `json:"status" bun:"status"`
	ReadAt                  *timex.DateTime  `json:"readAt" bun:"read_at,nullzero"`
	ParentTaskID            *string          `json:"parentTaskId" bun:"parent_task_id,nullzero"`
	AddAssigneeType         *AddAssigneeType `json:"addAssigneeType" bun:"add_assignee_type,nullzero"`
	Deadline                *timex.DateTime  `json:"deadline" bun:"deadline,nullzero"`
	IsTimeout               bool             `json:"isTimeout" bun:"is_timeout"`
	IsPreWarningSent        bool             `json:"isPreWarningSent" bun:"is_pre_warning_sent"`
	FinishedAt              *timex.DateTime  `json:"finishedAt" bun:"finished_at,nullzero"`
}

type TaskApprovedEvent struct {
	TaskEventBase

	Operator UserInfo `json:"operator"`
	Opinion  *string  `json:"opinion,omitempty"`
}

type TaskCanceledEvent struct {
	TaskEventBase

	Assignee UserInfo `json:"assignee"`
	Reason   string   `json:"reason"`
}

type TaskCreatedEvent struct {
	TaskEventBase

	Assignee UserInfo        `json:"assignee"`
	Deadline *timex.DateTime `json:"deadline,omitempty"`
}

type TaskDeadlineWarningEvent struct {
	TaskEventBase

	Assignee  UserInfo       `json:"assignee"`
	Deadline  timex.DateTime `json:"deadline"`
	HoursLeft int            `json:"hoursLeft"`
}

type TaskEventBase struct {
	InstanceEventBase

	TaskID   string `json:"taskId"`
	NodeID   string `json:"nodeId"`
	NodeName string `json:"nodeName"`
}

type TaskHandledEvent struct {
	TaskEventBase

	Operator UserInfo `json:"operator"`
	Opinion  *string  `json:"opinion,omitempty"`
}

type TaskNodeData struct {
	Assignees                []AssigneeDefinition  `json:"assignees,omitempty"`
	ExecutionType            ExecutionType         `json:"executionType,omitempty"`
	EmptyAssigneeAction      EmptyAssigneeAction   `json:"emptyAssigneeAction,omitempty"`
	FallbackUserIDs          []string              `json:"fallbackUserIds,omitempty"`
	AdminUserIDs             []string              `json:"adminUserIds,omitempty"`
	IsTransferAllowed        *bool                 `json:"isTransferAllowed,omitempty"`
	IsOpinionRequired        bool                  `json:"isOpinionRequired,omitempty"`
	TimeoutHours             int                   `json:"timeoutHours,omitempty"`
	TimeoutAction            TimeoutAction         `json:"timeoutAction,omitempty"`
	TimeoutNotifyBeforeHours int                   `json:"timeoutNotifyBeforeHours,omitempty"`
	UrgeCooldownMinutes      int                   `json:"urgeCooldownMinutes,omitempty"`
	CCs                      []CCDefinition        `json:"ccs,omitempty"`
	FieldPermissions         map[string]Permission `json:"fieldPermissions,omitempty"`
}

type TaskReassignedEvent struct {
	TaskEventBase

	From   UserInfo `json:"from"`
	To     UserInfo `json:"to"`
	Reason *string  `json:"reason,omitempty"`
}

type TaskRejectedEvent struct {
	TaskEventBase

	Operator UserInfo `json:"operator"`
	Opinion  *string  `json:"opinion,omitempty"`
}

type TaskStatus string

type TaskTimedOutEvent struct {
	TaskEventBase

	Assignee UserInfo       `json:"assignee"`
	Deadline timex.DateTime `json:"deadline"`
}

type TaskTransferredEvent struct {
	TaskEventBase

	From   UserInfo `json:"from"`
	To     UserInfo `json:"to"`
	Reason *string  `json:"reason,omitempty"`
}

type TaskUrgedEvent struct {
	TaskEventBase

	Urger   UserInfo `json:"urger"`
	Target  UserInfo `json:"target"`
	Message *string  `json:"message,omitempty"`
}

type TimelineEntry struct {
	Kind           TimelineEntryKind `json:"kind"`
	NodeID         *string           `json:"nodeId,omitempty"`
	Name           string            `json:"name,omitempty"`
	Status         NodeVisitStatus   `json:"status,omitempty"`
	ExecutionType  string            `json:"executionType,omitempty"`
	ApprovalMethod string            `json:"approvalMethod,omitempty"`
	PassRule       string            `json:"passRule,omitempty"`
	PassRatio      *decimal.Decimal  `json:"passRatio,omitempty"`
	Participants   []NodeParticipant `json:"participants,omitempty"`
	CCRecipients   []CCRecipient     `json:"ccRecipients,omitempty"`
	Activities     []Activity        `json:"activities,omitempty"`
	StartedAt      timex.DateTime    `json:"startedAt"`
	FinishedAt     *timex.DateTime   `json:"finishedAt,omitempty"`
}

type TimelineEntryKind string

type TimeoutAction string

type UrgeRecord struct {
	orm.BaseModel `bun:"table:apv_urge_record,alias:aur"`
	orm.Model
	orm.CreationTrackedModel

	InstanceID               string  `json:"instanceId" bun:"instance_id"`
	NodeID                   string  `json:"nodeId" bun:"node_id"`
	TaskID                   *string `json:"taskId" bun:"task_id,nullzero"`
	UrgerID                  string  `json:"urgerId" bun:"urger_id"`
	UrgerName                string  `json:"urgerName" bun:"urger_name"`
	UrgerDepartmentID        *string `json:"urgerDepartmentId" bun:"urger_department_id,nullzero"`
	UrgerDepartmentName      *string `json:"urgerDepartmentName" bun:"urger_department_name,nullzero"`
	TargetUserID             string  `json:"targetUserId" bun:"target_user_id"`
	TargetUserName           string  `json:"targetUserName" bun:"target_user_name"`
	TargetUserDepartmentID   *string `json:"targetUserDepartmentId" bun:"target_user_department_id,nullzero"`
	TargetUserDepartmentName *string `json:"targetUserDepartmentName" bun:"target_user_department_name,nullzero"`
	Message                  string  `json:"message" bun:"message"`
}

type UserInfo struct {
	ID             string  `json:"id"`
	Name           string  `json:"name"`
	DepartmentID   *string `json:"departmentId,omitempty"`
	DepartmentName *string `json:"departmentName,omitempty"`
}

type UserInfoResolver interface {
	// ResolveUsers returns user info for the given IDs.
	// Missing IDs should be returned with empty Name (not omitted).
	// Department fields are optional; fill them to enrich the person
	// snapshots the approval module records.
	ResolveUsers(ctx context.Context, userIDs []string) (map[string]UserInfo, error)
}

type ValidationRule struct {
	MinLength *int     `json:"minLength,omitempty"`
	MaxLength *int     `json:"maxLength,omitempty"`
	Min       *float64 `json:"min,omitempty"`
	Max       *float64 `json:"max,omitempty"`
	Pattern   string   `json:"pattern,omitempty"`
	Message   string   `json:"message,omitempty"`
}

type VersionStatus string