Files
AskaEth 877ff15823 feat(0.5.1): 业务逻辑审查 9 条 P0 全修 + 自绘安装器 + 现场反馈四项
## 算分正确性(6 份只读审查 → 收敛成 5 个病根,均先复现失败再修)
- 「人工名次」与「自动名次回写」互斥:原来同一份成绩**发布两次分数不同**
  (团体报名项 dual 通道 10/8/6 → 25/18/14),现在连发多次逐字节一致
- 删小项时在同一事务作废旧流水并推榜:原来分数**永久残留**在总榜、任何重算都打不到
- 规则包导入整体事务化:原来中途失败会清空名次表且补不回(奖牌全丢);
  另加守卫「compare=none 的小项不得配 basis=result/aggregate」
- 末位归零只抹真正落在末位的那一档:原来跨末位的并列组会被整组抹 0
  (7 人三人并列第 5 时第 5、6 名的分也一起没了)
- 模板「分值表档位超出录取名次」现在拒绝保存:原来静默截断成 0 分

## 现场反馈(主人实测报的)
- 已发布成绩可改:行内「修改本条」+ 成绩格/状态格可点(退回草稿→改→重新发布本组),
  与「作废」语义分开;取消路径不产生任何副作用
- 单位积分明细补「运动员 / 来源」列,并显示「已修订 ×N(时间·原因)」:
  管理端、大屏覆盖层、xlsx 备注列三处同源
- 单位奖牌榜改为按奖牌独立排名(金→银→铜→单位编码),与积分榜解耦
- 历史孤儿积分流水清理(迁移 0022,只动 result/record_bonus,人工调整分不受影响)

## 新功能
- 团体项目聚合口径二选一:平均(默认)/ 总和(迁移 0023,通道编辑器可切)

## 安装器
- 自绘五页安装界面:无边框、自绘标题栏、DPI 自适应(4K@200% 实测)、
  安装/卸载逻辑复用 electron-builder 宏不变;默认「为所有用户安装」并自动放行防火墙 19540
- 构建期校验:安装器素材里的版本号必须与 VERSION 一致,否则构建失败

自检:服务端 14 包 ×2 / 前端 vue-tsc + build + 742 例 ×2 / Console 20 文件 + 68 例 ×2,全绿。
端到端对拍:修前 vs 修后,纯团体 / 双计 / 普通个人三形态**逐字节一致**,仅出 bug 的双通道形态按要求改变。
2026-09-13 15:20:18 +08:00

78 lines
2.4 KiB
Go

package rules
import (
"bytes"
"errors"
"fmt"
"io"
"gopkg.in/yaml.v3"
)
// 导出文件的注释头:规则包可能含赛事敏感信息,不进版本库(rules/README.md)。
const header = `# 积分规则包 · scoreboard-rules v1
# 由系统导出,可手工编辑后再导入;导入前请先预览差异。
# 注意:本文件可能含赛事敏感信息,请勿提交到版本库。
`
// Parse 解析并校验规则包 YAML。未知字段一律报错,避免拼错的配置被静默忽略。
func Parse(data []byte) (*RulePack, error) {
if len(bytes.TrimSpace(data)) == 0 {
return nil, fmt.Errorf("%w: 内容为空", ErrNotRulePack)
}
dec := yaml.NewDecoder(bytes.NewReader(data))
dec.KnownFields(true)
var pack RulePack
if err := dec.Decode(&pack); err != nil {
if errors.Is(err, io.EOF) {
return nil, fmt.Errorf("%w: 内容为空", ErrNotRulePack)
}
return nil, fmt.Errorf("解析规则包 YAML: %w", err)
}
// 规则包只允许一个文档;多文档容易让人以为后面的也会生效。
var extra any
if err := dec.Decode(&extra); err == nil {
return nil, fmt.Errorf("%w: 只允许一个 YAML 文档", ErrNotRulePack)
} else if !errors.Is(err, io.EOF) {
return nil, fmt.Errorf("解析规则包 YAML: %w", err)
}
canonical := pack.Canonical()
if err := canonical.Validate(); err != nil {
return nil, err
}
// 导入是写入路径:在解析阶段就拦下「这份配置算不出分」的情况(例如分值表配到第 7 档、
// awardRanks 还是 6,第 7 档进来就会静默变 0 分)。导出侧不走这里——历史库里已经存在的
// 越档模板照样要能导出来(见 Validate 与 ValidateForImport 的注释)。
if err := canonical.ValidateForImport(); err != nil {
return nil, err
}
return &canonical, nil
}
// Marshal 把规则包序列化成带注释头的 YAML;输出是规范化后的结果,可安全往返。
func Marshal(pack *RulePack) ([]byte, error) {
if pack == nil {
return nil, fmt.Errorf("%w: 规则包为空", ErrNotRulePack)
}
canonical := pack.Canonical()
if err := canonical.Validate(); err != nil {
return nil, err
}
var buf bytes.Buffer
buf.WriteString(header)
enc := yaml.NewEncoder(&buf)
enc.SetIndent(2)
if err := enc.Encode(&canonical); err != nil {
return nil, fmt.Errorf("序列化规则包 YAML: %w", err)
}
if err := enc.Close(); err != nil {
return nil, fmt.Errorf("序列化规则包 YAML: %w", err)
}
return buf.Bytes(), nil
}