models

type AdminCreateUserRequest struct {
	// Email is the new user's email address.
	// required: true
	// example: newuser@example.com
	Email string `json:"email" binding:"required,email" example:"newuser@example.com"`

	// Password is the initial password for the new user (min 8 characters).
	// required: true
	// example: InitialP@ssw0rd!
	Password string `json:"password" binding:"required,min=8" example:"InitialP@ssw0rd!"`

	// Name is the new user's display name.
	// required: true
	// example: Jane Smith
	Name string `json:"name" binding:"required" example:"Jane Smith"`

	// Roles is an optional list of roles to assign to the new user.
	// example: ["user", "editor"]
	Roles []string `json:"roles" example:"user,editor"` // Optional: roles to assign (e.g., ["user", "admin"])

	// Active specifies if the new user account should be active immediately. Defaults to true if omitted.
	// example: true
	Active bool `json:"active" example:"true"` // Optional: defaults to true if omitted

	// EmailVerified specifies if the new user's email should be marked as verified. Defaults to false.
	// example: false
	EmailVerified bool `json:"email_verified" example:"false"` // Optional: defaults to false
}

type AdminUpdateUserRequest struct {
	// Name is the user's updated display name.
	// example: "Johnathan Doe"
	Name *string `json:"name" example:"Johnathan Doe"` // Optional: Pointer to allow omitting

	// Email is the user's updated email address. If changed, email verification status might be reset.
	// example: "john.doe.updated@example.com"
	Email *string `json:"email" example:"john.doe.updated@example.com"` // Optional: Pointer to allow omitting

	// Roles is the updated list of roles for the user. An empty slice clears existing roles.
	// example: ["user", "admin"]
	Roles *[]string `json:"roles" example:"user,admin"` // Optional: Pointer to allow omitting (empty slice means clear roles)

	// Active specifies whether the user account should be active.
	// example: false
	Active *bool `json:"active" example:"false"` // Optional: Pointer to allow omitting

	// EmailVerified specifies whether the user's email address is verified.
	// example: true
	EmailVerified *bool `json:"email_verified" example:"true"` // Optional: Pointer to allow omitting
}

type ChangeItemResponse struct {
	// Path is the path to the file or directory that has changed.
	// required: true
	// example: "/app/config.json"
	Path string `json:"path" example:"/etc/nginx/nginx.conf"`

	// Kind indicates the type of change: 0 for Modified, 1 for Added, 2 for Deleted.
	// required: true
	// example: 1
	Kind int `json:"kind"` // 0: Modified, 1: Added, 2: Deleted
}

type ChangePasswordRequest struct {
	// CurrentPassword is the user's existing password.
	// required: true
	// example: OldP@ssw0rd!
	CurrentPassword string `json:"current_password" binding:"required" example:"OldP@ssw0rd!"`

	// NewPassword is the desired new password (min 8 characters).
	// required: true
	// example: NewStrongP@ssw0rd!
	NewPassword string `json:"new_password" binding:"required,min=8" example:"NewStrongP@ssw0rd!"`
}

type ComposeDeployment struct {
	DockerResource
	ProjectName  string           `json:"project_name" gorm:"uniqueIndex;size:255" validate:"required,max=255,alphanumdash"`
	FilePath     string           `json:"file_path" validate:"omitempty,filepath"`
	Content      string           `json:"-" gorm:"type:text"` // Store raw compose content
	EnvVars      JSONMap          `json:"env_vars" gorm:"type:text"`
	Status       string           `json:"status" gorm:"index;size:64" validate:"required,max=64"`
	ServiceCount int              `json:"service_count"`
	RunningCount int              `json:"running_count"`
	Services     []ComposeService `json:"services" gorm:"foreignKey:DeploymentID"`
	LastDeployed time.Time        `json:"last_deployed"`
	LastUpdated  time.Time        `json:"last_updated"`
}

type ComposeDeploymentResponse struct {
	ID           uint                     `json:"id" example:"1"`
	Name         string                   `json:"name"`
	ProjectName  string                   `json:"project_name" example:"my-web-app"`
	FilePath     string                   `json:"file_path,omitempty"`
	Status       string                   `json:"status" example:"running"`
	ServiceCount int                      `json:"service_count"`
	RunningCount int                      `json:"running_count"`
	Services     []ComposeServiceResponse `json:"services"`
	Networks     []NetworkResponse        `json:"networks,omitempty"`
	Volumes      []VolumeResponse         `json:"volumes,omitempty"`
	Labels       map[string]string        `json:"labels,omitempty"`
	Notes        string                   `json:"notes,omitempty"`
	LastDeployed time.Time                `json:"last_deployed" example:"2023-10-27T12:00:00Z"`
	LastUpdated  time.Time                `json:"last_updated"`
	UserID       uint                     `json:"user_id"`
	CreatedAt    time.Time                `json:"created_at"`
	UpdatedAt    time.Time                `json:"updated_at"`
}

type ComposeDownOptions struct {
	RemoveVolumes  bool   `json:"removeVolumes,omitempty"`
	RemoveImages   string `json:"removeImages,omitempty"` // e.g., "all", "local"
	RemoveOrphans  bool   `json:"removeOrphans,omitempty"`
	TimeoutSeconds int    `json:"timeoutSeconds,omitempty"` // Renamed for clarity
}

type ComposeDownRequest struct {
	// RemoveVolumes removes named volumes declared in the 'volumes' section of the Compose file and anonymous volumes attached to containers.
	// example: false
	RemoveVolumes bool `form:"remove_volumes"`

	// RemoveOrphans removes containers for services not defined in the Compose file.
	// example: false
	RemoveOrphans bool `form:"remove_orphans"`

	// Force forces the removal of containers.
	// example: false
	Force bool `form:"force"`
}

type ComposeFile struct {
	// Version is the version of the Compose file format
	Version string `yaml:"version" json:"version"`

	// Services is a map of service definitions
	Services map[string]ServiceConfig `yaml:"services" json:"services"`

	// Networks is a map of network definitions
	Networks map[string]NetworkConfig `yaml:"networks,omitempty" json:"networks,omitempty"`

	// Volumes is a map of volume definitions
	Volumes map[string]VolumeConfig `yaml:"volumes,omitempty" json:"volumes,omitempty"`

	// Secrets is a map of secret definitions
	Secrets map[string]SecretConfig `yaml:"secrets,omitempty" json:"secrets,omitempty"`

	// Configs is a map of config definitions
	Configs map[string]ConfigConfig `yaml:"configs,omitempty" json:"configs,omitempty"`

	// Extensions stores extension fields
	Extensions map[string]interface{} `yaml:"extensions,omitempty" json:"extensions,omitempty"` // Removed ,inline tag
}

type ComposeListRequest struct {
	PaginationRequest // Embeds Page and PageSize
	SortRequest       // Embeds SortBy and SortOrder
	FilterRequest     // Embeds Search, Filters, StartDate, EndDate
	// Status filters deployments by their current status (e.g., running, stopped, error).
	// example: running
	Status string `json:"status" form:"status" example:"running"`
}

type ComposeListResponse struct {
	Deployments []ComposeDeploymentResponse `json:"deployments"`
	Metadata    MetadataResponse            `json:"metadata"`
}

type ComposeRestartRequest struct {
	// Timeout specifies the shutdown timeout in seconds before restarting containers.
	// example: 10
	Timeout int `form:"timeout" binding:"omitempty,gte=0" example:"10"` // Timeout in seconds
}

type ComposeScaleRequest struct {
	// Service is the name of the service to scale.
	// required: true
	// example: "worker"
	Service string `json:"service" binding:"required" example:"worker"`

	// Replicas is the desired number of containers for the service.
	// required: true
	// example: 3
	Replicas int `json:"replicas" binding:"required,gte=0" example:"3"`
}

type ComposeService struct {
	ID           uint            `json:"id" gorm:"primaryKey"`
	DeploymentID uint            `json:"-" gorm:"index" validate:"required"` // Link back to ComposeDeployment
	Name         string          `json:"name" gorm:"index;size:255" validate:"required,max=255,alphanumdash"`
	ImageName    string          `json:"image_name" validate:"required,max=512"`
	Status       ContainerStatus `json:"status" gorm:"index;size:32" validate:"containerStatus"`
	Replicas     int             `json:"replicas" validate:"min=0"`
	RunningCount int             `json:"running_count" validate:"min=0"`
	Ports        JSONMap         `json:"ports" gorm:"type:text"`
	Volumes      JSONMap         `json:"volumes" gorm:"type:text"`
	Networks     StringArray     `json:"networks" gorm:"type:text"`
	Environment  StringArray     `json:"environment" gorm:"type:text"`
	Command      string          `json:"command" validate:"max=1024"`
	Depends      StringArray     `json:"depends" gorm:"type:text"`
	Labels       JSONMap         `json:"labels" gorm:"type:text"`
	Build        JSONMap         `json:"build" gorm:"type:text"` // Store build context/args as JSON
	Healthcheck  JSONMap         `json:"healthcheck" gorm:"type:text"`
	Secrets      StringArray     `json:"secrets" gorm:"type:text" validate:"-"`
	Configs      StringArray     `json:"configs" gorm:"type:text" validate:"-"`
	Deploy       JSONMap         `json:"deploy" gorm:"type:text"` // Store deploy options (replicas, resources, etc.)
	LastUpdated  time.Time       `json:"last_updated"`
	CreatedAt    time.Time       `json:"created_at"`
	UpdatedAt    time.Time       `json:"updated_at"`
	DeletedAt    gorm.DeletedAt  `json:"-" gorm:"index"`
}

type ComposeServiceResponse struct {
	ID           uint                  `json:"id"`
	Name         string                `json:"name" example:"web"`
	ContainerID  string                `json:"container_id,omitempty"`
	ImageName    string                `json:"image_name"`
	Status       ContainerStatus       `json:"status"`
	Replicas     int                   `json:"replicas"`
	RunningCount int                   `json:"running_count"`
	Ports        []PortMapping         `json:"ports,omitempty"`
	Volumes      []VolumeMountResponse `json:"volumes,omitempty"`
	Networks     []string              `json:"networks,omitempty"`
	Environment  []string              `json:"environment,omitempty"`
	Command      string                `json:"command,omitempty"`
	Depends      []string              `json:"depends,omitempty"`
	LastUpdated  time.Time             `json:"last_updated"`
	CreatedAt    time.Time             `json:"created_at"`
	UpdatedAt    time.Time             `json:"updated_at"`
}

type ComposeServiceStatus struct {
	ID           string        `json:"id"` // Container ID if running
	Name         string        `json:"name"`
	State        string        `json:"state"` // e.g., "running", "exited(0)", "starting"
	Health       string        `json:"health,omitempty"`
	ExitCode     int           `json:"exit_code,omitempty"`
	Ports        []PortMapping `json:"ports,omitempty"`         // Reusing PortMapping from docker_entities.go
	DesiredState string        `json:"desired_state,omitempty"` // e.g. "running"
}

type ComposeStartRequest struct {
}

type ComposeStatus struct {
	DeploymentID string                 `json:"deploymentId"`
	ProjectName  string                 `json:"projectName"`
	Status       string                 `json:"status"` // e.g., "running", "exited", "degraded"
	Services     []ComposeServiceStatus `json:"services"`
	Message      string                 `json:"message,omitempty"`
	LastUpdated  time.Time              `json:"lastUpdated"`
}

type ComposeStopRequest struct {
	// Timeout specifies the shutdown timeout in seconds for containers.
	// example: 10
	Timeout int `form:"timeout" binding:"omitempty,gte=0"` // Timeout in seconds
}

type ComposeUpOptions struct {
	ProjectName          string            `json:"projectName"` // Used in API call logic, though not directly in SDK options
	EnvironmentVariables map[string]string `json:"environmentVariables,omitempty"`
	Recreate             string            `json:"recreate,omitempty"` // e.g., "never", "diverged", "always"
	NoStart              bool              `json:"noStart,omitempty"`
	ForceRecreate        bool              `json:"forceRecreate,omitempty"`
	NoBuild              bool              `json:"noBuild,omitempty"`
	ForceBuild           bool              `json:"forceBuild,omitempty"`
	TimeoutSeconds       int               `json:"timeoutSeconds,omitempty"` // Renamed for clarity
	QuietPull            bool              `json:"quietPull,omitempty"`      // Common compose option
}

type ComposeUpRequest struct {
	// ProjectName is the name to assign to the Compose project.
	// required: true
	// example: "my-web-app"
	ProjectName string `json:"project_name" binding:"required"`

	// ComposeFileContent is the raw YAML content of the Docker Compose file.
	// required: true
	// example: "version: '3.8'\nservices:\n  web:\n    image: nginx:latest\n"
	ComposeFileContent string `` /* 150-byte string literal not displayed */

	// ForceRecreate forces the recreation of containers even if their configuration hasn't changed.
	// example: false
	ForceRecreate bool `json:"force_recreate" example:"false"`

	// NoBuild disables building images before starting containers.
	// example: false
	NoBuild bool `json:"no_build" example:"false"`

	// NoStart creates containers but does not start them.
	// example: false
	NoStart bool `json:"no_start"`

	// Pull attempts to pull newer versions of images before starting containers.
	// example: true
	Pull bool `json:"pull"`

	// RemoveOrphans removes containers for services not defined in the Compose file.
	// example: false
	RemoveOrphans bool `json:"remove_orphans" example:"false"`
}

type ComposeValidateRequest struct {
	// ComposeFileContent is the raw YAML content of the Docker Compose file.
	// required: true
	// example: "version: '3.8'\nservices:\n  web:\n    image: nginx:latest\n"
	ComposeFileContent string `` /* 150-byte string literal not displayed */
}

type ComposeValidationResponse struct {
	Valid    bool     `json:"valid"`
	Warnings []string `json:"warnings,omitempty"`
	Errors   []string `json:"errors,omitempty" example:"service 'db' depends on undefined network 'external_net'"`
	Services []string `json:"services,omitempty"`
	Networks []string `json:"networks,omitempty"`
	Volumes  []string `json:"volumes,omitempty"`
}

