backup

type FileEntry struct {
	ID         uint   `json:"id"`
	Code       string `json:"code"`
	FilePath   string `json:"file_path"`
	Size       int64  `json:"size"`
	Status     string `json:"status"`
	ExpiredAt  string `json:"expired_at"`
	UsedCount  int    `json:"used_count"`
	UUIDFileNm string `json:"uuid_file_name"`
}

type FileList struct {
	// Count 记录条数。
	Count int `json:"count"`
	// Files 分享记录。
	Files []FileEntry `json:"files"`
}

type Manifest struct {
	// BackupFormat 格式版本（见 FormatVersion）。
	BackupFormat int `json:"backup_format"`
	// CreatedAt 导出时间（RFC3339）。
	CreatedAt string `json:"created_at"`
	// AppVersion 导出时的应用版本（构建版本）。
	AppVersion string `json:"app_version"`
	// CoreVersion 导出时的 core 版本（构建版本）。
	CoreVersion string `json:"core_version"`
	// DBType 数据库类型（当前仅 sqlite 支持快照；见 ErrUnsupportedDB）。
	DBType string `json:"db_type"`
	// StorageType 导出时的存储后端类型（local / s3 / …）。
	StorageType string `json:"storage_type"`
	// ObjectCount / ObjectBytes 对象数与总字节。
	ObjectCount int64 `json:"object_count"`
	ObjectBytes int64 `json:"object_bytes"`
	// FileCount 分享/取件码记录数。
	FileCount int64 `json:"file_count"`
	// Objects 对象清单（逐个 sha256）。
	Objects []ObjectEntry `json:"objects"`
	// MissingObjects **DB 引用了但磁盘上已经没有**的对象（存量数据本身缺失）。
	//
	// 为什么要单独记：真机实录（2026-10-31，10.10.10.3）——DB 里有 300+ 条分享记录，
	// 其中若干对象文件早被清理 ⇒ 若「读不到就整体失败」，**备份包在这台实例上根本导不出来**
	// ⇒ 灾备能力在最需要它的机器上反而不可用。
	// ⇒ 改成：缺失对象**跳过并如实记账**（不是静默吞掉）；其余故障（权限/网络/驱动错）
	// 仍然整体报错 —— 真故障不能吞。
	MissingObjects []string `json:"missing_objects"`
}

type ObjectEntry struct {
	// Path 存储相对路径（与 file_codes.file_path 同形 ⇒ 恢复时原样写回）。
	Path string `json:"path"`
	// Size 字节数。
	Size int64 `json:"size"`
	// SHA256 内容摘要（hex）⇒ 恢复前逐个校验。
	SHA256 string `json:"sha256"`
}

type ObjectLister interface {
	// ListReferencedObjectPaths 返回全部被引用的对象路径（去重）。
	ListReferencedObjectPaths(ctx context.Context) ([]string, error)
}

type ObjectStore interface {
	// GetFileReader 打开对象读取器（同时给出大小）。
	GetFileReader(ctx context.Context, filePath string) (io.ReadCloser, int64, error)
	// EffectiveType 当前生效的存储后端类型（记进 manifest ⇒ 恢复时知道源后端）。
	EffectiveType() string
	// SaveStream 把 reader 写入相对路径（路径逃逸由存储层自防）。
	SaveStream(ctx context.Context, savePath string, r io.Reader, expectedSize int64) (int64, error)
	// FileExists 对象是否已存在（**存量数据缺失**的判定：读之前先问一句，
	// 免得把「文件本来就没了」与「存储后端出故障」混为一谈）。
	FileExists(ctx context.Context, filePath string) bool
}

type RestoreOptions struct {
	// Confirm 显式确认（**破坏性操作必须确认**）。
	//
	// 恢复会**替换**数据库文件并重写对象 ⇒ 没确认就恢复 = 把线上数据换成一份
	// 可能不是你要的快照 ⇒ 一律先报错，由调用方（CLI）显式传 --yes。
	Confirm bool
	// DBPath 目标数据库文件（SQLite）。空 = 不恢复 DB（只恢复对象）。
	DBPath string
	// DryRun 只校验（manifest / 摘要 / DB 可用性），不落任何盘。
	DryRun bool
}

type RestoreResult struct {
	// Manifest 备份包清单。
	Manifest *Manifest
	// ObjectsRestored / BytesRestored 恢复的对象数与字节数。
	ObjectsRestored int64
	BytesRestored   int64
	// DBRestored 是否已替换数据库。
	DBRestored bool
	// MissingObjects DB 快照引用、但包里没有的对象（导出期间新上传 ⇒ 如实列出，不静默）。
	MissingObjects []string
}

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