266 lines
10 KiB
Go
266 lines
10 KiB
Go
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, "<tr><td>%s</td><td class=\"desc\">%s</td><td><code>%s</code></td><td>%d</td><td>%s</td></tr>\n",
|
||
htmlEscape(it.Name), htmlEscape(desc), loc, it.Rows, humanBytes(it.Bytes))
|
||
}
|
||
// 包内目录树
|
||
var tree strings.Builder
|
||
fmt.Fprintf(&tree, "%s\n├─ index.html ← 本文件(清单 / 使用说明 / 恢复指引)\n├─ manifest.json ← 机器可读元数据(记事本可直接查看)\n", zipName)
|
||
for _, it := range items {
|
||
if it.Key == "attachments" || it.Key == "attachment" {
|
||
fmt.Fprintf(&tree, "├─ attachments/ ← 附件原文件(按备份时的原始相对路径存放)\n└─ attachment/\n └─ data.jsonl ← 附件元数据索引(每行一条 JSON)\n")
|
||
} else {
|
||
fmt.Fprintf(&tree, "├─ %s/\n └─ data.jsonl ← %s(每行一条 JSON,可用记事本/VS Code 打开)\n", it.Key, htmlEscape(it.Name))
|
||
}
|
||
}
|
||
treeStr := htmlEscape(tree.String())
|
||
|
||
cs := checksum
|
||
if cs == "" {
|
||
if c, ok := manifest["checksum"].(string); ok {
|
||
cs = c
|
||
}
|
||
}
|
||
csHTML := "<p class=\"meta\">校验和(sha256):包内为流式写入无法回填,请以系统内「数据归档 → 备份/清理历史 → 详情」中的校验和为准。</p>"
|
||
if cs != "" {
|
||
csHTML = "<p class=\"meta\">校验和(sha256):<code>" + cs + "</code></p>"
|
||
}
|
||
verifyCmd := ""
|
||
if zipPath != "" {
|
||
verifyCmd = "<p class=\"meta\">本地核对完整 zip 文件:在命令行执行 <code>certutil -hashfile \"" + htmlEscape(zipPath) + "\" SHA256</code>,与历史详情中的校验和比对。</p>"
|
||
}
|
||
|
||
return fmt.Sprintf(`<!doctype html><html lang="zh"><head><meta charset="utf-8">
|
||
<title>%s</title><style>
|
||
body{font-family:-apple-system,"Segoe UI",Roboto,"Microsoft YaHei",sans-serif;margin:32px auto;max-width:900px;color:#222;line-height:1.7}
|
||
h2{margin-bottom:4px}h3{margin-top:28px;border-bottom:1px solid #eee;padding-bottom:6px}
|
||
table{border-collapse:collapse;margin-top:8px;width:100%%}td,th{border:1px solid #ddd;padding:6px 10px;text-align:left;vertical-align:top}
|
||
th{background:#f7f8fa}td.desc{color:#555;font-size:13px}
|
||
.meta{color:#666;font-size:13px}code{background:#f4f4f5;padding:1px 5px;border-radius:3px;font-size:13px;word-break:break-all}
|
||
pre{background:#f7f8fa;border:1px solid #e5e7eb;border-radius:6px;padding:12px 16px;font-size:13px;overflow:auto;line-height:1.6}
|
||
.box{border:1px solid #f0d896;background:#fdf6e3;border-radius:6px;padding:10px 14px;font-size:13px}
|
||
ol li,ul li{margin-bottom:6px}
|
||
</style></head><body>
|
||
<h2>%s</h2>
|
||
<p class="meta">
|
||
备份时间窗:<b>%s ~ %s</b>(含起止日)| 生成时间:%s | 操作人:%s<br>
|
||
归档位置:<code>%s</code><br>
|
||
数据项:共 %d 项 | 明细大小合计:%s(zip 实际大小以文件属性为准,压缩后略小)
|
||
</p>
|
||
%s
|
||
%s
|
||
<h3>一、包内目录结构</h3>
|
||
<pre>%s</pre>
|
||
<h3>二、数据项明细</h3>
|
||
<table><tr><th>数据项</th><th>业务说明</th><th>包内位置</th><th>行数 / 文件数</th><th>大小</th></tr>%s</table>
|
||
<h3>三、如何打开与查看</h3>
|
||
<ol>
|
||
<li><b>本文件</b>:双击即可离线查看,无需联网、无需安装任何软件。</li>
|
||
<li><b>日志类数据(data.jsonl)</b>:每行一条 JSON 记录。用记事本 / Notepad++ / VS Code 直接打开查看;如需用 Excel 分析,请在 Excel 中「数据 → 获取数据 → 自文件 → 从 JSON」导入(切勿直接双击用 Excel 打开,避免长数字精度丢失)。</li>
|
||
<li><b>附件(attachments/ 目录)</b>:按备份时的原始相对路径存放原文件,可直接双击打开(图片、PDF、Office 文档等)。附件的清单(编号、原文件名、路径、大小、删除状态)见 <code>attachment/data.jsonl</code>——时间窗内已删除的附件同样包含在包内(元数据 deleted 标注),本机彻底清除后可凭包内拷贝找回(介质可读性由保管人自行核对)。</li>
|
||
<li><b>manifest.json</b>:机器可读元数据(时间窗、数据项、大小、生成时间、操作人),可供脚本化核对或二次导入使用。</li>
|
||
</ol>
|
||
<h3>四、恢复与保管说明</h3>
|
||
<div class="box">
|
||
<b>本包为离线冷备份,删除系统数据前请务必确认:</b>
|
||
<ul style="margin:6px 0">
|
||
<li>备份盘(U 盘 / 移动硬盘)已妥善保管,建议<b>双份异地保存</b>,并标注备份日期与时间窗;</li>
|
||
<li>本系统当前版本未提供自动恢复功能,如需将数据导回系统,请联系系统管理员按 manifest.json 逐项人工导入;</li>
|
||
<li>校验和与该次备份的详细信息(操作人、数据项、大小)可在系统「数据归档 → 备份/清理历史」中按时间窗查到。</li>
|
||
</ul>
|
||
</div>
|
||
<p class="meta" style="margin-top:20px">本文件由系统在备份时自动生成,仅作清单、说明与校验用途,不含任何业务数据内容。</p>
|
||
</body></html>`,
|
||
title, title,
|
||
manifest["rangeStartText"], manifest["rangeEndText"], manifest["generatedAt"], manifest["operator"],
|
||
htmlEscape(zipPath), len(items), humanBytes(sumItemBytes(items)),
|
||
csHTML, verifyCmd, treeStr, rows.String())
|
||
}
|
||
|
||
func sumItemBytes(items []ItemResult) int64 {
|
||
var n int64
|
||
for _, it := range items {
|
||
n += it.Bytes
|
||
}
|
||
return n
|
||
}
|