Files
bj_power/bj_power_mes/internal/backup/util.go
T

266 lines
10 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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("&", "&amp;", "<", "&lt;", ">", "&gt;", `"`, "&#34;").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
}