Scoreboard/server/internal/httpapi/enums.go

package httpapi

import "strings"

// 枚举型入参的取值校验集中在本文件（**但不全**：`entries.status` 的归一只有导入那条路走
// entry_status.go 的 normalizeImportStatus；`scope` / `basis` / `records.level` / `/api/users`
// 的 `role`，以及性别、`avgMode` 等仍在各自原处）。
//
// 这些列在迁移里都写了 CHECK (col IN (...))，但 CHECK 是最后一道闸：非法值一路落到
// SQLite 才被拒，报出来的是原始约束错误，被统一错误处理当成服务端异常，前端看到
// 「服务端异常」而不是「这个值不合法」。必须在这一层拦下来，才能给出 400 与字段名。
//
// 每个函数都直接调用 badRequest：拦截点靠它捕获调用栈，中间再包一层错误构造 helper
// 会让拦截点退化成 response.go 里的构造函数（有测试钉着，见 intercept_log_test.go）。
// 空值一律给建表默认值，与原先 orDefault(...) 的默认值保持一致；本文件里的函数返回值都做
// TrimSpace，避免「前后带空格」这种近失值又落回 CHECK。
// ⚠️ 例外：`normalizeAvgMode` 还在 repo_events.go（本文件之外），且**不做 TrimSpace**——
// 前后带空格的 `valid` / `all` 会被直接拒成 400，不会被裁掉（P2-C24b）。

// normalizeEventType 校验 events.event_type。
// 取值来自 0004 的 CHECK，0016 用 writable_schema 追加了 individual_team。
func normalizeEventType(v string) (string, error) {
	switch strings.TrimSpace(v) {
	case "":
		return "individual", nil
	case "individual", "team", "match", "individual_team":
		return strings.TrimSpace(v), nil
	default:
		return "", badRequest("eventType 只能是 individual / team / match / individual_team", v)
	}
}

// normalizeResultMode 校验 events.result_mode（0004 的 CHECK）。
func normalizeResultMode(v string) (string, error) {
	switch strings.TrimSpace(v) {
	case "":
		return "auto", nil
	case "auto", "manual":
		return strings.TrimSpace(v), nil
	default:
		return "", badRequest("resultMode 只能是 auto / manual", v)
	}
}

// normalizeResultType 校验 events.result_type（0004 的 CHECK）。
func normalizeResultType(v string) (string, error) {
	switch strings.TrimSpace(v) {
	case "":
		return "none", nil
	case "time", "distance", "count", "score", "none":
		return strings.TrimSpace(v), nil
	default:
		return "", badRequest("resultType 只能是 time / distance / count / score / none", v)
	}
}

// normalizeCompare 校验 events.compare（0004 的 CHECK）。
func normalizeCompare(v string) (string, error) {
	switch strings.TrimSpace(v) {
	case "":
		return "none", nil
	case "asc", "desc", "none":
		return strings.TrimSpace(v), nil
	default:
		return "", badRequest("compare 只能是 asc / desc / none", v)
	}
}

// normalizeEventStatus 校验 events.status（0004 的 CHECK）。
// 与 entries.status / results.status 同名但取值不同，故单独一个函数。
func normalizeEventStatus(v string) (string, error) {
	switch strings.TrimSpace(v) {
	case "":
		return "pending", nil
	case "pending", "ongoing", "finished", "published":
		return strings.TrimSpace(v), nil
	default:
		return "", badRequest("status 只能是 pending / ongoing / finished / published", v)
	}
}

// normalizeTieMode 校验 scoring_profiles.tie_mode（0003 的 CHECK）。
func normalizeTieMode(v string) (string, error) {
	switch strings.TrimSpace(v) {
	case "":
		return "skip", nil
	case "skip", "average", "higher":
		return strings.TrimSpace(v), nil
	default:
		return "", badRequest("tieMode 只能是 skip / average / higher", v)
	}
}

// normalizeRecordBonusMode 校验 scoring_profiles.record_bonus_mode（0003 的 CHECK）。
func normalizeRecordBonusMode(v string) (string, error) {
	switch strings.TrimSpace(v) {
	case "":
		return "max", nil
	case "max", "sum":
		return strings.TrimSpace(v), nil
	default:
		return "", badRequest("recordBonusMode 只能是 max / sum", v)
	}
}

// normalizeResultStatus 校验 results.status（0005 的 CHECK）。
func normalizeResultStatus(v string) (string, error) {
	switch strings.TrimSpace(v) {
	case "":
		return "ok", nil
	case "ok", "dq", "dns", "dnf", "withdrawn":
		return strings.TrimSpace(v), nil
	default:
		return "", badRequest("status 只能是 ok / dq / dns / dnf / withdrawn", v)
	}
}