fix: 实机复测六批发现的 16 条缺陷（导入编码静默错误 / 导出观感 / 错误分级 / 大屏裁切）

先把「实机复测」能在这台 Linux 机器上验的全部自己验掉（真服务端 + 真 Chromium + 真样本），
六批全部通过，另挖出 16 条缺陷，逐条修完并复验：

导入
- 坏字节被静默替换成 U+FFFD 却报「组别不存在」→ 检测 RuneError 回 400 + 可操作中文文案
- UTF-16 无 BOM 误报「缺少列 event_code」→ 保守判据识别并正确解码
- CSV 语法错只有英文 → 中文提示，英文原文保留在 detail
- 表头缺列补「第 1 行应是表头」的指向

导出
- 名次列宽 8 → 11（放得下「3（并列）」，Excel 里不再硬裁）
- 运动员/队列宽 18 → 24（含奖牌明细的同一列）
- 聚合流水行补组别（仅单位在该小项只参加一个组别时回推；多组别宁可留空也不猜）
- docProps 作者从 excelize 默认的 xuri 改成中性名 + 真实导出时间
- Content-Disposition 补 ASCII 退化 filename（9 个下载端点，含此前没有测试的 project.zip）

错误分级与限流
- 未知大屏指令 500 → 400 VALIDATION_FAILED（传输层真失败仍走 5xx）
- 5xx 的 ERROR 日志补 role / ip（4xx 的 WARN 一直有）
- 写限流 30 → 120 次/分钟/用户（登录 5 次/分/IP 不动，性质不同）
- 赛事名含非法字符时导出给 400 + 可操作提示（原来永远 500「服务端异常」）

大屏与基础设施
- 实时赛况 2 栏成绩末位被裁（1:09.00 显示成 1:09.0）→ 成绩列按内容定宽 + nowrap；
  字号不缩，让位给可省略号截断的运动员列。真 Chromium 实测 slack −45px → +6px、0 裁切、
  scrollWidth 恒 1920（无横向滚动条）；顺带修掉 1 栏长成绩同样被裁 8px 的问题
- logging 启动即预建两个日志目录（原来 interceptions/ 懒创建，现场会以为日志坏了）
- C→S 裸帧由静默忽略改为 WARN，并把「要套 {event,data} 外壳」写进日志
- 建单位/大项漏传 active 不再静默建成「停用」（新增 decodeJSONPresence 按键是否存在判意图）

文档
- README 单位 logo 措辞收窄到「大屏端」（管理端只负责上传配置）
- 导入规范补三类编码报错说明 + 现场另存结论 + 限流提示
- 部署指南补「导出前先看赛事名称」与「切换后怎么确认真的切过去了」
- devdocs 05/08/13 同步（含第三十五轮的完整记录与教训）

自检：服务端 13 包连跑两遍全绿；前端 257 例；vue-tsc + build 通过；Console 18 文件。
版本号 dev_0.1.4 → dev_0.1.5。

server/internal/httpapi/handlers_config.go

