fix: P0 计分根因 + 奖牌结算/奖牌通道 + 身份口径改回证件号 + 19 条 P1(dev_0.1.8)

## P0:双通道项目重复发布跳分(45→85→收敛)
results.rank 一列同时充当「个人名次输出」「手工名次输入」「榜单数据源」,
团体手工通道把个人名次当团体名次又按团体表发一遍分。
- 新增 channel_ranks(每个计分通道各自持久化名次,发布时全量重建)
  与 channel_manual_ranks(按单位录入的团体手工名次,故意不挂通道外键,
  避免规则包重导时级联删掉录入数据)
- results.rank 语义收窄为「只表示个人名次」,只由 scope=athlete 通道写回;
  团体手工名次的来源改为 TeamRanks 优先、团体报名项兜底,
  个人报名项的名次绝不进团体通道
- writeLedgerTx 内重建 channel_ranks;buildRanked / export.loadRanked /
  realtime.loadRanked 三份同源 SQL 一起改读新表
- 回归:发布两次流水与名次逐字节一致(domain + httpapi 各一条,含变异验证)

## 奖牌结算开关与奖牌通道(P1(5),新功能)
- events.award_medals + 通道 count_to_medals / count_to_team_medals
  (迁移默认 1,升级不改变既有榜单)
- 单位榜入选 = 小项结算奖牌 && 通道发奖牌 && 前三名 &&(团体项目 || 个人奖牌并入单位)
- 个人榜只取个人通道;金牌榜与积分榜同源同数据、按通道过滤独立计算
- 前端:小项「该项启用奖牌结算」、通道「发奖牌/个人奖牌并入单位金牌榜」、
  录入页新增「团体名次」区块(含新接口 GET/PUT .../team-ranks)

## 身份口径改回证件号(P1(15),推翻第三十六轮)
- 匹配顺序恢复 证件号 → 号码布 → 姓名+单位;新增 athleteByIDCard
- 同表重复证件号 = 同一人报多个组别(notices 提示,不报错);
  只有「同证件号 + 同小项同组别」才是真重复(conflicts[].duplicate)
- 补齐后端缺失但前端/文档已在依赖的三处契约

## 其余 P1
- 安全:会话撤销断开 ws、实时层按角色裁剪、整库快照限流(含 hello 路径,
  被限流的请求挂起并由心跳兜底补发,不丢刷新)
- 错误分级:手填名次非正数 / gender / 组别年龄 / 导出不存在的小项与单位 /
  积分模板 awardRanks → 400 或 404,不再 500
- 算分一致性:破纪录加分看得失状态;批量退赛·恢复·移出、作废成绩、
  报名导入改状态一律无条件重算推榜(不受延迟结算约束,与实时模式逐字节等价)
- 配置改动触发重算:通道 / 小项参数 / 积分模板
- 升级自愈:channel_ranks 空而已有已发布成绩时,启动时一次性全量重算
  (服务对外监听之前完成,避免升级后奖牌榜全 0)
- 示例数据模式下破坏性操作被阻断,不再假成功
- Console:修复「只剩一块屏」后屏幕监听器被永久摘掉
- 大屏模板引擎:嵌套深度与体积安全阀,任何输入都不抛异常

## 文档
- docs/:使用手册(奖牌开关、奖牌通道、团体名次、枚举列留空口径)、
  常见问题(奖牌排查、升级后奖牌榜为 0、历史重放已知限制)、
  部署指南、上线检查清单
- 版本 dev_0.1.7 → dev_0.1.8(console/package.json 同步)

自检:服务端 13 包 ×2 全绿;前端 vue-tsc + 449 例 ×2 + pnpm build;
Console 35 例 + 语法检查。
This commit is contained in:
AskaEth committed 2026-09-11 21:47:07 +08:00
1 parent 53a0cb225c
commit 45edfbeb71
115 files changed
+10104 -755

No files matched your search

