Files
Scoreboard/server/internal/export/squad_test.go
T
AskaEth 7a3e4ad365 feat(entry): 团体项目多队(迁移 0025)+ 修联队团体名次 / 大屏分项成绩 / 预览算分口径;版本 dev_0.5.5
## 一、新能力:团体项目多队
现场:羽毛球双打,一个单位可能派两个队,一个单位两个队各占一个名次。
- 迁移 `0025_entry_squad.sql`:`entries` 加 `squad TEXT NOT NULL DEFAULT ''`(自由文本队名,空串=不区分队伍);
  唯一索引由 `(category_id, team_id) WHERE athlete_id IS NULL` 换成 `(category_id, team_id, squad) WHERE athlete_id IS NULL`
  —— 原来那条正是「一个单位在一个组别只能报一条团体报名」的拦路虎。
- 导入:**第 13 列「队伍」**(`squad` / 队伍 / 队名 / 队伍名,可选,放最后);老 12 列表照常导入。
- 显示:`单位名 + 队名`(不加括号),榜单不写队名(分与牌本来就归单位)。
- 新增「改队名」:`PUT /api/entries/{id}/squad` + 「成员单位与份额」弹窗里的队伍输入框(只对纯团体报名显示)。
  改队名**不需要重算**(`grep squad server/internal/domain/` = 0 处,改名前后流水/名次/榜单逐字节相同)。
- **老数据零变化**:接口层 JSON 剥掉新字段后逐字节相同;导出层 9 份导出件全单元格 750 行 dump 的 md5 相同。

## 二、修:团体名次控件没体现联队
联队的成员单位在「团体名次」里各占一行 → **合并成一行**(标签用大屏/导出一致的联队名),名次**只落主单位**;
成员单位不再进保存载荷,顺手堵掉「看 A、B 各一行,给 B 也录一个名次 → B 重复拿分」。
被并掉的成员单位原来若录过名次,区块里点名提示「已并入联队那一行,保存后清除」,不静默吞。

## 三、修:大屏「分项成绩」排名错乱
现场:第 3 栏列出的项目排名跳着显示(3、6、9、14、15、16),羽毛球单打第 1 名不显示。
**根因**:`group.rows.slice(0, 6)` 取的是**数据到达顺序**,整条渲染链**没有一处读 `rank`**。
修法:按名次升序(并列保持原先后、无名次排最后)再截断 —— 与同页「实时赛况」的既有口径一致。
复现证据:修前 `actual: [3,6,9,14,15,16]`(与现场数字一致)、`expected: [1,2,3,4,5,6]`。
顺带澄清:「只有第 3 栏出问题」不是栏的问题,是那一栏分到的数据次序不成立。

## 四、修:录入页预览算分与后端口径不一致(四处 + 一条延伸)
现场:手动录名次的项目(台球)「积分(自动)」列全是 0,而后端**有分**。
1. **预览不读 `channel_manual_ranks`、也不按通道 scope 分名次来源** → 「按单位录名次」的项目预览全 0,反过来名次填在成绩表时预览有分而服务端 0;
2. **末位归零判据不同**:预览原本「区间跨末位就整组归零」,与后端的 `startRank == lastPlace` 不符(并列第 1 时预览 0、服务端 10);
3. **`compare=none` 时预览静默降级成 manual**(后端此时直接报错)→ 改为同口径:显示**原因**而不是一个算不出来的数字;
4. **管理端保存计分通道缺守卫**:`compare=none + basis=result/aggregate` 原先只有规则包导入拦,手工能配出来、到发布才报错 → 保存前 400 + 人话。
延伸:预览的「已发布分」基线**只扣行分**,不挂报名项的分(团体名次那类)没扣 → 发布确认框「最大分差」虚高;新增 `unitPoints` 一并扣。

## 五、修:手录名次项目的「成绩」列空白
`displayResult()` 在 `resultValue`/`resultText` 都拿不到时**漏出空值**(且函数声明返回 `string`)→
新增占位 `—`、类型收紧,实时赛况与底栏对齐同一口径。