type ConfigConfig struct {
	// Name is the name of the config
	Name string `yaml:"-" json:"name"`

	// File is the file containing the config
	File string `yaml:"file,omitempty" json:"file,omitempty"`

	// External indicates whether the config is external
	External interface{} `yaml:"external,omitempty" json:"external,omitempty"`

	// Labels are labels to apply to the config
	Labels interface{} `yaml:"labels,omitempty" json:"labels,omitempty"`

	// Extensions stores extension fields
	Extensions map[string]interface{} `yaml:",inline" json:"extensions,omitempty"`
}

type Container struct {
	DockerResource
	ContainerID         string                     `json:"container_id" gorm:"index;size:64" validate:"len=64,alphanum"`
	ImageID             string                     `json:"image_id" gorm:"index;size:64" validate:"required"`
	Command             string                     `json:"command" validate:"max=1024"`
	Status              ContainerStatus            `json:"status" gorm:"index;size:32" validate:"containerStatus"`
	Ports               JSONMap                    `json:"ports" gorm:"type:text"`
	Volumes             JSONMap                    `json:"volumes" gorm:"type:text"`
	Networks            JSONMap                    `json:"networks" gorm:"type:text"`
	IPAddress           string                     `json:"ip_address" validate:"omitempty,ip"`
	ExitCode            int                        `json:"exit_code"`
	RestartPolicy       RestartPolicy              `json:"restart_policy" validate:"required,restartPolicy"`
	NetworkMode         NetworkMode                `json:"network_mode" validate:"required,networkMode"`
	Privileged          bool                       `json:"privileged"`
	HasChanged          bool                       `json:"has_changed" gorm:"default:false"`
	LastInspected       time.Time                  `json:"last_inspected"`
	SecurityOptions     StringArray                `json:"security_options" gorm:"type:text"`
	SecurityProfile     string                     `json:"security_profile" gorm:"size:255"`
	AutoRemove          bool                       `json:"auto_remove"`
	ReadOnly            bool                       `json:"read_only"`
	HostIPC             bool                       `json:"host_ipc"`
	HostPID             bool                       `json:"host_pid"`
	CapAdd              StringArray                `json:"cap_add" gorm:"type:text"`
	CapDrop             StringArray                `json:"cap_drop" gorm:"type:text"`
	UsernsMode          string                     `json:"userns_mode" gorm:"size:255"`
	Resources           JSONMap                    `json:"resources" gorm:"type:text"`
	Healthcheck         JSONMap                    `json:"healthcheck" gorm:"type:text"`
	EnvVars             StringArray                `json:"env_vars" gorm:"type:text"`
	Secrets             StringArray                `json:"secrets" gorm:"type:text" validate:"-"`
	Stats               ContainerStats             `json:"stats" gorm:"-"`
	Processes           []Process                  `json:"processes" gorm:"-"`
	DetailedNetworkInfo map[string]DetailedNetwork `json:"detailed_network_info" gorm:"-"`
	DetailedVolumeInfo  map[string]DetailedVolume  `json:"detailed_volume_info" gorm:"-"`
	// Fields from list item conversion (might be redundant with inspect)
	Names      []string `json:"names" gorm:"-"`
	Image      string   `json:"image" gorm:"-"`
	State      string   `json:"state" gorm:"-"` // Raw state string
	SizeRw     int64    `json:"size_rw,omitempty" gorm:"-"`
	SizeRootFs int64    `json:"size_root_fs,omitempty" gorm:"-"`
	// Fields from inspect conversion (might be redundant)
	Entrypoint     []string       `json:"entrypoint" gorm:"-"`
	WorkingDir     string         `json:"working_dir" gorm:"-"`
	User           string         `json:"user" gorm:"-"`
	ExposedPorts   []string       `json:"exposed_ports" gorm:"-"`
	RestartCount   int            `json:"restart_count" gorm:"-"`
	Platform       string         `json:"platform" gorm:"-"`
	Health         string         `json:"health,omitempty" gorm:"-"`
	HealthLog      string         `json:"health_log,omitempty" gorm:"-"`
	Running        bool           `json:"running" gorm:"-"`
	Paused         bool           `json:"paused" gorm:"-"`
	Restarting     bool           `json:"restarting" gorm:"-"`
	OOMKilled      bool           `json:"oom_killed" gorm:"-"`
	Dead           bool           `json:"dead" gorm:"-"`
	StartedAt      time.Time      `json:"started_at,omitempty" gorm:"-"`
	FinishedAt     time.Time      `json:"finished_at,omitempty" gorm:"-"`
	UpTime         string         `json:"up_time,omitempty" gorm:"-"`
	Mounts         []MountPoint   `json:"mounts" gorm:"-"`
	ResourceLimits ResourceLimits `json:"resource_limits" gorm:"-"`
	SecurityInfo   SecurityInfo   `json:"security_info" gorm:"-"`
}

type ContainerCreateRequest struct {
	// Name is the name to assign to the new container.
	// required: true
	// example: "my-nginx-container"
	Name string `json:"name" binding:"required" example:"my-nginx-container"`

	// Image is the name or ID of the Docker image to use.
	// required: true
	// example: "nginx:latest"
	Image string `json:"image" binding:"required" example:"nginx:latest"`

	// Command is the command to run when the container starts.
	// example: ["nginx", "-g", "daemon off;"]
	Command []string `json:"command" example:"nginx,-g,daemon off;"`

	// Entrypoint overrides the default entrypoint of the image.
	// example: ["/docker-entrypoint.sh"]
	Entrypoint []string `json:"entrypoint" example:"/docker-entrypoint.sh"`

	// Env is a list of environment variables to set in the container (e.g., "VAR=value").
	// example: ["NGINX_HOST=example.com", "NGINX_PORT=80"]
	Env []string `json:"env" example:"NGINX_HOST=example.com,NGINX_PORT=80"`

	// Labels are key-value pairs to apply to the container.
	// example: {"environment": "development", "app": "webserver"}
	Labels map[string]string `json:"labels" example:"environment:development,app:webserver"`

	// Ports specifies the port mappings between the host and the container.
	Ports []PortMapping `json:"ports"`

	// Volumes specifies the volume mappings between the host/named volumes and the container.
	Volumes []VolumeMapping `json:"volumes"`

	// Networks is a list of network names or IDs to connect the container to.
	// example: ["my-app-network"]
	Networks []string `json:"networks" example:"my-app-network"`

	// RestartPolicy defines the container's behavior when it exits.
	// example: "unless-stopped"
	RestartPolicy string `json:"restart_policy" binding:"omitempty,oneof=no on-failure always unless-stopped" example:"unless-stopped"`

	// MemoryLimit is the maximum amount of memory the container can use (in bytes).
	// example: 104857600 (100MB)
	MemoryLimit int64 `json:"memory_limit" example:"104857600"` // 100MB

	// CPULimit specifies the CPU quota for the container (e.g., 1.5 means 1.5 CPU cores). Docker uses NanoCPUs (1e9 per core).
	// example: 1.5
	CPULimit float64 `json:"cpu_limit" example:"1.5"` // 1.5 CPU cores

	// Privileged gives the container extended privileges on the host. Use with caution.
	// example: false
	Privileged bool `json:"privileged" example:"false"`

	// AutoRemove automatically removes the container when it exits.
	// example: false
	AutoRemove bool `json:"auto_remove" example:"false"`

	// Notes are user-defined notes for the container (stored in application DB).
	// example: "Main web server container."
	Notes string `json:"notes" example:"Main web server container."`
}

type ContainerExecCreateRequest struct {
	// Command is the command to execute in the container, with arguments.
	// required: true
	// example: ["/bin/bash", "-c", "echo hello"]
	Command []string `json:"command" binding:"required" example:"/bin/bash,-c,echo hello"`

	// AttachStdin specifies whether to attach stdin to the exec command.
	// example: false
	AttachStdin bool `json:"attach_stdin" example:"false"`

	// AttachStdout specifies whether to attach stdout to the exec command.
	// example: true
	AttachStdout bool `json:"attach_stdout" example:"true"`

	// AttachStderr specifies whether to attach stderr to the exec command.
	// example: true
	AttachStderr bool `json:"attach_stderr" example:"true"`

	// DetachKeys specifies the key sequence for detaching from the exec session.
	// example: "ctrl-p,ctrl-q"
	DetachKeys string `json:"detach_keys" example:"ctrl-p,ctrl-q"`

	// Tty specifies whether to allocate a pseudo-TTY for the exec command. Required for interactive sessions.
	// example: false
	Tty bool `json:"tty" example:"false"`

	// Env specifies environment variables to set in the exec command's environment.
	// example: ["VAR1=value1", "VAR2=value2"]
	Env []string `json:"env" example:"VAR1=value1,VAR2=value2"`

	// Privileged specifies whether to run the exec command in privileged mode.
	// example: false
	Privileged bool `json:"privileged" example:"false"`

	// WorkingDir specifies the working directory inside the container for the exec command.
	// example: "/app"
	WorkingDir string `json:"working_dir" example:"/app"`
}

type ContainerExecResizeRequest struct {
	ExecID string `json:"exec_id" binding:"required" example:"a1b2c3d4e5f6"`
	Height int    `json:"height" binding:"required,gt=0" example:"24"`
	Width  int    `json:"width" binding:"required,gt=0" example:"80"`
}

type ContainerExecResponse struct {
	// ID is the unique identifier of the exec instance.
	// required: true
	// example: "a1b2c3d4e5f6..."
	ID string `json:"id" example:"a1b2c3d4e5f6"`

	// Running indicates whether the exec process is currently running.
	// required: true
	// example: false
	Running bool `json:"running" example:"false"`

	// ExitCode is the exit code of the exec process. Only available after the process has finished.
	// example: 0
	ExitCode int `json:"exit_code" example:"0"`

	// ProcessConfig holds the configuration of the process executed.
	ProcessConfig struct {
		// EntryPoint is the entry point for the executed command.
		// example: "/bin/sh"
		EntryPoint string `json:"entrypoint" example:"/bin/sh"`
		// Arguments are the arguments passed to the command.
		// example: ["-c", "echo hello"]
		Arguments []string `json:"arguments" example:"-c,echo hello"`
		// Tty indicates if a TTY was allocated for the process.
		// example: false
		Tty bool `json:"tty" example:"false"`
		// Privileged indicates if the process ran with elevated privileges.
		// example: false
		Privileged bool `json:"privileged" example:"false"`
	} `json:"process_config"`

	// OpenStdin indicates if stdin was attached to the process.
	// required: true
	// example: false
	OpenStdin bool `json:"open_stdin" example:"false"`

	// OpenStderr indicates if stderr was attached to the process.
	// required: true
	// example: true
	OpenStderr bool `json:"open_stderr" example:"true"`

	// OpenStdout indicates if stdout was attached to the process.
	// required: true
	// example: true
	OpenStdout bool `json:"open_stdout" example:"true"`

	// ContainerID is the ID of the container where the exec instance ran.
	// required: true
	// example: "f7d9e8c7b6a5..."
	ContainerID string `json:"container_id" example:"f7d9e8c7b6a5"`

	// CreatedAt is the timestamp when the exec instance was created (Note: Docker API might not provide this directly in inspect).
	// example: "2023-10-27T10:00:00Z"
	CreatedAt time.Time `json:"created_at,omitempty"`
}

type ContainerExecStartRequest struct {
	ExecID      string `json:"exec_id" binding:"required" example:"a1b2c3d4e5f6"`
	Tty         bool   `json:"tty" example:"true"`
	DetachKeys  string `json:"detach_keys" example:"ctrl-p,ctrl-q"`
	StdinBase64 string `json:"stdin_base64" example:"aGVsbG8gd29ybGQK"` // Base64 encoded input for non-websocket start
}

type ContainerExecStartResponse struct {
	ExecID   string `json:"exec_id"`
	Output   string `json:"output"` // Base64 encoded stdout
	Error    string `json:"error"`  // Base64 encoded stderr
	ExitCode int    `json:"exit_code"`
	Running  bool   `json:"running"`
}

type ContainerHealth struct {
	Status        string      `json:"status"`
	FailingStreak int         `json:"failing_streak"`
	Log           []HealthLog `json:"log"`
}

type ContainerListRequest struct {
	PaginationRequest
	SortRequest
	FilterRequest
	All       bool   `json:"all" form:"all" example:"false"`
	Status    string `` /* 134-byte string literal not displayed */
	ImageID   string `json:"image_id" form:"image_id" example:"sha256:a1b2c3d4..."`
	NetworkID string `json:"network_id" form:"network_id" example:"net_abc123"`
	VolumeID  string `json:"volume_id" form:"volume_id" example:"vol_def456"`
}

type ContainerListResponse struct {
	// Containers is the list of container objects returned for the current page.
	// required: true
	Containers []ContainerResponse `json:"containers"`

	// Metadata contains pagination and other metadata for the response.
	// required: true
	Metadata MetadataResponse `json:"metadata"`
}

type ContainerLogResponse struct {
	Logs       string    `json:"logs" example:"Log line 1\nLog line 2"`
	Timestamps bool      `json:"timestamps" example:"true"`
	Since      time.Time `json:"since,omitempty" example:"2023-10-27T10:00:00Z"`
	Until      time.Time `json:"until,omitempty" example:"2023-10-27T11:00:00Z"`
	Tail       string    `json:"tail,omitempty" example:"100"`
}

type ContainerLogsRequest struct {
	// Follow streams the logs in real-time.
	// example: false
	Follow bool `json:"follow" form:"follow" example:"false"`

	// Since shows logs since a specific timestamp (RFC3339 or Unix timestamp) or relative duration (e.g., "10m").
	// example: "2023-10-27T10:00:00Z"
	Since time.Time `json:"since" form:"since" time_format:"rfc3339" example:"2023-10-27T10:00:00Z"` // Added time_format

	// Until shows logs before a specific timestamp (RFC3339 or Unix timestamp) or relative duration (e.g., "5m").
	// example: "2023-10-27T11:00:00Z"
	Until time.Time `json:"until" form:"until" time_format:"rfc3339" example:"2023-10-27T11:00:00Z"` // Added time_format

	// Timestamps includes timestamps for each log line.
	// example: true
	Timestamps bool `json:"timestamps" form:"timestamps" example:"true"`

	// Tail specifies the number of lines to show from the end of the logs (e.g., "100" or "all").
	// example: "100"
	Tail string `json:"tail" form:"tail" example:"100"`

	// ShowStdout includes stdout logs. Defaults to true if neither stdout nor stderr is specified.
	// example: true
	ShowStdout bool `json:"stdout" form:"stdout" example:"true"`

	// ShowStderr includes stderr logs. Defaults to true if neither stdout nor stderr is specified.
	// example: true
	ShowStderr bool `json:"stderr" form:"stderr" example:"true"`
}

