AskaEth
08a5740fb2
## 分批发布（现场：100 米跑道只有 8 条，不能等所有人跑完才发） - 空成绩从"错误"降级为"提示"，不再阻塞发布；真会算错（写法无法识别、秒位 ≥ 60、 手动名次缺名次）仍挡住。发布确认框说明"只发已填的 M 人，其余保持未发布"。 - 服务端核实：publishResults/computeEventScore 本就不会因缺成绩报错 （collectCandidates 直接跳过没有 results 的报名项），根因在前端防呆。 ## 实时赛况（新大屏页 + 定向接口） - 新增 `GET /api/display/live`（guest 可读）：返回「当前项目」判定 + 该项目**全量**已发布成绩 （不受快照 latestResults 的 20 行截断）。回退链：manual 指定 > 排期命中 > 最近发布。 设置键 display.live_events / display.live_source。 - 大屏新页 `live`「实时赛况」：1 个项目单栏、2 个自动左右分栏；失败保留上一次画面 （下一场开始前持续显示上一场）；30s 轮询（判定依赖当前时间）+ 快照变更触发。 - 管理端「大屏控制」新增「实时赛况」卡；该卡走 PUT /api/settings（admin-only）， 故对非管理员整组置灰 + 提示条（不新增角色）。 ## 显式批次层（组别之下） - 迁移 0019 `entries.heat`；批次仅是录入/展示分组，**不参与算分**（有"分批与不分批结果 完全一致"的断言守住）。批量设置接口 + 导入 CSV 可选列 heat + 录入页批次下拉 + 一键均分（按 N 人切片，已有批次号接着往后排）。 ## 成绩输入框实时悬浮提示 - 聚焦格旁的浮动气泡：pointer-events:none、不占布局不改行高、贴底自动上翻； 合法显示解析结果（1:06 → = 66 秒）、可疑/不合法显示原因并带那一格原文； 与发布防呆共用同一套纯函数（entryGuards.ts），口径不会分叉。 ## 窄屏 / 手机端布局 - 真浏览器（Playwright + chromium）在 1440/1024/768/390 四宽度逐页审计 + 溢出探针， 四轮迭代修复；桌面端 1440 前后像素差异 < 0.25%（无回归）；修掉如「修改密码」输入框 塌成 22px 这类真问题。 ## 版本号单一真相 - 新增仓库根 `VERSION`：构建时注入二进制（-X main.version）并同步 console/package.json 的版本（产物名跟随）。源码里不再有人工维护的版本号（兜底值改为 `dev`，故意不写数字）。 测试：服务端 13 包全绿；前端 vue-tsc 通过、249 例全过；Console 18 文件。 docs/ 与 devdocs/ 同步（FAQ 到 Q80、新增 devdocs/16 自定义大屏模板设计文档）。
342 lines
11 KiB
Go
342 lines
11 KiB
Go
package httpapi
|
|
|
|
// 本文件是 REST 的 JSON 契约（camelCase，与 web/src/shared/types.ts 一一对应）。
|
|
// 数据库列是 snake_case，转换集中放在 repo.go 的扫描函数里。
|
|
|
|
type teamDTO struct {
|
|
ID int64 `json:"id"`
|
|
Code string `json:"code"`
|
|
Name string `json:"name"`
|
|
ShortName *string `json:"shortName"`
|
|
LogoPath *string `json:"logoPath"`
|
|
Color *string `json:"color"`
|
|
SortOrder int `json:"sortOrder"`
|
|
Active bool `json:"active"`
|
|
// DeletedAt 非空表示「彻底删除」（对界面不可见），行仍在库里；停用是另一回事（active = false）。
|
|
DeletedAt *string `json:"deletedAt"`
|
|
}
|
|
|
|
type athleteDTO struct {
|
|
ID int64 `json:"id"`
|
|
Name string `json:"name"`
|
|
Gender *string `json:"gender"`
|
|
TeamID int64 `json:"teamId"`
|
|
EmployeeNo *string `json:"employeeNo"`
|
|
IDCard *string `json:"idCard"`
|
|
Bib *string `json:"bib"`
|
|
Age *int `json:"age"`
|
|
Active bool `json:"active"`
|
|
}
|
|
|
|
type sportDTO struct {
|
|
ID int64 `json:"id"`
|
|
Code string `json:"code"`
|
|
Name string `json:"name"`
|
|
ShortName *string `json:"shortName"`
|
|
DefaultProfileID *int64 `json:"defaultProfileId"`
|
|
SortOrder int `json:"sortOrder"`
|
|
Active bool `json:"active"`
|
|
}
|
|
|
|
type categoryDTO struct {
|
|
ID int64 `json:"id"`
|
|
EventID int64 `json:"eventId"`
|
|
Name string `json:"name"`
|
|
Multiplier float64 `json:"multiplier"`
|
|
Gender *string `json:"gender"`
|
|
AgeMin *int `json:"ageMin"`
|
|
AgeMax *int `json:"ageMax"`
|
|
SortOrder int `json:"sortOrder"`
|
|
}
|
|
|
|
type channelDTO struct {
|
|
ID int64 `json:"id"`
|
|
EventID int64 `json:"eventId"`
|
|
Scope string `json:"scope"`
|
|
Basis string `json:"basis"`
|
|
ProfileID int64 `json:"profileId"`
|
|
SortOrder int `json:"sortOrder"`
|
|
// CountToTeam 决定该通道产出的流水是否计入单位总分；请求体里缺省（null）按 true 处理，
|
|
// 「个人+团体」项目的个人通道传 false。响应里始终是具体值。
|
|
CountToTeam *bool `json:"countToTeam"`
|
|
}
|
|
|
|
type eventDTO struct {
|
|
ID int64 `json:"id"`
|
|
SportID int64 `json:"sportId"`
|
|
Code string `json:"code"`
|
|
Name string `json:"name"`
|
|
EventType string `json:"eventType"`
|
|
ResultMode string `json:"resultMode"`
|
|
ResultType string `json:"resultType"`
|
|
Compare string `json:"compare"`
|
|
RecordEligible bool `json:"recordEligible"`
|
|
Scored bool `json:"scored"`
|
|
Multiplier float64 `json:"multiplier"`
|
|
Status string `json:"status"`
|
|
ScheduledAt *string `json:"scheduledAt"`
|
|
Venue *string `json:"venue"`
|
|
SortOrder int `json:"sortOrder"`
|
|
Remark *string `json:"remark"`
|
|
AvgMode string `json:"avgMode"`
|
|
Categories []categoryDTO `json:"categories,omitempty"`
|
|
Channels []channelDTO `json:"channels,omitempty"`
|
|
}
|
|
|
|
type profileRuleDTO struct {
|
|
Rank int `json:"rank"`
|
|
Points float64 `json:"points"`
|
|
}
|
|
|
|
type profileDTO struct {
|
|
ID int64 `json:"id"`
|
|
Code string `json:"code"`
|
|
Name string `json:"name"`
|
|
TieMode string `json:"tieMode"`
|
|
RecordBonusMode string `json:"recordBonusMode"`
|
|
AwardRanks int `json:"awardRanks"`
|
|
LastPlaceZero bool `json:"lastPlaceZero"`
|
|
Rules []profileRuleDTO `json:"rules"`
|
|
}
|
|
|
|
type entryDTO struct {
|
|
ID int64 `json:"id"`
|
|
EventID int64 `json:"eventId"`
|
|
CategoryID int64 `json:"categoryId"`
|
|
TeamID int64 `json:"teamId"`
|
|
AthleteID *int64 `json:"athleteId"`
|
|
MemberNames []string `json:"memberNames"`
|
|
Bib *string `json:"bib"`
|
|
Seed *string `json:"seed"`
|
|
// Heat 是录入 / 展示用的批次号，null 表示「未分批」；批次不参与算分。
|
|
Heat *int64 `json:"heat"`
|
|
Status string `json:"status"`
|
|
Remark *string `json:"remark"`
|
|
AthleteName *string `json:"athleteName,omitempty"`
|
|
TeamCode string `json:"teamCode,omitempty"`
|
|
TeamName string `json:"teamName,omitempty"`
|
|
ShortName *string `json:"shortName,omitempty"`
|
|
CategoryName string `json:"categoryName,omitempty"`
|
|
}
|
|
|
|
type entryWithResultDTO struct {
|
|
entryDTO
|
|
Result *resultDTO `json:"result"`
|
|
}
|
|
|
|
// entryHeatResultDTO 是批量设置批次的结果：本批条目当前统一的批次号（null = 未分批）。
|
|
type entryHeatResultDTO struct {
|
|
Updated int `json:"updated"`
|
|
Heat *int64 `json:"heat"`
|
|
EntryIDs []int64 `json:"entryIds"`
|
|
}
|
|
|
|
type resultDTO struct {
|
|
ID int64 `json:"id"`
|
|
EventID int64 `json:"eventId"`
|
|
EntryID int64 `json:"entryId"`
|
|
Rank *int `json:"rank"`
|
|
ResultText string `json:"resultText"`
|
|
ResultValue *float64 `json:"resultValue"`
|
|
Unit string `json:"unit"`
|
|
IsTie bool `json:"isTie"`
|
|
PointsOverride *float64 `json:"pointsOverride"`
|
|
Status string `json:"status"`
|
|
State string `json:"state"`
|
|
RecordedBy *int64 `json:"recordedBy"`
|
|
RecordedAt *string `json:"recordedAt"`
|
|
VerifiedBy *int64 `json:"verifiedBy"`
|
|
VerifiedAt *string `json:"verifiedAt"`
|
|
Note *string `json:"note"`
|
|
Points *float64 `json:"points,omitempty"`
|
|
}
|
|
|
|
type athleteStandingDTO struct {
|
|
Rank int `json:"rank"`
|
|
AthleteID int64 `json:"athleteId"`
|
|
AthleteName string `json:"athleteName"`
|
|
Gender *string `json:"gender"`
|
|
TeamID int64 `json:"teamId"`
|
|
TeamCode string `json:"teamCode"`
|
|
TeamName string `json:"teamName"`
|
|
ShortName *string `json:"shortName"`
|
|
LogoPath *string `json:"logoPath"`
|
|
TotalPoints float64 `json:"totalPoints"`
|
|
Gold int `json:"gold"`
|
|
Silver int `json:"silver"`
|
|
Bronze int `json:"bronze"`
|
|
}
|
|
|
|
type breakdownItemDTO struct {
|
|
LedgerID int64 `json:"ledgerId"`
|
|
SourceType string `json:"sourceType"`
|
|
EventID *int64 `json:"eventId"`
|
|
EventCode *string `json:"eventCode"`
|
|
EventName *string `json:"eventName"`
|
|
CategoryName *string `json:"categoryName"`
|
|
AthleteID *int64 `json:"athleteId"`
|
|
AthleteName *string `json:"athleteName"`
|
|
Rank *int `json:"rank"`
|
|
ResultText *string `json:"resultText"`
|
|
Points float64 `json:"points"`
|
|
CreatedAt string `json:"createdAt"`
|
|
}
|
|
|
|
type teamBreakdownDTO struct {
|
|
TeamID int64 `json:"teamId"`
|
|
TeamCode string `json:"teamCode"`
|
|
TeamName string `json:"teamName"`
|
|
TotalPoints float64 `json:"totalPoints"`
|
|
Items []breakdownItemDTO `json:"items"`
|
|
}
|
|
|
|
type adjustmentDTO struct {
|
|
ID int64 `json:"id"`
|
|
TeamID int64 `json:"teamId"`
|
|
Delta float64 `json:"delta"`
|
|
Category string `json:"category"`
|
|
Reason string `json:"reason"`
|
|
EventID *int64 `json:"eventId"`
|
|
Voided bool `json:"voided"`
|
|
CreatedBy *int64 `json:"createdBy"`
|
|
CreatedAt string `json:"createdAt"`
|
|
}
|
|
|
|
type recordEntryDTO struct {
|
|
ID int64 `json:"id"`
|
|
EventID int64 `json:"eventId"`
|
|
Level string `json:"level"`
|
|
ResultValue float64 `json:"resultValue"`
|
|
ResultText string `json:"resultText"`
|
|
HolderName *string `json:"holderName"`
|
|
HolderTeamID *int64 `json:"holderTeamId"`
|
|
AchievedAt *string `json:"achievedAt"`
|
|
IsCurrent bool `json:"isCurrent"`
|
|
Source string `json:"source"`
|
|
}
|
|
|
|
type recordBreakDTO struct {
|
|
ID int64 `json:"id"`
|
|
EventID int64 `json:"eventId"`
|
|
EntryID int64 `json:"entryId"`
|
|
Level string `json:"level"`
|
|
ResultValue float64 `json:"resultValue"`
|
|
ResultText string `json:"resultText"`
|
|
BonusPoints float64 `json:"bonusPoints"`
|
|
State string `json:"state"`
|
|
ApprovedBy *int64 `json:"approvedBy"`
|
|
ApprovedAt *string `json:"approvedAt"`
|
|
}
|
|
|
|
type auditLogDTO struct {
|
|
ID int64 `json:"id"`
|
|
UserID *int64 `json:"userId"`
|
|
Action string `json:"action"`
|
|
EntityType string `json:"entityType"`
|
|
EntityID *int64 `json:"entityId"`
|
|
BeforeJSON *string `json:"beforeJson"`
|
|
AfterJSON *string `json:"afterJson"`
|
|
IP *string `json:"ip"`
|
|
RequestID *string `json:"requestId"`
|
|
CreatedAt string `json:"createdAt"`
|
|
}
|
|
|
|
type currentUserDTO struct {
|
|
ID int64 `json:"id"`
|
|
Username string `json:"username"`
|
|
DisplayName string `json:"displayName"`
|
|
Role string `json:"role"`
|
|
LastLoginAt *string `json:"lastLoginAt"`
|
|
MustChangePassword bool `json:"mustChangePassword"`
|
|
}
|
|
|
|
type backupResultDTO struct {
|
|
Path string `json:"path"`
|
|
CreatedAt string `json:"createdAt"`
|
|
}
|
|
|
|
// GET/PUT /api/settings 的线上结构见 internal/dto.EventSettings（与 snapshot.settings 共用）。
|
|
|
|
// ---------- 用户管理 ----------
|
|
|
|
type userListItemDTO struct {
|
|
ID int64 `json:"id"`
|
|
Username string `json:"username"`
|
|
DisplayName string `json:"displayName"`
|
|
Role string `json:"role"`
|
|
Active bool `json:"active"`
|
|
MustChangePassword bool `json:"mustChangePassword"`
|
|
LastLoginAt *string `json:"lastLoginAt"`
|
|
}
|
|
|
|
// resetPasswordResultDTO 里的 password 是唯一一次明文，落库只存哈希。
|
|
type resetPasswordResultDTO struct {
|
|
ID int64 `json:"id"`
|
|
Username string `json:"username"`
|
|
Password string `json:"password"`
|
|
Generated bool `json:"generated"`
|
|
MustChangePassword bool `json:"mustChangePassword"`
|
|
}
|
|
|
|
// ---------- 变更历史 ----------
|
|
|
|
type revisionPageDTO struct {
|
|
Items []revisionListItemDTO `json:"items"`
|
|
Total int `json:"total"`
|
|
Limit int `json:"limit"`
|
|
Offset int `json:"offset"`
|
|
}
|
|
|
|
type revisionListItemDTO struct {
|
|
ID int64 `json:"id"`
|
|
ParentID *int64 `json:"parentId"`
|
|
EventID int64 `json:"eventId"`
|
|
EventName string `json:"eventName"`
|
|
Action string `json:"action"`
|
|
ActorID *int64 `json:"actorId"`
|
|
ActorName string `json:"actorName"`
|
|
Message *string `json:"message"`
|
|
CreatedAt string `json:"createdAt"`
|
|
ChangedCount int `json:"changedCount"`
|
|
}
|
|
|
|
type revisionDetailDTO struct {
|
|
revisionListItemDTO
|
|
Snapshot []resultDTO `json:"snapshot"`
|
|
Diff revisionDiffDTO `json:"diff"`
|
|
}
|
|
|
|
type revisionDiffDTO struct {
|
|
Results []revisionResultChangeDTO `json:"results"`
|
|
Teams []revisionTeamDeltaDTO `json:"teams"`
|
|
}
|
|
|
|
type revisionResultChangeDTO struct {
|
|
ResultID int64 `json:"resultId"`
|
|
EntryID int64 `json:"entryId"`
|
|
TeamID *int64 `json:"teamId"`
|
|
Change string `json:"change"`
|
|
Fields []string `json:"fields,omitempty"`
|
|
Before *resultDTO `json:"before"`
|
|
After *resultDTO `json:"after"`
|
|
}
|
|
|
|
type revisionTeamDeltaDTO struct {
|
|
TeamID int64 `json:"teamId"`
|
|
TeamCode string `json:"teamCode"`
|
|
TeamName string `json:"teamName"`
|
|
PointsBefore float64 `json:"pointsBefore"`
|
|
PointsAfter float64 `json:"pointsAfter"`
|
|
PointsDelta float64 `json:"pointsDelta"`
|
|
ChangedResults int `json:"changedResults"`
|
|
}
|
|
|
|
// ---------- domain → DTO ----------
|
|
|
|
func nilIfEmpty(s string) *string {
|
|
if s == "" {
|
|
return nil
|
|
}
|
|
return &s
|
|
}
|