Scoreboard/docs/报名名单导入规范.md

# 报名名单导入规范

> 这份文件说明**报名名单应该做成什么样子、每一列怎么填**，用于把各单位报上来的名单一次性导入积分榜系统。
> 给负责收表、填表的同志看即可，不需要懂系统内部。
>
> 配套模板可在系统里直接下载：**基础数据 → 报名导入 →「中文表头」/「英文表头」**（两个文件列数与列顺序完全一样，只有表头语言不同，按手上表格的样子选）。
> 小项与组别很多时，同一处还有**「分工作表 · 中文表头 / 分工作表 · 英文表头」**：一个小项组别再抄串——**一个小项 × 一个组别一张工作表**，表名写成「小项名称@组别名称」，详见第八节。

---

## 一、先看懂三件事

1. **用什么软件做表**：Excel 或 WPS 都行，做完存成 `.xlsx` 或 `.csv` 都可以（推荐 `.csv`，系统兼容性最好，不用管编码）。
2. **表格长什么样**：**第一行是表头**（固定的 12 个列名，**中文、英文两套任选其一**，见第二节），**从第二行开始每人一行**。不要合并单元格，不要在表头上方再加标题行、说明行。
3. **编码不能自己编**：表里的「小项编码」「单位编码」「组别名称」必须是系统里已经配好的，**照抄系统里的写法**。系统里没有的编码，这一行会被跳过并报错。

---

## 二、表头（第一行的列名）

一共 12 列。系统**同时认两套表头**——英文一套、中文一套，**两套都能导入**，也可以**中英混着写**（每一列各自认名字，例如英文 `event_code` 配中文「姓名」）。**英文是规范列名**：老的英文模板一个字都不用改，照常导入；中文只是给习惯看中文的人用的同义写法。

下载模板时按手上表格的样子选：

- 「**中文表头**」→ 文件 `entries-template-zh.csv`
- 「**英文表头**」→ 文件 `entries-template-en.csv`
- 「**分工作表 · 中文表头**」/「**分工作表 · 英文表头**」→ 文件 `entries-template-zh.xlsx` / `entries-template-en.xlsx`
  （一个小项组别一张工作表，见第八节；表头语言与上面两个按钮同一套口径）

单表模板的两个文件**列数与列顺序完全一样，只有表头语言不同**，示例行也一样。列的**先后顺序可以随便调**，多出来的列系统会忽略。

| 英文表头（规范列名） | 中文表头（同义写法） | 这一列是 |
|---|---|---|
| `event_code` | 项目编码（也认「小项编码」） | 小项编码 |
| `category` | 组别（也认「组别名称」） | 组别名称 |
| `team_code` | 单位编码（也认「参赛单位编码」） | 参赛单位编码 |
| `athlete_name` | 姓名（也认「运动员姓名」） | 运动员姓名；团体项目这一列留空 |
| `id_card` | 证件号（也认「身份证号」） | 证件号，可缺省 |
| `gender` | 性别 | 可缺省 |
| `age` | 年龄 | 可缺省 |
| `bib` | 号码布 | 号码布 |
| `seed` | 种子（也认「道次」） | 道次 / 种子 |
| `heat` | 批次（也认「批次号」） | 批次，可缺省 |
| `status` | 状态（也认「报名状态」） | 报名状态 |
| `member_names` | 队员名单 | 团体项目的队员名单 |

> **同一列只能写一次**：一份表里同时出现 `event_code` 和「项目编码」（或者干脆把同一列写了两遍），会被整份拦下并提示「报名表表头重复」，删掉多余的那一列再导入即可——系统不会替你猜该信哪一列，免得静默丢掉另一列的数据。
>
> 表头识别对**大小写、首尾空格、全角字母 / 全角空格、文件开头的 BOM** 都容错：`Event_Code`、「项目编码 」、「ＥＶＥＮＴ＿ＣＯＤＥ」都认。

下面是逐列要填什么（列名用英文规范名，括号里是中文表头的同义写法）：