type ContainerRenameRequest struct {
	// Name is the new name to assign to the container. Must be unique.
	// required: true
	// example: "my-renamed-nginx"
	Name string `json:"name" binding:"required" example:"my-renamed-nginx"`
}

type ContainerResponse struct {
	// ID is the internal database ID (if managed by the application).
	// example: 101
	ID uint `json:"id" example:"101"`

	// ContainerID is the unique identifier assigned by Docker.
	// required: true
	// example: "f7d9e8c7b6a5..."
	ContainerID string `json:"container_id" example:"f7d9e8c7b6a5"`

	// Name is the user-defined name of the container.
	// required: true
	// example: "my-nginx-container"
	Name string `json:"name" example:"my-nginx-container"`

	// Image is the name of the image used by the container.
	// required: true
	// example: "nginx:latest"
	Image string `json:"image" example:"nginx:latest"`

	// ImageID is the ID of the image used by the container.
	// required: true
	// example: "sha256:a1b2c3d4..."
	ImageID string `json:"image_id" example:"sha256:a1b2c3d4..."`

	// Command is the command executed when the container started.
	// example: "nginx -g daemon off;"
	Command string `json:"command" example:"nginx -g daemon off;"`

	// Status is a simplified status string (e.g., running, stopped).
	// required: true
	// example: "running"
	Status ContainerStatus `json:"status" example:"running"`

	// State is the detailed state string from Docker (e.g., "running", "exited (0)").
	// required: true
	// example: "running"
	State string `json:"state" example:"running"`

	// Created is the timestamp when the container was created by Docker.
	// required: true
	// example: "2023-10-27T10:00:00Z"
	Created time.Time `json:"created" example:"2023-10-27T10:00:00Z"`

	// Started is the timestamp when the container was last started.
	// example: "2023-10-27T10:01:00Z"
	Started time.Time `json:"started,omitempty" example:"2023-10-27T10:01:00Z"`

	// Finished is the timestamp when the container last finished.
	// example: "2023-10-27T11:00:00Z"
	Finished time.Time `json:"finished,omitempty" example:"2023-10-27T11:00:00Z"`

	// Ports lists the port mappings for the container.
	Ports []PortMapping `json:"ports"`

	// Volumes lists the volume mounts for the container.
	Volumes []VolumeMountResponse `json:"volumes"`

	// Networks lists the network connections for the container.
	Networks []NetworkConnectionResponse `json:"networks"`

	// Labels are the labels applied to the container.
	// example: {"environment": "development"}
	Labels map[string]string `json:"labels" example:"environment:development"`

	// RestartPolicy is the restart policy applied to the container.
	// example: "unless-stopped"
	RestartPolicy string `json:"restart_policy" example:"unless-stopped"`

	// Platform is the platform string (e.g., "linux/amd64").
	// example: "linux/amd64"
	Platform string `json:"platform" example:"linux/amd64"`

	// HostConfig contains details about the container's host configuration.
	HostConfig *HostConfigResponse `json:"host_config,omitempty"`

	// Stats contains the latest resource usage statistics (if requested/available).
	Stats *ContainerStatsResponse `json:"stats,omitempty"`

	// Notes are user-defined notes stored in the application database.
	// example: "Main web server container."
	Notes string `json:"notes" example:"Main web server container."`

	// UserID is the ID of the user who owns/created this container record in the application database.
	// required: true
	// example: 1
	UserID uint `json:"user_id" example:"1"`

	// CreatedAt is the timestamp when the container record was created in the application database.
	// required: true
	// example: "2023-10-27T10:00:05Z"
	CreatedAt time.Time `json:"created_at" example:"2023-10-27T10:00:05Z"`

	// UpdatedAt is the timestamp when the container record was last updated in the application database.
	// required: true
	// example: "2023-10-27T10:05:00Z"
	UpdatedAt time.Time `json:"updated_at" example:"2023-10-27T10:05:00Z"`
}

type ContainerStartRequest struct {
	CheckpointID string `json:"checkpoint_id" example:"my-checkpoint"`
}

type ContainerStats struct {
	Time             time.Time `json:"time"`
	CPUPercentage    float64   `json:"cpu_percentage"`
	CPUUsage         uint64    `json:"cpu_usage"`
	SystemCPUUsage   uint64    `json:"system_cpu_usage"`
	OnlineCPUs       uint32    `json:"online_cpus"`
	MemoryUsage      uint64    `json:"memory_usage"`
	MemoryMaxUsage   uint64    `json:"memory_max_usage"`
	MemoryLimit      uint64    `json:"memory_limit"`
	MemoryPercentage float64   `json:"memory_percentage"`
	NetworkRx        int64     `json:"network_rx"`
	NetworkTx        int64     `json:"network_tx"`
	BlockRead        int64     `json:"block_read"`
	BlockWrite       int64     `json:"block_write"`
	PIDs             uint64    `json:"pids"`
}

type ContainerStatsResponse struct {
	// CPUPercentage is the container's CPU usage percentage across all cores.
	// required: true
	// example: 12.34
	CPUPercentage float64 `json:"cpu_percentage" example:"12.34"`

	// MemoryUsage is the current memory usage in bytes.
	// required: true
	// example: 52428800
	MemoryUsage int64 `json:"memory_usage" example:"52428800"`

	// MemoryLimit is the memory limit for the container in bytes.
	// required: true
	// example: 104857600
	MemoryLimit int64 `json:"memory_limit" example:"104857600"`

	// MemoryPercentage is the current memory usage as a percentage of the limit.
	// required: true
	// example: 50.0
	MemoryPercentage float64 `json:"memory_percentage" example:"50.0"`

	// NetworkRx is the total bytes received over the network by the container.
	// required: true
	// example: 1024000
	NetworkRx int64 `json:"network_rx" example:"1024000"`

	// NetworkTx is the total bytes transmitted over the network by the container.
	// required: true
	// example: 512000
	NetworkTx int64 `json:"network_tx" example:"512000"`

	// BlockRead is the total bytes read from block devices by the container.
	// required: true
	// example: 204800
	BlockRead int64 `json:"block_read" example:"204800"`

	// BlockWrite is the total bytes written to block devices by the container.
	// required: true
	// example: 102400
	BlockWrite int64 `json:"block_write" example:"102400"`

	// PIDs is the number of processes currently running in the container.
	// required: true
	// example: 5
	PIDs int `json:"pids" example:"5"`

	// Timestamp is the time when the stats were collected.
	// required: true
	// example: "2023-10-27T10:15:00Z"
	Timestamp time.Time `json:"timestamp" example:"2023-10-27T10:15:00Z"`
}

type ContainerStatus string

type ContainerStopRequest struct {
	Timeout int `json:"timeout" binding:"omitempty,gte=0" example:"10"` // Seconds
}

type DeployOptions struct {
	ProjectName           string
	Timeout               time.Duration
	ForceRecreate         bool
	NoBuild               bool
	NoStart               bool
	Pull                  bool
	RemoveOrphans         bool
	DependencyTimeout     time.Duration
	AdjustNetworkSettings bool
	Logger                *logrus.Logger
}

type DeploymentInfo struct {
	// ProjectName is the name of the Compose project.
	// required: true
	// example: "my-web-app"
	ProjectName string `json:"projectName"`

	// Status is the overall status of the deployment.
	// required: true
	// example: "running"
	Status DeploymentStatus `json:"status"`

	// Services maps service names to their detailed status information.
	// required: true
	Services map[string]*ServiceInfo `json:"services"`

	// Operation describes the currently active operation (e.g., up, down), if any.
	Operation *OperationInfo `json:"operation,omitempty"`

	// StartTime is the timestamp when the deployment was first tracked or started.
	// required: true
	// example: "2023-10-27T10:00:00Z"
	StartTime time.Time `json:"startTime"`

	// UpdateTime is the timestamp when the deployment status was last updated.
	// required: true
	// example: "2023-10-27T10:05:00Z"
	UpdateTime time.Time `json:"updateTime"`

	// Error contains the last error message associated with the deployment, if any.
	// example: "Failed to pull image 'nonexistent:latest'"
	Error string `json:"error,omitempty"` // Store error message as string

	// ComposeFile is the parsed representation of the compose file (excluded from JSON).
	ComposeFile *ComposeFile `json:"-"` // Avoid recursion in JSON, maybe store path?
}

type DeploymentStatus string

type DeploymentUpdate struct {
	ProjectName string      `json:"project_name"`
	ServiceName string      `json:"service_name,omitempty"` // Empty if it's a project-level update
	Status      interface{} `json:"status"`                 // Can be DeploymentStatus or ServiceStatus
	Timestamp   time.Time   `json:"timestamp"`
	Error       string      `json:"error,omitempty"`
	Details     interface{} `json:"details,omitempty"` // Additional details (e.g., health status)
}

type DetailedNetwork struct {
	Name       string  `json:"name"`
	ID         string  `json:"id"`
	Driver     string  `json:"driver"`
	Scope      string  `json:"scope"`
	Internal   bool    `json:"internal"`
	IPAMConfig IPAM    `json:"ipam_config"` // Use local models.IPAM
	Options    JSONMap `json:"options"`
	Labels     JSONMap `json:"labels"`
}

type DetailedVolume struct {
	Name       string  `json:"name"`
	Driver     string  `json:"driver"`
	Mountpoint string  `json:"mountpoint"`
	Status     JSONMap `json:"status"`
	Labels     JSONMap `json:"labels"`
	Options    JSONMap `json:"options"`
	Scope      string  `json:"scope"`
}

type DockerContainer struct {
	ID              string                    `json:"id"`
	Name            string                    `json:"name"`
	Image           string                    `json:"image"`
	ImageID         string                    `json:"image_id"`
	Command         string                    `json:"command"`
	Created         time.Time                 `json:"created"`
	Started         time.Time                 `json:"started,omitempty"`
	Finished        time.Time                 `json:"finished,omitempty"`
	State           *types.ContainerState     `json:"state,omitempty"` // Use pointer to Docker SDK State struct from types package
	Status          string                    `json:"status"`
	Health          *ContainerHealth          `json:"health,omitempty"` // Assuming this is a custom local type
	ExitCode        int                       `json:"exit_code"`
	Error           string                    `json:"error,omitempty"`
	Ports           []PortMapping             `json:"ports"` // Use PortMapping from docker_entities.go
	Labels          map[string]string         `json:"labels"`
	Mounts          []MountPoint              `json:"mounts"` // Use MountPoint from docker_entities.go
	NetworkSettings NetworkSettings           `json:"network_settings"`
	Config          *container.Config         `json:"config,omitempty"`
	HostConfig      *container.HostConfig     `json:"host_config,omitempty"`
	NetworkConfig   *network.NetworkingConfig `json:"network_config,omitempty"`
	Platform        *specs.Platform           `json:"platform,omitempty"`
	Stats           *ContainerStats           `json:"stats,omitempty"` // Use ContainerStats from docker_entities.go
	LogsSize        int64                     `json:"logs_size,omitempty"`
	SizeRw          int64                     `json:"size_rw,omitempty"`
	SizeRootFs      int64                     `json:"size_root_fs,omitempty"`
	RestartCount    int                       `json:"restart_count"`
	IsManaged       bool                      `json:"is_managed"`
	IsMonitored     bool                      `json:"is_monitored"`
	ComposeProject  string                    `json:"compose_project,omitempty"`
	ComposeService  string                    `json:"compose_service,omitempty"`
}

type DockerEvent struct {
	ID           uint      `json:"id" gorm:"primaryKey"`
	Type         string    `json:"type" gorm:"index;size:64" validate:"required,max=64"`
	Action       string    `json:"action" gorm:"index;size:64" validate:"required,max=64"`
	Actor        string    `json:"actor" gorm:"index;size:64" validate:"required,max=64"` // Usually container ID
	ActorID      string    `json:"actor_id" gorm:"index;size:64" validate:"required,max=64"`
	Attributes   JSONMap   `json:"attributes" gorm:"type:text"`
	Scope        string    `json:"scope" gorm:"index;size:64" validate:"max=64"`
	Timestamp    time.Time `json:"timestamp" gorm:"index"`
	TimeNano     int64     `json:"time_nano"`
	HostID       uint      `json:"host_id" gorm:"index"` // Link to DockerHost if managing multiple hosts
	HostName     string    `json:"host_name" gorm:"size:255"`
	Acknowledged bool      `json:"acknowledged" gorm:"index;default:false"`
	CreatedAt    time.Time `json:"created_at"`
}

type DockerHost struct {
	ID            uint           `json:"id" gorm:"primaryKey"`
	Name          string         `json:"name" gorm:"uniqueIndex;size:255" validate:"required,max=255,alphanumdash"`
	Host          string         `json:"host" validate:"required"` // e.g., "unix:///var/run/docker_test.sock" or "tcp://192.168.1.100:2376"
	TLSEnabled    bool           `json:"tls_enabled"`
	TLSCertPath   string         `json:"tls_cert_path" validate:"omitempty,filepath"`
	TLSKeyPath    string         `json:"tls_key_path" validate:"omitempty,filepath"`
	TLSCACertPath string         `json:"tls_ca_cert_path" validate:"omitempty,filepath"`
	TLSVerify     bool           `json:"tls_verify"`
	Username      string         `json:"username" validate:"omitempty,max=255"`
	Password      string         `json:"-" validate:"omitempty"` // Store securely, don't expose in JSON
	RegistryToken string         `json:"-" validate:"omitempty"` // Store securely
	Status        string         `json:"status" gorm:"size:64" validate:"max=64"`
	LastChecked   time.Time      `json:"last_checked"`
	Version       string         `json:"version" gorm:"size:64" validate:"max=64"`
	APIVersion    string         `json:"api_version" gorm:"size:64" validate:"max=64"`
	Default       bool           `json:"default" gorm:"index"`
	Notes         string         `json:"notes" gorm:"type:text" validate:"max=5000"`
	CreatedAt     time.Time      `json:"created_at"`
	UpdatedAt     time.Time      `json:"updated_at"`
	DeletedAt     gorm.DeletedAt `json:"-" gorm:"index"`
}

