k8sbackup

type Manifest struct {
	SchemaVersion int               `json:"schema_version"`
	Generator     ManifestGenerator `json:"generator"`
	Job           ManifestJob       `json:"job"`
	Snapshot      ManifestSnapshot  `json:"snapshot"`
	Kubernetes    ManifestCluster   `json:"kubernetes"`
	Spec          *Spec             `json:"spec"`
	Resources     ManifestResources `json:"resources"`
	Volumes       []VolumeResult    `json:"volumes"`
	Warnings      []string          `json:"warnings,omitempty"`
	Restore       ManifestRestore   `json:"restore"`
	// Partial marks a manifest the server assembled from the volume outcomes because
	// the run ended (resources step failed, cancelled) before the agent produced one:
	// only Job, Snapshot and Volumes are meaningful, and nothing was uploaded for it
	Partial bool `json:"partial,omitempty"`
}

type ManifestCluster struct {
	ServerVersion string `json:"server_version,omitempty"`
	SnapshotCRD   bool   `json:"snapshot_crd"`
}

type ManifestGenerator struct {
	Agent   string `json:"agent"`
	Version string `json:"version"`
	Cluster string `json:"cluster"`
}

type ManifestJob struct {
	ID          string `json:"id"`
	Name        string `json:"name,omitempty"`
	RunID       string `json:"run_id,omitempty"`
	BackupRunID string `json:"backup_run_id"`
}

type ManifestResources struct {
	DumpedAt        time.Time      `json:"dumped_at"`
	Counts          map[string]int `json:"counts,omitempty"` // "apps/deployments" -> n
	Excluded        []string       `json:"excluded,omitempty"`
	FailedGroups    []string       `json:"failed_groups,omitempty"`
	SecretsIncluded bool           `json:"secrets_included"`
	Namespaces      []string       `json:"namespaces,omitempty"`
}

type ManifestRestore struct {
	Summary  string   `json:"summary"`
	Commands []string `json:"commands"`
}

type ManifestSnapshot struct {
	Type    string    `json:"type"`
	ID      string    `json:"id"`
	Time    time.Time `json:"time"`
	Archive string    `json:"archive"`
}

type NamespaceFilter struct {
	Include []string `json:"include,omitempty"`
	Exclude []string `json:"exclude,omitempty"`
}

type Plan struct {
	ClusterName    string       `json:"cluster_name"`
	ServerVersion  string       `json:"server_version,omitempty"`
	SnapshotCRD    bool         `json:"snapshot_crd"`
	AgentNamespace string       `json:"agent_namespace,omitempty"`
	Volumes        []VolumePlan `json:"volumes"`
	Warnings       []string     `json:"warnings,omitempty"`
}

type ResourceOptions struct {
	// ExcludeExtra adds group/resource patterns to the built-in exclusion list
	// ("apps/deployments", "*/secrets", "cert-manager.io/*")
	ExcludeExtra []string `json:"exclude_extra,omitempty"`
	// IncludeSecrets defaults to true: a disaster-recovery backup without Secrets is
	// crippled; the UI carries the warning instead
	IncludeSecrets *bool `json:"include_secrets,omitempty"`
}

type Spec struct {
	Namespaces    NamespaceFilter `json:"namespaces"`
	LabelSelector string          `json:"label_selector,omitempty"`
	Resources     ResourceOptions `json:"resources"`
	Volumes       VolumeOptions   `json:"volumes"`
}

type VolumeOptions struct {
	Mode          string `json:"mode,omitempty"` // all | labeled | none
	LabelSelector string `json:"label_selector,omitempty"`
	// SkipLabelSelector excludes PVCs whose labels match it (e.g. fallbck.io/skip-backup=true),
	// on top of the built-in fallbck.io/skip annotation; applied after LabelSelector
	SkipLabelSelector string `json:"skip_label_selector,omitempty"`
	// Namespaces overrides the top-level namespace filter for volumes (nil = inherit)
	Namespaces            *NamespaceFilter `json:"namespaces,omitempty"`
	StorageClasses        []string         `json:"storage_classes,omitempty"`
	ExcludeStorageClasses []string         `json:"exclude_storage_classes,omitempty"`
	// SnapshotClassOverrides maps a StorageClass to the VolumeSnapshotClass to use
	SnapshotClassOverrides map[string]string `json:"snapshot_class_overrides,omitempty"`
	// AllowLiveFallback (default true) backs up volumes without snapshot support by
	// mounting them read-only (rsync-grade consistency)
	AllowLiveFallback *bool `json:"allow_live_fallback,omitempty"`
	// ContinueOnError (default true) records failed volumes and completes the run
	ContinueOnError *bool `json:"continue_on_error,omitempty"`
	// Parallelism bounds concurrent volume uploads (worker pods), 1..8, default 2
	Parallelism int `json:"parallelism,omitempty"`
	// SnapshotTimeout waits for a VolumeSnapshot to become ready (default 10m, max 30m)
	SnapshotTimeout string `json:"snapshot_timeout,omitempty"`
	// VolumeTimeout bounds one volume's snapshot+upload (default 2h, max 5h)
	VolumeTimeout string `json:"volume_timeout,omitempty"`
}

type VolumePlan struct {
	Namespace     string `json:"namespace"`
	PVCName       string `json:"pvc"`
	PVName        string `json:"pv,omitempty"`
	StorageClass  string `json:"storage_class,omitempty"`
	Provisioner   string `json:"provisioner,omitempty"`
	VolumeMode    string `json:"volume_mode,omitempty"`
	CapacityBytes int64  `json:"capacity_bytes,omitempty"`
	// Mode: snapshot | live | skipped
	Mode          string `json:"mode"`
	SnapshotClass string `json:"snapshot_class,omitempty"`
	// GroupID is the PBS backup group this volume uploads into
	GroupID    string `json:"group_id"`
	SkipReason string `json:"skip_reason,omitempty"`
}

type VolumeResult struct {
	Namespace string `json:"namespace"`
	PVCName   string `json:"pvc"`
	GroupID   string `json:"group_id"`
	// Mode actually used (snapshot may fall back to live)
	Mode string `json:"mode"`
	// Consistency: csi-snapshot | crash-consistent-live
	Consistency string `json:"consistency,omitempty"`
	// Status: completed | failed | skipped | cancelled
	Status        string  `json:"status"`
	SnapshotID    string  `json:"snapshot_id,omitempty"`
	BytesScanned  int64   `json:"bytes_scanned"`
	BytesUploaded int64   `json:"bytes_uploaded"`
	ChunkCount    int     `json:"chunk_count"`
	DedupRatio    float64 `json:"dedup_ratio,omitempty"`
	DurationMS    int64   `json:"duration_ms,omitempty"`
	Error         string  `json:"error,omitempty"`
}