@@ -193,9 +193,15 @@ func (s *server) getTeamHandler(w http.ResponseWriter, r *http.Request) (any, er
 
 func (s *server) createTeamHandler(w http.ResponseWriter, r *http.Request) (any, error) {
 	var in teamDTO
-	if err := decodeJSON(r, &in); err != nil {
+	keys, err := decodeJSONPresence(r, &in)
+	if err != nil {
 		return nil, err
 	}
+	// 缺省 = 启用。Go 的 bool 零值是 false，漏传 active 会被静默建成「停用」，
+	// 而停用的单位在界面上等于不存在 —— 脚本与导入侧踩过一次就很难查。
+	if !keys.has("active") {
+		in.Active = true
+	}
 	created, err := s.createTeam(r.Context(), in)
 	if err != nil {
 		return nil, err
@@ -210,13 +216,19 @@ func (s *server) updateTeamHandler(w http.ResponseWriter, r *http.Request) (any,
 		return nil, err
 	}
 	var in teamDTO
-	if err := decodeJSON(r, &in); err != nil {
+	keys, err := decodeJSONPresence(r, &in)
+	if err != nil {
 		return nil, err
 	}
 	before, err := s.getTeam(r.Context(), id)
 	if err != nil {
 		return nil, err
 	}
+	// 更新仍是「全量覆盖」语义，但漏传 active 不等于「把它停用」：沿用库里的现值。
+	// 想停用请显式传 false，或走 DELETE（那才是界面上那个「停用」）。
+	if !keys.has("active") {
+		in.Active = before.Active
+	}
 	updated, err := s.updateTeam(r.Context(), id, in)
 	if err != nil {
 		return nil, err
@@ -269,9 +281,14 @@ func (s *server) getSportHandler(w http.ResponseWriter, r *http.Request) (any, e
 
 func (s *server) createSportHandler(w http.ResponseWriter, r *http.Request) (any, error) {
 	var in sportDTO
-	if err := decodeJSON(r, &in); err != nil {
+	keys, err := decodeJSONPresence(r, &in)
+	if err != nil {
 		return nil, err
 	}
+	// 与建单位同口径：缺省 = 启用（漏传 active 不该建成一个在界面上不存在的大项）。
+	if !keys.has("active") {
+		in.Active = true
+	}
 	created, err := s.createSport(r.Context(), in)
 	if err != nil {
 		return nil, err
@@ -286,13 +303,18 @@ func (s *server) updateSportHandler(w http.ResponseWriter, r *http.Request) (any
 		return nil, err
 	}
 	var in sportDTO
-	if err := decodeJSON(r, &in); err != nil {
+	keys, err := decodeJSONPresence(r, &in)
+	if err != nil {
 		return nil, err
 	}
 	before, err := s.getSport(r.Context(), id)
 	if err != nil {
 		return nil, err
 	}
+	// 同单位：漏传 active 沿用现值，不静默停用。
+	if !keys.has("active") {
+		in.Active = before.Active
+	}
 	updated, err := s.updateSport(r.Context(), id, in)
 	if err != nil {
 		return nil, err
@@ -734,7 +756,9 @@ func readTable(ext string, file io.Reader) ([][]string, error) {
 		reader.TrimLeadingSpace = true
 		rows, err := reader.ReadAll()
 		if err != nil {
-			return nil, badRequest("无法解析 CSV", err.Error())
+			// CSV 语法错误几乎都是格子里有没配对的双引号。message 给现场能照着做的中文提示，
+			// Go 的英文原文（parse error on line ...）留在 detail 里，排查时还要用。
+			return nil, badRequest("无法解析 CSV：表格里多半有没配对的双引号。请用 Excel 打开原文件，另存为「CSV UTF-8」后再导入", err.Error())
 		}
 		return rows, nil
 	}
@@ -747,6 +771,11 @@ var (
 	tableUTF16BEBOM = []byte{0xFE, 0xFF}
 )
 
+// errTableReplacementRune 表示解码结果里出现了替换字符 U+FFFD。
+// x/text 的解码器对非法字节、孤立代理对这类坏数据不返回 error，只把它们换成 U+FFFD，
+// 靠这个哨兵错误把「解出一串 �」和「真的解开了」区分开。
+var errTableReplacementRune = errors.New("decoded text contains U+FFFD replacement character")
+
 // decodeTableText 把报名表的字节流解码成 UTF-8 文本。
 //
 // 现场拿到的 CSV 基本都是直接从 Excel 存的，而 Excel 默认不写 UTF-8：中文 Windows 上
@@ -765,9 +794,16 @@ func decodeTableText(file io.Reader) (string, error) {
 	case bytes.HasPrefix(data, tableUTF8BOM):
 		data = data[len(tableUTF8BOM):]
 	case bytes.HasPrefix(data, tableUTF16LEBOM):
-		return decodeUTF16Table(data[len(tableUTF16LEBOM):], textunicode.LittleEndian)
+		return decodeUTF16Table(data[len(tableUTF16LEBOM):], textunicode.LittleEndian, false)
 	case bytes.HasPrefix(data, tableUTF16BEBOM):
-		return decodeUTF16Table(data[len(tableUTF16BEBOM):], textunicode.BigEndian)
+		return decodeUTF16Table(data[len(tableUTF16BEBOM):], textunicode.BigEndian, false)
+	}
+
+	// 丢了 BOM 的 UTF-16 必须排在 utf8.Valid 之前判断：UTF-16 里 0x00 是合法的 UTF-8 码点，
+	// utf8.Valid 会放它过去，表头随即被当成 "e\0v\0e\0n\0t..."，最后报「缺少列 event_code」——
+	// 把现场引去查表头，而真正的问题是编码。
+	if order, ok := guessUTF16Order(data); ok {
+		return decodeUTF16Table(data, order, true)
 	}
 
 	if utf8.Valid(data) {
@@ -778,14 +814,63 @@ func decodeTableText(file io.Reader) (string, error) {
 	if err != nil {
 		return "", badRequest("报名表编码无法识别，请另存为 UTF-8 或 GB18030 编码的 CSV 后重试", err.Error())
 	}
+	// 非法字节会被静默换成 U+FFFD：不拦住的话它一路往下走，现场看到的是
+	// 「第 2 行：组别 ��� 不存在」，跑去查组别配置——真正坏的是文件。
+	if strings.ContainsRune(text, utf8.RuneError) {
+		return "", badRequest("报名表编码无法识别：文件里混有无法解码的字节（多半是复制粘贴或转换工具弄坏的）。请用 Excel 打开原文件，另存为「CSV UTF-8」后再导入", nil)
+	}
 	return text, nil
 }
 
-// decodeUTF16Table 解 UTF-16（BOM 已由调用方摘掉）。
-func decodeUTF16Table(data []byte, order textunicode.Endianness) (string, error) {
+// guessUTF16Order 判断无 BOM 的字节流是不是 UTF-16，是的话顺带给出字节序。
+//
+// 判据刻意保守，因为猜错的代价是把好文件解成乱码：UTF-16 的每个 ASCII 字符
+// （列名、逗号、数字、换行）都会贡献一个固定奇偶位的 0x00，而正常的 UTF-8/GB18030
+// 报名表里一个 0x00 都没有。所以只认「NUL 足够多、且几乎只落在同一位」的字节流，
+// 只是混进一两个坏字节的文本文件不会被误判。
+func guessUTF16Order(data []byte) (textunicode.Endianness, bool) {
+	var even, odd int
+	for i, b := range data {
+		if b != 0 {
+			continue
+		}
+		if i%2 == 0 {
+			even++
+		} else {
+			odd++
+		}
+	}
+	zeros := even + odd
+	if zeros < 8 || zeros*4 < len(data) {
+		return false, false
+	}
+	switch {
+	case odd*20 >= zeros*19: // 小端：ASCII 的高位 0x00 落在奇数位
+		return textunicode.LittleEndian, true
+	case even*20 >= zeros*19: // 大端：0x00 落在偶数位
+		return textunicode.BigEndian, true
+	}
+	return false, false
+}
+
+// decodeUTF16Table 解 UTF-16（BOM 已由调用方摘掉）。missingBOM 决定失败时给现场哪句提示：
+// 缺 BOM 的要教他「另存为 CSV UTF-8」，带 BOM 还解不动的按编码损坏处理。
+func decodeUTF16Table(data []byte, order textunicode.Endianness, missingBOM bool) (string, error) {
 	text, _, err := transform.String(textunicode.UTF16(order, textunicode.IgnoreBOM).NewDecoder(), string(data))
+	if err == nil && strings.ContainsRune(text, utf8.RuneError) {
+		err = errTableReplacementRune
+	}
+	// 字节序猜反时整份文本会翻成另一堆合法码点（不会出现 U+FFFD），再拿表头必然有的
+	// 逗号兜一道底：认不出是 CSV 就宁可报编码问题，也不能把乱码当成功导进去。
+	if err == nil && missingBOM && !strings.ContainsRune(text, ',') {
+		err = errors.New("utf-16 decode produced no csv delimiter")
+	}
 	if err != nil {
-		return "", badRequest("报名表编码无法识别，请另存为 UTF-8 编码的 CSV 后重试", err.Error())
+		message := "报名表编码无法识别，请另存为 UTF-8 编码的 CSV 后重试"
+		if missingBOM {
+			message = "报名表看起来是 UTF-16 编码但缺少 BOM，请用 Excel 打开原文件，另存为「CSV UTF-8」后再导入"
+		}
+		return "", badRequest(message, err.Error())
 	}
 	return text, nil
 }
@@ -813,7 +898,9 @@ func (s *server) importEntriesWith(ctx context.Context, rows [][]string, decisio
 	}
 	for _, col := range importColumns {
 		if _, ok := index[col]; !ok {
-			return result, badRequest("报名表缺少列 "+col, nil)
+			// 表头类报错必须点到「表头行」本身：用户常在表头上方加一行标题，
+			// 只说「缺少列 X」会让他去翻数据行，找不到问题在哪。
+			return result, badRequest("报名表缺少列 "+col+"：第 1 行应是表头（列名与导入模板一致），请确认没有在表头上方加标题行、也没有把表头写成别的名字", nil)
 		}
 	}