type DockerResource struct {
	ID        uint           `json:"id" gorm:"primaryKey"`
	UserID    uint           `json:"user_id" gorm:"index" validate:"required"`
	User      User           `json:"-" gorm:"foreignKey:UserID"`
	Name      string         `json:"name" gorm:"index;size:255" validate:"required,max=255,alphanumdash"`
	Labels    JSONMap        `json:"labels" gorm:"type:text"`
	Notes     string         `json:"notes" gorm:"type:text" validate:"max=5000"`
	CreatedAt time.Time      `json:"created_at"`
	UpdatedAt time.Time      `json:"updated_at"`
	DeletedAt gorm.DeletedAt `json:"-" gorm:"index"`
}

type EndpointIPAMConfigRequest struct {
	// IPv4Address is the static IPv4 address to assign to the container.
	// example: 172.28.5.10
	IPv4Address string `json:"ipv4_address" example:"172.20.10.5"`

	// IPv6Address is the static IPv6 address to assign to the container.
	// example: "2001:db8:abcd::10"
	IPv6Address string `json:"ipv6_address" example:"2001:db8:abcd::5"`
}

type EndpointResource struct {
	Name        string `json:"name"`
	EndpointID  string `json:"endpoint_id"`
	MacAddress  string `json:"mac_address"`
	IPv4Address string `json:"ipv4_address"`
	IPv6Address string `json:"ipv6_address"`
}

type EndpointSettings struct {
	IPAddress           string   `json:"ip_address"`
	IPPrefixLen         int      `json:"ip_prefix_len"`
	Gateway             string   `json:"gateway"`
	MacAddress          string   `json:"mac_address"`
	NetworkID           string   `json:"network_id"`
	EndpointID          string   `json:"endpoint_id"`
	GlobalIPv6Address   string   `json:"global_ipv6_address"`
	GlobalIPv6PrefixLen int      `json:"global_ipv6_prefix_len"`
	IPv6Gateway         string   `json:"ipv6_gateway"`
	Links               []string `json:"links"`
	Aliases             []string `json:"aliases"`
}

type EndpointSettingsRequest struct {
	// IPAMConfig allows specifying a static IP address for the container in this network.
	IPAMConfig *EndpointIPAMConfigRequest `json:"ipam_config"`

	// Aliases are network-scoped aliases for the container.
	// example: ["web", "frontend"]
	Aliases []string `json:"aliases" example:"app,web"`
}

type ErrorInfo struct {
	// Code is a machine-readable error code identifying the specific error type.
	// required: true
	// example: RESOURCE_NOT_FOUND
	Code string `json:"code" example:"RESOURCE_NOT_FOUND"`

	// Message is a human-readable description of the error.
	// required: true
	// example: The requested container was not found.
	Message string `json:"message" example:"The requested container was not found."`

	// Details provides optional additional information about the error, such as validation failures.
	// example: {"field": "command", "error": "cannot be empty"}
	Details interface{} `json:"details,omitempty"`
}

type ErrorResponse struct {
	// Success indicates if the request was successful (always false for errors).
	// required: true
	// example: false
	Success bool `json:"success" example:"false"`

	// Error contains the detailed error information.
	// required: true
	Error ErrorInfo `json:"error"`

	// Meta contains metadata about the response.
	// required: true
	Meta MetadataResponse `json:"meta"`
}

type EventListResponse struct {
	Events   []EventResponse  `json:"events"`
	Metadata MetadataResponse `json:"metadata"`
}

type EventResponse struct {
	ID           uint              `json:"id"`
	Type         string            `json:"type" example:"container"` // e.g., container, image, volume, network
	Action       string            `json:"action" example:"start"`   // e.g., create, start, stop, die, pull, tag, prune
	Actor        string            `json:"actor"`
	ActorID      string            `json:"actor_id"`
	Attributes   map[string]string `json:"attributes,omitempty"`
	Scope        string            `json:"scope"`
	Timestamp    time.Time         `json:"timestamp" example:"2023-10-27T10:01:00Z"`
	TimeNano     int64             `json:"time_nano"`
	HostID       uint              `json:"host_id"`
	HostName     string            `json:"host_name"`
	Acknowledged bool              `json:"acknowledged"`
}

type FileEditRequest struct {
	// Path is the absolute path to the file inside the container.
	// required: true
	// example: "/app/config.json"
	Path string `json:"path" binding:"required" example:"/app/config.json"`

	// Content is the new content for the file, encoded in Base64.
	// required: true
	// example: "ewogICJhcGlLZXkiOiAiYWJjMTIzIgp9Cg=="
	Content string `json:"content" binding:"required" example:"ewogICJhcGlLZXkiOiAiYWJjMTIzIgp9Cg=="` // Base64 encoded content

	// Create specifies whether to create the file if it doesn't exist. Defaults to false.
	// example: false
	Create bool `json:"create" example:"false"` // Flag to create the file if it doesn't exist
}

type FilterRequest struct {
	Search    string            `json:"search" form:"search" example:"my-app"`
	Filters   map[string]string `json:"filters" form:"filters" example:"label=production,status=running"`
	StartDate *time.Time        `json:"start_date" form:"start_date" format:"date-time" example:"2023-10-26T00:00:00Z"`
	EndDate   *time.Time        `json:"end_date" form:"end_date" format:"date-time" example:"2023-10-27T23:59:59Z"`
}

type HealthInfo struct {
	// Status indicates the current health status (e.g., "healthy", "unhealthy", "starting").
	// required: true
	// example: "healthy"
	Status string `json:"status"`

	// FailingStreak is the number of consecutive failed health checks.
	// required: true
	// example: 0
	FailingStreak int `json:"failingStreak"`

	// Log contains recent health check probe results.
	Log []HealthLogEntry `json:"log,omitempty"`
}

type HealthLog struct {
	Start    time.Time `json:"start"`
	End      time.Time `json:"end"`
	ExitCode int       `json:"exit_code"`
	Output   string    `json:"output"`
}

type HealthLogEntry struct {
	// Start is the timestamp when the health check probe started.
	// required: true
	// example: "2023-10-27T10:05:50Z"
	Start time.Time `json:"start"`

	// End is the timestamp when the health check probe ended.
	// required: true
	// example: "2023-10-27T10:05:51Z"
	End time.Time `json:"end"`

	// ExitCode is the exit code of the health check command. 0 typically indicates success.
	// required: true
	// example: 0
	ExitCode int `json:"exitCode"`

	// Output contains the stdout/stderr output from the health check command.
	// example: "OK"
	Output string `json:"output,omitempty"`
}

type HostConfigResponse struct {
	// CPUShares is the relative CPU weight (vs. other containers).
	// example: 1024
	CPUShares int64 `json:"cpu_shares,omitempty" example:"1024"`

	// Memory is the memory limit in bytes. 0 means no limit.
	// example: 104857600
	Memory int64 `json:"memory,omitempty" example:"104857600"`

	// MemorySwap is the total memory (memory + swap). -1 means unlimited swap.
	// example: -1
	MemorySwap int64 `json:"memory_swap,omitempty" example:"-1"`

	// CPUPeriod is the CPU CFS period in microseconds.
	// example: 100000
	CPUPeriod int64 `json:"cpu_period,omitempty" example:"100000"`

	// CPUQuota is the CPU CFS quota in microseconds.
	// example: 50000
	CPUQuota int64 `json:"cpu_quota,omitempty" example:"50000"`

	// CpusetCpus specifies the CPUs the container can use (e.g., "0-3", "0,1").
	// example: "0,1"
	CpusetCpus string `json:"cpuset_cpus,omitempty" example:"0,1"`

	// CpusetMems specifies the memory nodes the container can use.
	// example: "0"
	CpusetMems string `json:"cpuset_mems,omitempty" example:"0"`

	// BlkioWeight is the block I/O weight (relative weight).
	// example: 500
	BlkioWeight uint16 `json:"blkio_weight,omitempty" example:"500"`

	// Privileged indicates if the container runs in privileged mode.
	// required: true
	// example: false
	Privileged bool `json:"privileged" example:"false"`

	// ReadonlyRootfs indicates if the container's root filesystem is read-only.
	// required: true
	// example: false
	ReadonlyRootfs bool `json:"readonly_rootfs" example:"false"`

	// SecurityOpt lists the security options applied to the container.
	// example: ["seccomp=unconfined"]
	SecurityOpt []string `json:"security_opt,omitempty" example:"seccomp=unconfined"`

	// CapAdd lists the capabilities added to the container.
	// example: ["NET_ADMIN"]
	CapAdd []string `json:"cap_add,omitempty" example:"NET_ADMIN"`

	// CapDrop lists the capabilities dropped from the container.
	// example: ["MKNOD"]
	CapDrop []string `json:"cap_drop,omitempty" example:"MKNOD"`

	// RestartPolicy is the full restart policy string (e.g., "unless-stopped").
	// required: true
	// example: "unless-stopped"
	RestartPolicy string `json:"restart_policy" example:"unless-stopped"`

	// NetworkMode is the network mode used by the container (e.g., "bridge", "host").
	// required: true
	// example: "bridge"
	NetworkMode string `json:"network_mode" example:"bridge"`
}

type IPAM struct {
	Driver  string       `json:"driver"`
	Options JSONMap      `json:"options"`
	Config  []IPAMConfig `json:"config"`
}

type IPAMConfig struct {
	Subnet     string  `json:"subnet"`
	IPRange    string  `json:"ip_range"`
	Gateway    string  `json:"gateway"`
	AuxAddress JSONMap `json:"aux_address"`
}

type IPAMConfigRequest struct {
	// Subnet in CIDR format that represents a network segment.
	// example: 172.28.0.0/16
	Subnet string `json:"subnet" example:"172.20.0.0/16"`

	// IPRange specifies a range of IP addresses for containers in CIDR format.
	// example: 172.28.5.0/24
	IPRange string `json:"ip_range" example:"172.20.10.0/24"`

	// Gateway is the IPv4 or IPv6 gateway for the subnet.
	// example: 172.28.5.254
	Gateway string `json:"gateway" example:"172.20.0.1"`

	// AuxAddress is a map of auxiliary addresses used by the IPAM driver.
	// example: {"host1": "172.28.1.5"}
	AuxAddress map[string]string `json:"aux_address"`
}

type IPAMCreateRequest struct {
	// Driver specifies the IPAM driver to use (e.g., "default").
	// example: default
	Driver string `json:"driver" example:"default"`

	// Options are IPAM driver specific options.
	Options map[string]string `json:"options"` // Example removed due to swag parsing issues

	// Config is a list of IPAM configurations, each specifying subnet, gateway, etc.
	Config []IPAMConfigRequest `json:"config"`
}

type Image struct {
	DockerResource
	ImageID         string      `json:"image_id" gorm:"index;size:128" validate:"required"` // Docker Image ID (sha256:...) - Increased size
	Repository      string      `json:"repository" gorm:"index;size:255" validate:"required,max=255"`
	Tag             string      `json:"tag" gorm:"index;size:128" validate:"required,max=128"`
	Digest          string      `json:"digest" gorm:"index;size:255" validate:"omitempty,max=255"`
	Size            int64       `json:"size" validate:"min=0"`
	Created         time.Time   `json:"created"`
	Author          string      `json:"author" validate:"max=255"`
	Architecture    string      `json:"architecture" validate:"max=64"`
	OS              string      `json:"os" validate:"max=64"`
	Containers      []Container `json:"-" gorm:"foreignKey:ImageID;references:ImageID"`
	LastInspected   time.Time   `json:"last_inspected"`
	ContentTrust    bool        `json:"content_trust"`
	SignatureInfo   JSONMap     `json:"signature_info" gorm:"type:text"`
	Vulnerabilities JSONMap     `json:"vulnerabilities" gorm:"type:text"`
}

type ImageBuildRequest struct {
	Repository    string                `json:"repository" binding:"required" example:"my-custom-app"`
	Tag           string                `json:"tag" example:"v1.0"`
	Dockerfile    string                `json:"dockerfile" example:"Dockerfile.prod"`
	Context       string                `json:"context" example:"."`               // Path to build context (directory)
	ContextFile   *multipart.FileHeader `json:"context_file" swaggerignore:"true"` // Use multipart form for context upload
	BuildArgs     map[string]string     `json:"build_args" example:"VERSION=1.0,API_KEY=abcdef"`
	Labels        map[string]string     `json:"labels" example:"maintainer=devteam,project=webapp"`
	NoCache       bool                  `json:"no_cache" example:"false"`
	Pull          bool                  `json:"pull" example:"true"` // Attempt to pull newer image layers
	RemoteContext string                `json:"remote_context" example:"git://github.com/user/repo.git#main:subdir"`
}

type ImageBuildResponse struct {
	// Success indicates if the build operation completed successfully (may not mean the image is usable if errors occurred during build).
	// required: true
	// example: true
	Success bool `json:"success"`

	// ImageID is the Docker Image ID (SHA256 digest) of the built image, if successful.
	// example: "sha256:c3d4e5f6..."
	ImageID string `json:"image_id,omitempty" example:"sha256:b1c2d3e4..."`

	// Repository is the repository name used for tagging.
	// example: "my-custom-app"
	Repository string `json:"repository,omitempty"`

	// Tag is the tag applied to the built image.
	// example: "v1.1"
	Tag string `json:"tag,omitempty"`

	// Logs contains the output stream from the Docker build process.
	Logs []string `json:"logs,omitempty"`

	// ErrorDetail contains specific error information if the build failed.
	// example: "failed to solve: rpc error: code = Unknown desc = executor failed running..."
	ErrorDetail string `json:"error_detail,omitempty"`

	// StartTime is the timestamp when the build process started.
	// required: true
	// example: "2023-10-27T11:00:00Z"
	StartTime time.Time `json:"start_time"`

	// EndTime is the timestamp when the build process finished.
	// required: true
	// example: "2023-10-27T11:05:00Z"
	EndTime time.Time `json:"end_time"`

	// Duration is the total duration of the build process in a human-readable format.
	// required: true
	// example: "5m0s"
	Duration string `json:"duration"`
}

