feat(export): 新增「导入格式」报名名单导出（汇总 / 分小项），与导入模板逐列一致、可直接重导；版本 dev_0.5.14
主人反馈：导出页「报名名单」卡片导出的表格与导入模板对不上，没法拿回去重导。
核对属实（旧导出是给人看的报表）：列序与 importColumns 不同、缺「种子 / 队员名单 / 队伍」
三列、姓名列被拼成「姓名（号码布）」、队名拼在单位名后面、状态列写「已退赛」而
normalizeImportStatus 不认 —— 整体错位 + 状态列报错，重导必炸。
- 新增 GET /api/export/entries-import.xlsx?format=flat|sheets&lang=zh|en&<四个筛选>
· flat（缺省）= 所有行汇总在一张工作表；表名不含 @（导入侧见到带 @ 的表名就整份按
分工作表模板解析，汇总表定不出「小项@组别」会被拒）
· sheets = 按「小项@组别」分工作表，表名走 entrySheetName（与模板、导入解析三处同源，
31 字符截断与撞名去重都跟着一起走）
· 权限与筛选参数与 /api/export/entries.xlsx 完全一致（访客可读）；空结果回 200 + 只有表头
· 列序不写常量：按 importColumns 逐列取值，表头走 entryTemplateHeader(lang)，
加列/改序时测试当场红（TestEntryImportRecordCoversImportColumns）
- 取值口径（重导的关键）：团体行的「姓名」留空、队员写「队员名单」列（中文逗号分隔；
以库里 token 为底，再补上 entry_athletes 里后加的队员号码布，只增不减）、
队伍独立成列、状态写导入器认的四个中文说法（正常参赛/退赛/取消资格/未出场）、
联队照旧写 A+B、未分批留空、证件号/性别/年龄来自运动员档案（团体行空）
- 新增 internal/export/entries_import.go（读库层，与报表导出同源 SQL、取值口径刻意不同）
与 internal/httpapi/entries_import_export.go（工作簿组装 + handler）
- 原有报表导出（/api/export/entries.xlsx 与 internal/export/entries.go）一个字没动；
导出页新增两个按钮与中文/英文表头选择（只影响这两个导入格式）
测试：往返测试把导出件直接喂回报名导入解析器，flat 与 sheets 各断言四条（解析零错误 /
行数与 13 列逐项一致 / 团体行没被变成个人报名 / 两种格式都跑）；另做变异验证 —— 状态改回
「已退赛」、给团体行填姓名，守卫当场变红。四套自检 ×2 全绿（finalcheck_0514.log：
前端 996 例 / Console 96 例 / 服务端 16 包，EXIT=0）。
无数据库迁移；已有成绩、名次与榜单不变。
文档：使用手册 §11.1（并订正「不要拿导出件重导」的旧话）、报名名单导入规范 新增第九节、
升级说明 新增 dev_0.5.14、常见问题 新增 Q104。
This commit is contained in:
AskaEth committed
1 parent
19e5630b39
commit
ee19b92182
19 files changed
+2135
-34
No files matched your search
+36
-3
@@ -125,7 +125,7 @@ F1+F2
|
||||
**导入之后长什么样**
|
||||
|
||||
- 联队仍是一条报名，但**分与奖牌都按份额记给各成员单位**：单位总分榜、单位奖牌榜上 A、B 各有一份；
|
||||
- 大屏和导出件里写的是**联队的名字**：`第一分公司+第二分公司联队`，报名名单导出的「单位编码」列也回写成 `F1+F2`（**导出的名单可以直接拿去重导**，不用手工改回单个单位）；
|
||||
- 大屏和导出件里写的是**联队的名字**：`第一分公司+第二分公司联队`，报名名单导出的「单位编码」列也回写成 `F1+F2`（**这一列本身可以直接重导**，不用手工改回单个单位；但那两份「报名名单」导出的口径不同——**报表件整份不能导回，要重导用卡片里的两个「导入格式」按钮**，见第九节）；
|
||||
- 用成员单位筛「报名名单」导出时，**也能看到这条联队报名**（否则 B 导出自己的名单会以为没派人上场）。
|
||||
|
||||
### `athlete_name` 运动员姓名
|
||||
@@ -314,7 +314,7 @@ A001，A002
|
||||
- `F2` 在**加号左边**，所以 **F2 是主单位**：这一条的名次与榜单以它为主体。写成 `F5+F2` 是另一条报名（主单位变成 F5），同一组别里只写一种；
|
||||
- 默认**均分**：这条成绩拿到的分，F2 与 F5 **各一半**（团体第 1 名 15 分 → 各 7.5 分）；奖牌**两边各记一枚整枚**（一块金牌，F2 榜上 1 枚、F5 榜上 1 枚）；
|
||||
- 要改成 **2:1** 这类非均分：**不能在这张表里写**，导入后到「成绩录入」页点那一行的「单位」格改（见[使用手册 · 4.11](./使用手册.md#411-联队两个单位合并参赛)）；
|
||||
- 大屏与导出件里写的是 `第二分公司+第五分公司联队`，报名名单导出的「单位编码」列回写成 `F2+F5`（可以直接拿去重导）。
|
||||
- 大屏与导出件里写的是 `第二分公司+第五分公司联队`，报名名单导出的「单位编码」列回写成 `F2+F5`（**这一列本身可以直接重导**；报表件整份不能导回，要重导用报名名单卡片里的两个「导入格式」按钮，见第九节）。
|
||||
|
||||
### 例 5：同一个单位派两个队（团体项目多队）
|
||||
|
||||
@@ -503,7 +503,40 @@ Excel 对工作表名有硬限制：**最长 31 个字符**，同一份工作簿
|
||||
|
||||
---
|
||||
|
||||
## 九、给填写人的最短提示（一页版）
|
||||
## 九、导出的名单怎么导回去
|
||||
|
||||
系统里一共能导出**三份**报名名单，**只有标着「导入格式」的那两份是给导入器看的**（三份都在「导出 → 结果」页签的**报名名单卡片**里，四个筛选完全一样）：
|
||||
|
||||
| 卡片上的按钮 | 导出来是什么 | 文件名 | 对应哪种模板 |
|
||||
|---|---|---|---|
|
||||
| 导出报名名单 | 给人看的**报表**：另含小项名称、单位名称与备注，姓名列拼了队员，状态写「已退赛」 | `报名名单.xlsx` | **不能导回**（导入器不认它） |
|
||||
| 导出（汇总·导入格式） | 13 列，所有行**汇总在一张工作表** | `报名名单（导入格式）.xlsx` | **单表模板**（第二、三节） |
|
||||
| 导出（分小项·导入格式） | 13 列，按「小项名称@组别名称」**分成多张工作表** | `报名名单（导入格式·分小项）.xlsx` | **分工作表模板**（第八节） |
|
||||
|
||||
- 两个「导入格式」导出的 **13 列与第二节的模板逐列一致，顺序也一致**：项目编码 / 组别 / 单位编码 / 姓名 / 证件号 / 性别 / 年龄 / 号码布 / 种子 / 批次 / 状态 / 队员名单 / 队伍。**没有小项名称、单位名称与备注列**——重导用不着它们（「项目编码 + 组别」已经足够定位）；
|
||||
- 卡片上的**「表头语言」两个按钮（中文表头 / 英文表头）只影响这两个导出**，与第二节的两套表头同一口径（选英文走规范列名 `event_code` / `category` / `team_code` / `athlete_name` / `id_card` / `gender` / `age` / `bib` / `seed` / `heat` / `status` / `member_names` / `squad`；两条路都能导回来）；
|
||||
- 筛选（小项 / 组别 / 单位 / 批次）与报表**完全一样**，都可留空（留空 = 不筛这一维度）；**访客也能导**；
|
||||
- 导出的文件**原样传回「基础数据 → 报名导入」就能导回去**：**不要改表头、不要插列删列、不要把列名换成别的写法**；要改内容就在格子里改；
|
||||
- 分小项那种格式的**工作表名仍然是「小项名称@组别名称」**，与模板一字不差（8.1、8.3 的规矩照样适用）——**不要手工改工作表名**，改了就对不上号。本来没人报名的组合不会出一张空表；
|
||||
- 两种格式都把**团体报名的姓名列留空**、队员写进「队员名单」列（「姓名」列填了就是个人报名，见第三节）——这正是它与报表件最关键的区别；
|
||||
- 「状态」列写的是导入器认的**四个中文说法**：`正常参赛` / `退赛` / `取消资格` / `未出场`。报表件写的是「已退赛」，**那个导入器不认**（会报「status 无法识别」），所以报表件不能重导；
|
||||
- 「单位编码」列照旧：联队写 `A+B`（加号左边是主单位）；按成员单位筛也能筛出这条报名。
|
||||
|
||||
### 9.1 往返验证过的（现场也可以自己验一遍）
|
||||
|
||||
把这两种导出件**原样喂回导入接口**各跑一遍，结论是：**零错误、行数一致、13 列逐项一致、团体行没有被变成个人报名**（队员与那支队的关联还在）。现场自验的办法：导出 → **一个字都不改** → 在「基础数据 → 报名导入」原样上传 → 结果应当是「新增 0 / 更新 N / 错误 0」，名单看不出变化。
|
||||
|
||||
> ⚠️ 但它**不是"完全无损"的往返**：重导前先看下面三条限制。
|
||||
|
||||
### 9.2 三条要知道的限制
|
||||
|
||||
1. **「号码布」列可能撞冲突面板**：导出件里写的是**报名上登记的号码布**；导入时对**个人行**会拿它跟**运动员档案里的号码布**比对，两边都非空且不一样，这一行就进「冲突」列表，等你在导入结果里逐条选「保留已有数据 / 使用新数据」（见第六、七节）。库里这两者通常是**一致**的（一致时是静默幂等，什么都不用做）；不一致时重导**不是**静默幂等，会走这套既有的冲突流程；
|
||||
2. **联队的份额权重不会被带回来**：13 列里联队只能写成 `A+B`，重导回去是**平均分（各 50%）**。当初设成 `2:1` 这种非均分的联队，重导之后会变成均分——**表格格式本身表达不了这件事**，要保权重只能在界面上改（到「成绩录入」点那一行的「单位」格）；
|
||||
3. **「队员名单」只增不减**：导出时会**以库里存的名单为底，再把界面上后来补进这支队的队员号码布补上**（否则那些人在重导后就没了）。所以重导后这支队的队员**不会少**，但个别名单的**顺序或写法**可能与最初上传的那张表不完全一样——以系统里现在的名单为准，是正常的。
|
||||
|
||||
---
|
||||
|
||||
## 十、给填写人的最短提示（一页版）
|
||||
|
||||
> 1. 用系统里下载的模板（**中文表头 / 英文表头都能用**，见第二节），**第一行不要动**、同一列不要写两遍；
|
||||
> 2. **一个人一行**；一个人报几项就写几行；
|
||||
|
||||
Reference in new issue
Block a user