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
1 parent
53a0cb225c
commit
45edfbeb71
115 files changed
+10104
-755
No files matched your search
@@ -25,7 +25,10 @@ type EventScoreInput struct {
|
||||
Results []Result
|
||||
RecordBonus *RecordBonusConfig
|
||||
RecordBreaks []RecordBreak
|
||||
Options ScoreOptions
|
||||
// TeamRanks 是按单位录入的团体名次，只有 scope=team + basis=manual 的通道读它。
|
||||
// 与「团体报名项（athlete_id=0）的 results.rank」共同构成团体名次的全部来源。
|
||||
TeamRanks []TeamManualRank
|
||||
Options ScoreOptions
|
||||
}
|
||||
|
||||
// EventScore 是一次小项计分的结果。
|
||||
@@ -54,6 +57,15 @@ type RankedResult struct {
|
||||
Points float64
|
||||
ResultValue *float64
|
||||
Status ResultStatus
|
||||
// SubjectKey 是这条名次的主体标识：名次按 (通道, 组别, 主体) 唯一，
|
||||
// 取值 'e:<entryId>' / 'a:<athleteId>' / 't:<teamId>'，三者都是 0 时退化为 'ch:<channelId>'。
|
||||
// 聚合与团体手工名次没有单条报名项，靠它才能唯一落库。
|
||||
SubjectKey string
|
||||
// 下面三个开关随名次一起携带，榜单侧（standings.go）不必回查库就能算出奖牌：
|
||||
// 小项是否结算奖牌、通道是否发牌、个人奖牌是否并入单位奖牌榜。
|
||||
AwardMedals bool
|
||||
CountToMedals bool
|
||||
CountToTeamMedals bool
|
||||
}
|
||||
|
||||
// ScoreEvent 按项目的计分通道逐条计算名次与积分，输出流水与名次明细。
|
||||
@@ -175,10 +187,14 @@ func entryMatches(in EventScoreInput, e Entry) bool {
|
||||
|
||||
// collectCandidates 过滤出本通道真正参与排名的报名项：
|
||||
// 只取已发布、状态正常、且带有本通道所需数据的成绩。聚合通道不用本函数，见 scoreByAggregate。
|
||||
// scope=team + basis=manual 的候选来源与其它通道不同（P0 的修法），转给 collectTeamManualCandidates。
|
||||
func collectCandidates(in EventScoreInput, ch ScoreChannel) ([]candidate, error) {
|
||||
if ch.Basis == BasisResult && in.Event.Compare == CompareNone {
|
||||
return nil, ErrCompareRequired
|
||||
}
|
||||
if ch.Basis == BasisManual && ch.Scope == ScopeTeam {
|
||||
return collectTeamManualCandidates(in, ch), nil
|
||||
}
|
||||
|
||||
byEntry := make(map[int64]Result, len(in.Results))
|
||||
for _, r := range in.Results {
|
||||
@@ -222,6 +238,72 @@ func collectCandidates(in EventScoreInput, ch ScoreChannel) ([]candidate, error)
|
||||
return out, nil
|
||||
}
|
||||
|
||||
// collectTeamManualCandidates 是 scope=team + basis=manual 的候选来源，只有两处：
|
||||
// 1. in.TeamRanks（按单位录入的团体名次）：没有对应的报名项，用合成 Entry{TeamID: id} 承载；
|
||||
// 2. 兜底：团体报名项（athlete_id == 0）的 results.rank，纯团体项目（篮球等）沿用原录入流程。
|
||||
//
|
||||
// 同一单位两个来源都有时以 TeamRanks 为准；rank <= 0 的团体名次视为未填 / 清空，直接忽略。
|
||||
// 个人报名项（athlete_id != 0）的名次是个人名次，绝不进团体通道——否则双通道项目
|
||||
// 第 2 次发布时会把刚写回 results.rank 的个人名次当成团体名次再发一次分（P0）。
|
||||
func collectTeamManualCandidates(in EventScoreInput, ch ScoreChannel) []candidate {
|
||||
type manualRank struct {
|
||||
teamID int64
|
||||
rank int
|
||||
}
|
||||
overrides := make([]manualRank, 0, len(in.TeamRanks))
|
||||
overrideOf := make(map[int64]int, len(in.TeamRanks))
|
||||
for _, tr := range in.TeamRanks {
|
||||
if tr.TeamID == 0 || tr.Rank <= 0 {
|
||||
continue
|
||||
}
|
||||
if _, dup := overrideOf[tr.TeamID]; dup {
|
||||
continue
|
||||
}
|
||||
overrideOf[tr.TeamID] = tr.Rank
|
||||
overrides = append(overrides, manualRank{teamID: tr.TeamID, rank: tr.Rank})
|
||||
}
|
||||
|
||||
byEntry := make(map[int64]Result, len(in.Results))
|
||||
for _, r := range in.Results {
|
||||
byEntry[r.EntryID] = r
|
||||
}
|
||||
|
||||
out := make([]candidate, 0, len(in.Entries)+len(overrides))
|
||||
taken := make(map[int64]bool, len(overrides))
|
||||
for _, e := range in.Entries {
|
||||
if !entryMatches(in, e) || e.AthleteID != 0 || !e.Status.rankable() {
|
||||
continue
|
||||
}
|
||||
r, ok := byEntry[e.ID]
|
||||
if !ok {
|
||||
continue
|
||||
}
|
||||
if r.State == ResultStateDraft && !in.Options.IncludeDrafts {
|
||||
continue
|
||||
}
|
||||
if !r.Status.rankable() || r.Rank <= 0 {
|
||||
continue
|
||||
}
|
||||
rankIn := r.Rank
|
||||
if rank, ok := overrideOf[e.TeamID]; ok {
|
||||
rankIn = rank
|
||||
}
|
||||
taken[e.TeamID] = true
|
||||
out = append(out, candidate{entry: e, result: r, rankIn: rankIn})
|
||||
}
|
||||
for _, or := range overrides {
|
||||
if taken[or.teamID] {
|
||||
continue
|
||||
}
|
||||
// 合成报名项：ID=0 表示「不对应任何一条报名项」，团体名次的主体是单位。
|
||||
out = append(out, candidate{
|
||||
entry: Entry{TeamID: or.teamID},
|
||||
rankIn: or.rank,
|
||||
})
|
||||
}
|
||||
return out
|
||||
}
|
||||
|
||||
func scoreByResult(in EventScoreInput, ch ScoreChannel, profile ScoringProfile) ([]RankedResult, error) {
|
||||
cands, err := collectCandidates(in, ch)
|
||||
if err != nil {
|
||||
@@ -366,6 +448,10 @@ func rankedResult(in EventScoreInput, ch ScoreChannel, c candidate, rank int, po
|
||||
Points: points,
|
||||
Status: c.result.Status,
|
||||
}
|
||||
rr.SubjectKey = subjectKeyOf(rr)
|
||||
rr.AwardMedals = in.Event.AwardMedals
|
||||
rr.CountToMedals = ch.CountsToMedals()
|
||||
rr.CountToTeamMedals = ch.CountsToTeamMedals()
|
||||
if c.result.ResultValue != nil {
|
||||
v := *c.result.ResultValue
|
||||
rr.ResultValue = &v
|
||||
@@ -474,6 +560,10 @@ func scoreByAggregate(in EventScoreInput, ch ScoreChannel, profile ScoringProfil
|
||||
rr.AthleteName = c.entry.AthleteName
|
||||
rr.Shares = wholeShare(c.entry.primaryTeamID())
|
||||
}
|
||||
rr.SubjectKey = subjectKeyOf(rr)
|
||||
rr.AwardMedals = in.Event.AwardMedals
|
||||
rr.CountToMedals = ch.CountsToMedals()
|
||||
rr.CountToTeamMedals = ch.CountsToTeamMedals()
|
||||
v := c.value
|
||||
rr.ResultValue = &v
|
||||
out = append(out, rr)
|
||||
@@ -516,6 +606,11 @@ func validResultValue(r Result, found bool, opts ScoreOptions) (float64, bool) {
|
||||
// ledgerFromRanked 把名次明细转成积分流水：按通道 scope 决定记给个人还是单位；
|
||||
// 0 分不产生流水，避免流水表被零分噪声撑大。
|
||||
// 流水是否计入单位总分由通道的 countToTeam 决定（个人通道可以只记个人）。
|
||||
//
|
||||
// 团体手工名次与聚合名次没有对应的报名项与成绩（EntryID=0、ResultID=0），
|
||||
// 仍要能落库：SourceType 与聚合流水一样是 result，sourceID 退化为通道 id，
|
||||
// 由真实来源（通道 + 主体）唯一确定。写入侧按「EntryID=0 && ResultID=0 && source_type=result」
|
||||
// 识别这类流水（httpapi 的 isAggregateLedger），按组别重算时会整项重算回填，条数不增不减。
|
||||
func ledgerFromRanked(in EventScoreInput, ch ScoreChannel, ranked []RankedResult) []LedgerEntry {
|
||||
var out []LedgerEntry
|
||||
for _, rr := range ranked {
|
||||
@@ -556,6 +651,22 @@ func ledgerFromRanked(in EventScoreInput, ch ScoreChannel, ranked []RankedResult
|
||||
return out
|
||||
}
|
||||
|
||||
// subjectKeyOf 计算一条名次明细的主体标识（channel_ranks.subject_key 同口径）：
|
||||
// 有报名项就用报名项（个人名次按报名项去重才不会被并列拆开），否则按主体（个人 / 单位），
|
||||
// 全为空时退化为通道 id，保证 (通道, 组别, 主体) 的唯一索引不会撞键。
|
||||
func subjectKeyOf(rr RankedResult) string {
|
||||
switch {
|
||||
case rr.EntryID != 0:
|
||||
return fmt.Sprintf("e:%d", rr.EntryID)
|
||||
case rr.Scope == ScopeAthlete && rr.AthleteID != 0:
|
||||
return fmt.Sprintf("a:%d", rr.AthleteID)
|
||||
case rr.TeamID != 0:
|
||||
return fmt.Sprintf("t:%d", rr.TeamID)
|
||||
default:
|
||||
return fmt.Sprintf("ch:%d", rr.ChannelID)
|
||||
}
|
||||
}
|
||||
|
||||
// wholeShare 构造「主单位独占 100%」的归属份额。联队拆分未实现，这里只产出这一种口径。
|
||||
func wholeShare(teamID int64) []TeamShare {
|
||||
if teamID == 0 {
|
||||
|
||||
Reference in new issue
Block a user