type ImageDeleteResponseItem struct {
	Untagged string `json:"untagged,omitempty"`
	Deleted  string `json:"deleted,omitempty" example:"sha256:a1b2c3d4..."`
}

type ImageHistoryItem struct {
	// ID is the identifier for this history record (often the layer ID or <missing>).
	// required: true
	// example: "sha256:b1c2d3e4..."
	ID string `json:"id" example:"sha256:a1b2c3d4..."`

	// Created is the timestamp when this layer was created.
	// required: true
	// example: "2023-10-26T13:50:00Z"
	Created time.Time `json:"created" example:"2023-09-15T14:00:00Z"`

	// CreatedBy is the command used to create this layer.
	// required: true
	// example: "/bin/sh -c #(nop) ADD file:abc in /"
	CreatedBy string `json:"created_by" example:"/bin/sh -c #(nop) CMD [\"nginx\" \"-g\" \"daemon off;\"]"`

	// Size is the size of this layer in bytes.
	// required: true
	// example: 5242880
	Size int64 `json:"size" example:"0"` // Size of this layer

	// SizeHuman is the size of this layer in a human-readable format.
	// required: true
	// example: "5MB"
	SizeHuman string `json:"size_human"`

	// Comment is an optional comment associated with the layer creation.
	// example: "Added base filesystem"
	Comment string `json:"comment,omitempty"`

	// Tags lists the tags associated with this specific history entry (usually empty).
	Tags []string `json:"tags,omitempty"`
}

type ImageHistoryResponse struct {
	// ID is the identifier for this history record (often the layer ID or <missing>).
	// required: true
	// example: "sha256:b1c2d3e4..."
	ID string `json:"id" example:"sha256:a1b2c3d4..."`

	// Created is the timestamp when this layer was created.
	// required: true
	// example: "2023-10-26T13:50:00Z"
	Created time.Time `json:"created" example:"2023-09-15T14:00:00Z"`

	// CreatedBy is the command used to create this layer.
	// required: true
	// example: "/bin/sh -c #(nop) ADD file:abc in /"
	CreatedBy string `json:"created_by" example:"/bin/sh -c #(nop) CMD [\"nginx\" \"-g\" \"daemon off;\"]"`

	// Size is the size of this layer in bytes.
	// required: true
	// example: 5242880
	Size int64 `json:"size"`

	// SizeHuman is the size of this layer in a human-readable format.
	// required: true
	// example: "5MB"
	SizeHuman string `json:"size_human"`

	// Comment is an optional comment associated with the layer creation.
	// example: "Added base filesystem"
	Comment string `json:"comment,omitempty"`

	// Tags lists the tags associated with this specific history entry (usually empty).
	Tags []string `json:"tags,omitempty"`
}

type ImageListRequest struct {
	PaginationRequest
	SortRequest
	FilterRequest
	All        bool   `json:"all" form:"all" example:"false"`
	Repository string `json:"repository" form:"repository" example:"nginx"`
	Tag        string `json:"tag" form:"tag" example:"latest"`
	Digest     string `json:"digest" form:"digest" example:"sha256:a1b2c3d4..."`
}

type ImageListResponse struct {
	// Images is the list of image objects returned for the current page.
	// required: true
	Images []ImageResponse `json:"images"`

	// Metadata contains pagination and other metadata for the response.
	// required: true
	Metadata MetadataResponse `json:"metadata"`
}

type ImagePullRequest struct {
	// Image is the name of the image to pull (e.g., "nginx", "myregistry.com/myapp").
	// required: true
	// example: "nginx"
	Image string `json:"image" binding:"required" example:"nginx"`

	// Tag is the specific tag of the image to pull. Defaults to "latest" if omitted.
	// example: "1.21-alpine"
	Tag string `json:"tag" example:"1.21-alpine"`

	// Credentials contains optional username and password for authenticating with a private registry.
	Credentials struct {
		// Username for the private registry.
		// example: "dockerhub_user"
		Username string `json:"username" example:"dockerhub_user"`
		// Password or access token for the private registry.
		// example: "mysecretpassword"
		Password string `json:"password" example:"mysecretpassword"`
	} `json:"credentials"`
}

type ImagePullResponse struct {
	// Success indicates if the pull operation was successful (note: Docker pull itself doesn't return success/fail easily, this might be application-level).
	// required: true
	// example: true
	Success bool `json:"success"`

	// Image is the full name (repo:tag) of the image that was pulled.
	// required: true
	// example: "nginx:latest"
	Image string `json:"image"`

	// ID is the Docker Image ID (SHA256 digest) of the pulled image.
	// example: "sha256:a1b2c3d4..."
	ID string `json:"id,omitempty"`

	// Size is the size of the pulled image in bytes.
	// example: 135234567
	Size int64 `json:"size,omitempty"`

	// CreatedAt is the creation timestamp of the pulled image (from image inspect).
	// example: "2023-10-26T14:00:00Z"
	CreatedAt string `json:"created_at,omitempty"` // Keep as string from Docker API? Or parse?

	// Time is the timestamp when the pull operation completed on the server.
	// required: true
	// example: "2023-10-27T10:30:00Z"
	Time time.Time `json:"time"`
}

type ImageRemoveRequest struct {
	Force         bool `json:"force" example:"false"`
	PruneChildren bool `json:"prune_children" example:"false"`
}

type ImageRemoveResponse struct {
	// Deleted is the count of deleted image layers/references.
	// example: 5
	Deleted int `json:"deleted"`

	// SpaceReclaimed is the total disk space freed in bytes.
	// example: 150000000
	SpaceReclaimed int64 `json:"space_reclaimed"`

	// Items provides details on untagged or deleted items (structure may vary based on Docker API).
	// example: [{"Untagged": "myimage:latest"}, {"Deleted": "sha256:a1b2..."}]
	Items []map[string]interface{} `json:"items"` // Use map for flexibility as DeleteResponse structure varies
}

type ImageResponse struct {
	// ID is the internal database ID (if managed by the application).
	// example: 25
	ID uint `json:"id,omitempty"`

	// ImageID is the unique identifier assigned by Docker (SHA256 digest).
	// required: true
	// example: "sha256:a1b2c3d4e5f6..."
	ImageID string `json:"image_id"`

	// Name is the primary repository:tag associated with the image.
	// example: "nginx:latest"
	Name string `json:"name,omitempty"`

	// Repository is the repository part of the image name.
	// example: "nginx"
	Repository string `json:"repository"`

	// Tag is the tag part of the image name.
	// example: "latest"
	Tag string `json:"tag"`

	// Digest is the repository digest (SHA256) if available.
	// example: "sha256:f6d669c..."
	Digest string `json:"digest,omitempty"`

	// Created is the timestamp when the image was created.
	// required: true
	// example: "2023-10-26T14:00:00Z"
	Created time.Time `json:"created" example:"2023-09-15T14:00:00Z"`

	// Size is the total size of the image layers in bytes.
	// required: true
	// example: 135234567
	Size int64 `json:"size" example:"133000000"` // Bytes

	// SizeHuman is the total size in a human-readable format.
	// required: true
	// example: "129MB"
	SizeHuman string `json:"size_human"`

	// Architecture is the CPU architecture the image was built for.
	// example: "amd64"
	Architecture string `json:"architecture" example:"amd64"`

	// OS is the operating system the image was built for.
	// example: "linux"
	OS string `json:"os"`

	// Author is the author specified in the image metadata.
	// example: "Nginx Maintainers <nginx-devel@nginx.org>"
	Author string `json:"author,omitempty"`

	// Labels are the labels applied to the image.
	// example: {"maintainer": "Nginx Maintainers"}
	Labels map[string]string `json:"labels,omitempty"`

	// Containers lists the IDs of containers currently using this image.
	// example: ["f7d9e8c7b6a5"]
	Containers []string `json:"containers,omitempty"`

	// History provides details about the layers that make up the image.
	History []ImageHistoryResponse `json:"history,omitempty"`

	// Notes are user-defined notes stored in the application database.
	// example: "Base image for web servers."
	Notes string `json:"notes,omitempty"`

	// UserID is the ID of the user who owns/created this image record in the application database.
	// example: 1
	UserID uint `json:"user_id,omitempty"`

	// CreatedAt is the timestamp when the image record was created in the application database.
	// example: "2023-10-27T09:00:00Z"
	CreatedAt time.Time `json:"created_at,omitempty"`

	// UpdatedAt is the timestamp when the image record was last updated in the application database.
	// example: "2023-10-27T09:05:00Z"
	UpdatedAt time.Time `json:"updated_at,omitempty"`
}

type ImageTagRequest struct {
	// SourceImage is the ID or current name:tag of the image to tag.
	// required: true
	// example: "nginx:latest" or "sha256:a1b2c3d4..."
	SourceImage string `json:"source_image" binding:"required" example:"nginx:latest"` // Image ID or Name:Tag to tag

	// Repository is the repository name for the new tag.
	// required: true
	// example: "my-custom-nginx"
	Repository string `json:"repository" binding:"required" example:"my-custom-nginx"`

	// Tag is the tag name for the new tag.
	// required: true
	// example: "v1.0"
	Tag string `json:"tag" binding:"required" example:"v1.0"`
}

type ImageTagResponse struct {
	Success    bool   `json:"success"`
	SourceID   string `json:"source_id"`
	Repository string `json:"repository"`
	Tag        string `json:"tag"`
	FullTag    string `json:"full_tag"`
}

type JSONMap map[string]interface{}

type LoginRequest struct {
	// Email is the user's registered email address.
	// required: true
	// example: user@example.com
	Email string `json:"email" binding:"required,email" example:"user@example.com"`

	// Password is the user's password.
	// required: true
	// example: StrongP@ssw0rd!
	Password string `json:"password" binding:"required" example:"StrongP@ssw0rd!"`
}

type MetadataResponse struct {
	Timestamp  time.Time           `json:"timestamp" example:"2023-10-27T10:30:00Z"`
	RequestID  string              `json:"request_id,omitempty" example:"req-12345"`
	Pagination *PaginationResponse `json:"pagination,omitempty"`
}

type MountPoint struct {
	Type        string `json:"type"`
	Name        string `json:"name"`
	Source      string `json:"source"`
	Destination string `json:"destination"`
	Mode        string `json:"mode"`
	RW          bool   `json:"rw"`
	Propagation string `json:"propagation"`
}

type Network struct {
	DockerResource
	NetworkID     string    `json:"network_id" gorm:"index;size:64" validate:"required,alphanumdash"`
	Driver        string    `json:"driver" validate:"max=255"`
	Scope         string    `json:"scope" validate:"max=64"`
	Created       time.Time `json:"created"`
	Gateway       string    `json:"gateway" validate:"omitempty,ip"`
	Subnet        string    `json:"subnet" validate:"omitempty,cidr"`
	IPRange       string    `json:"ip_range" validate:"omitempty,cidr"`
	Internal      bool      `json:"internal"`
	EnableIPv6    bool      `json:"enable_ipv6"`
	Attachable    bool      `json:"attachable"`
	Ingress       bool      `json:"ingress"`
	ConfigOnly    bool      `json:"config_only"`
	Containers    JSONMap   `json:"containers" gorm:"type:text"` // Store container connections as JSON
	LastInspected time.Time `json:"last_inspected"`
	Options       JSONMap   `json:"options" gorm:"type:text"`
	IPAMOptions   JSONMap   `json:"ip_am_options" gorm:"type:text"` // Store IPAM config as JSON
	Security      JSONMap   `json:"security" gorm:"type:text"`
	ConfigFrom    string    `json:"config_from" gorm:"size:255"` // Name of network this config is from
}

type NetworkConfig struct {
	// Name is the name of the network
	Name string `yaml:"-" json:"name"`

	// Driver is the network driver
	Driver string `yaml:"driver,omitempty" json:"driver,omitempty"`

	// DriverOpts are driver-specific options
	DriverOpts map[string]string `yaml:"driver_opts,omitempty" json:"driver_opts,omitempty"`

	// IPAM is the IPAM configuration
	IPAM map[string]interface{} `yaml:"ipam,omitempty" json:"ipam,omitempty"` // Map structure

	// External indicates whether the network is external
	External interface{} `yaml:"external,omitempty" json:"external,omitempty"`

	// Internal indicates whether the network is internal
	Internal bool `yaml:"internal,omitempty" json:"internal,omitempty"`

	// Attachable indicates whether the network is attachable
	Attachable bool `yaml:"attachable,omitempty" json:"attachable,omitempty"`

	// Labels are labels to apply to the network
	Labels interface{} `yaml:"labels,omitempty" json:"labels,omitempty"`

	// Extensions stores extension fields
	Extensions map[string]interface{} `yaml:",inline" json:"extensions,omitempty"`
}

type NetworkConnectRequest struct {
	// Container is the ID or name of the container to connect.
	// required: true
	// example: my-web-container
	Container string `json:"container" binding:"required" example:"my-app-container"` // Container ID or Name

	// EndpointConfig provides custom network settings for the container within this network.
	EndpointConfig *EndpointSettingsRequest `json:"endpoint_config"` // Added
}

type NetworkConnectionResponse struct {
	// NetworkID is the ID of the network the container is connected to.
	// required: true
	// example: "b7cda8f3e9a1..."
	NetworkID string `json:"network_id" example:"b7cda8f3e9a1"`

	// NetworkName is the name of the network.
	// required: true
	// example: "my-app-network"
	NetworkName string `json:"network_name" example:"my-app-network"`

	// IPAddress is the IPv4 address assigned to the container within this network.
	// example: "172.28.0.3"
	IPAddress string `json:"ip_address" example:"172.28.0.3"`

	// Gateway is the gateway address for this network connection.
	// example: "172.28.0.1"
	Gateway string `json:"gateway" example:"172.28.0.1"`

	// MacAddress is the MAC address assigned to the container's endpoint in this network.
	// example: "02:42:ac:1c:00:03"
	MacAddress string `json:"mac_address" example:"02:42:ac:1c:00:03"`

	// Aliases are network-scoped aliases for the container within this network.
	// example: ["nginx", "webserver"]
	Aliases []string `json:"aliases,omitempty" example:"nginx,webserver"`
}