## 文档
`docs/报名名单导入规范.md`(12 → 13 列)、`docs/使用手册.md`(多队章节)、
`docs/升级说明.md`(新增 `dev_0.5.5` 一节)、`debug/使用说明/` 七份同步。

## 验证
- 全量自检两轮**全绿、`EXIT=0`**:服务端 14 包 / 前端 **883 例** 0 fail / Console 68 例 0 fail。
- 各块都先写会红的测试、留了原始输出(含现场报的那组数字与「预览全 0」)。

## 版本
`dev_0.5.4` → **`dev_0.5.5`**(含数据迁移 `0025`);安装器素材同步重生成(照例只动 `brand.bmp` 两张)。

## 下一批
`dev_0.5.6` = **团体报名队员身份**(把队员从文字名单变成人员关联,标识用**号码布**),工单见 `devdocs/20-团体报名队员身份.md`。
2026-09-14 11:45:32 +08:00

211 lines
8.9 KiB
Go

package export
import (
"database/sql"
"path/filepath"
"testing"
)
// seedSquads 造一场「一个单位派两支队」的团体赛:羽毛球男子双打,第一分公司派一队 / 二队,
// 两队分别拿第 1、第 2 名(口径 3:一个单位两个队各占一个名次、各拿一块牌,不去重不合并),
// 第二分公司一支不区分队伍的队(squad 留空 = 老写法)拿第 3 名。
func seedSquads(t *testing.T, db *sql.DB) {
t.Helper()
stmts := []string{
`INSERT INTO teams(code, name, short_name, sort_order) VALUES ('T1', '第一分公司', '一公司', 1)`,
`INSERT INTO teams(code, name, short_name, sort_order) VALUES ('T2', '第二分公司', '二公司', 2)`,
`INSERT INTO sports(code, name) VALUES ('SP1', '羽毛球')`,
`INSERT INTO events(sport_id, code, name, event_type, result_mode, result_type, compare, status)
VALUES (1, 'E1', '男子双打', 'team', 'auto', 'score', 'desc', 'published')`,
`INSERT INTO event_categories(event_id, name, sort_order) VALUES (1, '男子', 1)`,
`INSERT INTO event_score_channels(event_id, scope, basis, profile_id)
SELECT 1, 'team', 'result', id FROM scoring_profiles WHERE code = 'individual_top6'`,
// 同一个单位在同一组别的两条团体报名:靠 squad 区分,只有带上 squad 的唯一索引才放得下。
`INSERT INTO entries(event_id, category_id, team_id, member_names, squad, bib)
VALUES (1, 1, 1, '["王磊","赵雷"]', '一队', '101')`,
`INSERT INTO entries(event_id, category_id, team_id, member_names, squad, bib)
VALUES (1, 1, 1, '["陈刚","郑凯"]', '二队', '102')`,
`INSERT INTO entries(event_id, category_id, team_id, member_names, bib)
VALUES (1, 1, 2, '["孙七","周八"]', '103')`,
`INSERT INTO results(event_id, entry_id, rank, result_text, result_value, unit, state)
VALUES (1, 1, 1, '2:0', 2, 'pts', 'published')`,
`INSERT INTO results(event_id, entry_id, rank, result_text, result_value, unit, state)
VALUES (1, 2, 2, '2:1', 2, 'pts', 'published')`,
`INSERT INTO results(event_id, entry_id, rank, result_text, result_value, unit, state)
VALUES (1, 3, 3, '2:1', 2, 'pts', 'published')`,
`INSERT INTO score_ledger(team_id, event_id, entry_id, result_id, source_type, source_id, points)
VALUES (1, 1, 1, 1, 'result', 1, 10)`,
`INSERT INTO score_ledger(team_id, event_id, entry_id, result_id, source_type, source_id, points)
VALUES (1, 1, 2, 2, 'result', 2, 8)`,
`INSERT INTO score_ledger(team_id, event_id, entry_id, result_id, source_type, source_id, points)
VALUES (2, 1, 3, 3, 'result', 3, 6)`,
`UPDATE settings SET value = '测试运动会' WHERE key = 'event.name'`,
`UPDATE settings SET value = '测试主办方' WHERE key = 'event.organizer'`,
}
for _, s := range stmts {
if _, err := db.Exec(s); err != nil {
t.Fatalf("造数据 %q: %v", s, err)
}
}
}
// 分项成绩表:单位列在队名非空时写「单位名+队名」,一个单位的两个队各占一行。
func TestEventSheetShowsSquadAfterUnitName(t *testing.T) {
db := openEventDB(t)
seedSquads(t, db)
seedChannelRanks(t, db)
dst := filepath.Join(t.TempDir(), "成绩表.xlsx")
if err := ExportEventXLSX(db, 0, dst, Options{}); err != nil {
t.Fatalf("导出分项成绩表: %v", err)
}
rows := readSheet(t, dst, "羽毛球·男子双打·男子")
// 4 行版式 + 3 条报名,按名次排:一队、二队、第二分公司。
want := []string{"第一分公司一队", "第一分公司二队", "第二分公司"}
for i, w := range want {
if got := cell(rows, 4+i, 2); got != w {
t.Errorf("第 %d 行单位 = %q,期望 %q", i+1, got, w)
}
}
}
// 全部成绩(单页):与分项成绩表同源,单位列同样带上队名。
func TestFlatSheetShowsSquadAfterUnitName(t *testing.T) {
db := openEventDB(t)
seedSquads(t, db)
seedChannelRanks(t, db)
dst := filepath.Join(t.TempDir(), "单页.xlsx")
if err := ExportFlatXLSX(db, dst, Options{}); err != nil {
t.Fatalf("导出全部成绩(单页): %v", err)
}
rows := readSheet(t, dst, "全部成绩")
// 单页表在「名次」前多了 大项/小项/组别 三列,单位列是第 6 列。
want := []string{"第一分公司一队", "第一分公司二队", "第二分公司"}
for i, w := range want {
if got := cell(rows, 4+i, 5); got != w {
t.Errorf("第 %d 行单位 = %q,期望 %q", i+1, got, w)
}
}
}
// 报名名单:单位名列在队名非空时写「单位名+队名」,不区分队伍的报名照旧只写单位名。
func TestEntriesSheetShowsSquadAfterUnitName(t *testing.T) {
db := openEventDB(t)
seedSquads(t, db)
dst := filepath.Join(t.TempDir(), "报名名单.xlsx")
if err := ExportEntriesXLSX(db, dst, EntriesFilter{}, Options{}); err != nil {
t.Fatalf("导出报名名单: %v", err)
}
rows := readSheet(t, dst, "报名名单")
// 列序:小项编码/小项名/组别/单位编码/单位名/…,单位名是第 5 列。
want := []string{"第一分公司一队", "第一分公司二队", "第二分公司"}
for i, w := range want {
if got := cell(rows, 4+i, 4); got != w {
t.Errorf("第 %d 行单位名 = %q,期望 %q", i+1, got, w)
}
}
}
// 单位奖牌明细:总表的单位列按该奖牌对应报名项的队名写全;一个单位两个队各拿一块牌,
// 就是两块牌(口径 3),不合并、不去重。
func TestMedalDetailShowsSquadAfterUnitName(t *testing.T) {
db := openEventDB(t)
seedSquads(t, db)
seedChannelRanks(t, db)
dst := filepath.Join(t.TempDir(), "奖牌.xlsx")
if err := ExportMedalDetailXLSX(db, dst, Options{}); err != nil {
t.Fatalf("导出单位奖牌明细: %v", err)
}
f := openXLSX(t, dst)
defer func() { _ = f.Close() }()
wantSheets := []string{"单位奖牌明细", "第一分公司奖牌明细", "第二分公司奖牌明细"}
if got := f.GetSheetList(); !equalStrings(got, wantSheets) {
t.Fatalf("sheet 列表 = %v,期望 %v", got, wantSheets)
}
master, err := f.GetRows("单位奖牌明细")
if err != nil {
t.Fatalf("读取总表: %v", err)
}
want := []string{"第一分公司一队", "第一分公司二队", "第二分公司"}
for i, w := range want {
if got := cell(master, 4+i, 0); got != w {
t.Errorf("总表第 %d 行单位 = %q,期望 %q", i+1, got, w)
}
}
// 第一分公司是一枚金牌加一枚银牌(两个队各一块),分表的小计照实写两块。
unit, err := f.GetRows("第一分公司奖牌明细")
if err != nil {
t.Fatalf("读取分表: %v", err)
}
if got := cell(unit, len(unit)-1, 4); got != "金 1 / 银 1 / 铜 0" {
t.Errorf("第一分公司小计 = %q,期望 金 1 / 银 1 / 铜 0", got)
}
}
// 单位积分总明细:总表的单位列按该条流水对应报名项的队名写全(分表没有单位列,表名就是单位)。
func TestAllTeamDetailsShowsSquadAfterUnitName(t *testing.T) {
db := openEventDB(t)
seedSquads(t, db)
seedChannelRanks(t, db)
dst := filepath.Join(t.TempDir(), "总明细.xlsx")
if err := ExportAllTeamDetailsXLSX(db, dst, Options{}); err != nil {
t.Fatalf("导出总明细: %v", err)
}
rows := readSheet(t, dst, "积分总明细")
// 列序:单位/序号/大项/小项/组别/运动员/名次/成绩/来源/积分/备注;
// 行序按单位总分榜(第一分公司在前),单位内按名次:一队 10 分、二队 8 分,第二分公司 6 分。
want := []string{"第一分公司一队", "第一分公司二队", "第二分公司"}
for i, w := range want {
if got := cell(rows, 4+i, 0); got != w {
t.Errorf("总明细第 %d 行单位 = %q,期望 %q", i+1, got, w)
}
}
if got := cell(rows, 7, 0); got != "合计" {
t.Errorf("末行首列 = %q,期望 合计", got)
}
}
// 队名为空(不区分队伍)时,五份导出件的单位名列一个字都不多:这是老数据与单队单位的默认,
// 导出件必须与升级前逐行一致。
func TestEmptySquadKeepsPlainUnitName(t *testing.T) {
db := openEventDB(t)
seedSquads(t, db)
seedChannelRanks(t, db)
dir := t.TempDir()
entriesDst := filepath.Join(dir, "报名名单.xlsx")
if err := ExportEntriesXLSX(db, entriesDst, EntriesFilter{}, Options{}); err != nil {
t.Fatalf("导出报名名单: %v", err)
}
// 第三条报名(第二分公司)没有队名。
if got := cell(readSheet(t, entriesDst, "报名名单"), 6, 4); got != "第二分公司" {
t.Errorf("空队名的单位名 = %q,期望 第二分公司", got)
}
medalDst := filepath.Join(dir, "奖牌.xlsx")
if err := ExportMedalDetailXLSX(db, medalDst, Options{}); err != nil {
t.Fatalf("导出单位奖牌明细: %v", err)
}
if got := cell(readSheet(t, medalDst, "单位奖牌明细"), 6, 0); got != "第二分公司" {
t.Errorf("空队名的奖牌总表单位 = %q,期望 第二分公司", got)
}
detailDst := filepath.Join(dir, "总明细.xlsx")
if err := ExportAllTeamDetailsXLSX(db, detailDst, Options{}); err != nil {
t.Fatalf("导出总明细: %v", err)
}
if got := cell(readSheet(t, detailDst, "积分总明细"), 6, 0); got != "第二分公司" {
t.Errorf("空队名的总明细单位 = %q,期望 第二分公司", got)
}
}