pro

type CreateGroupRequest struct {
	Name        string             `json:"name" validate:"required"`
	Permissions []utils.Permission `json:"permissions"`
}

type Deployment struct {
	Name     string `json:"name" validate:"required,min=3,max=64,alphanum"`
	Replicas int    `json:"replicas" validate:"required,min=1"`
	// Strategy selects which PlacementStrategy the scheduler uses for this
	// deployment. Empty is treated as "round-robin" for back-compat with
	// KV entries written before this field existed.
	Strategy string `json:"strategy" validate:"omitempty,oneof=round-robin least-busy"`
	// Tags filter eligible placement nodes. A deployment with Tags=["gpu"]
	// will only land on nodes whose ConstellationDevice.Tags contains "gpu".
	// Multiple tags are AND'd: ["gpu","nvme"] requires both. Empty means no
	// filter — any node is eligible.
	Tags []string `json:"tags,omitempty" validate:"omitempty,dive,min=1,max=64"`
	// Storage lists RCLONE remote names this deployment depends on. Checked
	// node-side in executeApply before docker.CreateService runs — a missing
	// remote produces StatusFail and flows through the existing fail-streak
	// quarantine path. Not a placement filter: RCLONE config is cluster-synced
	// via constellation, so every eligible node has the same remote set.
	// ${storage.NAME} in compose fields resolves to the mount path on apply.
	Storage []string                          `json:"storage,omitempty" validate:"omitempty,dive,min=1,max=64"`
	Compose docker.DockerServiceCreateRequest `json:"compose" validate:"required"`
}

type DeploymentHealth struct {
	Desired      int      `json:"desired"`
	Actual       int      `json:"actual"`
	Nodes        []string `json:"nodes"`
	Broken       bool     `json:"broken"`
	BrokenReason string   `json:"brokenReason,omitempty"`
	// Version is the desired (current) spec version. UpToDate counts how many of
	// the nodes reporting this deployment are running that version. Updating is
	// true while a spec change is still rolling out — i.e. at least one reporting
	// node is on an older version. A deployment is only fully healthy when
	// Actual == Desired AND UpToDate == Actual (Updating == false).
	Version  int  `json:"version"`
	UpToDate int  `json:"upToDate"`
	Updating bool `json:"updating"`
}

type NodeIdentity struct {
	DeviceName string
	IP         string
	CosmosNode int
}

type NodeMetrics struct {
	CPUPercent   float64
	RAMPercent   float64
	MonitoringOn bool
}

type NodeResources struct {
	CPUPercent   float64
	RAMPercent   float64
	MonitoringOn bool
}

type PlacementInput struct {
	Deployment    Deployment
	EligibleNodes []string
	CurrentlyOn   []string
	NodeMetrics   map[string]NodeMetrics
}

type PlacementStrategy interface {
	Choose(in PlacementInput) []string
}

type UpdateGroupRequest struct {
	Name        *string            `json:"name,omitempty"`
	Permissions []utils.Permission `json:"permissions,omitempty"`
}