## 需求
现场 6 项球类比赛里,有两个单位因参赛人数不足**合并成一个单位参赛**。
做法不是新建「联队单位」(那样榜单会多出第 8 个单位,且分和奖牌分不到原单位头上),
而是**一条报名挂多个单位、按份额拆**。
## 拍板口径
- 份额**可配、默认均分**
- 积分**平均拆、接受 .5**(团体第 1 名 15 分 → 两个单位各 7.5 分)
- 奖牌**各记一枚**(两个单位各 1 枚完整金牌,不是各 0.5 枚)
- 显示上把联队名字写全(形如 `第一分公司+第二分公司联队`),成员单位的 logo 都放
- 导入表里单位编码写 `A+B`
## 一、核心层(数据模型 + 引擎 + 存储 + 报名写入 + 导入解析)
- 迁移 `0024_entry_team_shares.sql`:新建 `entry_team_shares(entry_id, team_id, points_share,
medal_share, sort_order)`。**两个口径分开表达**是刻意的——积分要拆成小数(7.5)、奖牌要整枚
各记,用一个数表达就会把「7.5 分」和「半枚金牌」绑在一起,奖牌榜立刻错。
`entries.team_id` 保留为**主单位**;老数据 `INSERT OR IGNORE` 回填成「主单位独占 100%」。
- 引擎:`ResolveShares`(引擎与读侧共用)、`splitSharePoints`(按权重归一、**末位吞余数**,
各份之和恒等于原来那一份)、`TeamShare.Medal`(缺省整枚)。积分按权重拆,奖牌每个份额各记整枚。
- 报名写入:`PUT /api/entries/{id}/team-shares`(recorder 及以上,保存后当场重算该小项组别并推榜)。
- 导入:`team_code` 支持 `A+B`(主单位 = 加号左边,均分,奖牌各整枚);非法形态
(`A+` / `+B` / `A++B` / `A+A` / 成员 >5 / 单位不存在)**行级拦下、不落库**,给人话报错。
## 二、导出与导入模板
- 11 份导出件:联队写全成员单位(`第一分公司+第二分公司联队`),并注明**分拆给了哪几家、各多少**
(份额占比 + 各单位实得积分,取自按份额拆完的流水)。
- 单位奖牌明细:奖牌格写「金牌(联队 …,各单位各记 1 枚)」;含联队时副标题说明
「各单位奖牌数之和会大于实际颁发数」——这是口径 3 的必然结果,**不是 bug**。
- 按单位筛选导出把成员单位一起算上(否则 B 单位导自己的名单会看不到自己参加的那场联队比赛)。
- 分工作表模板:`A+B` 写法挂在「单位编码」表头的**单元格批注 + 输入提示**(中英各一份);
**表头文字、列序、12 列、工作表命名一个字未动**(动了模板就导不回去)。
## 三、前端与大屏
- 录入页 / 复核页「单位」列:联队显示 `联队 第一分公司 67%(权重 2) 第二分公司 33%`,
点该格打开「成员单位与份额」弹窗(加/删成员、改权重、主单位徽标、实时比例预览)。
**普通报名(单单位)的文案、元素、类名一字未动**,只多了一个 `@click` 入口与悬停提示。
- 大屏:分项成绩 / 实时赛况单位列显示联队全名并**放上两个单位的 logo**(单位列宽按该行的
logo 数留位);底栏同理。
## 四、验证(都留了证据)
- **老数据逐字节不变**(改算分引擎的硬门槛):引擎层 golden `a2aa1c97…`、接口层 golden
`aa6cea37…`,两个哈希由主会话**在修前树上亲手重跑确认**;导出层另有 11 份导出件逐行对拍,
差异 **0 处**。
- 前端 773 → **809 例**全绿(旧用例一行未改);服务端 14 包两轮全绿;Console 68 例全绿。
- 真机联调:录入页份额弹窗、大屏两个 logo、奖牌榜 A/B 各 1 金、写路径(移除成员 → 保存 → 200)。
## 五、版本
`dev_0.5.2` → **`dev_0.5.3`**(本批含数据迁移 0024 + 新功能,必须与上一包区分开);
安装器素材重生成(版本号烙在位图里,实测只有 `brand.bmp` 的 1x/2x 两张变化,其余 92 张逐字节未变)。
212 lines
6.2 KiB
Go
212 lines
6.2 KiB
Go
package domain
|
||
|
||
import "testing"
|
||
|
||
// ---------- 通用构造 ----------
|
||
|
||
func ptr(f float64) *float64 { return &f }
|
||
|
||
func boolPtr(b bool) *bool { return &b }
|
||
|
||
// individualTop6 是规则包里的个人项目前六名:10/8/6/3/2/1。
|
||
func individualTop6() ScoringProfile {
|
||
return ScoringProfile{
|
||
ID: 1, Code: "individual_top6", Name: "个人项目前六名",
|
||
AwardRanks: 6, LastPlaceZero: false, TieMode: TieSkip,
|
||
Rules: []ScoringRule{{1, 10}, {2, 8}, {3, 6}, {4, 3}, {5, 2}, {6, 1}},
|
||
}
|
||
}
|
||
|
||
// teamTop6 是规则包里的团体项目前六名:15/10/8/4/2/1。
|
||
func teamTop6() ScoringProfile {
|
||
return ScoringProfile{
|
||
ID: 2, Code: "team_top6", Name: "团体项目前六名",
|
||
AwardRanks: 6, LastPlaceZero: false, TieMode: TieSkip,
|
||
Rules: []ScoringRule{{1, 15}, {2, 10}, {3, 8}, {4, 4}, {5, 2}, {6, 1}},
|
||
}
|
||
}
|
||
|
||
// nineProfile 是测试矩阵 case 1..6 使用的八名表:9/7/6/5/4/3/2/1。
|
||
func nineProfile(tie TieMode) ScoringProfile {
|
||
return ScoringProfile{
|
||
ID: 3, Code: "nine", Name: "八名表",
|
||
AwardRanks: 8, LastPlaceZero: false, TieMode: tie,
|
||
Rules: []ScoringRule{{1, 9}, {2, 7}, {3, 6}, {4, 5}, {5, 4}, {6, 3}, {7, 2}, {8, 1}},
|
||
}
|
||
}
|
||
|
||
func testCategory() EventCategory {
|
||
return EventCategory{ID: 1, EventID: 1, Name: "男子组", Multiplier: 1}
|
||
}
|
||
|
||
func individualEvent(multiplier float64) Event {
|
||
return Event{
|
||
ID: 1, Code: "E1", Name: "100米跑", EventType: EventTypeIndividual,
|
||
Compare: CompareAsc, RecordEligible: true, Scored: true, AwardMedals: true,
|
||
Multiplier: multiplier, Status: EventStatusPublished,
|
||
}
|
||
}
|
||
|
||
func teamEvent(multiplier float64) Event {
|
||
e := individualEvent(multiplier)
|
||
e.EventType = EventTypeTeam
|
||
e.Code = "E2"
|
||
return e
|
||
}
|
||
|
||
func athleteResultChannel(profileID int64) ScoreChannel {
|
||
return ScoreChannel{ID: 1, EventID: 1, Scope: ScopeAthlete, Basis: BasisResult, ProfileID: profileID}
|
||
}
|
||
|
||
func athleteManualChannel(profileID int64) ScoreChannel {
|
||
return ScoreChannel{ID: 1, EventID: 1, Scope: ScopeAthlete, Basis: BasisManual, ProfileID: profileID}
|
||
}
|
||
|
||
func teamManualChannel(profileID int64) ScoreChannel {
|
||
return ScoreChannel{ID: 2, EventID: 1, Scope: ScopeTeam, Basis: BasisManual, ProfileID: profileID}
|
||
}
|
||
|
||
func teamAggregateChannel(profileID int64) ScoreChannel {
|
||
return ScoreChannel{ID: 3, EventID: 1, Scope: ScopeTeam, Basis: BasisAggregate, ProfileID: profileID}
|
||
}
|
||
|
||
// participant 是构造「报名项 + 成绩」的最小描述。
|
||
type participant struct {
|
||
entryID int64
|
||
athleteID int64
|
||
teamID int64
|
||
name string
|
||
value float64
|
||
noValue bool // true 表示这条成绩没有可比数值(如直接录名次的项目)
|
||
rank int
|
||
status ResultStatus
|
||
entryStatus EntryStatus
|
||
state ResultState
|
||
// shares 是联队份额(多个单位共享一条成绩);留空 = 主单位独占 100%。
|
||
shares []TeamShare
|
||
}
|
||
|
||
func fixture(ps []participant) ([]Entry, []Result) {
|
||
entries := make([]Entry, 0, len(ps))
|
||
results := make([]Result, 0, len(ps))
|
||
for _, p := range ps {
|
||
entries = append(entries, Entry{
|
||
ID: p.entryID, EventID: 1, CategoryID: 1, TeamID: p.teamID,
|
||
AthleteID: p.athleteID, AthleteName: p.name,
|
||
Status: p.entryStatus, TeamShares: p.shares,
|
||
})
|
||
state := p.state
|
||
if state == "" {
|
||
state = ResultStatePublished
|
||
}
|
||
var value *float64
|
||
if !p.noValue {
|
||
value = ptr(p.value)
|
||
}
|
||
results = append(results, Result{
|
||
ID: p.entryID * 100, EventID: 1, EntryID: p.entryID,
|
||
Rank: p.rank, ResultValue: value, Status: p.status, State: state,
|
||
})
|
||
}
|
||
return entries, results
|
||
}
|
||
|
||
// lineup 生成 n 个参赛者:成绩 1..n,entryID 1..n。
|
||
func lineup(n int) []participant {
|
||
ps := make([]participant, 0, n)
|
||
for i := 1; i <= n; i++ {
|
||
ps = append(ps, participant{
|
||
entryID: int64(i), athleteID: int64(100 + i), teamID: int64(1000 + i),
|
||
name: "选手" + string(rune('A'+i-1)), value: float64(i),
|
||
})
|
||
}
|
||
return ps
|
||
}
|
||
|
||
// lineupValues 生成 n 个参赛者并指定成绩值,用于构造并列。
|
||
func lineupValues(values ...float64) []participant {
|
||
ps := make([]participant, 0, len(values))
|
||
for i, v := range values {
|
||
ps = append(ps, participant{
|
||
entryID: int64(i + 1), athleteID: int64(100 + i + 1), teamID: int64(1000 + i + 1),
|
||
name: "选手" + string(rune('A'+i)), value: v,
|
||
})
|
||
}
|
||
return ps
|
||
}
|
||
|
||
func mustScore(t *testing.T, in EventScoreInput) EventScore {
|
||
t.Helper()
|
||
es, err := ScoreEvent(in)
|
||
if err != nil {
|
||
t.Fatalf("ScoreEvent 返回错误: %v", err)
|
||
}
|
||
return es
|
||
}
|
||
|
||
func pointsByEntry(ledger []LedgerEntry) map[int64]float64 {
|
||
out := make(map[int64]float64)
|
||
for _, e := range ledger {
|
||
if e.Voided {
|
||
continue
|
||
}
|
||
out[e.EntryID] += e.Points
|
||
}
|
||
return out
|
||
}
|
||
|
||
func rankByEntry(ranked []RankedResult) map[int64]int {
|
||
out := make(map[int64]int, len(ranked))
|
||
for _, r := range ranked {
|
||
out[r.EntryID] = r.Rank
|
||
}
|
||
return out
|
||
}
|
||
|
||
func pointsByTeam(ledger []LedgerEntry) map[int64]float64 {
|
||
out := make(map[int64]float64)
|
||
for _, e := range ledger {
|
||
if e.Voided {
|
||
continue
|
||
}
|
||
out[e.TeamID] += e.Points
|
||
}
|
||
return out
|
||
}
|
||
|
||
// assertEntryPoints 断言 entryID 1..len(want) 的积分依次等于 want;缺键按 0 处理。
|
||
func assertEntryPoints(t *testing.T, got map[int64]float64, want []float64) {
|
||
t.Helper()
|
||
for i, w := range want {
|
||
id := int64(i + 1)
|
||
if !nearlyEqual(got[id], w) {
|
||
t.Errorf("entry %d 积分 = %v,期望 %v", id, got[id], w)
|
||
}
|
||
}
|
||
}
|
||
|
||
func testTeams(ids ...int64) []Team {
|
||
out := make([]Team, 0, len(ids))
|
||
for i, id := range ids {
|
||
out = append(out, Team{
|
||
ID: id, Code: string(rune('A' + i)), Name: "单位" + string(rune('A'+i)), Active: true,
|
||
})
|
||
}
|
||
return out
|
||
}
|
||
|
||
func ledgerFor(teamID int64, points float64) LedgerEntry {
|
||
return LedgerEntry{TeamID: teamID, SourceType: SourceResult, SourceID: teamID, Points: points, CountToTeam: true}
|
||
}
|
||
|
||
func ledgerForAthlete(teamID, athleteID int64, points float64) LedgerEntry {
|
||
return LedgerEntry{TeamID: teamID, AthleteID: athleteID, SourceType: SourceResult, SourceID: athleteID, Points: points, CountToTeam: true}
|
||
}
|
||
|
||
// ledgerForPersonal 是「不计入单位总分」的流水:只记在个人头上(如「个人+团体」项目的个人通道)。
|
||
func ledgerForPersonal(teamID, athleteID int64, points float64) LedgerEntry {
|
||
e := ledgerForAthlete(teamID, athleteID, points)
|
||
e.CountToTeam = false
|
||
return e
|
||
}
|