type NetworkContainerResponse struct {
	// Name is the name of the connected container.
	// required: true
	// example: "my-web-container"
	Name string `json:"name" example:"my-app-container"`

	// EndpointID is the ID of the network endpoint for this container.
	// required: true
	// example: "ep-a1b2c3d4e5f6..."
	EndpointID string `json:"endpoint_id" example:"ep-a1b2c3d4..."`

	// MacAddress is the MAC address assigned to the container's endpoint.
	// required: true
	// example: "02:42:ac:1c:00:02"
	MacAddress string `json:"mac_address" example:"02:42:ac:1c:00:03"`

	// IPv4Address is the IPv4 address assigned to the container's endpoint.
	// example: "172.28.0.2"
	IPv4Address string `json:"ipv4_address,omitempty"`

	// IPv6Address is the IPv6 address assigned to the container's endpoint.
	// example: "2001:db8:abcd::2"
	IPv6Address string `json:"ipv6_address,omitempty"`

	// Aliases are network-scoped aliases for the container within this network.
	// example: ["web", "frontend"]
	Aliases []string `json:"aliases,omitempty"`
}

type NetworkCreateOptions struct {
	Name       string            `json:"Name" binding:"required"` // Match Docker API field name
	Driver     string            `json:"Driver,omitempty"`
	Internal   bool              `json:"Internal,omitempty"`
	Attachable bool              `json:"Attachable,omitempty"`
	Ingress    bool              `json:"Ingress,omitempty"` // Common overlay option
	EnableIPv6 bool              `json:"EnableIPv6,omitempty"`
	IPAM       *IPAM             `json:"IPAM,omitempty"` // Reusing IPAM struct from docker_entities.go
	Options    map[string]string `json:"Options,omitempty"`
	Labels     map[string]string `json:"Labels,omitempty"`
}

type NetworkCreateRequest struct {
	// Name is the name for the new network.
	// required: true
	// example: my-app-network
	Name string `json:"name" binding:"required" example:"my-app-network"`

	// Driver specifies the network driver to use (e.g., bridge, overlay). Defaults to bridge.
	// example: bridge
	Driver string `json:"driver" example:"bridge"`

	// Internal restricts external access to the network.
	// example: false
	Internal bool `json:"internal" example:"false"`

	// Labels are key-value pairs to apply to the network.
	// example: {"environment": "production", "project": "webapp"}
	Labels map[string]string `json:"labels" example:"project:myapp,tier:backend"`

	// Options are driver-specific options.
	// example: {"com.docker.network.bridge.name": "mybridge0"}
	Options map[string]string `json:"options"` // Example removed due to swag parsing issues

	// EnableIPv6 enables IPv6 support for the network.
	// example: false
	EnableIPv6 bool `json:"enable_ipv6" example:"false"`

	// Attachable allows non-service containers to attach to this network (useful for overlay networks).
	// example: true
	Attachable bool `json:"attachable" example:"true"`

	// Ingress indicates the network provides the routing-mesh in swarm mode.
	// example: false
	Ingress bool `json:"ingress"` // Added

	// ConfigOnly specifies that the network configuration is only used for services.
	// example: false
	ConfigOnly bool `json:"config_only"` // Added

	// Scope specifies the network scope (e.g., local, swarm).
	// example: local
	Scope string `json:"scope"` // Added

	// IPAM provides custom IP Address Management configuration.
	IPAM *IPAMCreateRequest `json:"ipam"` // Added

	// Notes are user-defined notes for the network (stored in the application DB).
	// example: "Main network for the web application stack."
	Notes string `json:"notes" example:"Network for backend services."`
}

type NetworkDisconnectRequest struct {
	// Container is the ID or name of the container to disconnect.
	// required: true
	// example: my-web-container
	Container string `json:"container" binding:"required" example:"my-app-container"` // Container ID or Name

	// Force disconnects the container even if it is running.
	// example: false
	Force bool `json:"force" example:"false"`
}

type NetworkListRequest struct {
	PaginationRequest // Embeds Page and PageSize
	SortRequest       // Embeds SortBy and SortOrder
	FilterRequest     // Embeds Search, Filters, StartDate, EndDate
	// Driver filters networks by the specified driver name.
	// example: bridge
	Driver string `json:"driver" form:"driver"`
}

type NetworkListResponse struct {
	// Networks is the list of network objects returned for the current page.
	// required: true
	Networks []NetworkResponse `json:"networks"`

	// Metadata contains pagination and other metadata for the response.
	// required: true
	Metadata MetadataResponse `json:"metadata"`
}

type NetworkMode string

type NetworkPruneRequest struct {
	FilterRequest // Embeds Search, Filters, StartDate, EndDate
}

type NetworkPruneResponse struct {
	NetworksDeleted []string `json:"networks_deleted"`
}

type NetworkResponse struct {
	// ID is the internal database ID (if managed by the application).
	// example: 5
	ID uint `json:"id,omitempty"`

	// NetworkID is the unique identifier assigned by Docker.
	// required: true
	// example: "b7cda8f3e9a1..."
	NetworkID string `json:"network_id"`

	// Name is the user-defined name of the network.
	// required: true
	// example: "my-app-network"
	Name string `json:"name" example:"my-app-network"`

	// Driver is the network driver used (e.g., bridge, overlay).
	// required: true
	// example: "bridge"
	Driver string `json:"driver" example:"bridge"`

	// Scope indicates the scope of the network (e.g., local, swarm).
	// required: true
	// example: "local"
	Scope string `json:"scope" example:"local"`

	// Created is the timestamp when the network was created by Docker.
	// required: true
	// example: "2023-10-27T09:00:00Z"
	Created time.Time `json:"created" example:"2023-10-25T09:00:00Z"`

	// Gateway is the IPv4 gateway for the network's subnet.
	// example: "172.28.0.1"
	Gateway string `json:"gateway,omitempty"`

	// Subnet is the primary IPv4 subnet for the network in CIDR notation.
	// example: "172.28.0.0/16"
	Subnet string `json:"subnet,omitempty"`

	// IPRange is the range of IPs available within the subnet.
	// example: "172.28.5.0/24"
	IPRange string `json:"ip_range,omitempty"`

	// Internal indicates if the network is internal (restricts external access).
	// required: true
	// example: false
	Internal bool `json:"internal" example:"false"`

	// EnableIPv6 indicates if IPv6 is enabled for the network.
	// required: true
	// example: false
	EnableIPv6 bool `json:"enable_ipv6" example:"false"`

	// Attachable indicates if non-service containers can attach to the network.
	// required: true
	// example: true
	Attachable bool `json:"attachable" example:"true"`

	// Ingress indicates if the network provides the routing-mesh in swarm mode.
	// required: true
	// example: false
	Ingress bool `json:"ingress" example:"false"`

	// ConfigOnly indicates if the network configuration is only used for services.
	// required: true
	// example: false
	ConfigOnly bool `json:"config_only" example:"false"`

	// Labels are the labels applied to the network.
	// example: {"environment": "production"}
	Labels map[string]string `json:"labels,omitempty"`

	// Options are driver-specific options for the network.
	// example: {"com.docker.network.bridge.name": "mybridge0"}
	Options map[string]string `json:"options,omitempty"`

	// Containers lists the containers connected to this network and their endpoint details.
	Containers map[string]NetworkContainerResponse `json:"containers,omitempty"`

	// Notes are user-defined notes stored in the application database.
	// example: "Main network for the web application stack."
	Notes string `json:"notes,omitempty"`

	// UserID is the ID of the user who owns/created this network record in the application database.
	// example: 1
	UserID uint `json:"user_id,omitempty"`

	// CreatedAt is the timestamp when the network record was created in the application database.
	// example: "2023-10-27T09:05:00Z"
	CreatedAt time.Time `json:"created_at,omitempty"`

	// UpdatedAt is the timestamp when the network record was last updated in the application database.
	// example: "2023-10-27T09:10:00Z"
	UpdatedAt time.Time `json:"updated_at,omitempty"`
}

type NetworkSettings struct {
	Networks    map[string]EndpointSettings `json:"networks"`
	IPAddress   string                      `json:"ip_address"`
	IPPrefixLen int                         `json:"ip_prefix_len"`
	Gateway     string                      `json:"gateway"`
	Bridge      string                      `json:"bridge"`
	Ports       nat.PortMap                 `json:"ports"`
	MacAddress  string                      `json:"mac_address"`
	DNS         []string                    `json:"dns"`
	DNSOptions  []string                    `json:"dns_options"`
	DNSSearch   []string                    `json:"dns_search"`
}

type NetworkUpdateOptions struct {
}

type OperationInfo struct {
	// Type indicates the type of operation being performed.
	// required: true
	// example: "up"
	Type OperationType `json:"type"`

	// Status indicates the current status of the operation.
	// required: true
	// example: "in_progress"
	Status OperationStatus `json:"status"`

	// StartTime is the timestamp when the operation began.
	// required: true
	// example: "2023-10-27T10:04:30Z"
	StartTime time.Time `json:"startTime"`

	// EndTime is the timestamp when the operation finished (only present if Status is 'complete' or 'failed').
	// example: "2023-10-27T10:05:15Z"
	EndTime time.Time `json:"endTime,omitempty"`

	// Error contains the error message if the operation failed.
	// example: "Failed to create service 'db': network 'shared' not found"
	Error string `json:"error,omitempty"` // Store error message as string

	// Details provides additional context or progress information about the operation.
	// example: {"step": "Creating service web", "progress": 0.5}
	Details map[string]interface{} `json:"details,omitempty"`
}

type OperationStatus string

type OperationType string

type PaginatedResponse struct {
	Success bool             `json:"success" example:"true"`
	Data    interface{}      `json:"data"` // Should hold the slice of items
	Meta    MetadataResponse `json:"meta"`
}

type PaginationRequest struct {
	Page     int `json:"page" form:"page" binding:"gte=1" example:"1"`
	PageSize int `json:"page_size" form:"page_size" binding:"gte=1,lte=100" example:"10"`
}

type PaginationResponse struct {
	Page       int `json:"page" example:"1"`
	PageSize   int `json:"page_size" example:"10"`
	TotalPages int `json:"total_pages" example:"5"`
	TotalItems int `json:"total_items" example:"42"`
}

type ParseOptions struct {
	WorkingDir  string // Working directory for resolving relative paths
	EnvFile     string // Optional path to an environment file
	ProjectName string // Optional project name override

}

type PingResponse struct {
	APIVersion     string `json:"api_version"`
	OSType         string `json:"os_type"`
	Experimental   bool   `json:"experimental"`
	BuilderVersion string `json:"builder_version"`
}

type PortMapping struct {
	// HostIP is the IP address on the host to bind the port to. Defaults to 0.0.0.0 (all interfaces).
	// example: "127.0.0.1"
	HostIP string `json:"host_ip"`

	// HostPort is the port number on the host. If empty or "0", Docker assigns a random ephemeral port.
	// example: "8080"
	HostPort string `json:"host_port"`

	// ContainerPort is the port number inside the container.
	// required: true
	// example: "80"
	ContainerPort string `json:"container_port"`

	// Type is the protocol (e.g., "tcp", "udp", "sctp"). Defaults to "tcp".
	// example: "tcp"
	Type string `json:"type"`
}

type Process struct {
	PID     int    `json:"pid"`
	User    string `json:"user"`
	Time    string `json:"time"`
	Command string `json:"command"`
	CPU     string `json:"cpu"`
	Memory  string `json:"memory"`
}

type RefreshTokenRequest struct {
	// RefreshToken is the valid refresh token previously issued to the user.
	// required: true
	// example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... (long token string)
	RefreshToken string `json:"refresh_token" binding:"required" example:"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."`
}

type RegisterRequest struct {
	// Email is the user's email address, used for login.
	// required: true
	// example: user@example.com
	Email string `json:"email" binding:"required,email" example:"user@example.com"`

	// Password is the user's desired password (min 8 characters).
	// required: true
	// example: StrongP@ssw0rd!
	Password string `json:"password" binding:"required,min=8" example:"StrongP@ssw0rd!"`

	// Name is the user's display name.
	// required: true
	// example: John Doe
	Name string `json:"name" binding:"required" example:"John Doe"`

	// InviteCode is an optional code required for registration if the system is configured for invite-only.
	// example: ABC-123
	InviteCode string `json:"invite_code" example:"ABC-123"` // Optional, depends on system configuration
}

type RegistryAuth struct {
	Username      string `json:"username"`
	Password      string `json:"password"`
	ServerAddress string `json:"server_address"`
	Email         string `json:"email,omitempty"`
	IdentityToken string `json:"identity_token,omitempty"`
	Auth          string `json:"auth,omitempty"` // Base64 encoded username:password
}

type RemoveOptions struct {
	ProjectName       string
	Timeout           time.Duration
	RemoveVolumes     bool
	RemoveImages      string // e.g., "all", "local"
	RemoveOrphans     bool
	Force             bool
	DependencyTimeout time.Duration
	Logger            *logrus.Logger
}

type ResourceLimits struct {
	Memory            int64  `json:"memory"`
	MemorySwap        int64  `json:"memory_swap"`
	MemoryReservation int64  `json:"memory_reservation"`
	CPUShares         int64  `json:"cpu_shares"`
	CPUPeriod         int64  `json:"cpu_period"`
	CPUQuota          int64  `json:"cpu_quota"`
	CpusetCpus        string `json:"cpuset_cpus"`
	CpusetMems        string `json:"cpuset_mems"`
	PidsLimit         int64  `json:"pids_limit"`
	BlkioWeight       uint16 `json:"blkio_weight"`
}