| 列名 | 是否必须 | 填什么 | 示例 |
|---|---|---|---|
| `event_code`（项目编码） | **必须** | 小项编码，抄系统里配好的 | `M100` |
| `category`（组别） | **必须** | 组别**名称**（中文，要跟系统里一字不差） | `男子30岁以下` |
| `team_code`（单位编码） | **必须** | 参赛单位编码，抄系统里配好的 | `F1` |
| `athlete_name`（姓名） | **必须** | 运动员姓名。**团体项目这一列留空** | `张伟` |
| `id_card`（证件号） | 可选 | 证件号（身份证号）。**系统的第一认人依据**；一个证件号只能属于一个人 | `110101199001011234` |
| `gender`（性别） | 可选 | 性别，只写「男」或「女」 | `男` |
| `age`（年龄） | 可选 | 年龄，0–120 的整数 | `26` |
| `bib`（号码布） | 可选 | 号码布；证件号为空时按它认人（同一个号码布不能给两个人） | `101` |
| `seed`（种子） | 可选 | 道次 / 种子，随便写或留空 | `种子1` |
| `heat`（批次） | 可选 | 批次号：1–999 的整数；**留空 = 未分批**（不参与算分，见下） | `1` |
| `status`（状态） | 可选 | 报名状态：4 个英文词（大小写都行）或等价的中文别名（见下） | `registered` |
| `member_names`（队员名单） | 可选 | 团体项目的队员名单，多人用 `/` 隔开 | `张三/李四/王五` |

> 「必须」指的是**这一列的表头要有**。至于每格里能不能留空，看下面第三节逐列的说明。

**表头大小写不敏感**：写 `Event_Code` 或 `event_code` 都认；换成中文表头（`项目编码`）也认，两套混着写同样可以。

---

## 三、逐列怎么填（重点）

> 下面每一列的小标题写的是**英文规范名**；用中文表头时列名换成第二节对照表里的中文写法（`event_code` = 项目编码、`category` = 组别、`team_code` = 单位编码、`athlete_name` = 姓名、`id_card` = 证件号、`gender` = 性别、`age` = 年龄、`bib` = 号码布、`seed` = 种子、`heat` = 批次、`status` = 状态、`member_names` = 队员名单），**填法完全相同**。

### `event_code` 小项编码 —— 必须填
在系统「基础数据 → 大项 / 小项」里给每个小项配的**编码**，比如 `M100`（男子100米）、`BB`（多人抓杆蛇形跑）。
填了系统里没有的编码，这一行会被跳过，提示「小项 XXX 不存在」。

### `category` 组别名称 —— 必须填
填**组别的名字**，不是编码。比如「男子30岁以下」「男子31岁以上」「女子组」「基层组」「领导组」。
- 必须和系统里该小项的组别名称**完全一致**（含标点），否则提示「组别 XXX 不存在」。
- 这一格**留空**也可以：系统会自动放到该小项排序最靠前的那个组别。一个单位一个项目只报一个组时，留空能省事；报了多个组别的项目，必须写明。

### `team_code` 单位编码 —— 必须填
在系统「基础数据 → 参赛单位」里给每个大单位配的**编码**，比如 `F1`、`F2`。系统里没有的会提示「单位 XXX 不存在」。
被「彻底删除」的单位，导入时若再次用到它的编码，它会**重新出现（复活）**，这一行照常导入——单位编码是唯一的，系统按编码复用原来那条记录，它以前的报名、成绩与积分都还在。

### `athlete_name` 运动员姓名
- **个人项目**：填姓名，必填。
- **团体项目**：**这一列留空**，表示"这是某个单位的一条团体报名"，队员写在 `member_names` 里。
- 姓名为空的行，系统只建一条单位报名，不会去建运动员档案。

### `id_card` 证件号 / `bib` 号码布 —— 有姓名就至少填一个
只要有姓名，**证件号与号码布至少要填一个**，否则无法确认是哪一个人，这一行会被跳过，提示「填写了 athlete_name 就必须填 id_card 或 bib」。

