strategy

type AllPassStrategy ¶

type AllPassStrategy struct{}

AllPassStrategy requires all assignees to approve; any single rejection fails the node, so "everyone must agree" and "one veto rejects" are the same rule under this strategy.

func (*AllPassStrategy) Evaluate(ctx approval.PassRuleContext) approval.PassRuleResult

func (*AllPassStrategy) Rule() approval.PassRule

type AnyPassStrategy ¶ added in v0.35.0

type AnyPassStrategy struct{}

AnyPassStrategy passes when at least one assignee approves.

func (*AnyPassStrategy) Evaluate(ctx approval.PassRuleContext) approval.PassRuleResult

func (*AnyPassStrategy) Rule() approval.PassRule

type AssigneeResolver ¶

type AssigneeResolver interface {
	// Kind returns the assignee kind this resolver handles (user, role, department_leader, superior, etc.).
	Kind() approval.AssigneeKind
	// Resolve resolves concrete assignees from the assignee configuration in ResolveContext.
	Resolve(ctx context.Context, rc *ResolveContext) ([]approval.ResolvedAssignee, error)
}

AssigneeResolver resolves assignees for a specific kind.

func NewDepartmentAssigneeResolver(svc approval.AssigneeService) AssigneeResolver

func NewDepartmentLeaderAssigneeResolver(svc approval.AssigneeService) AssigneeResolver

func NewFormFieldAssigneeResolver() AssigneeResolver

func NewRoleAssigneeResolver(svc approval.AssigneeService) AssigneeResolver

func NewSelfAssigneeResolver() AssigneeResolver

func NewSuperiorAssigneeResolver(svc approval.AssigneeService) AssigneeResolver

func NewUserAssigneeResolver() AssigneeResolver

type AvgAggregator ¶ added in v0.36.0

type AvgAggregator struct{}

AvgAggregator folds a numeric column into its mean. The average of zero values is undefined — like SQL's AVG returning NULL, the condition then matches nothing instead of comparing against a fabricated 0.

func (*AvgAggregator) Fold(values []float64, _ int) (float64, bool)

func (*AvgAggregator) Kind() approval.AggregateKind

type CompositeAssigneeResolver ¶

type CompositeAssigneeResolver struct {
	// contains filtered or unexported fields
}

CompositeAssigneeResolver chains multiple resolvers and resolves assignees based on config kind.

func NewCompositeAssigneeResolver(resolvers ...AssigneeResolver) *CompositeAssigneeResolver

func (c *CompositeAssigneeResolver) ResolveAll(ctx context.Context, assignees []approval.FlowNodeAssignee, baseRC *ResolveContext) ([]approval.ResolvedAssignee, error)

type CountAggregator ¶ added in v0.36.0

type CountAggregator struct{}

CountAggregator folds a table into its row count. It works on rows, not a column, so conditions using it leave Column empty.

func (*CountAggregator) Fold(_ []float64, rowCount int) (float64, bool)

func (*CountAggregator) Kind() approval.AggregateKind

type DepartmentAssigneeResolver ¶ added in v0.20.1

type DepartmentAssigneeResolver struct {
	// contains filtered or unexported fields
}

DepartmentAssigneeResolver resolves the leaders of the configured department IDs (rc.IDs) as assignees.

func (*DepartmentAssigneeResolver) Kind() approval.AssigneeKind

func (r *DepartmentAssigneeResolver) Resolve(ctx context.Context, rc *ResolveContext) ([]approval.ResolvedAssignee, error)

type DepartmentLeaderAssigneeResolver ¶ added in v0.20.1

type DepartmentLeaderAssigneeResolver struct {
	// contains filtered or unexported fields
}

DepartmentLeaderAssigneeResolver resolves the leaders of the applicant's own department as assignees. This is a single-level lookup (GetDepartmentLeaders); it does not walk a multi-level supervisor chain.

func (*DepartmentLeaderAssigneeResolver) Kind() approval.AssigneeKind

func (r *DepartmentLeaderAssigneeResolver) Resolve(ctx context.Context, rc *ResolveContext) ([]approval.ResolvedAssignee, error)

type ExpressionConditionEvaluator ¶

type ExpressionConditionEvaluator struct {
	// contains filtered or unexported fields
}

ExpressionConditionEvaluator evaluates expression conditions through the framework's expression.Engine abstraction, so approval depends on the engine contract rather than any concrete backend. The expression environment carries formData (the instance form), applicantId, applicantDepartmentId, and every host-supplied global from EvaluationContext.Globals as a top-level binding (built-ins win a name collision).

func (e *ExpressionConditionEvaluator) Evaluate(ctx context.Context, cond approval.Condition, ec *approval.EvaluationContext) (bool, error)

