container

type ContainerConfig struct {
	Image string
	Cmd   []string
	Tty   bool
}

type ContainerStatsSummary struct {
	Duration    time.Duration `json:"-"`        // raw в наносекундах (не выводим)
	DurationStr string        `json:"Duration"` // человекочитаемый

	// CPU мы теперь храним в nanoseconds (чтобы никогда не было нуля),
	// а уже в JSON конвертируем его в проценты вручную
	CPUUsageNs uint64  `json:"CPUUsageNs"`
	CPUPercent float64 `json:"CPUPercent"`

	// Память храним в байтах, а в JSON делим на 1024, чтобы вывести в kilobytes
	MemUsage   uint64  `json:"-"`
	MemLimit   uint64  `json:"-"`
	MemUsageKB uint64  `json:"MemUsageKB"`
	MemLimitKB uint64  `json:"MemLimitKB"`
	MemPercent float64 `json:"MemPercent"`
}

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

type Manager interface {
	Create(config ContainerConfig) (string, error)
	Start(id string) error
	Stop(id string, timeout int) error
	Remove(id string) error
	GetLogs(id string) (string, error)
	Wait(id string) (container.WaitResponse, error)
	IsRunning(id string) (bool, error)
	GetStats(containerID string) (string, error)
	EnsureImage(image string) error
	GetStatsOneShot(containerID string, startTime time.Time) (ContainerStatsSummary, error)
	StreamStats(id string) (io.ReadCloser, error)
	Ping() error
}

type StatsRecord struct {
	ID            string        `json:"id"`
	StartTime     time.Time     `json:"start_time"`
	EndTime       time.Time     `json:"end_time"`
	Duration      time.Duration `json:"duration"`
	CPUUsageNs    uint64        `json:"cpu_usage_ns"`
	MemUsageBytes uint64        `json:"mem_usage_bytes"`
	MemMaxBytes   uint64        `json:"mem_max_bytes"`
}

type StatsResponse struct {
	CPUStats struct {
		// TotalUsage — кумулятивные наносекунды CPU
		CPUUsage struct {
			TotalUsage uint64 `json:"total_usage"`
		} `json:"cpu_usage"`
		// SystemUsage — кумулятивные наносекунды всех ядер
		SystemUsage uint64 `json:"system_cpu_usage"`
	} `json:"cpu_stats"`

	// PreCPUStats нужен, если ты захочешь рассчитывать %-ные изменения по docker-алгоритму
	PreCPUStats struct {
		CPUUsage struct {
			TotalUsage uint64 `json:"total_usage"`
		} `json:"cpu_usage"`
		SystemUsage uint64 `json:"system_cpu_usage"`
	} `json:"precpu_stats"`

	MemoryStats struct {
		Usage uint64 `json:"usage"`
		Limit uint64 `json:"limit"`
	} `json:"memory_stats"`
}