- **证件号是系统认人的第一依据**：先按证件号找人；证件号为空、或库里的档案还没登记证件号时，再按号码布找；两者都没找到，才按「姓名 + 单位」找（完整顺序见本节的「系统怎么认人」）。
- **一个证件号在系统里只能属于一个人**。表里给的证件号如果已经登记在别人名下，系统会按这个证件号去认那个人，姓名 / 单位对不上就进「冲突」列表让你逐条决定——不会把证件号抢过来，也不会静默改档。**证件号填错是最容易认错人的地方，请照抄身份证，不要凭记忆写。**
- **没有身份证的人只填号码布也行**（外聘人员、临时工常见）：此时系统按号码布认人，下次导入也要带同样的号码布。
- **同一个证件号在同一份表里重复出现不报错**（同一个人报多个组别时本来就会重复）：系统当作同一个人，每个组别各落一条报名，并在导入结果里给一条提示「证件号 XXXX 在本表中出现 N 次（同一人报名多个组别）」。**但同一小项同一个组别里出现两次就是真重复**，会进「冲突」列表，由你决定保留已有还是改用表里这条。
- **号码布不是唯一标识**，但两个人不能共用一个号码布：把同一个号码布给了两个不同的人，这一行会报错并跳过。（同一个人报多个组别时号码布可以重复。）
- 号码布会同时写进人员档案和报名记录。

### `gender` 性别
只认「男」「女」两个字。留空没问题；写「男性」「女 」等其它写法会被**当成没填**（不报错，但也不记录）。

### `age` 年龄
0–120 的整数，可以留空。填了「二十六」「26岁」这种会被跳过，提示「age 需要是 0-120 的整数」。

### `seed` 道次 / 种子
自由填写，可以留空。系统只做记录，不参与算分、不影响名次。

### `heat` 批次 —— 可以留空
给同一组别的人**分批**用的号：填 **1–999 的正整数**，留空表示「未分批」。现场分批比赛（例如 100 米跑道只有 8 条、一组 30 人要分 4 场跑）时，填上批次，录入员就能在「成绩录入」页按批筛选，只在自己这一批里找人录成绩。

- **批次不参与算分**：名次与积分仍然按「小项 + 组别」整体计算，分批与否不会改变任何分数与名次；批次只是录入 / 展示分组；
- 同一小项、同一组别里，批次号相同的人就是同一批；批次号不要求连续，也不要求从 1 开始；
- 格子**留空**就是未分批，不报错；
- 填了不是整数、或超出 1–999（例如 `第1批`、`0`、`1000`），这一行会被跳过并提示「heat 需要是 1-999 的整数（留空表示未分批）」，其余行照常导入；
- 重新上传同一份表会把这一列**整条覆盖**：表里留空就会把这行原来的批次清掉（见第七节第 2 条）。

