Files
Scoreboard/server/internal/rules/apply.go
T
AskaEth 45edfbeb71 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 例 + 语法检查。
2026-09-11 21:47:07 +08:00

265 lines
8.5 KiB
Go

package rules
import (
"database/sql"
"fmt"
"sort"
"strings"
)
// ApplyResult 汇总一次导入实际落库的行数。
type ApplyResult struct {
ProfilesWritten int `json:"profilesWritten"`
ProfilesDeleted int `json:"profilesDeleted"`
ChannelsWritten int `json:"channelsWritten"`
EventsUpdated int `json:"eventsUpdated"`
SettingsWritten int `json:"settingsWritten"`
EventsSkipped []string `json:"eventsSkipped,omitempty"`
}
// Apply 把差异预览落地。规则包语义是「全量覆盖」,因此按 Next 的目标状态同步,
// 而不是逐条套用 diff 列表——这样重复导入同一份规则包是幂等的。
// 只填了 Next 的变更集(例如确认导入时重新 Parse 上传内容)同样可以调用,等价于强制全量导入。
//
// 落地顺序:模板 → 通道 → 删除无主模板 → 项目开关 → 赛事设置。
// 通道先改完再删模板,避免「模板被换掉」时误判引用。
// Apply 不负责重算积分:分值一变,调用方必须全量重算(devdocs 02 §7.3)。
func Apply(db *sql.DB, cs *ChangeSet) (*ApplyResult, error) {
if cs == nil || cs.Next == nil {
return nil, ErrNilChangeSet
}
next := cs.Next.Canonical()
if err := next.Validate(); err != nil {
return nil, err
}
cur, err := Load(db)
if err != nil {
return nil, err
}
targets, unknown, err := resolveTargets(cur, &next)
if err != nil {
return nil, err
}
tx, err := db.Begin()
if err != nil {
return nil, fmt.Errorf("开启事务: %w", err)
}
defer func() { _ = tx.Rollback() }()
res := &ApplyResult{EventsSkipped: unknown}
// 1. 模板全量 upsert,并建立「编码 → id」映射供通道引用。
profileIDs := map[string]int64{}
for _, prof := range next.Profiles {
id, err := upsertProfile(tx, prof)
if err != nil {
return nil, err
}
profileIDs[prof.Code] = id
res.ProfilesWritten++
}
// 2. 通道:只覆盖规则包明确提到的项目。
eventIDs := map[string]int64{}
for _, ev := range cur.Events {
eventIDs[ev.Code] = ev.ID
}
codes := make([]string, 0, len(targets))
for code := range targets {
codes = append(codes, code)
}
sort.Strings(codes)
for _, code := range codes {
eventID, ok := eventIDs[code]
if !ok {
continue
}
if _, err := tx.Exec(`DELETE FROM event_score_channels WHERE event_id = ?`, eventID); err != nil {
return nil, fmt.Errorf("清理项目 %s 的计分通道: %w", code, err)
}
for i, ch := range targets[code] {
profileID, ok := profileIDs[ch.Profile]
if !ok {
return nil, fmt.Errorf("项目 %s 的通道引用了不存在的模板 %q", code, ch.Profile)
}
if _, err := tx.Exec(`INSERT INTO event_score_channels (event_id, scope, basis, profile_id, sort_order, count_to_team, count_to_medals, count_to_team_medals)
VALUES (?, ?, ?, ?, ?, ?, ?, ?)`, eventID, string(ch.Scope), string(ch.Basis), profileID, i,
boolToInt(ch.CountsToTeam()), boolToInt(ch.CountsToMedals()), boolToInt(ch.CountsToTeamMedals())); err != nil {
return nil, fmt.Errorf("写入项目 %s 的计分通道: %w", code, err)
}
}
res.ChannelsWritten++
}
// 3. 删除目标规则包里已没有的模板;仍被引用就报错,绝不静默拆掉别人的配置。
for _, prof := range cur.Pack.Profiles {
if _, keep := profileIDs[prof.Code]; keep {
continue
}
if err := deleteProfile(tx, prof.Code); err != nil {
return nil, err
}
res.ProfilesDeleted++
}
// 4. 项目开关:只改 override 里显式给出的字段。
for _, ov := range next.EventOverrides {
eventID, ok := eventIDs[ov.EventCode]
if !ok || (ov.Scored == nil && ov.Multiplier == nil && ov.AwardMedals == nil) {
continue
}
scored, err := currentScored(tx, eventID)
if err != nil {
return nil, err
}
if ov.Scored != nil {
scored = *ov.Scored
}
multiplier, err := currentMultiplier(tx, eventID)
if err != nil {
return nil, err
}
if ov.Multiplier != nil {
multiplier = *ov.Multiplier
}
awardMedals, err := currentAwardMedals(tx, eventID)
if err != nil {
return nil, err
}
if ov.AwardMedals != nil {
awardMedals = *ov.AwardMedals
}
if _, err := tx.Exec(`UPDATE events SET scored = ?, multiplier = ?, award_medals = ? WHERE id = ?`,
boolToInt(scored), multiplier, boolToInt(awardMedals), eventID); err != nil {
return nil, fmt.Errorf("更新项目 %s: %w", ov.EventCode, err)
}
res.EventsUpdated++
}
// 5. 赛事设置。
settings := settingsFromPack(&next)
for _, key := range settingsKeys() {
if _, err := tx.Exec(`INSERT INTO settings (key, value, updated_at) VALUES (?, ?, datetime('now'))
ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = datetime('now')`,
key, settings[key]); err != nil {
return nil, fmt.Errorf("写入赛事设置 %s: %w", key, err)
}
res.SettingsWritten++
}
if err := tx.Commit(); err != nil {
return nil, fmt.Errorf("提交导入事务: %w", err)
}
return res, nil
}
func upsertProfile(tx *sql.Tx, prof Profile) (int64, error) {
if _, err := tx.Exec(`INSERT INTO scoring_profiles
(code, name, tie_mode, record_bonus_mode, award_ranks, last_place_zero)
VALUES (?, ?, ?, ?, ?, ?)
ON CONFLICT(code) DO UPDATE SET
name = excluded.name,
tie_mode = excluded.tie_mode,
record_bonus_mode = excluded.record_bonus_mode,
award_ranks = excluded.award_ranks,
last_place_zero = excluded.last_place_zero,
updated_at = datetime('now')`,
prof.Code, prof.Name, string(prof.TieMode), string(prof.RecordBonusMode), prof.AwardRanks, boolToInt(prof.LastPlaceZero)); err != nil {
return 0, fmt.Errorf("写入积分模板 %s: %w", prof.Code, err)
}
var id int64
if err := tx.QueryRow(`SELECT id FROM scoring_profiles WHERE code = ?`, prof.Code).Scan(&id); err != nil {
return 0, fmt.Errorf("读取积分模板 %s 的 id: %w", prof.Code, err)
}
if _, err := tx.Exec(`DELETE FROM scoring_profile_rules WHERE profile_id = ?`, id); err != nil {
return 0, fmt.Errorf("清理积分模板 %s 的明细: %w", prof.Code, err)
}
for _, r := range prof.Rules {
if _, err := tx.Exec(`INSERT INTO scoring_profile_rules (profile_id, rank, points) VALUES (?, ?, ?)`,
id, r.Rank, r.Points); err != nil {
return 0, fmt.Errorf("写入积分模板 %s 的名次 %d: %w", prof.Code, r.Rank, err)
}
}
return id, nil
}
func deleteProfile(tx *sql.Tx, code string) error {
var id int64
if err := tx.QueryRow(`SELECT id FROM scoring_profiles WHERE code = ?`, code).Scan(&id); err != nil {
if err == sql.ErrNoRows {
return nil
}
return fmt.Errorf("读取积分模板 %s: %w", code, err)
}
refs, err := profileRefs(tx, id)
if err != nil {
return err
}
if len(refs) > 0 {
return fmt.Errorf("%w: 模板 %s 仍被 %s 引用", ErrProfileInUse, code, strings.Join(refs, "、"))
}
if _, err := tx.Exec(`DELETE FROM scoring_profile_rules WHERE profile_id = ?`, id); err != nil {
return fmt.Errorf("删除积分模板 %s 的明细: %w", code, err)
}
if _, err := tx.Exec(`DELETE FROM scoring_profiles WHERE id = ?`, id); err != nil {
return fmt.Errorf("删除积分模板 %s: %w", code, err)
}
return nil
}
func profileRefs(tx *sql.Tx, profileID int64) ([]string, error) {
var refs []string
var channels int
if err := tx.QueryRow(`SELECT COUNT(*) FROM event_score_channels WHERE profile_id = ?`, profileID).Scan(&channels); err != nil {
return nil, fmt.Errorf("统计模板引用: %w", err)
}
if channels > 0 {
refs = append(refs, fmt.Sprintf("%d 个计分通道", channels))
}
var sports int
if err := tx.QueryRow(`SELECT COUNT(*) FROM sports WHERE default_profile_id = ?`, profileID).Scan(&sports); err != nil {
return nil, fmt.Errorf("统计模板引用: %w", err)
}
if sports > 0 {
refs = append(refs, fmt.Sprintf("%d 个大项的默认模板", sports))
}
return refs, nil
}
func currentScored(tx *sql.Tx, eventID int64) (bool, error) {
var v int
if err := tx.QueryRow(`SELECT scored FROM events WHERE id = ?`, eventID).Scan(&v); err != nil {
return false, fmt.Errorf("读取项目计分开关: %w", err)
}
return v != 0, nil
}
func currentMultiplier(tx *sql.Tx, eventID int64) (float64, error) {
var v float64
if err := tx.QueryRow(`SELECT multiplier FROM events WHERE id = ?`, eventID).Scan(&v); err != nil {
return 0, fmt.Errorf("读取项目权重: %w", err)
}
return v, nil
}
func currentAwardMedals(tx *sql.Tx, eventID int64) (bool, error) {
var v int
if err := tx.QueryRow(`SELECT award_medals FROM events WHERE id = ?`, eventID).Scan(&v); err != nil {
return false, fmt.Errorf("读取项目奖牌结算开关: %w", err)
}
return v != 0, nil
}
func boolToInt(v bool) int {
if v {
return 1
}
return 0
}