type ResourceStat struct {
	Name string      `json:"name"`
	Size int64       `json:"size"`
	Mode os.FileMode `json:"mode"` // Use os.FileMode (uint32)
	// ModTime is NOT available from CopyFromContainer stat
	LinkTarget string `json:"link_target"`
}

type RestartOptions struct {
	ProjectName       string
	Timeout           time.Duration
	DependencyTimeout time.Duration
	Logger            *logrus.Logger
}

type RestartPolicy string

type Role string

type ScaleOptions struct {
	ProjectName       string
	Service           string
	Replicas          int
	Timeout           time.Duration
	DependencyTimeout time.Duration
	Logger            *logrus.Logger
}

type ScanSummary struct {
	TotalVulnerabilities int `json:"total_vulnerabilities"`
	CriticalCount        int `json:"critical_count"`
	HighCount            int `json:"high_count"`
	MediumCount          int `json:"medium_count"`
	LowCount             int `json:"low_count"`
	UnknownCount         int `json:"unknown_count"`
}

type SecretConfig struct {
	// Name is the name of the secret
	Name string `yaml:"-" json:"name"`

	// File is the file containing the secret
	File string `yaml:"file,omitempty" json:"file,omitempty"`

	// External indicates whether the secret is external
	External interface{} `yaml:"external,omitempty" json:"external,omitempty"`

	// Labels are labels to apply to the secret
	Labels interface{} `yaml:"labels,omitempty" json:"labels,omitempty"`

	// Extensions stores extension fields
	Extensions map[string]interface{} `yaml:",inline" json:"extensions,omitempty"`
}

type SecurityInfo struct {
	Privileged      bool     `json:"privileged"`
	ReadOnlyRootfs  bool     `json:"read_only_rootfs"`
	CapAdd          []string `json:"cap_add"`
	CapDrop         []string `json:"cap_drop"`
	SecurityOpt     []string `json:"security_opt"`
	NetworkMode     string   `json:"network_mode"`
	PidMode         string   `json:"pid_mode"`
	IpcMode         string   `json:"ipc_mode"`
	UTSMode         string   `json:"uts_mode"`
	UsernsMode      string   `json:"userns_mode"`
	SensitiveMounts []string `json:"sensitive_mounts"`
}

type SecurityScanResult struct {
	Target          string          `json:"target"`  // e.g., image name, container ID
	Scanner         string          `json:"scanner"` // Name of the scanner used
	ScanTimestamp   time.Time       `json:"scan_timestamp"`
	Summary         ScanSummary     `json:"summary"`
	Vulnerabilities []Vulnerability `json:"vulnerabilities"`
	Error           string          `json:"error,omitempty"` // Any error during the scan
}

type ServiceConfig struct {
	// Name is the name of the service
	Name string `yaml:"-" json:"name"`

	// Image is the image to use
	Image string `yaml:"image,omitempty" json:"image,omitempty"`

	// Build is the build configuration
	Build interface{} `yaml:"build,omitempty" json:"build,omitempty"`

	// Command is the command to run
	Command interface{} `yaml:"command,omitempty" json:"command,omitempty"`

	// Environment is a list of environment variables
	Environment interface{} `yaml:"environment,omitempty" json:"environment,omitempty"`

	// EnvFile is a list of environment files
	EnvFile interface{} `yaml:"env_file,omitempty" json:"env_file,omitempty"`

	// Ports is a list of port mappings
	Ports []interface{} `yaml:"ports,omitempty" json:"ports,omitempty"` // Can be list of strings or maps

	// Expose is a list of exposed ports
	Expose []interface{} `yaml:"expose,omitempty" json:"expose,omitempty"` // Can be list of strings/numbers

	// Volumes is a list of volume mappings
	Volumes interface{} `yaml:"volumes,omitempty" json:"volumes,omitempty"` // Reverted back to interface{} again

	// VolumesFrom is a list of services to mount volumes from
	VolumesFrom []string `yaml:"volumes_from,omitempty" json:"volumes_from,omitempty"` // List of strings

	// Networks is a list of networks to connect to
	Networks interface{} `yaml:"networks,omitempty" json:"networks,omitempty"`

	// NetworkMode is the network mode
	NetworkMode string `yaml:"network_mode,omitempty" json:"network_mode,omitempty"`

	// DependsOn is a list of services that this service depends on
	DependsOn interface{} `yaml:"depends_on,omitempty" json:"depends_on,omitempty"`

	// HealthCheck is the health check configuration
	HealthCheck map[string]interface{} `yaml:"healthcheck,omitempty" json:"healthcheck,omitempty"` // Map structure

	// Deploy is the deployment configuration
	Deploy map[string]interface{} `yaml:"deploy,omitempty" json:"deploy,omitempty"` // Map structure

	// Restart is the restart policy
	Restart string `yaml:"restart,omitempty" json:"restart,omitempty"`

	// Labels are labels to apply to the container
	Labels interface{} `yaml:"labels,omitempty" json:"labels,omitempty"`

	// Extensions stores extension fields
	Extensions map[string]interface{} `json:"extensions,omitempty"` // Removed yaml tag entirely
}

type ServiceInfo struct {
	// Name is the name of the service as defined in the Compose file.
	// required: true
	// example: "web"
	Name string `json:"name"`

	// ContainerIDs lists the Docker container IDs associated with this service instance(s).
	// example: ["f7d9e8c7b6a5", "a1b2c3d4e5f6"]
	ContainerIDs []string `json:"containerIDs"`

	// Status is the current status of the service.
	// required: true
	// example: "running"
	Status ServiceStatus `json:"status"`

	// StartTime is the timestamp when the service (or its first container) was started.
	// required: true
	// example: "2023-10-27T10:01:00Z"
	StartTime time.Time `json:"startTime"`

	// UpdateTime is the timestamp when the service status was last updated.
	// required: true
	// example: "2023-10-27T10:06:00Z"
	UpdateTime time.Time `json:"updateTime"`

	// Error contains the last error message associated with the service, if any.
	// example: "Container exited with code 1"
	Error string `json:"error,omitempty"` // Store error message as string

	// Health provides details about the service's health check status, if configured.
	Health *HealthInfo `json:"health,omitempty"`
}

type ServiceStatus string

type ServiceStatusInfo struct {
	Name         string        `json:"name"`
	Status       ServiceStatus `json:"status"`
	ContainerIDs []string      `json:"container_ids"`
	HealthStatus string        `json:"health_status,omitempty"` // e.g., healthy, unhealthy, starting
	Error        string        `json:"error,omitempty"`
	UpdateTime   time.Time     `json:"update_time"`
}

type Setting struct {
	ID        uint           `json:"id" gorm:"primaryKey"`
	Key       string         `json:"key" gorm:"uniqueIndex;not null"`
	Value     string         `json:"value" gorm:"type:text;not null"`
	CreatedAt time.Time      `json:"created_at"`
	UpdatedAt time.Time      `json:"updated_at"`
	DeletedAt gorm.DeletedAt `json:"-" gorm:"index"`
}

type SortRequest struct {
	SortBy    string `json:"sort_by" form:"sort_by" example:"name"`
	SortOrder string `json:"sort_order" form:"sort_order" binding:"omitempty,oneof=asc desc" example:"asc"`
}

type StartOptions struct {
	ProjectName       string
	Timeout           time.Duration
	DependencyTimeout time.Duration
	Logger            *logrus.Logger
}

type StopOptions struct {
	ProjectName       string
	Timeout           time.Duration
	DependencyTimeout time.Duration
	Logger            *logrus.Logger
}

type StringArray []string

type SuccessResponse struct {
	Success bool             `json:"success" example:"true"`
	Data    interface{}      `json:"data,omitempty"`    // Use omitempty if data might be nil/empty
	Message string           `json:"message,omitempty"` // Optional success message
	Meta    MetadataResponse `json:"meta"`
}

type SystemInfoResponse struct {
	ID                 string                 `json:"id" example:"system-id-123"`
	Name               string                 `json:"name"`
	ServerVersion      string                 `json:"server_version" example:"24.0.5"`
	APIVersion         string                 `json:"api_version"`
	KernelVersion      string                 `json:"kernel_version" example:"5.15.0-87-generic"`
	OperatingSystem    string                 `json:"operating_system" example:"Docker Desktop"`
	OSType             string                 `json:"os_type"`
	Architecture       string                 `json:"architecture" example:"aarch64"`
	CPUs               int                    `json:"cpus"`
	Memory             int64                  `json:"memory"`
	MemoryHuman        string                 `json:"memory_human"`
	ContainersRunning  int                    `json:"containers_running"`
	ContainersPaused   int                    `json:"containers_paused"`
	ContainersStopped  int                    `json:"containers_stopped"`
	Images             int                    `json:"images" example:"50"`
	Driver             string                 `json:"driver" example:"overlay2"`
	DriverStatus       [][]string             `json:"driver_status,omitempty"`
	DockerRootDir      string                 `json:"docker_root_dir"`
	ExperimentalBuild  bool                   `json:"experimental_build"`
	ServerTime         time.Time              `json:"server_time"`
	HTTPProxy          string                 `json:"http_proxy,omitempty"`
	HTTPSProxy         string                 `json:"https_proxy,omitempty"`
	NoProxy            string                 `json:"no_proxy,omitempty"`
	SecurityOptions    []string               `json:"security_options,omitempty"`
	RegistryConfig     map[string]interface{} `json:"registry_config,omitempty"`
	LiveRestoreEnabled bool                   `json:"live_restore_enabled"`
	Debug              bool                   `json:"debug"`
	NFd                int                    `json:"n_fd"`
	NGoroutines        int                    `json:"n_goroutines"`
	SystemTime         time.Time              `json:"system_time"`
	LoggingDriver      string                 `json:"logging_driver"`
	CgroupDriver       string                 `json:"cgroup_driver"`
	CgroupVersion      string                 `json:"cgroup_version"`
	NEventsListener    int                    `json:"n_events_listener"`
	KernelMemory       bool                   `json:"kernel_memory"`
	MemoryLimit        bool                   `json:"memory_limit"`
	SwapLimit          bool                   `json:"swap_limit"`
	KernelMemoryTCP    bool                   `json:"kernel_memory_tcp"`
	CPUCfsPeriod       bool                   `json:"cpu_cfs_period"`
	CPUCfsQuota        bool                   `json:"cpu_cfs_quota"`
	CPUShares          bool                   `json:"cpu_shares"`
	CPUSet             bool                   `json:"cpu_set"`
	PidsLimit          bool                   `json:"pids_limit"`
	IPv4Forwarding     bool                   `json:"ipv4_forwarding"`
	BridgeNfIptables   bool                   `json:"bridge_nf_iptables"`
	BridgeNfIp6tables  bool                   `json:"bridge_nf_ip6tables"`
	Debug0             bool                   `json:"debug0"`
	OomKillDisable     bool                   `json:"oom_kill_disable"`
}

type SystemPruneRequest struct {
	Containers bool              `json:"containers" example:"true"`               // Prune containers
	Images     bool              `json:"images" example:"false"`                  // Prune images
	Networks   bool              `json:"networks" example:"true"`                 // Prune networks
	Volumes    bool              `json:"volumes" example:"true"`                  // Prune volumes
	BuildCache bool              `json:"build_cache" example:"true"`              // Prune build cache
	Filters    map[string]string `json:"filters" example:"label:mylabel=myvalue"` // Filters to apply (e.g., {"label": ["key=value"]}) - Note: Docker API uses map[string][]string, adjust if needed
}

type SystemPruneResponse struct {
	ContainersDeleted []string                  `json:"containers_deleted,omitempty"`  // Renamed from ContainersPruned
	ImagesDeleted     []ImageDeleteResponseItem `json:"images_deleted,omitempty"`      // Renamed from ImagesPruned, changed type
	NetworksDeleted   []string                  `json:"networks_deleted,omitempty"`    // Renamed from NetworksPruned
	VolumesDeleted    []string                  `json:"volumes_deleted,omitempty"`     // Renamed from VolumesPruned
	BuildCacheDeleted []string                  `json:"build_cache_deleted,omitempty"` // Keep this field
	SpaceReclaimed    int64                     `json:"space_reclaimed"`
}

type SystemSettings struct {
	DockerHost           string `json:"docker_host"`
	DockerTLSVerify      bool   `json:"docker_tls_verify"`
	DockerCertPath       string `json:"docker_cert_path"`
	DefaultCPULimit      string `json:"default_cpu_limit"`
	DefaultMemoryLimit   string `json:"default_memory_limit"`
	DefaultStorageLimit  string `json:"default_storage_limit"`
	EnableLogging        bool   `json:"enable_logging"`
	LogLevel             string `json:"log_level"`
	EnableNotifications  bool   `json:"enable_notifications"`
	NotificationEndpoint string `json:"notification_endpoint"`
	EnableScheduling     bool   `json:"enable_scheduling"`
	EnableAudit          bool   `json:"enable_audit"`
	UITheme              string `json:"ui_theme"`
	SessionTimeout       int    `json:"session_timeout"` // In minutes
	EnableRegistration   bool   `json:"enable_registration"`
	MaxContainers        int    `json:"max_containers"`
	MaxImages            int    `json:"max_images"`
	MaxVolumes           int    `json:"max_volumes"`
	MaxNetworks          int    `json:"max_networks"`
}

type Token struct {
	ID        uint           `json:"-" gorm:"primaryKey"`
	UUID      string         `json:"-" gorm:"unique;index"`
	UserID    uint           `json:"-" gorm:"index"`
	Token     string         `json:"-"`
	Type      string         `json:"-"` // "access" or "refresh"
	Blacklist bool           `json:"-" gorm:"default:false;index"`
	ExpiresAt time.Time      `json:"-" gorm:"index"`
	CreatedAt time.Time      `json:"-"`
	UpdatedAt time.Time      `json:"-"`
	DeletedAt gorm.DeletedAt `json:"-" gorm:"index"`
}