> 不想在报名表里写批次也行：导入后到「成绩录入」页勾选若干行点「设为第 N 批」，或用「一键均分」按人数自动分批（见[使用手册 · 4.1](./使用手册.md#41-选择项目与批次)）。

### `status` 报名状态 —— 英文词或中文别名都认
**大小写不敏感**（`registered`、`Registered`、`DNS` 都认），也可以直接写中文：

| 英文写法 | 等价的中文别名 | 含义 |
|---|---|---|
| `registered` | `正常` / `正常参赛` / `参赛` | 正常参赛 |
| `scratched` | `退赛` / `弃赛` / `请假` | 退赛 / 弃赛 |
| `dq` | `取消资格` / `犯规` | 取消资格 |
| `dns` | `未出场` / `未到` / `缺席` | 未出场 |

留空 = `registered`（正常参赛），拿不准就留空，特殊情况再填。

真正**认不出**的写法（例如「已报到」「未参赛」）：这一行会被跳过，并给出中文行级提示，其余行照常导入。

> 第 12 行：status「已报到」无法识别，只能填 registered / scratched / dq / dns（或留空）

### `member_names` 队员名单
团体项目用这一列写队员，多人之间用 `/`、`,` 或 `，` 分开：

```
张三/李四/王五
张三,李四,王五
```

- 团体项目**可以只报单位、不写队员**（这一列留空即可），队员名单以后还能补。
- 系统界面里会把这条名单显示成「张三、李四、王五」。

### 系统怎么认人（证件号 → 号码布 → 姓名 + 单位）
有姓名的行，系统按下面的顺序认人。**证件号是唯一标识，号码布是它的替补，最后才靠「姓名 + 单位」兜底回填**：

| 情况 | 系统怎么处理 |
|---|---|
| 表里的**证件号**在系统里已有 | 认作**同一个人**；若表里的姓名 / 性别 / 年龄 / 单位 / 号码布与他的档案对不上，会进「冲突」列表等你逐条决定（保留哪一侧），该行本轮不写入 |
| 证件号为空，或系统里还没有人有这个证件号 | 再看**号码布**：号码布在系统里已有 → 认作同一个人（差异同样进「冲突」列表） |
| 证件号与号码布都没找到 | 按「**姓名 + 单位**」找：<br>· 找不到 → 新建人员档案；<br>· 恰好一人、两边给的证件号（或号码布）对得上或有一边没填 → 认定是同一人，表里给的证件号 / 号码布 / 年龄会**回填**到他的档案（不算冲突）；<br>· 恰好一人、但他已有**另一个**证件号（或号码布）且与表里不同 → 按「**同名的另一个人**」**新建档案**，并在导入结果里单独列出（姓名 / 单位 / 原证件号或号码布 / 新证件号或号码布）提醒你核对，**不拦截、不报错**；<br>· 多人 → 分不清是谁，进「冲突」列表等逐条决定 |

> 「同名的另一个人」多半是证件号（或号码布）写错了。收到这条提醒时，先核对表里那个号是不是本人：是别人（真的同名），确认无误即可；是本人写错了，到「基础数据 → 运动员」把档案里的号改回来，并把多出来的那条新档案删掉。

---

## 四、三个完整例子

### 例 1：个人项目（七单位 × 若干人）

表头那一行照抄，下面每人一行。假设 `M100` 是按年龄分组的男子100米，`F1`/`F2` 是两个单位：

| event_code | category | team_code | athlete_name | id_card | gender | age | bib | seed | heat | status | member_names |
|---|---|---|---|---|---|---|---|---|---|---|---|
| M100 | 男子30岁以下 | F1 | 张伟 | 110101199001011234 | 男 | 26 | 101 |  | 1 | registered |  |
| M100 | 男子31岁以上 | F1 | 李强 | 110101198505054321 | 男 | 41 | 102 |  | 1 | registered |  |
| M100 | 女子组 | F2 | 王芳 |  | 女 |  | 202 |  | 2 | registered |  |
| W100 | 女子组 | F2 | 王芳 | 110101199203031234 | 女 | 34 | 202 |  | 2 | registered |  |

要点：**同一个人报多个项目，就写多行**（如上面的王芳报了两项）；每行的 `event_code` 不同。

### 例 2：团体项目（七单位 × 两组）

`BB` 是「多人抓杆蛇形跑」，七家单位各出基层组和领导组两支队伍：

| event_code | category | team_code | athlete_name | id_card | gender | age | bib | seed | heat | status | member_names |
|---|---|---|---|---|---|---|---|---|---|---|---|
| BB | 基层组 | F1 |  |  |  |  |  |  |  | registered | 张三/李四/王五/赵六 |
| BB | 基层组 | F2 |  |  |  |  |  |  |  | registered | 钱七/孙八 |
| BB | 领导组 | F1 |  |  |  |  |  |  |  | registered | 周九 |
| BB | 领导组 | F3 |  |  |  |  |  |  |  | registered |  |

要点：`athlete_name` 一列**全部留空**；不参赛的单位**不写行**（不写就是没报名）；最后一行是不写队员的纯单位报名，也是允许的。

### 例 3：「个人 + 团体」项目

这类项目（比如团体引体向上）**按个人报名填**：每人一行、填姓名和单位。系统会自己算两份成绩——个人的名次分记在个人身上，团体分按各队成员的**平均成绩**排名后算给单位。**不需要**再单独写团体行。

---

## 五、导入前请先检查（自检清单）

- [ ] 第一行是那 12 个列名（**英文一套、中文一套都行**，也可以中英混着写，见第二节），没有被合并单元格、**同一列没有写两遍**
- [ ] 表头上方没有多余的标题行或空行
- [ ] `event_code`、`team_code` 都是从系统里抄的编码，没有空格
- [ ] `category` 与系统里的组别名一字不差
- [ ] 个人行都有姓名，且都有证件号或号码布
- [ ] 证件号优先填、填准（**它是系统认人的第一依据**，填错最容易认错人）
- [ ] 一份表里**没有把同一个号码布给两个不同的人**（同一个人报多个组别时可以重复）
- [ ] 同一小项同一个组别里没有把同一个人写两遍（真重复会进「冲突」列表等决策）
- [ ] 每个证件号在系统里只属于一个人，别和别人的档案重号
- [ ] `status` 只用那 4 个英文词（大小写都行）或第三节列的中文别名，不写别的词；拿不准就留空
- [ ] `heat` 要么留空，要么是 1–999 的整数（不参与算分，只是录入分组）
- [ ] 全表没有因为"怕麻烦"把某些列删掉——**表头 8 个必须列一个都不能少**（哪怕整列是空的）
- [ ] 用的是**分工作表模板**时：每张工作表的名字都是「小项名称@组别名称」、没有多余的工作表；「项目编码 / 组别」两列要么整列留空、要么与表名一字不差（见第八节）

---

## 六、常见报错怎么办

| 提示 | 原因 | 怎么办 |
|---|---|---|
| 第 N 行：event_code / team_code 必填 | 这两格至少有一格是空的 | 每行都必须有小项编码和单位编码 |
| 报名表缺少列 xxx（yyy） | 表头少了这一列，或者列名有错别字 / 上面多了一行标题行。括号里的中文与前面的英文是**同一列**的两种写法（例：`报名表缺少列 athlete_name（姓名）`） | 对照第二节的对照表逐字核对（中英两套都认，混着写也行）；最稳的是重新下载模板，把数据粘进去 |
| 报名表表头重复：第 1 行里同一列出现了两种写法 | 同一列在表头里写了两次（例如既有 `event_code` 又有「项目编码」）——两列都可能带着数据，系统不知道该信哪一列 | 删掉多余的那一列（同一列只留一种写法），再重新上传 |
| 中文变成乱码 | 编码问题，**现在已修好**：Excel 另存的 GB18030 / GBK / UTF-8(带 BOM) / UTF-16(带 BOM) 都认 | **直接传原文件即可，不用转码**。唯一例外见下面两条 |
| 报名表编码无法识别：文件里混有无法解码的字节 | 这个文件**本身坏了**（复制粘贴、转换工具、半路截断都会这样）：坏字节会被静默解成 `�`，导进去就是一串乱码人名，比报错更危险，所以系统直接拦下 | 用 Excel 打开**原文件**，另存为「CSV UTF-8」后再上传；如果另存后仍报同一句，说明原文件已经损坏，请找原始数据重新导出一份 |
| 文件像 UTF-16 但缺 BOM | 用记事本「另存为 Unicode」会产出**不带 BOM** 的 UTF-16；这种文件以前会被误报成「缺少列 event_code」，指向完全错误的方向 | 多数情况系统能自动认出字节序并正确导入；仍报此提示时，用 Excel 另存为「CSV UTF-8」 |
| 无法解析 CSV：表格里多半有没配对的双引号 | 格子里**手工**写了双引号，或只有一个引号没配对 | 让 Excel 重新另存一次（引号由 Excel 按规则加，别手工写）；确实需要引号的，写成 `""` 转义 |
| 第 N 行：小项 XXX 不存在 | `event_code` 写错，或该小项还没在系统里配 | 到「基础数据 → 大项 / 小项」核对编码；没配的先配 |
| 第 N 行：单位 XX 不存在 | `team_code` 写错，或该单位还没配 | 到「基础数据 → 参赛单位」核对 |
| 第 N 行：组别 XXX 不存在 | 组别名和系统里不一致，或该小项还没有这个组别 | 到「基础数据 → 组别」核对名称（注意别多字少字） |
| 第 N 行：小项 XXX 没有组别 | 该小项一个组别都没配 | 先在「组别」里配好，再导入 |
| 第 N 行：填写了 athlete_name 就必须填 id_card 或 bib | 个人行缺两项标识 | 补证件号或号码布；确实都没有的，请先在「运动员」里登记 |
| 第 N 行：号码布 XX 在报名表内重复出现 | 同一份表里，**两个不同的人**用了同一个号码布 | 删掉重复行或改成各自的号码布。（同一个人报多个项目时号码布可以重复；不同的人不能共用。） |
| 第 N 行：证件号 X 已被另一个人占用（姓名 Y，号码布 Z） | 表里给的证件号已经登记在**另一个人**名下，而这一行又没法按证件号认到那个人（例如同时又给了别人的号码布） | 先核对证件号是不是抄错了：**不是这个人**的，把这一格留空即可（只填号码布也能导入）；**是他的**，先到「基础数据 → 运动员」把另一条档案里的证件号清掉或改对，再重新上传这一步列出的行 |
| 第 N 行：status「xxx」无法识别 | `status` 填了系统不认的词（4 个标准词以外的英文，或第三节没列的中文） | 改成 `registered` / `scratched` / `dq` / `dns`（大小写都行）或第三节列的中文别名，也可以留空（= 正常参赛）；改完重新上传 |
| 第 N 行：heat 需要是 1-999 的整数（留空表示未分批） | `heat` 填了非整数、0、负数或超过 999 的值（如 `第1批`、`一组`、`1000`） | 改成 1–999 的整数，或者整格留空（= 未分批）；批次只影响录入分组，不参与算分 |
| 提示「冲突」，人员没有写入 | 按证件号（或号码布、「姓名 + 单位」唯一命中）的人在系统里已有记录，但姓名 / 证件号 / 性别 / 年龄 / 单位 / 号码布跟表里**对不上** | 在导入结果里逐条选「保留已有数据」或「使用新数据」，选完再提交 |
| 文件传不上去 | 超过 32MB | 拆分上传，或改用 xlsx |
| 工作表「XXX」没能定出是哪个小项、哪个组别 | 这是一份**分工作表模板**（有工作表名里带 `@`），但工作簿里混进了别的表（备注表、说明表），或者表名写得不合规 | 删掉多余的工作表，或把表名改成「小项名称@组别名称」（见第八节）；只有一张表、数据都在里面时，把它存成 CSV 用单表模板导 |
| 本行项目编码 XXX 不是工作表名里那个小项 / 本行组别 XXX 与工作表名里的组别不一致 | 分工作表模板里范围由**工作表名**决定，而这一行的「项目编码 / 组别」两格又填了别的值 | 把那两格**清空**（留空即按工作表名走），或改成与工作表名一致的值 |
| 工作表「XXX」是隐藏表，按约定不参与导入 | 工作簿里有隐藏工作表 | 要在它里面导数据就先取消隐藏并改名成「小项名称@组别名称」，否则忽略这条提示即可 |

---

## 七、导入以后

1. 系统会显示**新增 / 更新 / 跳过**的数量：
   - **新增**：这次新建的报名；
   - **更新**：这个人本来就有这个项目的报名，用表里的信息覆盖了（**不会产生重复报名**）；
   - **跳过**：没能导入的行，会带着**行号**列出来，改好那几行重新上传即可。
   - 另有一份**「按同名的另一个人新建了档案（证件号 / 号码布不同）」**清单，单独列出姓名 / 单位 / 原证件号或号码布 / 新证件号或号码布。它不是错误：这些行**已经导入成功**，只是提醒你核对证件号与号码布有没有写错（见第三节的「系统怎么认人」）。
   - 同一证件号在本表里出现多次时，还会给一条**「证件号 XXXX 在本表中出现 N 次（同一人报名多个组别）」**的提示：这是正常的，只提醒你别把不同的人写成同一个证件号。
2. **重复上传同一份表是安全的**，不会把名单变成两份。改完再传一遍就行。
   - ⚠️ 但要注意「更新」是**整条覆盖**：表里空着的格会把系统里原来的值清掉（队员名单、道次、号码布、**批次**都会被清空），`status` 空着会被重置成「正常参赛」。如果之前手工调整过某些人的状态或批次，**重传前请在表里把 `status`、`heat` 写清楚**。
3. 名单导入后，到「成绩录入」里录成绩、发布，积分榜就会自动更新。
4. **被「彻底删除」的人，导入时会以新人员建档**：管理员彻底删除某个人时，他的档案连同他名下的报名与成绩会一起从库里删掉；之后表里再出现同一个证件号（或同一个号码布、同一「姓名 + 单位」），系统匹配不到旧档案，会把他当作**新人员**重新建档——名单里多出一条「以前删过的人」通常就是这么来的。新档案是全新的，他以前的报名、成绩与积分不会回来，需要重新录。
5. **被「彻底删除」的单位则相反，导入时会「复活」**：管理员彻底删除某个单位，只是把它从单位列表里移除，它的报名与成绩一条都没删；表里再出现这个 `team_code`，系统按编码复用原来那条单位记录，清掉删除标记并让它重新出现在列表里，**原有的报名、成绩与积分都还在**，也不会新建第二个同名单位。
6. **别一口气连传几十次**：写操作限 **120 次/分钟/用户**，超了会返回「操作过于频繁，请稍后再试」。正常一次导入只算一次；真被限了就等一分钟再传，不要连点。

---

## 八、分工作表模板（一个小项组别一张表）

前面几节讲的都是**单表模板**：一份表装下全部报名，「项目编码」与「组别」两列每行都要抄一遍。
小项一多（几十个小项 × 几个组别），抄这两列又累又容易串行——所以系统还提供一种
**分工作表模板（xlsx）**：**一个小项 × 一个组别 = 一张工作表**，范围写在**表名**上，数据区只填人。

> 两种模板**都能导入**，谁也替代不了谁：单表 CSV 老填表人照旧用，分工作表模板给「一个小项组别再抄串了」的场合。
> 「基础数据 → 报名导入」里四个下载按钮分别对应：**中文表头 / 英文表头**（单表 CSV）、
> **分工作表 · 中文表头 / 分工作表 · 英文表头**（xlsx）。

### 8.1 工作表怎么命名

| 规则 | 说明 |
|---|---|
| 表名 = **小项名称** `@` **组别名称** | 例如小项「100 米跑」+ 组别「男子组 30岁以下」→ 工作表名 `100 米跑@男子组 30岁以下` |
| 用的是**名称**，不是编码 | 就是「基础数据 → 大项 / 小项」里的小项名、「组别」里的组别名，一字不差 |
| 一张表只能对一个组合 | 一个小项组别一张表；两列都不用填——**范围由表名说了算** |
| 表名里**不能有** `@` 以外的花样 | `:` `\` `/` `?` `*` `[` `]` 会被系统自动换成同形的全角字符（Excel 不允许工作表名里有它们） |

**小项名称与组别名称里禁止使用 `@`（全角 `＠` 也不行）。** 理由是它就是表名里的分隔符：
名字里再出现一个 `@`，系统就分不清哪个 `@` 是分隔符、哪一个是名字的一部分。
- 界面（新建 / 编辑小项、编辑组别）会当场拦下并说明原因；
- 规则包里的小项名同样拦；服务端接口也拦（改接口、导 Excel 都绕不过去）；
- **已经存在**的历史名字里若带 `@`：不影响任何报名、成绩与积分，但**分工作表模板会生成不出来**——
  下载时会明确告诉你「哪一个小项 / 组别带 @，请先改名」，改名后再下载即可（改名不丢数据）。

### 8.2 数据怎么填

- 每张工作表**第 1 行就是表头**（与单表模板同样的 12 列、中英两套都认），**从第 2 行开始填人**；
- **「项目编码」「组别」两列可以整列留空**——表名已经说明了是哪个小项、哪个组别；
  一旦填了，就**必须与表名一致**，不一致的那一行会报错并跳过（系统不猜、也不会挑一个用）；
- 其余列与单表模板完全一样（第三节逐列说明照样适用）；
- **只填了表头、没填人的那张表**会被跳过并给一条提示（= 这个组别没人报名），其余表照常导入；
- 不要在工作簿里加「说明」之类的工作表：**只要工作簿里有一张表名带 `@`**，整份文件就按分工作表模板处理，
  其它表名（例如 `Sheet1`、`备注`）必须也是「小项名称@组别名称」的形状，否则**整份拒绝**并点名是哪张表——
  静默跳过意味着你填在第 3 张表里的几十行数据无声消失，结果面板上却还显示「导入成功」。

### 8.3 表名太长、或者两个组合撞名了怎么办

Excel 对工作表名有硬限制：**最长 31 个字符**，同一份工作簿里**不能重名**。系统的处理是确定的，不用你操心：

- **太长**：小项名与组别名各保留开头的一段（小项名优先保留，组别名至少留 8 个字符），拼起来不超过 31 字符。
  截断后的表名仍是原名的一段开头（保留头部、去掉尾巴），人一眼能认出是哪一项：小项名
  `第三届全国职工运动会田径比赛男子甲组100米跑决赛` + 组别名 `30岁以下公开组`，算出来是
  `第三届全国职工运动会田径比赛男子甲组100米@30岁以下公开组`（小项名留下 22 个字符，组别名留下 8 个）；
- **撞名**：截断后如果两张表名字一样，后一张会自动加 `(2)`、`(3)` 后缀（Excel 里重名会让后一张把前一张**覆盖掉**，数据无声消失，所以这一步必须做）；
- 下载下来的模板里这些名字**是最终名字**，照原样填、原样传回来即可；**不要手工改工作表名**，改了就对不上号了。

> 小项或组别**改过名字**（或改了截断规则之后重新下载）时：旧模板里的表名对不上新名字，导入会报
> 「工作表『XXX』没能定出是哪个小项、哪个组别」。这时**重新下载一份模板**、把数据粘过去最稳。

### 8.4 与单表模板的关系

| | 单表模板（CSV / XLSX） | 分工作表模板（XLSX） |
|---|---|---|
| 文件形态 | 一张表装全部报名 | 一个小项组别一张工作表 |
| 范围从哪来 | 每行的「项目编码 / 组别」两列 | **工作表名**（「项目编码 / 组别」可留空） |
| 表名限制 | 随便（`Sheet1`、`报名表` 都行） | 必须「小项名称@组别名称」 |
| 多张工作表的文件 | 只读第一张，其余在导入结果里提示「没有读」 | 每张表各导各的 |
| 适合 | 零散补报、小规模、沿用老表格 | 小项组别多、按项目分工填表 |

两种模板**解析口径完全一致**：表头、认人顺序、冲突处理、行级报错都共用同一套代码，
只有「范围从哪来」这一点不同。

---

## 九、给填写人的最短提示（一页版）

> 1. 用系统里下载的模板（**中文表头 / 英文表头都能用**，见第二节），**第一行不要动**、同一列不要写两遍；
> 2. **一个人一行**；一个人报几项就写几行；
> 3. `event_code`（小项）、`team_code`（单位）、`category`（组别）照抄系统里配好的，不自己编；
> 4. 每人要有**证件号或号码布**，至少一个；**证件号是系统认人的第一依据**（有就优先填、填准、别和人重号）；没有证件号时号码布顶替它认人，**号码布也不能给两个人**；
> 5. 团体项目：姓名列留空，队员写进 `member_names`，多人用 `/` 隔开；
> 6. 拿不准的列**留空**，不要写「无」「/」「—」这类符号；
> 7. 表里**不要合并单元格**、不要加标题行、不要插图；
> 8. 填完先对着第五节的清单自查一遍，再发给收表人；
> 9. **批次（`heat`）**可以不填；要分批比赛就填 1–999 的整数，它只影响录入时怎么分组找人，**不影响成绩与名次**；
> 10. **存成什么格式**：Excel →「另存为」→「**CSV UTF-8 (逗号分隔) (*.csv)**」最稳；中文 Excel 默认的「CSV (逗号分隔)」也能用。**别用「Unicode 文本」（UTF-16）**，**别手工改名或把两个文件拼起来**，也别在格子里手写双引号（让 Excel 自己加）。
>
> 一句话：**下载模板 → 只往下面粘数据 → 另存为 CSV UTF-8 → 上传**。中间任何一个"顺手改一下"都可能让整份表被拦下。