func (*ExpressionConditionEvaluator) Kind() approval.ConditionKind

type FieldConditionEvaluator ¶

type FieldConditionEvaluator struct {
	// contains filtered or unexported fields
}

FieldConditionEvaluator evaluates structured field conditions natively in Go. Field conditions are data, not code: comparing them directly keeps the operator semantics typed per field kind (no string templating, no injection surface, no expression-engine round-trip) and guarantees the operator set stays in lockstep with the approval.ConditionOperator contract — adding an operator there without handling it here fails loudly at evaluation.

Aggregate conditions fold a detail-table field through a registered approval.Aggregator before the comparison; the fold implementations are injected so new aggregate kinds extend the evaluator without modifying it.

func (e *FieldConditionEvaluator) Evaluate(_ context.Context, cond approval.Condition, ec *approval.EvaluationContext) (bool, error)

func (*FieldConditionEvaluator) Kind() approval.ConditionKind

type FormFieldAssigneeResolver ¶

type FormFieldAssigneeResolver struct{}

FormFieldAssigneeResolver resolves assignees from a form field value.

func (*FormFieldAssigneeResolver) Kind() approval.AssigneeKind

func (*FormFieldAssigneeResolver) Resolve(ctx context.Context, rc *ResolveContext) ([]approval.ResolvedAssignee, error)

type RatioPassStrategy ¶

type RatioPassStrategy struct{}

RatioPassStrategy passes when approval ratio meets threshold.

func (*RatioPassStrategy) Evaluate(ctx approval.PassRuleContext) approval.PassRuleResult

func (*RatioPassStrategy) Rule() approval.PassRule

type ResolveContext ¶

type ResolveContext struct {
	ApplicantID             string
	ApplicantName           string
	ApplicantDepartmentID   *string
	ApplicantDepartmentName *string
	FormData                approval.FormData
	UserResolver            approval.UserInfoResolver

	IDs       []string
	FormField *string
}

ResolveContext provides context for assignee resolution.

type RoleAssigneeResolver ¶

type RoleAssigneeResolver struct {
	// contains filtered or unexported fields
}

RoleAssigneeResolver resolves assignees from role IDs via AssigneeService.

func (*RoleAssigneeResolver) Kind() approval.AssigneeKind

func (r *RoleAssigneeResolver) Resolve(ctx context.Context, rc *ResolveContext) ([]approval.ResolvedAssignee, error)

type SelfAssigneeResolver ¶

type SelfAssigneeResolver struct{}

SelfAssigneeResolver resolves the applicant as assignee.

func (*SelfAssigneeResolver) Kind() approval.AssigneeKind

func (*SelfAssigneeResolver) Resolve(_ context.Context, rc *ResolveContext) ([]approval.ResolvedAssignee, error)

type StrategyRegistry ¶

type StrategyRegistry struct {
	// contains filtered or unexported fields
}

StrategyRegistry holds all strategy implementations indexed by their type.

func NewStrategyRegistry(
	passRules []approval.PassRuleStrategy,
	assignees []AssigneeResolver,
	conditions []approval.ConditionEvaluator,
) *StrategyRegistry

func (r *StrategyRegistry) CompositeAssigneeResolver() *CompositeAssigneeResolver

func (r *StrategyRegistry) GetConditionEvaluator(t approval.ConditionKind) (approval.ConditionEvaluator, error)

func (r *StrategyRegistry) GetPassRuleStrategy(rule approval.PassRule) (approval.PassRuleStrategy, error)

func (r *StrategyRegistry) ValidateBuiltins() error

type SumAggregator ¶ added in v0.36.0

type SumAggregator struct{}

SumAggregator folds a numeric column into its total. An empty table sums to 0 — the SQL convention for SUM over no rows.

func (*SumAggregator) Fold(values []float64, _ int) (float64, bool)

func (*SumAggregator) Kind() approval.AggregateKind

type SuperiorAssigneeResolver ¶

type SuperiorAssigneeResolver struct {
	// contains filtered or unexported fields
}

SuperiorAssigneeResolver resolves the direct superior as assignee.

func (*SuperiorAssigneeResolver) Kind() approval.AssigneeKind

func (r *SuperiorAssigneeResolver) Resolve(ctx context.Context, rc *ResolveContext) ([]approval.ResolvedAssignee, error)

type UserAssigneeResolver ¶

type UserAssigneeResolver struct{}

UserAssigneeResolver resolves assignees from fixed user IDs.

func (*UserAssigneeResolver) Kind() approval.AssigneeKind

func (*UserAssigneeResolver) Resolve(ctx context.Context, rc *ResolveContext) ([]approval.ResolvedAssignee, error)