type TokenResponse struct {
	// AccessToken is the JWT token used for authenticating subsequent requests.
	// required: true
	// example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... (long token string)
	AccessToken string `json:"access_token" example:"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."`

	// RefreshToken is the token used to obtain a new access token when the current one expires.
	// required: true
	// example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... (different long token string)
	RefreshToken string `json:"refresh_token" example:"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."`

	// TokenType indicates the type of token (always "Bearer").
	// required: true
	// example: Bearer
	TokenType string `json:"token_type" example:"Bearer"`

	// ExpiresIn is the duration in seconds until the access token expires.
	// required: true
	// example: 3600
	ExpiresIn int `json:"expires_in" example:"3600"` // seconds

	// ExpiresAt is the exact timestamp when the access token expires.
	// required: true
	// example: 2023-10-27T11:00:00Z
	ExpiresAt time.Time `json:"expires_at" example:"2023-10-27T11:00:00Z"`

	// UserID is the unique identifier of the logged-in user.
	// required: true
	// example: 1
	UserID uint `json:"user_id" example:"1"`

	// Roles is the list of roles assigned to the user.
	// required: true
	// example: ["user", "admin"]
	Roles []string `json:"roles" example:"user,admin"`
}

type TopResponse struct {
	// Titles are the column headers for the process list (e.g., "PID", "USER", "%CPU", "COMMAND").
	// required: true
	// example: ["PID", "USER", "COMMAND"]
	Titles []string `json:"titles"` // Process list titles (e.g., PID, USER, COMMAND)

	// Processes is a list of arrays, where each inner array represents a process and its corresponding column values.
	// required: true
	// example: [["1", "root", "/usr/sbin/nginx"], ["6", "nginx", "nginx: worker process"]]
	Processes [][]string `json:"processes"` // List of process information arrays
}

type User struct {
	ID            uint           `json:"id" gorm:"primaryKey"`
	Email         string         `json:"email" gorm:"unique;not null"`
	Password      string         `json:"-" gorm:"not null"` // Password is never returned in JSON
	Name          string         `json:"name"`
	Roles         []UserRole     `json:"roles" gorm:"foreignKey:UserID"`
	LastLogin     *time.Time     `json:"last_login,omitempty"`
	EmailVerified bool           `json:"email_verified" gorm:"default:false"`
	Active        bool           `json:"active" gorm:"default:true"`
	CreatedAt     time.Time      `json:"created_at"`
	UpdatedAt     time.Time      `json:"updated_at"`
	DeletedAt     gorm.DeletedAt `json:"-" gorm:"index"`
}

type UserListResponse struct {
	// Users is the list of user objects returned for the current page.
	// required: true
	Users []UserResponse `json:"users"`

	// Metadata contains pagination and other metadata for the response.
	// required: true
	Metadata MetadataResponse `json:"metadata"`
}

type UserResponse struct {
	// ID is the unique identifier for the user.
	// required: true
	// example: 1
	ID uint `json:"id" example:"1"`

	// Email is the user's email address.
	// required: true
	// example: user@example.com
	Email string `json:"email" example:"user@example.com"`

	// Name is the user's display name.
	// required: true
	// example: John Doe
	Name string `json:"name" example:"John Doe"`

	// Roles is the list of roles assigned to the user.
	// required: true
	// example: ["user", "admin"]
	Roles []string `json:"roles" example:"user,admin"`

	// LastLogin is the timestamp of the user's last login. Omitted if the user has never logged in.
	// example: 2023-10-27T10:00:00Z
	LastLogin time.Time `json:"last_login,omitempty" example:"2023-10-27T10:00:00Z"`

	// EmailVerified indicates whether the user's email address has been verified.
	// required: true
	// example: true
	EmailVerified bool `json:"email_verified" example:"true"`

	// Active indicates whether the user account is currently active.
	// required: true
	// example: true
	Active bool `json:"active" example:"true"`

	// CreatedAt is the timestamp when the user account was created.
	// required: true
	// example: 2023-01-15T09:30:00Z
	CreatedAt time.Time `json:"created_at" example:"2023-01-15T09:30:00Z"`

	// UpdatedAt is the timestamp when the user account was last updated.
	// required: true
	// example: 2023-10-26T15:45:00Z
	UpdatedAt time.Time `json:"updated_at" example:"2023-10-26T15:45:00Z"`
}

type UserRole struct {
	ID        uint      `json:"-" gorm:"primaryKey"`
	UserID    uint      `json:"-" gorm:"index"`
	Role      Role      `json:"role" gorm:"index"`
	CreatedAt time.Time `json:"-"`
	UpdatedAt time.Time `json:"-"`
}

type UserSettings struct {
	UITheme              string `json:"ui_theme"`
	ContainersPerPage    int    `json:"containers_per_page"`
	ImagesPerPage        int    `json:"images_per_page"`
	VolumesPerPage       int    `json:"volumes_per_page"`
	NetworksPerPage      int    `json:"networks_per_page"`
	DefaultView          string `json:"default_view"`
	ShowTerminated       bool   `json:"show_terminated"`
	NotificationsEnabled bool   `json:"notifications_enabled"`
	RefreshInterval      int    `json:"refresh_interval"` // In seconds
}

type VersionedSetting struct {
	ID        uint      `json:"id" gorm:"primaryKey"`
	Key       string    `json:"key" gorm:"index;not null"`
	Value     string    `json:"value" gorm:"type:text;not null"`
	Version   int       `json:"version" gorm:"not null"`
	Metadata  string    `json:"metadata" gorm:"type:text"`
	CreatedAt time.Time `json:"created_at"`
}

type Volume struct {
	DockerResource
	VolumeID      string           `json:"volume_id" gorm:"index;size:64" validate:"required,alphanumdash"`
	Driver        string           `json:"driver" validate:"max=255"`
	Mountpoint    string           `json:"mountpoint" validate:"required"`
	Scope         string           `json:"scope" validate:"max=64"`
	InUse         bool             `json:"in_use"`
	LastInspected time.Time        `json:"last_inspected"`
	Options       JSONMap          `json:"options" gorm:"type:text"`
	DriverOpts    JSONMap          `json:"driver_opts" gorm:"type:text"`
	Security      JSONMap          `json:"security" gorm:"type:text"`
	Status        JSONMap          `json:"status" gorm:"type:text"`
	UsageData     *VolumeUsageData `json:"usage_data" gorm:"-"` // Exclude from DB, populate on demand
	Containers    []Container      `json:"-" gorm:"many2many:container_volumes;"`
}

type VolumeCloneRequest struct {
	TargetName string            `json:"target_name" binding:"required"`
	Labels     map[string]string `json:"labels" example:"backup=true,environment=production"`
}

type VolumeConfig struct {
	// Name is the name of the volume
	Name string `yaml:"-" json:"name"`

	// Driver is the volume driver
	Driver string `yaml:"driver,omitempty" json:"driver,omitempty"`

	// DriverOpts are driver-specific options
	DriverOpts map[string]string `yaml:"driver_opts,omitempty" json:"driver_opts,omitempty"`

	// External indicates whether the volume is external
	External interface{} `yaml:"external,omitempty" json:"external,omitempty"`

	// Labels are labels to apply to the volume
	Labels interface{} `yaml:"labels,omitempty" json:"labels,omitempty"`

	// Extensions stores extension fields
	Extensions map[string]interface{} `yaml:",inline" json:"extensions,omitempty"`
}

type VolumeCreateOptions struct {
	Name       string            `json:"Name" binding:"required"` // Match Docker API field name
	Driver     string            `json:"Driver,omitempty"`
	DriverOpts map[string]string `json:"DriverOpts,omitempty"`
	Labels     map[string]string `json:"Labels,omitempty"`
}

type VolumeCreateRequest struct {
	// Name is the name for the new volume.
	// required: true
	// example: my-app-data
	Name string `json:"name" binding:"required" example:"my-app-data"`

	// Driver specifies the volume driver to use. Defaults to "local".
	// example: local
	Driver string `json:"driver" example:"local"`

	// DriverOpts are driver-specific options.
	// example: {"type": "nfs", "o": "addr=192.168.1.1,rw"}
	DriverOpts map[string]string `json:"driver_opts"` // Example removed due to swag parsing issues

	// Labels are key-value pairs to apply to the volume.
	// example: {"environment": "production", "backup": "true"}
	Labels map[string]string `json:"labels" example:"backup=true,environment=production"`

	// Notes are user-defined notes for the volume (stored in the application DB).
	// example: "Persistent data for the main database."
	Notes string `json:"notes" example:"Persistent data for the main application."`
}

type VolumeListRequest struct {
	PaginationRequest // Embeds Page and PageSize
	SortRequest       // Embeds SortBy and SortOrder
	FilterRequest     // Embeds Search, Filters, StartDate, EndDate
	// Driver filters volumes by the specified driver name.
	// example: local
	Driver string `json:"driver" form:"driver" example:"local"`
}

type VolumeListResponse struct {
	// Volumes is the list of volume objects returned for the current page.
	// required: true
	Volumes []VolumeResponse `json:"volumes"`

	// Metadata contains pagination and other metadata for the response.
	// required: true
	Metadata MetadataResponse `json:"metadata"`
}

type VolumeMapping struct {
	// Source is the name of the volume or the path on the host machine.
	// required: true
	// example: "my-app-data" or "/path/on/host"
	Source string `json:"source" binding:"required" example:"my-app-data"` // or "/path/on/host"

	// Destination is the absolute path inside the container where the volume is mounted.
	// required: true
	// example: "/var/www/html"
	Destination string `json:"destination" binding:"required" example:"/var/www/html"`

	// ReadOnly specifies whether the mount should be read-only within the container.
	// example: false
	ReadOnly bool `json:"read_only" example:"false"`
}

type VolumeMountResponse struct {
	// Source is the source path on the host or the name of the Docker volume.
	// required: true
	// example: "/path/on/host" or "my-app-data"
	Source string `json:"source" example:"my-app-data"` // or "/path/on/host"

	// Destination is the absolute path inside the container where the volume is mounted.
	// required: true
	// example: "/data"
	Destination string `json:"destination" example:"/data"`

	// Mode provides driver-specific options, often includes SELinux labels like 'z' or 'Z'.
	// example: "z"
	Mode string `json:"mode" example:"z"`

	// RW indicates if the mount is read-write.
	// required: true
	// example: true
	RW bool `json:"rw" example:"true"`

	// VolumeID is the name of the Docker volume (if Source refers to a named volume).
	// example: "my-app-data"
	VolumeID string `json:"volume_id,omitempty" example:"my-app-data"`
}

type VolumePermissionsRequest struct {
	// UserID is the ID of the user who will become the new owner of the volume record in the application database.
	// required: true
	// example: 2
	UserID uint `json:"user_id" binding:"required"` // ID of the user to transfer ownership to
}

type VolumePruneRequest struct {
	FilterRequest // Embeds Search, Filters, StartDate, EndDate
}

type VolumeResponse struct {
	// ID is the internal database ID (if managed by the application).
	// example: 12
	ID uint `json:"id,omitempty"`

	// VolumeID is the unique identifier assigned by Docker (often the same as Name).
	// required: true
	// example: "my-app-data"
	VolumeID string `json:"volume_id"`

	// Name is the user-defined name of the volume.
	// required: true
	// example: "my-app-data"
	Name string `json:"name" example:"my-app-data"`

	// Driver is the volume driver used (e.g., local).
	// required: true
	// example: "local"
	Driver string `json:"driver" example:"local"`

	// Mountpoint is the path on the host where the volume data is stored.
	// required: true
	// example: "/var/lib/docker/volumes/my-app-data/_data"
	Mountpoint string `json:"mountpoint" example:"/var/lib/docker/volumes/my-app-data/_data"`

	// CreatedAt is the timestamp when the volume was created by Docker. Note: Docker API might return this as 'CreatedAt' string, needs parsing.
	// required: true
	// example: "2023-10-27T08:00:00Z"
	CreatedAt time.Time `json:"created_at" example:"2023-10-26T12:00:00Z"`

	// Scope indicates the scope of the volume (e.g., local, global).
	// required: true
	// example: "local"
	Scope string `json:"scope" example:"local"`

	// Labels are the labels applied to the volume.
	// example: {"environment": "production", "backup": "true"}
	Labels map[string]string `json:"labels,omitempty"`

	// Options are driver-specific options for the volume.
	Options map[string]string `json:"options,omitempty"`

	// Status provides low-level status information about the volume (driver-specific).
	Status map[string]string `json:"status,omitempty"`

	// InUse indicates whether the volume is currently used by any containers. Requires UsageData from Docker API.
	// example: true
	InUse bool `json:"in_use"`

	// Containers lists the IDs of containers currently using this volume. Requires UsageData from Docker API.
	// example: ["f7d9e8c7b6a5", "a1b2c3d4e5f6"]
	Containers []string `json:"containers,omitempty"`

	// Size is the calculated size of the volume in bytes. Requires UsageData from Docker API.
	// example: 104857600
	Size int64 `json:"size,omitempty"`

	// SizeHuman is the calculated size of the volume in a human-readable format.
	// example: "100MB"
	SizeHuman string `json:"size_human,omitempty"`

	// Notes are user-defined notes stored in the application database.
	// example: "Persistent data for the main database."
	Notes string `json:"notes,omitempty"`

	// UserID is the ID of the user who owns/created this volume record in the application database.
	// example: 1
	UserID uint `json:"user_id,omitempty"`

	// UpdatedAt is the timestamp when the volume record was last updated in the application database.
	// example: "2023-10-27T08:10:00Z"
	UpdatedAt time.Time `json:"updated_at,omitempty"`
}

type VolumeUsageData struct {
	Size     int64 `json:"size"`
	RefCount int64 `json:"ref_count"` // Changed to int64 to match Docker SDK
}

type Vulnerability struct {
	ID          string   `json:"id"`       // e.g., CVE-2023-1234
	Severity    string   `json:"severity"` // e.g., HIGH, MEDIUM, LOW, CRITICAL
	PackageName string   `json:"package_name"`
	Version     string   `json:"version"`
	FixVersion  string   `json:"fix_version,omitempty"`
	Description string   `json:"description,omitempty"`
	URLs        []string `json:"urls,omitempty"`       // Links to advisories, etc.
	CVSSScore   float64  `json:"cvss_score,omitempty"` // CVSS score if available
}