feat(joint-team): 联队 + 份额分成 —— 迁移 0024、引擎按份额拆、导出 / 大屏 / 录入三路打通；版本 dev_0.5.3
## 需求
现场 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 张逐字节未变）。
This commit is contained in:
AskaEth committed
1 parent
b631418a85
commit
830a4dbdb7
61 files changed
+5649
-121
No files matched your search
@@ -433,6 +433,56 @@ func entryTemplateHeader(language string) []string {
|
||||
return out
|
||||
}
|
||||
|
||||
// 联队（devdocs/19）怎么写，是模板必须教给填表人的事：单位编码写 `A+B`，加号左边是主单位，
|
||||
// 积分平均分、奖牌两边各记一枚。中英各一份，与表头语言一致。
|
||||
//
|
||||
// 文案只能挂在**不会变成数据的载体**上：表头行是导入器认模板的锚点（必须留在第 1 行、12 列
|
||||
// 一字不动），工作表名是「小项@组别」的范围锚点（也不能多出一张说明表，否则整份文件按分工作表
|
||||
// 口径解析时会对不上号）。所以这里用两处：单位编码表头的**单元格批注**（红三角一眼能看见）
|
||||
// 与这一列的**输入提示**（点中格子就弹出来）。
|
||||
const (
|
||||
entryJointHintZH = "单位编码怎么写：\n" +
|
||||
"· 单个单位参赛：填它的编码，例如 A。\n" +
|
||||
"· 同一小项组别里两个单位联合参赛（联队）：写 A+B，加号左边那个是主单位。\n" +
|
||||
" 积分在两个单位之间平均分（各 50%，拆出 0.5 分照实记）；\n" +
|
||||
" 奖牌两边各记一枚整牌——联队的金牌，A、B 各记 1 枚。"
|
||||
entryJointPromptZH = "联队写 A+B（加号左边是主单位）：积分平均分，奖牌两边各记一枚"
|
||||
entryJointTitleZH = "单位编码怎么写"
|
||||
entryJointHintEN = "How to fill the team code:\n" +
|
||||
"- One unit: its code, for example A.\n" +
|
||||
"- Two units entering together as a joint team (same event and category): write A+B, " +
|
||||
"the left one is the primary unit.\n" +
|
||||
" Points are split evenly between them (50% each; halves such as 7.5 are kept as they are);\n" +
|
||||
" each unit is credited one full medal - a joint gold counts as one for A and one for B."
|
||||
entryJointPromptEN = "Joint team: write A+B (left one is the primary unit). " +
|
||||
"Points split evenly, each unit gets one full medal"
|
||||
entryJointTitleEN = "How to fill the team code"
|
||||
// entryTemplateAuthor 是批注作者。写系统名（与导出件的文档属性同一套），
|
||||
// 绝不写构建期注入的内部署名。
|
||||
entryTemplateAuthor = "赛事积分榜系统"
|
||||
// entryTemplateHintRows 是输入提示覆盖的行数：模板是空表，给填表人留够行即可。
|
||||
entryTemplateHintRows = 500
|
||||
)
|
||||
|
||||
// entryTemplateJointHint 按表头语言取「联队怎么写」的说明（批注正文 + 输入提示的标题与正文）。
|
||||
func entryTemplateJointHint(language string) (hint, title, prompt string) {
|
||||
if language == "en" {
|
||||
return entryJointHintEN, entryJointTitleEN, entryJointPromptEN
|
||||
}
|
||||
return entryJointHintZH, entryJointTitleZH, entryJointPromptZH
|
||||
}
|
||||
|
||||
// entryTeamCodeColumn 是 team_code 在表头里的列号（0 起）。模板的说明挂在这一列上，
|
||||
// 所以它从 importColumns 现算，改了列序也不会挂错格子。
|
||||
func entryTeamCodeColumn() int {
|
||||
for i, column := range importColumns {
|
||||
if column.name == "team_code" {
|
||||
return i
|
||||
}
|
||||
}
|
||||
return -1
|
||||
}
|
||||
|
||||
// entryTemplateFilename 是两种表头语言的下载文件名，前端按同一份口径拼文件名。
|
||||
func entryTemplateFilename(language string) string {
|
||||
if language == "en" {
|
||||
@@ -488,9 +538,13 @@ func (s *server) entriesTemplateXLSX(w http.ResponseWriter, r *http.Request) (an
|
||||
}
|
||||
|
||||
headers := entryTemplateHeader(language)
|
||||
hint, hintTitle, prompt := entryTemplateJointHint(language)
|
||||
sheets := make([]entriesTemplateSheet, 0, len(plan.sheets))
|
||||
for _, planned := range plan.sheets {
|
||||
sheets = append(sheets, entriesTemplateSheet{Name: planned.Name, Headers: headers})
|
||||
sheets = append(sheets, entriesTemplateSheet{
|
||||
Name: planned.Name, Headers: headers,
|
||||
JointHint: hint, JointHintTitle: hintTitle, JointPrompt: prompt,
|
||||
})
|
||||
}
|
||||
name := entryTemplateFilename(language)
|
||||
ascii := "entries-template-" + language + ".xlsx"
|
||||
@@ -518,6 +572,11 @@ func entrySheetExcludedMessage(problems []string) string {
|
||||
type entriesTemplateSheet struct {
|
||||
Name string
|
||||
Headers []string
|
||||
// JointHint / JointHintTitle / JointPrompt 是「单位编码写 A+B」的说明（按表头语言取），
|
||||
// 挂在该列的批注与输入提示上。
|
||||
JointHint string
|
||||
JointHintTitle string
|
||||
JointPrompt string
|
||||
}
|
||||
|
||||
// writeEntriesTemplateXLSX 写整份模板工作簿。
|
||||
@@ -580,6 +639,9 @@ func writeEntriesTemplateXLSX(out io.Writer, sheets []entriesTemplateSheet) erro
|
||||
if err := f.SetRowHeight(sheet.Name, 1, 24); err != nil {
|
||||
return err
|
||||
}
|
||||
if err := writeEntryJointTeamHint(f, sheet); err != nil {
|
||||
return err
|
||||
}
|
||||
// 冻结表头：一张表几十行，往下翻的时候列名得一直看得见。
|
||||
if err := f.SetPanes(sheet.Name, &excelize.Panes{
|
||||
Freeze: true, YSplit: 1, TopLeftCell: "A2", ActivePane: "bottomLeft",
|
||||
@@ -592,3 +654,45 @@ func writeEntriesTemplateXLSX(out io.Writer, sheets []entriesTemplateSheet) erro
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// writeEntryJointTeamHint 把「联队怎么写」挂在单位编码列上：表头那一格一条批注（有红三角），
|
||||
// 整列一条输入提示（点中格子就弹出）。
|
||||
//
|
||||
// 只动这两种载体，不碰任何单元格的值与行列结构：填好的表原样传回来时，导入器读到的仍是
|
||||
// 「第 1 行 12 列表头 + 数据行」，批注与输入提示不是数据。
|
||||
func writeEntryJointTeamHint(f *excelize.File, sheet entriesTemplateSheet) error {
|
||||
column := entryTeamCodeColumn()
|
||||
if column < 0 || column >= len(sheet.Headers) || sheet.JointHint == "" {
|
||||
return nil
|
||||
}
|
||||
name, err := excelize.ColumnNumberToName(column + 1)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
if err := f.AddComment(sheet.Name, excelize.Comment{
|
||||
Cell: name + "1",
|
||||
Author: entryTemplateAuthor,
|
||||
Text: sheet.JointHint,
|
||||
Width: 360,
|
||||
Height: 170,
|
||||
}); err != nil {
|
||||
return fmt.Errorf("httpapi: 写模板批注 %s!%s1: %w", sheet.Name, name, err)
|
||||
}
|
||||
if sheet.JointPrompt == "" {
|
||||
return nil
|
||||
}
|
||||
// 刻意用 type="none"：这里只要一条提示，不要任何取值限制——现场的表千奇百怪，
|
||||
// 模板不该因为一条校验规则把好好的编码挡在门外。
|
||||
dv := excelize.NewDataValidation(true)
|
||||
dv.SetSqref(fmt.Sprintf("%s2:%s%d", name, name, entryTemplateHintRows))
|
||||
dv.Type = "none"
|
||||
title := sheet.JointHintTitle
|
||||
if title == "" {
|
||||
title = "单位编码"
|
||||
}
|
||||
dv.SetInput(title, sheet.JointPrompt)
|
||||
if err := f.AddDataValidation(sheet.Name, dv); err != nil {
|
||||
return fmt.Errorf("httpapi: 写模板输入提示 %s!%s: %w", sheet.Name, name, err)
|
||||
}
|
||||
return nil
|
||||
}
|
||||
Reference in new issue
Block a user