feat(import): 报名模板按「小项 × 组别」分工作表;号码布判重改认证件号;备份改原子落盘
三件事合成一次提交(其中两件都落在 handlers_config.go,无法按文件拆开): 一、分工作表报名模板(新增能力) - 新增 GET /api/entries/template.xlsx:按当前赛事的「小项 × 组别」生成模板, 一个小项组别一张工作表,工作表名 = <小项>@<组别>(31 字符上限、重名自动去重)。 - 导入解析器认工作表名还原小项 + 组别;若与表内列冲突则报错,不静默取其一。 - 小项名与组别名禁用 @,基础数据界面 / 规则包导入 / 服务端校验三处一并拦截。 - 单表 CSV/XLSX 导入路径不回归。 二、号码布判重(修误判) - 旧逻辑依赖证件号本身,而证件号是可选字段 → 同一个人报多个项目会被整块拦下。 - 改为:号码布相同且证件号相同 → 判定为同一人报多项,放行; 号码布相同且证件号都能填且不同 → 仍报错(真抢号);一方证件号为空 → 放行并给提示。 - 团体行的号码布一并纳入查重。 三、自动备份的关停与落盘(修数据安全隐患) - export.Service 增加 Wait():StartAuto 的协程进 WaitGroup,关停时 join(10 秒上限, 超时只记 WARN 不拖死关闭),不再在备份写到一半时退出。 - vacuumInto 改为先写 <最终名>.tmp-<随机> 再 rename,失败则删临时文件; Backup / SafetySnapshot / ExportProjectZip 三个调用方一并受益。 - 新增 isFinalBackupName,ListBackups / safetyCopies / KindOfBackupName 统一过滤中间文件, 避免半截 .db 被列进备份列表、进而被「一键恢复」选中。 文档:docs/ 五份(使用手册 / 报名名单导入规范 / 升级说明 / 部署指南 / 上线检查清单)同步。
This commit is contained in:
1 parent
b74768b7d5
commit
1b8a37ff8c
32 files changed
+3302
-233
No files matched your search
@@ -147,6 +147,11 @@ type Service struct {
|
||||
logger *slog.Logger
|
||||
|
||||
mu sync.Mutex
|
||||
|
||||
// wg 记着 StartAuto 起的后台协程,供 Wait 在进程退出前 join。
|
||||
// 只加不减:协程退出后 Wait 照常立即返回,所以「没起过自动备份」与
|
||||
// 「自动备份已经停了」两种情况下 Wait 都是零成本。
|
||||
wg sync.WaitGroup
|
||||
}
|
||||
|
||||
// NewService 构造备份服务;keep<=0 时按 DefaultBackupKeep 滚动保留。
|
||||
@@ -184,7 +189,9 @@ func (s *Service) StartAuto(ctx context.Context, interval time.Duration) {
|
||||
s.logger.Warn("未配置数据目录,跳过自动备份")
|
||||
return
|
||||
}
|
||||
s.wg.Add(1)
|
||||
go func() {
|
||||
defer s.wg.Done()
|
||||
ticker := time.NewTicker(interval)
|
||||
defer ticker.Stop()
|
||||
for {
|
||||
@@ -208,6 +215,22 @@ func (s *Service) StartAuto(ctx context.Context, interval time.Duration) {
|
||||
}()
|
||||
}
|
||||
|
||||
// Wait 等 StartAuto 起的后台协程退出,含「已经在飞、正卡在 VACUUM INTO 里」的那一轮备份。
|
||||
//
|
||||
// 调用点只有服务端 main:srv.Shutdown 之后、关库之前。不 join 的话,进程可能正卡在
|
||||
// VACUUM INTO 中途就退出——那一轮备份会停在半路(见 vacuumInto 的原子落盘,最坏也只是
|
||||
// 留下一个中间文件,但「停止写盘」这件事必须等出来才做数)。
|
||||
//
|
||||
// 不阻断、不改变任何既有语义:没起过自动备份(间隔 <=0、没配数据目录)时立即返回;
|
||||
// 它不取消上下文、也不打断正在跑的备份,只是等它们收尾。ctx 取消(含
|
||||
// POST /api/shutdown 复用的那个信号)仍然由调用方负责,本方法只解决「等没等到」。
|
||||
//
|
||||
// 注意:别再拿同一个 Service 在 Wait 期间调 StartAuto(sync.WaitGroup 的复用限制),
|
||||
// 服务端一生只调一次。
|
||||
func (s *Service) Wait() {
|
||||
s.wg.Wait()
|
||||
}
|
||||
|
||||
func (s *Service) snapshotAll(reason string, withSystem bool) ([]BackupInfo, error) {
|
||||
if strings.TrimSpace(s.dir) == "" {
|
||||
return nil, ErrNoDir
|
||||
@@ -246,6 +269,10 @@ func (s *Service) snapshot(db *sql.DB, prefix, reason string) (BackupInfo, error
|
||||
|
||||
// ListBackups 按时间倒序列出备份;prefix 为空时列出全部 .db 备份。
|
||||
// 不计算校验和(避免每次列表都全量读盘),需要校验时用 Backup 的返回值。
|
||||
//
|
||||
// 只认「已经落好的」备份文件(isFinalBackupName):中间文件一律不列。
|
||||
// 备份列表是「一键恢复」选文件的唯一数据源,把一份没写完的文件列出去,
|
||||
// 现场就可能拿它去覆盖好库——这比没有备份更糟。
|
||||
func ListBackups(dir, prefix string) ([]BackupInfo, error) {
|
||||
entries, err := os.ReadDir(dir)
|
||||
if os.IsNotExist(err) {
|
||||
@@ -258,7 +285,7 @@ func ListBackups(dir, prefix string) ([]BackupInfo, error) {
|
||||
prefix = strings.TrimSpace(prefix)
|
||||
out := make([]BackupInfo, 0, len(entries))
|
||||
for _, e := range entries {
|
||||
if e.IsDir() || !strings.HasSuffix(strings.ToLower(e.Name()), ".db") {
|
||||
if e.IsDir() || !isFinalBackupName(e.Name()) {
|
||||
continue
|
||||
}
|
||||
if prefix != "" && !strings.HasPrefix(e.Name(), prefix+"-") {
|
||||
@@ -285,6 +312,23 @@ func ListBackups(dir, prefix string) ([]BackupInfo, error) {
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// isFinalBackupName 判断目录项是不是一份「已经落好的」备份文件。
|
||||
//
|
||||
// 备份目录里会短暂(异常退出后则是长期)存在两类非最终文件,都必须挡住:
|
||||
// - VACUUM INTO 的中间文件 <最终名>.tmp-<随机>(见 vacuumInto);
|
||||
// - 任何别的写法留下的 .tmp 临时文件。
|
||||
//
|
||||
// 判据是「.db 结尾」且名字里的主干不含 tmpMark。备份名由本包生成
|
||||
// (<库>-<原因>-<时间戳>[-序号].db,原因只有 manual / auto / publish / pre-restore),
|
||||
// 正常备份不可能命中这个标记。
|
||||
func isFinalBackupName(name string) bool {
|
||||
lower := strings.ToLower(name)
|
||||
if !strings.HasSuffix(lower, ".db") {
|
||||
return false
|
||||
}
|
||||
return !strings.Contains(strings.TrimSuffix(lower, ".db"), tmpMark)
|
||||
}
|
||||
|
||||
// LatestBackup 返回最近一份备份(ListBackups 已按时间倒序,取首个)。
|
||||
//
|
||||
// 注意:它**不是**健康检查的输入——05 §9 明确说 GET /api/health 不返回「最近备份时间」,
|
||||
|
||||
Reference in new issue
Block a user