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 的双通道形态按要求改变。
This commit is contained in:
AskaEth committed
1 parent
78b14efaa9
commit
877ff15823
181 files changed
+8747
-371
No files matched your search
@@ -1,6 +1,7 @@
|
||||
package export
|
||||
|
||||
import (
|
||||
"context"
|
||||
"database/sql"
|
||||
"encoding/json"
|
||||
"fmt"
|
||||
@@ -9,6 +10,7 @@ import (
|
||||
"time"
|
||||
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/domain"
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/revisions"
|
||||
)
|
||||
|
||||
// Meta 是导出件抬头里的赛事信息；留空的字段自动回落到赛事库的 settings。
|
||||
@@ -646,7 +648,8 @@ func loadTeamDetailRows(db *sql.DB, teamID int64) ([]TeamDetailRow, error) {
|
||||
SELECT COALESCE(s.name, ''), COALESCE(e.name, ''), COALESCE(c.name, ca.name, ''),
|
||||
COALESCE(a.name, ''), `+teamDetailRankExpr+`, COALESCE(r.result_text, ''),
|
||||
COALESCE(r.unit, ''),
|
||||
l.source_type, l.points, COALESCE(l.void_reason, ''), COALESCE(l.athlete_id, 0)
|
||||
l.source_type, l.points, COALESCE(l.void_reason, ''), COALESCE(l.athlete_id, 0),
|
||||
COALESCE(l.event_id, 0), COALESCE(l.entry_id, 0)
|
||||
FROM score_ledger l
|
||||
LEFT JOIN events e ON e.id = l.event_id
|
||||
LEFT JOIN sports s ON s.id = e.sport_id
|
||||
@@ -673,13 +676,15 @@ func loadTeamDetailRows(db *sql.DB, teamID int64) ([]TeamDetailRow, error) {
|
||||
defer func() { _ = rows.Close() }()
|
||||
|
||||
var out []TeamDetailRow
|
||||
// 每条流水背后的成绩身份（(小项, 报名项)，口径见 internal/revisions），用来补「备注」列的修订痕迹。
|
||||
keys := make([]revisions.Key, 0, len(out))
|
||||
for rows.Next() {
|
||||
var r TeamDetailRow
|
||||
var source string
|
||||
var athleteID int64
|
||||
var athleteID, eventID, entryID int64
|
||||
var resultText, unit string
|
||||
if err := rows.Scan(&r.SportName, &r.EventName, &r.Category, &r.AthleteName, &r.Rank,
|
||||
&resultText, &unit, &source, &r.Points, &r.Remark, &athleteID); err != nil {
|
||||
&resultText, &unit, &source, &r.Points, &r.Remark, &athleteID, &eventID, &entryID); err != nil {
|
||||
return nil, fmt.Errorf("export: 扫描积分明细: %w", err)
|
||||
}
|
||||
// 成绩与分项成绩表 / 个人明细同口径（走 displayResult），否则同一场比赛的同一个成绩
|
||||
@@ -687,14 +692,70 @@ func loadTeamDetailRows(db *sql.DB, teamID int64) ([]TeamDetailRow, error) {
|
||||
r.ResultText = displayResult(resultText, unit)
|
||||
r.Source = sourceLabel(source)
|
||||
r.individual = athleteID != 0
|
||||
keys = append(keys, revisions.KeyFor(source, eventID, entryID))
|
||||
out = append(out, r)
|
||||
}
|
||||
if err := rows.Err(); err != nil {
|
||||
return nil, fmt.Errorf("export: 遍历积分明细: %w", err)
|
||||
}
|
||||
attachRevisionRemarks(out, keys, loadRevisionTrails(db, keys))
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// loadRevisionTrails 取这些成绩的修订痕迹；查不出来只留空，导出照旧出。
|
||||
//
|
||||
// 导出件与屏幕上写的必须是同一句话（口径见 internal/revisions）：明细在屏幕上挂着
|
||||
// 「已修订 ×2」，xlsx 里一个字没有，事后拿表格对账的人就不知道该信哪份。
|
||||
func loadRevisionTrails(db *sql.DB, keys []revisions.Key) map[revisions.Key]revisions.Trail {
|
||||
trails, err := revisions.Load(context.Background(), db, keys)
|
||||
if err != nil {
|
||||
return nil
|
||||
}
|
||||
return trails
|
||||
}
|
||||
|
||||
// attachRevisionRemarks 把修订痕迹写进「备注」列：`已修订 ×2；最后一次 10:42 成绩录入笔误`。
|
||||
//
|
||||
// 没改过（或追不出来）的行备注留空 —— 这个列本来只写「作废理由」，而作废的流水不会出现在这里，
|
||||
// 所以正常行本来就是空白，只有真被改过的成绩才会多出一句话。
|
||||
func attachRevisionRemarks(rows []TeamDetailRow, keys []revisions.Key, trails map[revisions.Key]revisions.Trail) {
|
||||
for i, key := range keys {
|
||||
if i >= len(rows) {
|
||||
return
|
||||
}
|
||||
trail, ok := trails[key]
|
||||
if !ok || trail.Count == 0 {
|
||||
continue
|
||||
}
|
||||
text := fmt.Sprintf("已修订 ×%d", trail.Count)
|
||||
if clock := revisionClock(trail.At); clock != "" {
|
||||
text += "；最后一次 " + clock
|
||||
if trail.Reason != "" {
|
||||
text += " " + trail.Reason
|
||||
}
|
||||
} else if trail.Reason != "" {
|
||||
text += "；" + trail.Reason
|
||||
}
|
||||
if rows[i].Remark == "" {
|
||||
rows[i].Remark = text
|
||||
} else {
|
||||
rows[i].Remark += "；" + text
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// revisionClock 把 result_revisions.created_at 转成 `HH:mm`（本地时区）。
|
||||
//
|
||||
// 库里存的是 datetime('now') 的 UTC 但不带时区，按 UTC 解析再转本地 —— 与前端
|
||||
// shared/format.ts 的 toDate 同一口径，否则导出件上的 10:42 会比大屏早 8 小时。
|
||||
func revisionClock(at string) string {
|
||||
parsed, err := time.ParseInLocation("2006-01-02 15:04:05", strings.TrimSpace(at), time.UTC)
|
||||
if err != nil {
|
||||
return ""
|
||||
}
|
||||
return parsed.Local().Format("15:04")
|
||||
}
|
||||
|
||||
func rankLabel(rank int, isTie bool) string {
|
||||
if rank <= 0 {
|
||||
return ""
|
||||
|
||||
@@ -3,8 +3,15 @@ package export
|
||||
import (
|
||||
"context"
|
||||
"database/sql"
|
||||
"encoding/json"
|
||||
"path/filepath"
|
||||
"regexp"
|
||||
"strings"
|
||||
"testing"
|
||||
|
||||
"github.com/xuri/excelize/v2"
|
||||
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/dto"
|
||||
"git.yeij.top/AskaEth/Scoreboard/server/internal/realtime"
|
||||
)
|
||||
|
||||
@@ -27,6 +34,10 @@ func TestExportStandingsMatchesSnapshot(t *testing.T) {
|
||||
if len(wb.Team) != len(snap.Standings) {
|
||||
t.Fatalf("单位数不一致：导出 %d，快照 %d", len(wb.Team), len(snap.Standings))
|
||||
}
|
||||
medalRank := make(map[int64]int, len(wb.Medal))
|
||||
for _, m := range wb.Medal {
|
||||
medalRank[m.TeamID] = m.Rank
|
||||
}
|
||||
for _, s := range snap.Standings {
|
||||
idx := -1
|
||||
for i := range wb.Team {
|
||||
@@ -43,6 +54,10 @@ func TestExportStandingsMatchesSnapshot(t *testing.T) {
|
||||
row.Bronze != s.Bronze || row.Medals != s.MedalTotal || row.Rank != s.Rank {
|
||||
t.Errorf("单位 %d 口径不一致：导出 %+v，快照 %+v", s.TeamID, row, s)
|
||||
}
|
||||
// 单位奖牌榜的名次也必须同源：xlsx 的奖牌榜名次 = 快照下发的 medalRank。
|
||||
if got := medalRank[s.TeamID]; got != s.MedalRank {
|
||||
t.Errorf("单位 %d 的奖牌榜名次不一致：导出 %d，快照 %d", s.TeamID, got, s.MedalRank)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -138,6 +153,107 @@ func TestLoadStandingsHonoursTieBreak(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// 单位奖牌榜独立于积分榜（主人 2026-09-13 拍板，06 报告 P1④）：
|
||||
// T1 有 1 金但只 5 分、T2 无牌却 10 分——总积分榜 T2 在前，奖牌榜必须 T1 在前。
|
||||
// 三处同源：xlsx 的「单位奖牌榜」sheet 与 WS 快照下发的 medalRank 都出自 domain.BuildMedalStandings。
|
||||
func TestLoadStandingsMedalBoardIndependentOfPoints(t *testing.T) {
|
||||
db := openEventDB(t)
|
||||
seedEvent(t, db)
|
||||
// 与 TestLoadStandingsHonoursTieBreak 同一份造数：T1 金牌 1 / 5 分，T2 无牌 / 10 分。
|
||||
for _, s := range []string{
|
||||
`UPDATE score_ledger SET points = 5 WHERE team_id = 1`,
|
||||
`UPDATE score_ledger SET points = 10 WHERE team_id = 2`,
|
||||
} {
|
||||
if _, err := db.Exec(s); err != nil {
|
||||
t.Fatalf("造数据 %q: %v", s, err)
|
||||
}
|
||||
}
|
||||
seedChannelRanks(t, db)
|
||||
|
||||
wb, err := LoadStandingsWorkbook(db, Options{})
|
||||
if err != nil {
|
||||
t.Fatalf("导出总表: %v", err)
|
||||
}
|
||||
if wb.Team[0].Code != "T2" {
|
||||
t.Fatalf("总积分榜仍按总分排，榜首 = %q，期望 T2", wb.Team[0].Code)
|
||||
}
|
||||
if len(wb.Medal) != 2 || wb.Medal[0].Code != "T1" || wb.Medal[0].Rank != 1 || wb.Medal[0].Gold != 1 {
|
||||
t.Fatalf("奖牌榜应按金牌排，榜首 = %+v，期望 T1（1 金、名次 1）", wb.Medal)
|
||||
}
|
||||
if wb.Medal[1].Code != "T2" || wb.Medal[1].Rank != 2 {
|
||||
t.Fatalf("奖牌榜次席 = %+v，期望 T2（名次 2）", wb.Medal[1])
|
||||
}
|
||||
|
||||
// WS 快照（大屏推送）必须给出同一套奖牌榜名次。
|
||||
hub := realtime.NewHub(db, testLogger())
|
||||
defer func() { _ = hub.Close() }()
|
||||
snap, err := hub.Snapshot(context.Background())
|
||||
if err != nil {
|
||||
t.Fatalf("读取 WS 快照: %v", err)
|
||||
}
|
||||
rows := make(map[string]dto.StandingRow, len(snap.Standings))
|
||||
for _, r := range snap.Standings {
|
||||
rows[r.TeamCode] = r
|
||||
}
|
||||
if rows["T1"].MedalRank != 1 || rows["T2"].MedalRank != 2 {
|
||||
t.Fatalf("快照的奖牌榜名次 = T1:%d T2:%d，期望 1 / 2", rows["T1"].MedalRank, rows["T2"].MedalRank)
|
||||
}
|
||||
// 两套名次确实解耦：T1 总分低，总积分榜名次仍是 2。
|
||||
if rows["T1"].Rank != 2 || rows["T2"].Rank != 1 {
|
||||
t.Fatalf("快照的总积分榜名次 = T1:%d T2:%d，期望 2 / 1", rows["T1"].Rank, rows["T2"].Rank)
|
||||
}
|
||||
|
||||
// xlsx 的「单位奖牌榜」sheet 必须照同一个顺序落表（表头下一行就是第一名）。
|
||||
path := filepath.Join(t.TempDir(), "standings.xlsx")
|
||||
if err := ExportStandingsXLSX(db, path, Options{}); err != nil {
|
||||
t.Fatalf("导出总表 xlsx: %v", err)
|
||||
}
|
||||
f, err := excelize.OpenFile(path)
|
||||
if err != nil {
|
||||
t.Fatalf("打开导出件: %v", err)
|
||||
}
|
||||
defer func() { _ = f.Close() }()
|
||||
sheet := sheetNamed(t, f, "单位奖牌榜")
|
||||
sheetRows, err := f.GetRows(sheet)
|
||||
if err != nil {
|
||||
t.Fatalf("读取 %s: %v", sheet, err)
|
||||
}
|
||||
// 表头之前还有大标题 / 副标题 / 空行，按表头文字定位，别写死行号。
|
||||
head := -1
|
||||
for i, row := range sheetRows {
|
||||
if len(row) > 0 && row[0] == "名次" {
|
||||
head = i
|
||||
break
|
||||
}
|
||||
}
|
||||
if head < 0 {
|
||||
t.Fatalf("%s 里找不到表头行：%v", sheet, sheetRows)
|
||||
}
|
||||
if len(sheetRows) < head+3 {
|
||||
t.Fatalf("%s 数据行数 = %d，期望表头 + 2 行", sheet, len(sheetRows)-head-1)
|
||||
}
|
||||
// 列序：名次 / 单位代码 / 单位名称 / 金牌 / 银牌 / 铜牌 / 奖牌合计 / 总分。
|
||||
first, second := sheetRows[head+1], sheetRows[head+2]
|
||||
if first[0] != "1" || first[1] != "T1" || first[3] != "1" {
|
||||
t.Fatalf("奖牌榜首行 = %v，期望 1 / T1 / 1 金", first)
|
||||
}
|
||||
if second[0] != "2" || second[1] != "T2" {
|
||||
t.Fatalf("奖牌榜次行 = %v，期望 2 / T2", second)
|
||||
}
|
||||
}
|
||||
|
||||
// sheetNamed 按后缀取工作表名：导出件的工作表名带赛事名前缀（如「测试运动会 · 单位奖牌榜」）。
|
||||
func sheetNamed(t *testing.T, f *excelize.File, suffix string) string {
|
||||
t.Helper()
|
||||
for _, name := range f.GetSheetList() {
|
||||
if strings.HasSuffix(name, suffix) {
|
||||
return name
|
||||
}
|
||||
}
|
||||
t.Fatalf("导出件里没有以 %q 结尾的工作表：%v", suffix, f.GetSheetList())
|
||||
return ""
|
||||
}
|
||||
|
||||
// 停用但仍有积分的单位要显示编码/名称，不能是空行。
|
||||
func TestLoadStandingsShowsInactiveTeam(t *testing.T) {
|
||||
db := openEventDB(t)
|
||||
@@ -605,6 +721,96 @@ func TestEventRowsIncludeDraftsKeepsDraftValues(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
// 「备注」列要带上修订痕迹：屏幕上挂着「已修订 ×2」而导出件一个字没有，
|
||||
// 事后拿表格对账的人就不知道该信哪份。判定口径见 internal/revisions。
|
||||
func TestTeamDetailRemarkCarriesRevisionTrail(t *testing.T) {
|
||||
db := openEventDB(t)
|
||||
seedEvent(t, db)
|
||||
seedDetailRevisions(t, db)
|
||||
|
||||
wb, err := LoadTeamDetailWorkbook(db, 1, Options{})
|
||||
if err != nil {
|
||||
t.Fatalf("读取积分明细: %v", err)
|
||||
}
|
||||
rows := teamDetailRows(wb.Rows, wb.IndividualToTeamWeight)
|
||||
if len(rows) < 2 {
|
||||
t.Fatalf("明细行数 = %d，期望含合计行", len(rows))
|
||||
}
|
||||
// 备注是第 10 列（下标 9）。按「来源」找行，不按下标 —— 行序由名次决定，别把断言写死在行号上。
|
||||
for _, row := range rows {
|
||||
switch row[7] {
|
||||
case "成绩":
|
||||
if got, ok := row[9].(string); !ok ||
|
||||
!regexp.MustCompile(`^已修订 ×1；最后一次 \d{2}:\d{2} 成绩录入笔误$`).MatchString(got) {
|
||||
t.Errorf("成绩行备注 = %v，期望 `已修订 ×1；最后一次 HH:MM 成绩录入笔误`", row[9])
|
||||
}
|
||||
case "破纪录加分":
|
||||
// 破纪录加分是站在成绩旁边的另一笔分，不继承成绩的修订痕迹（见 revisions.KeyFor）。
|
||||
if got, _ := row[9].(string); got != "" {
|
||||
t.Errorf("破纪录加分行备注 = %q，期望留空（改的是成绩，不是这笔加分）", got)
|
||||
}
|
||||
}
|
||||
}
|
||||
// 合计行的备注留空，不被带上。
|
||||
if got, _ := rows[len(rows)-1][9].(string); got != "" {
|
||||
t.Errorf("合计行备注 = %q，期望留空", got)
|
||||
}
|
||||
}
|
||||
|
||||
// 没改过的成绩备注必须留空 —— 导出侧同样不许出现「其实没改过却写了已修订」。
|
||||
func TestTeamDetailRemarkEmptyWhenNeverRevised(t *testing.T) {
|
||||
db := openEventDB(t)
|
||||
seedEvent(t, db)
|
||||
// 只发布过一版（有基线、没改动）：能追溯，但一个字都不该写。
|
||||
writeRevision(t, db, "2026-09-13 02:40:00", "", []map[string]any{
|
||||
{"entryId": 1, "resultText": "11.58", "resultValue": 11.58, "unit": "s", "status": "ok"},
|
||||
})
|
||||
|
||||
wb, err := LoadTeamDetailWorkbook(db, 1, Options{})
|
||||
if err != nil {
|
||||
t.Fatalf("读取积分明细: %v", err)
|
||||
}
|
||||
rows := teamDetailRows(wb.Rows, wb.IndividualToTeamWeight)
|
||||
if got, _ := rows[0][9].(string); got != "" {
|
||||
t.Errorf("没改过的成绩备注 = %q，期望留空", got)
|
||||
}
|
||||
}
|
||||
|
||||
// seedDetailRevisions 造一条「发布 → 改成绩 → 重新发布」的历史：张三那条 11.58 被改成 11.42。
|
||||
// 两条修订都带上同小项另一条成绩，证明「别人改了」不会把修订痕迹算到自己头上。
|
||||
func seedDetailRevisions(t *testing.T, db *sql.DB) {
|
||||
t.Helper()
|
||||
writeRevision(t, db, "2026-09-13 02:40:00", "", []map[string]any{
|
||||
{"entryId": 1, "rank": 1, "resultText": "11.58", "resultValue": 11.58, "unit": "s", "state": "published"},
|
||||
{"entryId": 2, "rank": 2, "resultText": "11.90", "resultValue": 11.90, "unit": "s", "state": "published"},
|
||||
})
|
||||
writeRevision(t, db, "2026-09-13 02:58:00", "", []map[string]any{
|
||||
{"entryId": 1, "rank": 1, "resultText": "11.42", "resultValue": 11.42, "unit": "s", "state": "published",
|
||||
"note": "成绩录入笔误"},
|
||||
// 名次 2 → 1 是改张三的成绩后引擎重算的，李四这条自己没动过。
|
||||
{"entryId": 2, "rank": 1, "resultText": "11.90", "resultValue": 11.90, "unit": "s", "state": "published"},
|
||||
})
|
||||
// 同一报名项上再挂一条破纪录加分流水：它不该继承成绩的修订痕迹。
|
||||
if _, err := db.Exec(`INSERT INTO score_ledger(team_id, athlete_id, event_id, entry_id, result_id,
|
||||
source_type, source_id, points)
|
||||
VALUES (1, 1, 1, 1, 1, 'record_bonus', 1, 3)`); err != nil {
|
||||
t.Fatalf("写入破纪录加分流水: %v", err)
|
||||
}
|
||||
}
|
||||
|
||||
// writeRevision 往 result_revisions 里插一版快照（字段名与 httpapi.resultDTO 对齐）。
|
||||
func writeRevision(t *testing.T, db *sql.DB, createdAt, message string, results []map[string]any) {
|
||||
t.Helper()
|
||||
raw, err := json.Marshal(results)
|
||||
if err != nil {
|
||||
t.Fatalf("序列化快照: %v", err)
|
||||
}
|
||||
if _, err := db.Exec(`INSERT INTO result_revisions (event_id, action, snapshot_json, message, created_at)
|
||||
VALUES (1, 'publish', ?, ?, ?)`, string(raw), message, createdAt); err != nil {
|
||||
t.Fatalf("插入修订: %v", err)
|
||||
}
|
||||
}
|
||||
|
||||
// equalCells 逐格比较两行；float64 与 string 都按值比。
|
||||
func equalCells(got, want []any) bool {
|
||||
if len(got) != len(want) {
|
||||
|
||||
@@ -157,7 +157,9 @@ func medalRow(r MedalDetailRow) []any {
|
||||
}
|
||||
|
||||
// LoadMedalDetailWorkbook 读取全部奖牌来源。
|
||||
// 单位顺序沿用「单位奖牌榜」（与单位总分榜同序），没有奖牌的单位不出分表。
|
||||
// 单位顺序按「单位总分榜」（teamStandingsOrder，得分高的在前），**不跟单位奖牌榜**：
|
||||
// 奖牌榜已独立按金→银→铜排（domain.BuildMedalStandings），两份顺序本来就不一样。
|
||||
// 没有奖牌的单位不出分表。
|
||||
func LoadMedalDetailWorkbook(db *sql.DB, opts Options) (MedalDetailWorkbook, error) {
|
||||
if db == nil {
|
||||
return MedalDetailWorkbook{}, ErrNoDatabase
|
||||
|
||||
Reference in new issue
Block a user