feat: 主人拍板的 4 条全部落地（单条作废/重录、破纪录驳回、历史纪录、仪表盘卡片）+ 迁移 0021（dev_0.3.0）
## ① 成绩「作废本条 / 重新录入」——手滑填错了怎么办
- 新增 `POST /api/results/{id}/reopen`：把已发布的那条退回草稿（state=draft、
status=ok、rank=NULL、note=原因）并重算推榜；口径与既有 `void` 完全一致
（回滚类动作，不受 `standings.live_on_publish` 约束）。
- 成绩录入页新增「操作」列：已发布行可「作废本条」，已作废行可「重新录入」，
两者都必填原因、确认后立即重算+推大屏。**验收用例**：作废→重录→改→重发，
名次/流水/榜单与「一开始就填对」逐字节一致。
## ② 破纪录的驳回 / 作废
- 迁移 `0021_record_breaks_note.sql`：`record_breaks` 加一列可空 `note`。
- 新增 `GET /api/record-breaks?state=`（recorder 起可读，guest 403）与
`POST /api/record-breaks/{id}/reject`（必填原因）：已批准的登记被作废时
**撤回该笔加分、重算推榜、并把该级别当前纪录恢复为上一条**；`approve`
放开为可对 rejected 再次批准。
- 破纪录页新增「已批准的破纪录」卡片（作废入口）；原先只存在浏览器内存里的
「拒绝」改为持久化（先登记再驳回，刷新不再复现）。
## ③ 历史纪录的写入路径（`records.source` 以前恒为「本届」）
- 新增 `POST /api/records`（source 只收 history）与 `DELETE /api/records/{id}`
（删当前纪录时恢复上一条）。纪录库卡片新增「新增历史纪录」与「删除」。
- 至此《使用手册》6.2 承诺的「来源（本届/历史）」这一列才真正有意义。
## ④ 仪表盘补齐承诺的卡片
今天的小项（按 scheduledAt 的本地时区当天 + 进度）、草稿待发布、待确认破纪录、
大屏在线数；数据源读不到显示 `—` 而不是 0。文档里「管理端在线数」服务端没有
接口，按实际改写成本机管理端连接状态。
## 旧版数据包兼容（主人特别交代，三处验证）
迁移只加**可空**列、不重建表、不动数据行；旧赛事包导入后由 `main.go` 的
`store.MigrateEvent` 在启动时补跑迁移。证据：`migration_0021_test.go`
（旧库升级 + 幂等 + 老行取 NULL）、`migration_legacy_test.go` 扩到 0021、
`legacy_pack_upgrade_test.go`（真实旧 event.db 走 main 同一条路径后装配 API，
驳回老登记 → 加分撤回、纪录回退、旧数据逐表一行不差），另有真二进制冒烟。
未迁移的库上不存在任何新列读取。
## 文档
升级说明新增 dev_0.3.0（含「旧包仍可导入、自动补跑迁移」）；使用手册新增
§4.10 与 §6.1/§6.2 明细；常见问题新增 Q98/Q99/Q100；devdocs 04/05/07/13/02
同步（含新接口表与错误分级）。
自检：服务端 13 包 ×2 全绿（httpapi 新增 reopen/reject/records/旧包 四个用例文件）、
前端 vue-tsc + 604 例 ×2 + build、Console 19 文件 + 54 例。
This commit is contained in:
AskaEth committed
1 parent
6841cf49aa
commit
ed2c0b3f3c
35 files changed
+4003
-115
No files matched your search
+88
-11
@@ -53,12 +53,22 @@
|
||||
|
||||
## 3. 仪表盘
|
||||
|
||||
用于快速掌握全局：
|
||||
用于快速掌握全局。上方四张概览卡：领先单位、已发布项目数 / 总项目数、纪录条目数、实时连接状态。
|
||||
|
||||
- 领先单位、已发布项目数 / 总项目数、纪录条目数、实时连接状态；
|
||||
- 「当前赛程」列出小项及状态（已发布 / 待录入），点「录入」直接跳到该项目；
|
||||
下面一组是四张现场卡片——每个数据源各自独立，**任何一张读不到时只让那一张显示 `—`，不影响其它卡片**：
|
||||
|
||||
| 卡片 | 显示什么 |
|
||||
| --- | --- |
|
||||
| 今天的小项 | 排期（`scheduledAt`）落在**本机时区的当天**的小项数量与进度（`已发布 X / 共 Y`）。排期为空的小项不属于任何一天；项目列表还没加载完时显示「数据加载中…」，确实没有排期才显示「今天没有排期」 |
|
||||
| 草稿待发布 | 还没发布的成绩草稿条数（点了「存草稿」但还没「发布」的）；读不到时显示 `—`，不会用 0 冒充「一条都没有」 |
|
||||
| 待确认破纪录 | 状态为**待确认**的破纪录登记条数，点「去确认」跳到「破纪录」页；访客只读时显示「访客只读」 |
|
||||
| 大屏在线数 | `在线 / 总数`（读在线大屏实例列表）。副标题是**本机管理端的实时连接状态**（本机在线 / 连接中 / 未连接 / 连接中断 / 示例数据）——服务端没有「管理端在线数」这种统计，所以这里如实显示本机状态，不编一个数字出来 |
|
||||
|
||||
其余两块：
|
||||
|
||||
- 「当前赛程」列出小项及状态（已发布 / 待录入），今天的小项带「今天」标记，点「录入」直接跳到该项目；
|
||||
- 「实时积分 Top 3」显示前三名与奖牌数；
|
||||
- 有待录入项目时显示「待办」提醒。
|
||||
- 有待录入项目、草稿或待确认破纪录时显示「待办」提醒。
|
||||
|
||||
---
|
||||
|
||||
@@ -90,7 +100,7 @@
|
||||
|
||||
### 4.2 录入成绩
|
||||
|
||||
表格列依次为：号码、单位、运动员 / 队、成绩输入、名次、状态、积分（自动）、备注。**「运动员 / 队」这一列在姓名后面直接跟着该人的号码布**（灰色小字，例如 `张伟 101`）：号码列仍然保留，这一处只是省得在长表格里左右横跳找号。
|
||||
表格列依次为：勾选框、录入（状态徽标）、号码、批次、单位、运动员 / 队、成绩输入、名次、状态、积分（自动）、备注、操作。**「运动员 / 队」这一列在姓名后面直接跟着该人的号码布**（灰色小字，例如 `张伟 101`）：号码列仍然保留，这一处只是省得在长表格里左右横跳找号。
|
||||
|
||||
| 列 | 操作 |
|
||||
| --- | --- |
|
||||
@@ -99,6 +109,7 @@
|
||||
| 状态 | 下拉选择：**有效**、**DNS 弃赛**、**DQ 取消**、**DNF 未完赛**、**退赛** |
|
||||
| 积分（自动） | 随成绩实时计算，仅供参考 |
|
||||
| 备注 | 自由填写，示例文本是 `可留空` |
|
||||
| 操作 | 已发布的行显示 **「作废本条」**（已作废的行改显示 **「重新录入」**）；草稿行这里是 `—`（草稿本来就能直接改）。详见 4.10 |
|
||||
|
||||
**成绩写法**：能接受的写法比过去多，中文输入法下的全角冒号 `1：06`、全角数字也认。
|
||||
|
||||
@@ -168,7 +179,7 @@
|
||||
3. 确认框会写明：`本组还有 N 人没有成绩，本次将发布已填的 M 人；其余保持未发布，补录后再发布即可。本次影响 … 个单位，最大分差变化 … 分。发布后立即上屏并重算积分榜。`——**看完再确认**，系统只发布已填的那 M 人，不会把没成绩的人当成 0 分发出去（末句在延迟结算下会换成「名次与榜单等该组全部录完后再更新」，见下面）；
|
||||
4. 确认后这批成绩立即上屏；**实时结算（默认）下，名次与积分先按已发布的这部分算**，大屏立刻有内容（延迟结算下先不动，见下）；
|
||||
5. 下一批跑完，回到本页补录成绩，再点一次「发布本批」——系统会把两批放在一起重算名次与积分，先发的部分自动跟着更新；
|
||||
6. 全部发完后按钮不再显示「本批」（并变为不可用），此时该组视为已全部发布，要改就得走「撤销发布 → 修改 → 重新发布」（见 4.7）。
|
||||
6. 全部发完后按钮不再显示「本批」（并变为不可用），此时该组视为已全部发布。**只错一条**时不必撤销整组发布，用该行的「作废本条 → 重新录入」（见 4.10）；整组都要改才走「撤销发布 → 修改 → 重新发布」（见 4.7）。
|
||||
|
||||
> 只有「会被算错」的写法才会挡住发布（见 4.4）；空格子只是「还没录」，属于提醒，不影响发布。审核页（第 5 节）也是同一套口径：只有写错或缺名次才挡「发布整组」，空成绩只是本次跳过。
|
||||
|
||||
@@ -186,6 +197,8 @@
|
||||
2. 系统作废该组已产生的积分流水，大屏回退到发布前状态；
|
||||
3. 修改后重新发布即可。全程留痕，可在「变更历史」查看。
|
||||
|
||||
> **只错了一条成绩时**，不必撤销整组发布、把别人的成绩也一起翻下来——用该行「操作」列的「作废本条 / 重新录入」即可，见 4.10。
|
||||
|
||||
### 4.8 勾选与批量操作（退赛 / 恢复 / 移出报名）
|
||||
|
||||
表格每行最左边有勾选框，表头那个勾选框是**全选当前筛选范围内的行**——它只勾当前组别、当前批次筛选下看得见的行，被筛掉的行不会被选上。勾选后工具栏里出现「已选 N 行」与三个按钮：
|
||||
@@ -223,6 +236,34 @@
|
||||
- **权限**：读得到成绩的人都能看到这块卡片（访客只读，输入框置灰并写明原因）；**能保存的是录入员及以上**（与成绩录入同权限）。示例数据模式下不能保存；
|
||||
- 团体名次是**独立保存**的：点「保存团体名次」只提交这块卡片，不会顺手发布成绩；成绩仍然要另外「发布」。
|
||||
|
||||
### 4.10 单条作废 / 重新录入（手滑填错了怎么办）
|
||||
|
||||
已发布的成绩行在表格里仍然是**锁着的**（成绩、名次、状态、备注都改不了）——这是有意的：已发布的行已经上屏、已经计分，允许就地改会让「看到的榜单」和「改到一半的数据」对不上。要改就必须先明确地把它退回来。表格最后一列 **「操作」** 就是这件事的入口，只有已发布的行才有按钮。
|
||||
|
||||
**两个按钮，什么时候用哪个**
|
||||
|
||||
| 按钮 | 什么时候出现 | 做什么 |
|
||||
| --- | --- | --- |
|
||||
| **作废本条** | 这一行是**已发布且正常**的成绩 | 让这**一条**成绩退出名次与积分（同组其它人重新排名），但**不改**它的原始记录——需要改回来时还是用「重新录入」 |
|
||||
| **重新录入** | 这一行是**已作废**的（红徽标「已作废」） | 把这一条**退回草稿**（原来填的成绩还在格里，直接改就行）、不再计入名次与积分，之后就能像普通草稿一样编辑；改完再发布本组 |
|
||||
|
||||
两个按钮**都必须填写原因**（确认框里的「作废原因 / 退回原因」），留空时确认键点了也不会提交——原因会写进审计日志，事后能查清是谁、什么时候、为什么动的这一条。
|
||||
|
||||
**点完会立刻发生什么**
|
||||
|
||||
- 服务端在同一个事务里**按当前已发布成绩重算**该小项该组的名次与积分，并**立即推送大屏**；
|
||||
- 这一步**不受**「分批发布时实时更新榜单」这个延迟结算开关影响（它改的是「这条成绩算不算数」，不是「录了多少」），不会出现「榜上还有分、成绩却已经撤了」；
|
||||
- 两者都会留痕：**审计日志**（第 13 节）里的动作分别是 `result.void` 与 `result.reopen`，含操作人、时间与填写的原因。注意「变更历史」（第 12 节）记的是**发布 / 撤销发布**这类整组版本，单条作废 / 重新录入**不会**在那里新增一个版本节点。
|
||||
|
||||
**手滑填错了怎么办：两条路**
|
||||
|
||||
1. **只错了一条**（最常见）：在那一行点 **「作废本条」** 填原因 → 这一条退出名次与积分、大屏立刻更新 → 同一行点 **「重新录入」**（此时按钮已变成它）填原因 → 退回草稿，该行可以编辑了 → 改对成绩 → 再点页头的 **「发布」**（该组还有别的已发布成绩时显示为「发布本批」，见 4.6）。全程只动这一条，同组别人的成绩一直留在榜上；
|
||||
2. **整组都要改**（例如整组被判罚、名次口径整体调整）：点页面上的 **「撤销发布」** → 修改 → 重新发布（见 4.7）。这条会把该组已产生的积分流水整体作废再重发，大屏会先回退一次。
|
||||
|
||||
> 只错一条时**优先用第 1 条路**：撤销发布会让整组的分数先消失再回来，大屏在中间会闪一下；作废 / 重新录入只影响这一条。
|
||||
|
||||
> 需要先「存草稿」再点这两个按钮：作废 / 退回会重算并整表刷新，未保存的编辑会被刷新覆盖，页面会拦下并提示。
|
||||
|
||||
---
|
||||
|
||||
## 5. 成绩审核
|
||||
@@ -245,17 +286,52 @@
|
||||
|
||||
页面顶部会显示破纪录加分开关状态（来自规则包 `recordBonus.enabled`）。当前版本默认关闭；若当前角色读不到规则包，会如实显示「未知」，以服务端校验结果为准。
|
||||
|
||||
### 6.1 疑似破纪录
|
||||
### 6.1 疑似破纪录与「已批准的破纪录」
|
||||
|
||||
- 系统用**已发布且有效**的成绩与当前纪录自动比对，推导出疑似破纪录，草稿不参与；
|
||||
- 列表显示小项、组别、单位 / 运动员、成绩、原纪录、档位（赛会 / 市级 / 省级 / 全国）、预计加分；
|
||||
- **确认加分**：登记破纪录并生成加分流水、更新纪录库；开关关闭时按钮不可用；
|
||||
- **拒绝**：当前版本服务端没有拒绝接口，此操作只在本地隐藏该条，刷新后会重新出现。
|
||||
- **拒绝**：判定这条不是破纪录时点它。系统会**在服务端先登记一条破纪录记录、再立即驳回**（原因固定写「现场判定不是破纪录」），所以**刷新后不会再出现在待确认列表里**，谁在什么时候否掉了哪一条也能在日志里查到。示例数据模式或后端未就绪时只在本机隐藏，提示会如实说明「刷新页面后该条会重新出现」。
|
||||
|
||||
#### 已批准的破纪录（批错了可以撤回）
|
||||
|
||||
「已批准的破纪录」卡片列出所有**已批准**的登记。这条接口**需要录入员及以上**才能读（含待审核的登记与驳回理由）；访客只读时卡片会写明「访客只读：看不到破纪录登记」，不会假装成「一条都没有」。
|
||||
|
||||
每行显示小项、级别、成绩、加分、批准时间、说明，右端有：
|
||||
|
||||
- **作废**：批准时已经加过分，所以作废不只是改状态。点它会弹确认框，写明「作废后将撤回该笔加分，并恢复该级别的上一条纪录；大屏与此处纪录库会立即更新」，并要求填 **「作废原因」**（必填，留空点确认不会提交）。确认后服务端在同一个事务里**撤回该笔加分、重算并推榜、把该级别的当前纪录恢复为上一条**，完成后提示「加分已撤回，该级别纪录已恢复上一条」。
|
||||
- 如果该级别本来就没有更早的纪录，撤下后就留空——「无纪录」是事实，不会留一条刚被作废的纪录充数。
|
||||
|
||||
> 待确认的登记被驳回不涉及加分与纪录，服务端只改状态、记理由，不会白重算一次榜单。
|
||||
|
||||
### 6.2 纪录库
|
||||
|
||||
- 按小项分组展示，可用「全部 / 赛会 / 市级 / 省级 / 全国」页签筛选，也可搜索小项或保持者；
|
||||
- 每行显示档位、成绩、保持者、单位、达成时间、来源（本届 / 历史）以及是否为当前纪录。
|
||||
- 每行显示档位、成绩、保持者、单位、达成时间、**来源**以及是否为当前纪录（当前纪录带「当前」绿标）；
|
||||
- **「来源」列的含义**：
|
||||
- **历史** = 赛前手工登记的旧资料（用下面的「新增历史纪录」录进来的）；
|
||||
- **本届** = 本场赛事批准破纪录时系统自动写入的；
|
||||
- 读不到时显示 `—`（旧服务端不下发这个字段时不会冒充成「历史」）。
|
||||
|
||||
#### 新增历史纪录
|
||||
|
||||
点「纪录库」卡片头部的 **「新增历史纪录」**（**录入员及以上**；访客只读时按钮置灰并提示「访客只读，无法新增」）：
|
||||
|
||||
1. 选 **小项**（必选）；
|
||||
2. 选 **级别**：赛会 / 市级 / 省级 / 全国（默认「赛会」）；
|
||||
3. 填 **成绩值**（数字，例如 `11.2`）和 / 或 **成绩文本**（例如 `11.20`、`1:06.33`）——**两者至少填一个**，都填时比较与破纪录判断以成绩值为准；老秩序册上常常只有其中一种；
|
||||
4. 可选填 **保持人姓名**、**保持单位**（不指定就留空；很多历史纪录已经查不到人是谁，留空是正常的，不会逼你编一个名字）、**创造日期**（日期选择器，可留空）；
|
||||
5. 点 **「保存纪录」**；成功提示「已新增历史纪录 · 来源记为「历史」」。
|
||||
|
||||
新录入的这条会成为该小项该级别的**当前纪录**，原来那条自动变成非当前（但仍留在库里，来源与达成时间不变）。
|
||||
|
||||
#### 删除
|
||||
|
||||
每行右端有 **「删除」**（同样需要录入员及以上）：
|
||||
|
||||
1. 确认框会写明将删除哪一条（「将删除「小项」的「级别」纪录 X；若它是当前纪录，会恢复上一条。」），并注明「删除只影响纪录库，不会改动任何已发布的成绩与积分」；
|
||||
2. 点 **「确认删除」** 后：删掉这一条；如果删的正是当前纪录，服务端会把该级别的**上一条恢复为当前**；一条都没有就把该级别留空；
|
||||
3. 删除**不会**重算名次与积分——它只动纪录库本身。
|
||||
|
||||
---
|
||||
|
||||
@@ -711,7 +787,7 @@
|
||||
1. 顶部可筛选小项，以及「全部时间 / 近 24 小时 / 近 7 天」；
|
||||
2. 左侧时间轴最新在上，节点显示动作（发布 / 撤销发布 / 编辑）、项目、操作人、时间与备注；
|
||||
3. 点节点，右侧显示操作人、影响单位与成绩前后对比（diff）；
|
||||
4. 本页**不提供一键回滚**。纠错请到「成绩录入」走「撤销发布 → 修改 → 重新发布」。
|
||||
4. 本页**不提供一键回滚**。纠错请到「成绩录入」：只错一条走「作废本条 → 重新录入 → 修改 → 重新发布」（见 4.10），整组要改才走「撤销发布 → 修改 → 重新发布」（见 4.7）。
|
||||
|
||||
---
|
||||
|
||||
@@ -909,7 +985,8 @@
|
||||
草稿不会上屏。需要点「发布」（或 `Alt+Enter`），发布成功后立即更新。
|
||||
|
||||
**Q：发布后发现有错怎么办？**
|
||||
到「成绩录入」找到该组，点「撤销发布」→ 修改 → 重新发布。撤销会作废该组积分流水，大屏回退；全程可在「变更历史」追溯。
|
||||
只错一条成绩：到「成绩录入」找到那一行，点「作废本条」→ 再点「重新录入」→ 改 → 重新发布，只动这一条（见 4.10）。
|
||||
整组要改：点「撤销发布」→ 修改 → 重新发布。撤销会作废该组积分流水，大屏回退；全程可在「变更历史」追溯。
|
||||
|
||||
**Q：并列名次怎么显示？**
|
||||
成绩相同（或手动名次相同）即视为并列，显示同一名次，例如两个「3」。积分按规则包里的并列口径计算，默认是「顺延」：并列第 3 各得第 3 名的分，无第 4 名，下一名是第 5 名。奖牌也按并列处理，并列第 1 各记 1 金、无银牌。
|
||||
|
||||
+48
-1
@@ -6,7 +6,54 @@
|
||||
|
||||
---
|
||||
|
||||
## dev_0.2.0（当前版本）
|
||||
## dev_0.3.0（当前版本）
|
||||
|
||||
### 一句话
|
||||
|
||||
**旧版赛事项目包仍可导入**：本版只有一条迁移（**0021**），只给破纪录登记表加一列可空的「理由」。升级后榜单数字应当与升级前一致；新增四个现场入口（作废 / 重新录入成绩、作废已批准的破纪录、录入历史纪录、仪表盘四张新卡片）。
|
||||
|
||||
### ① 迁移只有一条（0021），而且只是「加一列」
|
||||
|
||||
- 迁移 **`0021_record_breaks_note.sql`**：给 `record_breaks` 表加一列 **`note`**（TEXT，**可空**，默认 NULL）——记「这条破纪录登记为什么被驳回 / 作废」。
|
||||
- 它**只加列**：不重建表、不改任何既有数据行；老登记的 `note` 保持 `NULL`（「本来就没有理由」是事实，不会被写成一条假理由）。
|
||||
- ✅ **旧版赛事项目包仍可导入**。导入一个不含 `note` 列的旧包后，它**成为当前赛事时（切换过去、服务端启动打开赛事库时）会自动补跑迁移**，**不需要任何手工处理**；旧的破纪录登记、纪录库、成绩与积分一行不丢。
|
||||
- 备份同理：升级前的备份文件（旧 `event.db`）照常能恢复，恢复后再打开时也会自动补迁移。
|
||||
|
||||
### ② 四个新入口
|
||||
|
||||
| 入口 | 位置 | 做什么 |
|
||||
| --- | --- | --- |
|
||||
| **作废本条 / 重新录入** | 成绩录入页每行的「操作」列 | 手滑填错了不必整组撤销发布：已发布的行仍然是锁的，但可以点「作废本条」（**必填原因**）让这一条退出名次与积分；已作废的行显示红徽标「已作废」，点「重新录入」（必填原因）退回草稿，改完再发布本组。两者都**立即重算并推大屏**，不受「分批发布时实时更新榜单」这个延迟结算开关影响 |
|
||||
| **已批准的破纪录 / 作废** | 破纪录页新增的「已批准的破纪录」卡片 | 批错的破纪录可以撤回：点「作废」（**必填原因**）→ 撤回该笔加分、重算推榜，并把该级别的当前纪录**恢复为上一条** |
|
||||
| **新增历史纪录 / 删除** | 破纪录页「纪录库」卡片 | 赛前手工登记历史纪录（小项 / 级别 / 成绩值或文本 / 保持人 / 保持单位 / 创造日期）；每行可「删除」，删的是当前纪录时会恢复上一条。**「来源」列现在真的会显示「历史」或「本届」**（以前没有历史录入入口，实际只会是「本届」） |
|
||||
| **仪表盘四张新卡片** | 仪表盘 | 今天的小项（按排期 + 进度）、草稿待发布、待确认破纪录、大屏在线数；旧卡片保留 |
|
||||
|
||||
### ③ 「拒绝」从内存改持久带来的行为变化
|
||||
|
||||
- 以前点「拒绝」只在**本机浏览器里**把这条疑似破纪录藏起来，刷新就回来。现在改成**先登记再驳回**：服务端会登记一条破纪录记录并立即驳回（理由写「现场判定不是破纪录」），**刷新后不再出现**；谁在什么时候否掉了哪一条，也能在审计日志里查到。
|
||||
- ⚠️ **升级前在本机「拒绝」过的疑似破纪录，升级后刷新会重新出现一次**——因为那次拒绝从来没有写到服务端。重新点一次「拒绝」即可（这次会落到服务端）。
|
||||
- 只有真的写不进去时（示例数据模式 / 未连接服务端）才退回本机隐藏，提示会如实说明「刷新页面后该条会重新出现」。
|
||||
|
||||
### ④ 升级后 5 分钟核对
|
||||
|
||||
1. 打开一次「成绩录入」页，确认表格最后一列是「操作」；
|
||||
2. 打开「破纪录」页，确认多出「已批准的破纪录」卡片，且「纪录库」卡片有「新增历史纪录」按钮与每行的「删除」；
|
||||
3. 打开仪表盘，确认多出今天的小项 / 草稿待发布 / 待确认破纪录 / 大屏在线数四张卡片；
|
||||
4. 旧赛事包核对：导入一个**升级前导出的赛事项目包**并切换为当前赛事，确认能正常打开、破纪录与纪录库数据都在（迁移 0021 会自动补跑）；
|
||||
5. 用《上线检查清单》过一遍。
|
||||
|
||||
### ⑤ 详细说明在哪
|
||||
|
||||
| 想了解 | 看 |
|
||||
| --- | --- |
|
||||
| 手滑填错一条成绩怎么改 | 《使用手册》4.10；《常见问题》Q98 |
|
||||
| 破纪录批错了 / 怎么拒绝 | 《使用手册》6.1；《常见问题》Q99 |
|
||||
| 历史纪录怎么录 | 《使用手册》6.2；《常见问题》Q100 |
|
||||
| 仪表盘四张卡片 | 《使用手册》第 3 节；开发侧 `devdocs/07` §7 |
|
||||
|
||||
---
|
||||
|
||||
## dev_0.2.0
|
||||
|
||||
### 一句话
|
||||
|
||||
|
||||
+52
-1
@@ -34,7 +34,7 @@
|
||||
草稿不上屏。需要「发布」（或 `Alt+Enter`），发布后 1 秒内大屏更新。
|
||||
|
||||
**Q8：发布错了怎么改？**
|
||||
撤销发布 → 修改 → 重新发布。撤销会作废该组积分流水，大屏回退到发布前状态，过程可在「变更历史」查看。
|
||||
撤销发布 → 修改 → 重新发布。撤销会作废该组积分流水，大屏回退到发布前状态，过程可在「变更历史」查看。**只错了一条成绩时不必撤销整组**，用那一行的「作废本条 → 重新录入」即可，见 Q98。
|
||||
|
||||
**Q9：为什么「发布」是灰的？**
|
||||
常见原因：未登录、服务端断开、示例数据模式，或存在**会阻止发布**的校验错误（秒位 ≥ 60、成绩写法无法识别、手动名次项目缺名次）。**没录成绩不算错误、不挡发布**（见 Q77）。成绩格的报错会把**那一格的实际内容**打出来并对症给改法（见 Q75、Q76）。
|
||||
@@ -101,6 +101,8 @@
|
||||
**Q19：破纪录加分为什么点不了？**
|
||||
规则包里破纪录加分默认关闭（`recordBonus.enabled = false`）时按钮不可用；若当前角色读不到规则包，页面显示「未知」，可提交，由服务端校验决定是否加分。
|
||||
|
||||
> 这个开关只管「**确认加分**」能不能点，不影响的：疑似破纪录照样列出，「**拒绝**」照样能用（它不会加分），以及 **已批准但批错了的登记可以「作废」**（会撤回加分并恢复上一条纪录，见 Q99）。
|
||||
|
||||
**Q20：人工调整为什么点不了？**
|
||||
规则包里人工调整默认关闭（`manualAdjustment.enabled = false`）时不可用；以页面顶部显示的开关状态为准。
|
||||
|
||||
@@ -628,3 +630,52 @@ Console 启动的多屏窗口默认每屏锁定一页。到「大屏控制」点
|
||||
- **什么现象**：在「变更历史」里展开某个历史版本时，页面会按**那一版保存下来的成绩**重新算一遍各单位分数。而**按单位录入的「团体名次」不在历史版本快照里**，所以回看时这些组别的团体分算不出来，各单位的分数增减可能与当时现场看到的略有差异；
|
||||
- **不影响什么**：**当前榜单、大屏、导出全部是对的**（它们读的是库里现存的团体名次，与历史快照无关）；只有「历史版本详情」里那一列**分数增减**（以及它影响的单位数）会因此偏小或对不上；
|
||||
- 想核对当时的真实分数，以**当时的导出件**（成绩总表 / 单位积分明细）为准。
|
||||
|
||||
**Q98：成绩填错了怎么改？**
|
||||
|
||||
先看是**只错一条**还是**整组都要改**——两条路的影响面完全不同：
|
||||
|
||||
**① 只错一条（最常见）**：到「成绩录入」找到那一行，用最右端「操作」列的按钮：
|
||||
|
||||
1. 点 **「作废本条」**，填 **「作废原因」**（必填，留空点了不提交）→ 确认。这一条立刻退出名次与积分，同组其它人重新排名，**大屏立即更新**；
|
||||
2. 同一行的按钮这时变成 **「重新录入」**，点它、填 **「退回原因」**（必填）→ 这一条退回草稿，变成可以编辑的行；
|
||||
3. 把成绩改对，再点页头的 **「发布」**（该组还有别的已发布成绩时显示为「发布本批」，见 Q77）。同组别人的成绩一直在榜上，不会被翻下来。
|
||||
|
||||
**② 整组都要改**（例如整组被判罚、名次口径整体调整）：点「撤销发布」→ 修改 → 重新发布（见 Q8）。它会把该组已产生的积分流水整体作废再重发，大屏先回退一次。
|
||||
|
||||
两个按钮的细节：
|
||||
|
||||
- **已发布的行是锁着的**（成绩 / 名次 / 状态 / 备注都改不了）——这是有意的：已发布就意味着已经上屏、已经计分，允许就地改会变成「榜单上是旧数、表格里是新数」；要改必须先明确地把它退回来，所以给了「作废本条 / 重新录入」这一对按钮，而不是直接解锁；
|
||||
- 作废与退回都**立即重算并推大屏**，**不受「分批发布时实时更新榜单」这个延迟结算开关影响**（它们改的是「这条成绩算不算数」，不是「录了多少」）；
|
||||
- 两者都会**留痕**：审计日志（见使用手册第 13 节）里的动作分别是 `result.void` 与 `result.reopen`，含操作人、时间与填写的原因。「变更历史」记的是**发布 / 撤销发布**这类整组版本，单条作废 / 退回不会在那里新增一个节点；
|
||||
- 有个前提：点之前先把未保存的编辑「存草稿」——作废 / 退回会重算并整表刷新，页面会拦下并提示。
|
||||
|
||||
**Q99：误批准了破纪录怎么办？**
|
||||
|
||||
到「破纪录」页，下面有 **「已批准的破纪录」** 卡片（需要**录入员及以上**才能看），找到那一条，点右端的 **「作废」**：
|
||||
|
||||
1. 确认框会写清后果并给一个 **「作废原因」** 输入框（必填）；
|
||||
2. 确认后服务端在同一件事里做完三样：**撤回该笔加分**、**重算并推榜**（榜单回退）、**把该级别的当前纪录恢复为上一条**；
|
||||
3. 完成提示「加分已撤回，该级别纪录已恢复上一条」。
|
||||
|
||||
注意两点：
|
||||
|
||||
- 如果**该级别本来就没有更早的纪录**，撤下后就留空——「无纪录」是事实，不会留一条刚被作废的纪录充数；
|
||||
- **撤回的是「加分」**：这条成绩本身的积分（名次分）不受影响，它当初是按正常成绩算的。
|
||||
|
||||
顺带纠正一个旧说法：点「拒绝」现在**不是**只在本机隐藏了——系统会在服务端**先登记一条破纪录记录、再立即驳回**（原因固定写「现场判定不是破纪录」），所以**刷新后不会再出现**，谁在什么时候否掉了哪一条也能在审计日志里查到。只有示例数据模式 / 服务端连不上时才退回本机隐藏，并会如实提示「刷新页面后该条会重新出现」。
|
||||
|
||||
> 升级提醒：**升级前在本机「拒绝」过的疑似破纪录，升级后刷新会重新出现一次**——那次拒绝没有写到服务端，重新点一次「拒绝」即可。
|
||||
|
||||
**Q100：历史纪录怎么录？**
|
||||
|
||||
到「破纪录」页的 **「纪录库」** 卡片，点卡片头部的 **「新增历史纪录」**：
|
||||
|
||||
1. 选 **小项**（必选）与 **级别**（赛会 / 市级 / 省级 / 全国，默认赛会）；
|
||||
2. 填 **成绩值**（数字）与 / 或 **成绩文本**（如 `11.20`、`1:06.33`）——**至少填一个**，都填时比较与破纪录判断以成绩值为准；
|
||||
3. 可选填 **保持人姓名**、**保持单位**、**创造日期**（都可以留空，老资料常常只有一部分，留空不会逼你编数据）；
|
||||
4. 点「保存纪录」，提示「已新增历史纪录 · 来源记为「历史」」。
|
||||
|
||||
新录的这条会成为该小项该级别的**当前纪录**，原来那条自动变成非当前（仍留在库里）。纪录库的 **「来源」列**因此有了两种值：**历史** = 赛前手工登记的旧资料，**本届** = 本场赛事批准破纪录时自动写入的（以前没有历史录入入口，实际只会看到「本届」）。
|
||||
|
||||
**删除**：每行右端有「删除」（需**录入员及以上**）。确认框会说明「若它是当前纪录，会恢复上一条」，并注明「删除只影响纪录库，不会改动任何已发布的成绩与积分」；删除不会触发重算。
|
||||
Reference in new issue
Block a user