+199
View File
@@ -66,6 +66,9 @@ func TestLoadRankedExcludesRankOnlyEvents(t *testing.T) {
t.Fatalf("造数据 %q: %v", s, err)
}
}
// scored=0 的小项照样有通道名次(引擎只排名不计分也会产出名次),
// 靠 loadRanked 的 scored 过滤把它们挡在奖牌之外。
seedChannelRanks(t, db)
ranked, err := loadRanked(db)
if err != nil {
@@ -77,6 +80,17 @@ func TestLoadRankedExcludesRankOnlyEvents(t *testing.T) {
}
}
if countRows(t, db, "channel_ranks") == 0 {
t.Fatal("用例前提不成立:channel_ranks 是空的,过滤没被真正考验")
}
var event2Ranks int
if err := db.QueryRow(`SELECT count(*) FROM channel_ranks WHERE event_id = 2`).Scan(&event2Ranks); err != nil {
t.Fatalf("统计小项 2 的通道名次: %v", err)
}
if event2Ranks == 0 {
t.Fatal("用例前提不成立:只排名的小项没有通道名次行,scored 过滤没被真正考验")
}
wb, err := LoadStandingsWorkbook(db, Options{})
if err != nil {
t.Fatalf("导出总表: %v", err)
@@ -101,6 +115,7 @@ func TestLoadStandingsHonoursTieBreak(t *testing.T) {
t.Fatalf("造数据 %q: %v", s, err)
}
}
seedChannelRanks(t, db)
wb, err := LoadStandingsWorkbook(db, Options{})
if err != nil {
@@ -263,6 +278,190 @@ func findAggregateRow(rows []TeamDetailRow) (TeamDetailRow, bool) {
return TeamDetailRow{}, false
}
// 三个奖牌开关随名次行从 events / event_score_channels 带出来(devdocs 17 §4.5):
// 关掉小项的 award_medals、或通道的 count_to_medals,奖牌就该消失;
// 只关 count_to_team_medals 时个人榜仍有牌、单位榜没有。
func TestLoadRankedCarriesMedalSwitches(t *testing.T) {
db := openEventDB(t)
seedEvent(t, db)
seedChannelRanks(t, db)
ranked, err := loadRanked(db)
if err != nil {
t.Fatalf("读取名次: %v", err)
}
if len(ranked) == 0 {
t.Fatal("用例前提不成立:读不到任何名次")
}
for _, rr := range ranked {
if !rr.AwardMedals || !rr.CountToMedals || !rr.CountToTeamMedals {
t.Fatalf("三列默认全为 1,开关应全为 true: %+v", rr)
}
}
if gold := standingsGold(t, db, 1); gold != 1 {
t.Fatalf("基线 T1 金牌 = %d,期望 1", gold)
}
if _, err := db.Exec(`UPDATE events SET award_medals = 0 WHERE id = 1`); err != nil {
t.Fatalf("关闭小项奖牌结算: %v", err)
}
if gold := standingsGold(t, db, 1); gold != 0 {
t.Errorf("award_medals=0 时 T1 金牌 = %d,期望 0", gold)
}
// 奖牌明细与榜单同口径(medals.go 走 domain.BuildMedalStandings),关掉开关后也不该再出牌。
if sheets := medalSheetsOf(t, db); len(sheets) != 0 {
t.Errorf("award_medals=0 时奖牌明细仍出分表: %v", sheets)
}
if _, err := db.Exec(`UPDATE events SET award_medals = 1 WHERE id = 1`); err != nil {
t.Fatalf("恢复小项奖牌结算: %v", err)
}
if _, err := db.Exec(`UPDATE event_score_channels SET count_to_medals = 0 WHERE event_id = 1`); err != nil {
t.Fatalf("关闭通道奖牌: %v", err)
}
if gold := standingsGold(t, db, 1); gold != 0 {
t.Errorf("count_to_medals=0 时 T1 金牌 = %d,期望 0", gold)
}
if _, err := db.Exec(`UPDATE event_score_channels SET count_to_medals = 1 WHERE event_id = 1`); err != nil {
t.Fatalf("恢复通道奖牌: %v", err)
}
if _, err := db.Exec(`UPDATE event_score_channels SET count_to_team_medals = 0 WHERE event_id = 1`); err != nil {
t.Fatalf("关闭个人奖牌并入单位: %v", err)
}
if gold := standingsGold(t, db, 1); gold != 0 {
t.Errorf("count_to_team_medals=0 时 T1 单位金牌 = %d,期望 0", gold)
}
if gold := athleteGold(t, db, 1); gold != 1 {
t.Errorf("count_to_team_medals=0 时张三个人金牌 = %d,期望 1(只影响单位榜)", gold)
}
}
// medalSheetsOf 取奖牌明细里出了分表的单位 id(没有奖牌时为空)。
func medalSheetsOf(t *testing.T, db *sql.DB) []int64 {
t.Helper()
wb, err := LoadMedalDetailWorkbook(db, Options{})
if err != nil {
t.Fatalf("读取奖牌明细: %v", err)
}
out := make([]int64, 0, len(wb.Sheets))
for _, s := range wb.Sheets {
out = append(out, s.Team.ID)
}
return out
}
// standingsGold / athleteGold 取导出总表里某个单位 / 运动员的金牌数。
func standingsGold(t *testing.T, db *sql.DB, teamID int64) int {
t.Helper()
wb, err := LoadStandingsWorkbook(db, Options{})
if err != nil {
t.Fatalf("读取总表: %v", err)
}
for _, row := range wb.Team {
if row.TeamID == teamID {
return row.Gold
}
}
return 0
}
func athleteGold(t *testing.T, db *sql.DB, athleteID int64) int {
t.Helper()
wb, err := LoadStandingsWorkbook(db, Options{})
if err != nil {
t.Fatalf("读取总表: %v", err)
}
for _, row := range wb.Athlete {
if row.AthleteID == athleteID {
return row.Gold
}
}
return 0
}
// 分项成绩表的名次列取「主通道」名次(devdocs 17 §11.3):双通道项目里 scope=athlete 的通道优先,
// 一张报名项只显示一个名次;channel_ranks 里没有对应行时回落到 results.rank。
func TestEventRowsUseMainChannelRank(t *testing.T) {
db := openEventDB(t)
seedEvent(t, db)
// 补一条团体通道,让「100米跑」变成双通道项目(与 TEAM_PULLUP 同形)。
if _, err := db.Exec(`INSERT INTO event_score_channels(event_id, scope, basis, profile_id)
SELECT 1, 'team', 'manual', id FROM scoring_profiles WHERE code = 'team_top6'`); err != nil {
t.Fatalf("补团体通道: %v", err)
}
seedChannelRanks(t, db)
// 个人名次只认 channel_ranks:把 results.rank 改坏,成绩表仍要显示个人通道的 1。
if _, err := db.Exec(`UPDATE results SET rank = 4 WHERE id = 1`); err != nil {
t.Fatalf("改坏 results.rank: %v", err)
}
wb, err := LoadEventWorkbook(db, 1, Options{})
if err != nil {
t.Fatalf("导出分项成绩: %v", err)
}
rows := eventRows(wb.Sheets[0].Rows)
if len(rows) != 2 {
t.Fatalf("行数 = %d,期望 2(一条报名项一行,不按通道复制)", len(rows))
}
// 行序按 results.rank 排(T1 被改坏成 4),所以按号码布找那一行。
byBib := make(map[string][]any, len(rows))
for _, r := range rows {
byBib[r[1].(string)] = r
}
if got := byBib["101"][0]; got != "1" {
t.Errorf("101 的名次列 = %v,期望主通道(个人通道)的 1", got)
}
if got := byBib["102"][0]; got != "2" {
t.Errorf("102 的名次列 = %v,期望 2", got)
}
}
// 团体手工 / 聚合这类没有成绩行的流水也要显示 channel_ranks 里的团体名次
// (迁移前这类流水的 rank 恒为 0,devdocs 17 §11.3)。
func TestTeamDetailShowsSubjectRank(t *testing.T) {
db := openEventDB(t)
seedEvent(t, db)
// 团体手工通道:名次按单位录入,流水没有 entry_id / result_id,写入侧把 source_id 退化为通道 id。
if _, err := db.Exec(`INSERT INTO event_score_channels(event_id, scope, basis, profile_id)
SELECT 1, 'team', 'manual', id FROM scoring_profiles WHERE code = 'team_top6'`); err != nil {
t.Fatalf("补团体手工通道: %v", err)
}
var channelID int64
if err := db.QueryRow(`SELECT id FROM event_score_channels WHERE event_id = 1 AND scope = 'team'`).Scan(&channelID); err != nil {
t.Fatalf("读通道 id: %v", err)
}
if _, err := db.Exec(`INSERT INTO channel_ranks(event_id, category_id, channel_id, basis, scope, subject_key,
entry_id, result_id, athlete_id, team_id, rank, points)
VALUES (1, 1, ?, 'manual', 'team', 't:1', NULL, NULL, NULL, 1, 2, 0)`, channelID); err != nil {
t.Fatalf("造团体手工名次: %v", err)
}
// 流水与写入侧一致:source_id 退化为通道 id(见 domain.ledgerFromRanked)。
if _, err := db.Exec(`INSERT INTO score_ledger(team_id, athlete_id, event_id, entry_id, result_id,
source_type, source_id, points, count_to_team)
VALUES (1, NULL, 1, NULL, NULL, 'result', ?, 6, 1)`, channelID); err != nil {
t.Fatalf("造团体手工流水: %v", err)
}
wb, err := LoadTeamDetailWorkbook(db, 1, Options{})
if err != nil {
t.Fatalf("读取积分明细: %v", err)
}
var found bool
for _, r := range wb.Rows {
if r.Points != 6 {
continue
}
found = true
if r.Rank != 2 {
t.Errorf("团体手工流水的名次 = %d,期望 2(来自 channel_ranks)", r.Rank)
}
}
if !found {
t.Fatalf("团体手工流水没出现在明细里: %+v", wb.Rows)
}
}
// 「个人+团体」项目的个人通道流水(count_to_team = 0)不进单位总分,
// 导出侧与 REST / WS 快照必须同口径。
func TestLoadStandingsSkipsPersonalOnlyLedger(t *testing.T) {