operation

type ComponentTarget struct {
	UUID     uuid.UUID    // RLA internal UUID (one of UUID or External must be set)
	External *ExternalRef // External system reference (one of UUID or External must be set)
}

type ConflictStrategy int

type ExternalRef struct {
	Type devicetypes.ComponentType // Component type determines the source system
	ID   string                    // Component ID from the component manager service
}

type RackTarget struct {
	Identifier     identifier.Identifier       // Rack identifier (ID or Name, at least one must be set)
	ComponentTypes []devicetypes.ComponentType // Optional: filter by type; empty = ALL component types in rack
}

type Request struct {
	Operation   Wrapper
	TargetSpec  TargetSpec // Either racks or components, not both
	Description string

	// ConflictStrategy controls how the task behaves when a conflict is
	// detected. Default (ConflictStrategyReject) rejects on conflict.
	ConflictStrategy ConflictStrategy

	// QueueTimeout is how long to wait in queue before auto-expiry. Zero
	// means use the server default. The server may enforce a maximum.
	// Only relevant when ConflictStrategy is ConflictStrategyQueue.
	QueueTimeout time.Duration

	// Optional: override rule resolution with a specific rule
	RuleID *uuid.UUID

	// RequiredRackID, when non-zero, causes SubmitTask to return an error
	// (and create no tasks) if the resolved targets do not belong exclusively
	// to this rack. Use this for component-targeting requests where the scope
	// was originally written against a specific rack, to guard against the
	// case where all listed components have since been moved to a different
	// single rack or span multiple racks.
	//
	// This field only handles the single-rack enforcement case. If a future
	// caller needs to constrain resolution to a known set of multiple racks,
	// this would need to become []uuid.UUID (or a separate AllowedRackIDs
	// field). Do not add that generalization until there is a concrete caller.
	RequiredRackID uuid.UUID
}

type TargetSpec struct {
	Racks      []RackTarget      // Set if targeting racks (mutually exclusive with Components)
	Components []ComponentTarget // Set if targeting components (mutually exclusive with Racks)
}

type Wrapper struct {
	Type taskcommon.TaskType
	Code string          // Operation code string (e.g., "power_on", "upgrade")
	Info json.RawMessage // Serialized operation details
}