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

80 lines
2.8 KiB
Go

package dto
import "git.yeij.top/AskaEth/Scoreboard/server/internal/domain"
// StandingRow 是 GET /api/standings 与 snapshot.standings 的线上结构。
//
// 字段名与 web/src/shared/types.ts 的 StandingRow 对齐:大屏与管理端共用一份解析逻辑,
// 不能再把 domain.StandingsRow 的 points/code/medals 直接下发。
//
// 两个榜共用这一行:rank 是总积分榜名次(总分优先),medalRank 是单位奖牌榜名次
// (金 → 银 → 铜 → 单位编码,与总分无关)。金牌多但总分低的单位,medalRank 会比 rank 靠前。
type StandingRow struct {
TeamID int64 `json:"teamId"`
TeamCode string `json:"teamCode"`
TeamName string `json:"teamName"`
ShortName *string `json:"shortName"`
Color *string `json:"color"`
LogoPath *string `json:"logoPath"`
Rank int `json:"rank"`
MedalRank int `json:"medalRank"`
Gold int `json:"gold"`
Silver int `json:"silver"`
Bronze int `json:"bronze"`
MedalTotal int `json:"medalTotal"`
TotalPoints float64 `json:"totalPoints"`
RankChange *int `json:"rankChange"`
}
// StandingRows 把 domain 榜单转换成线上结构。
//
// rows 是总积分榜(顺序与 Rank 都按总分),medal 是同一份输入算出的单位奖牌榜
// (顺序与名次按金→银→铜)。两个榜的行集合相同,这里用团队 id 把奖牌榜名次并进每一行,
// 于是 REST / WS 快照 / xlsx 导出三处拿到的奖牌榜口径完全一致(同一个 domain.BuildMedalStandings)。
//
// teams 用于补齐颜色/logo 等 domain 榜单没带的展示字段;rankChange 快照没有对比基准,与 REST 一致下发 null。
func StandingRows(rows []domain.StandingsRow, medal []domain.MedalRow, teams []domain.Team) []StandingRow {
byID := make(map[int64]domain.Team, len(teams))
for _, t := range teams {
byID[t.ID] = t
}
medalRanks := make(map[int64]int, len(medal))
for _, m := range medal {
medalRanks[m.TeamID] = m.Rank
}
out := make([]StandingRow, 0, len(rows))
for _, r := range rows {
t := byID[r.TeamID]
row := StandingRow{
TeamID: r.TeamID,
TeamCode: r.Code,
TeamName: r.Name,
ShortName: nilIfEmpty(r.ShortName),
Rank: r.Rank,
MedalRank: medalRanks[r.TeamID],
Gold: r.Gold,
Silver: r.Silver,
Bronze: r.Bronze,
MedalTotal: r.Medals,
TotalPoints: r.Points,
RankChange: nil,
}
if t.ID != 0 {
row.Color = nilIfEmpty(t.Color)
row.LogoPath = nilIfEmpty(t.LogoPath)
if row.TeamCode == "" {
row.TeamCode = t.Code
}
if row.TeamName == "" {
row.TeamName = t.Name
}
if row.ShortName == nil {
row.ShortName = nilIfEmpty(t.ShortName)
}
}
out = append(out, row)
}
return out
}