package backup import ( "crypto/rand" "fmt" "io" "path/filepath" "reflect" "regexp" "strings" "time" ) // randReader 安全随机源。 func randReader() io.Reader { return rand.Reader } // sliceToAny 把任意切片([]*ent.Xxx)转成 []any,便于统一 JSON 序列化。 func sliceToAny(slice any) []any { if slice == nil { return nil } v := reflect.ValueOf(slice) if v.Kind() != reflect.Slice { return nil } out := make([]any, v.Len()) for i := 0; i < v.Len(); i++ { out[i] = v.Index(i).Interface() } return out } // complement 计算 [start,end] 在被若干区间并集覆盖后的缺失段(闭区间,秒)。 func complement(intervals [][2]int64, start, end int64) []MissingSeg { if start > end { return nil } // 归一化并排序 ivs := make([][2]int64, 0, len(intervals)) for _, iv := range intervals { if iv[0] <= iv[1] && iv[1] >= start && iv[0] <= end { ivs = append(ivs, [2]int64{maxInt64(iv[0], start), minInt64(iv[1], end)}) } } sortIntervals(ivs) missing := make([]MissingSeg, 0) cur := start for _, iv := range ivs { if iv[0] > cur { missing = append(missing, MissingSeg{Start: cur, End: iv[0] - 1}) } if iv[1] > cur { cur = iv[1] + 1 } } if cur <= end { missing = append(missing, MissingSeg{Start: cur, End: end}) } return missing } func sortIntervals(ivs [][2]int64) { for i := 0; i < len(ivs); i++ { for j := i + 1; j < len(ivs); j++ { if ivs[j][0] < ivs[i][0] { ivs[i], ivs[j] = ivs[j], ivs[i] } } } } func maxInt64(a, b int64) int64 { if a > b { return a } return b } func minInt64(a, b int64) int64 { if a < b { return a } return b } func formatMissing(segs []MissingSeg) string { parts := make([]string, 0, len(segs)) for _, s := range segs { parts = append(parts, fmt.Sprintf("%s ~ %s", time.Unix(s.Start, 0).Format("2006-01-02"), time.Unix(s.End, 0).Format("2006-01-02"))) } return strings.Join(parts, ";") } // coverageSegments 基于已排序备份区间计算 [start,end] 内的已覆盖段与缺失段(均为闭区间,秒)。 // covered=窗口 ∩ 备份区间并集(合并相邻/重叠段);missing=窗口内未被任何备份覆盖的段。 func coverageSegments(intervals [][2]int64, start, end int64) (covered, missing []MissingSeg) { if start > end { return nil, nil } ivs := make([][2]int64, 0, len(intervals)) for _, iv := range intervals { if iv[0] <= iv[1] && iv[1] >= start && iv[0] <= end { ivs = append(ivs, [2]int64{maxInt64(iv[0], start), minInt64(iv[1], end)}) } } sortIntervals(ivs) // 合并重叠/相邻段 → covered merged := make([][2]int64, 0, len(ivs)) for _, iv := range ivs { if n := len(merged); n > 0 && iv[0] <= merged[n-1][1]+1 { if iv[1] > merged[n-1][1] { merged[n-1][1] = iv[1] } continue } merged = append(merged, iv) } covered = make([]MissingSeg, 0, len(merged)) for _, iv := range merged { covered = append(covered, MissingSeg{Start: iv[0], End: iv[1]}) } return covered, complement(intervals, start, end) } // validateAck 强制清理实名留痕校验。 var phoneRe = regexp.MustCompile(`^1\d{10}$`) func validateAck(req CleanupRequest) error { if strings.TrimSpace(req.AckName) == "" { return fmt.Errorf("强制清理须填写确认人姓名(警示留痕)") } if !phoneRe.MatchString(strings.TrimSpace(req.AckPhone)) { return fmt.Errorf("强制清理须填写有效的 11 位手机号(警示留痕)") } return nil } func summaryDeleted(deleted, skipped []ItemResult) string { var b strings.Builder for _, d := range deleted { fmt.Fprintf(&b, "%s 删除 %d 行;", d.Name, d.Rows) } if len(skipped) > 0 { b.WriteString(" 跳过共享附件(对端未备份):") for _, s := range skipped { fmt.Fprintf(&b, "%s %d 个;", s.Name, s.Rows) } } return strings.TrimRight(b.String(), ";") } // htmlEscape 最小 HTML 转义(路径/操作人可能含特殊字符)。 func htmlEscape(s string) string { return strings.NewReplacer("&", "&", "<", "<", ">", ">", `"`, """).Replace(s) } // buildIndexHTML 生成备份包内 index.html:清单 + 包内目录说明 + 打开/校验/恢复指引。 // 双击即可离线查看;不内嵌数据预览(数据在包内 data.jsonl 与 attachments/ 中)。 func buildIndexHTML(title string, manifest map[string]any, checksum string, defs []ItemDef) string { items, _ := manifest["items"].([]ItemResult) zipPath, _ := manifest["zipPath"].(string) if zipPath == "" { zipPath, _ = manifest["targetPath"].(string) } zipName := "备份包" if zipPath != "" { zipName = filepath.Base(zipPath) } descByName := make(map[string]string, len(defs)) for _, d := range defs { descByName[d.Name] = d.Desc } // 数据项明细行 var rows strings.Builder for _, it := range items { desc := descByName[it.Name] loc := htmlEscape(it.Key) + "/data.jsonl" if it.Key == "attachments" || it.Key == "attachment" { loc = "attachments/(附件原文件,含已删除)+ attachment/data.jsonl(元数据,含删除状态标注)" } fmt.Fprintf(&rows, "
%s%s
| 数据项 | 业务说明 | 包内位置 | 行数 / 文件数 | 大小 |
|---|
attachment/data.jsonl——时间窗内已删除的附件同样包含在包内(元数据 deleted 标注),本机彻底清除后可凭包内拷贝找回(介质可读性由保管人自行核对)。