docs: 新增《报名名单导入规范》,给各单位填表人看的导入格式说明

面向非技术读者写清楚报名表到底长什么样、每一列怎么填:

- 11 列逐列说明(哪些必填、值域、示例),表头大小写不敏感、
  列顺序可调、多余列忽略;event_code/team_code 抄系统编码、
  category 填组别名称、status 只能填 registered/scratched/dq/dns 小写
- 个人项目 / 团体项目 / 「个人+团体」三种项目的完整示例表格
- 导入前自检清单、常见报错逐条对照(含中文乱码与「缺少列 event_code」)、
  重传是整条覆盖(空值会清掉原值、status 会被重置)这条容易踩的坑
- 一页版「给填写人的最短提示」

同时:README 文档索引、使用手册 §10.7、常见问题 Q51 交叉引用该文档;
debug/使用说明/ 也放了一份,方便直接发给填表人。
This commit is contained in:
AskaEth committed 2026-09-10 19:05:25 +08:00
1 parent fc96d17660
commit 22ab49e73a
4 files changed
+193 -1

No files matched your search

+1 -1
View File
@@ -256,7 +256,7 @@ Console 启动的多屏窗口默认每屏锁定一页。到「大屏控制」点
**不用转码,直接传原文件就行。** 服务端会自己识别编码:UTF-8、带 BOM 的 UTF-8(Excel 的「CSV UTF-8」)、GBK / GB18030(中文 Windows 上 Excel「另存为 CSV」的默认编码)、UTF-16(PowerShell `Export-Csv` 的默认编码)都能正常导入。
- 这两种症状以前长这样:GBK 文件的中文单位名、运动员名**变成乱码**;带 BOM 的文件报「**报名表缺少列 event_code**」——看着像表头写错,其实是 BOM 粘在了第一列表头上。现在都已修好,两种文件都直接传。
- 如果还是报「报名表缺少列 xxx」,那就是表头真的不对:第一行必须是英文列名(`event_code,category,team_code,athlete_name,…`),不能是中文标题行,上面也不要有多余的标题行或合并单元格。最稳妥的做法是下载页面上的「CSV 模板」照着填。
- 如果还是报「报名表缺少列 xxx」,那就是表头真的不对:第一行必须是英文列名(`event_code,category,team_code,athlete_name,…`),不能是中文标题行,上面也不要有多余的标题行或合并单元格。最稳妥的做法是下载页面上的「CSV 模板」照着填,格式细节见 [报名名单导入规范](./报名名单导入规范.md)。
- xlsx 不受影响,它自带编码信息。
---