fix: P0 计分根因 + 奖牌结算/奖牌通道 + 身份口径改回证件号 + 19 条 P1（dev_0.1.8）
## P0：双通道项目重复发布跳分（45→85→收敛） results.rank 一列同时充当「个人名次输出」「手工名次输入」「榜单数据源」， 团体手工通道把个人名次当团体名次又按团体表发一遍分。 - 新增 channel_ranks（每个计分通道各自持久化名次，发布时全量重建） 与 channel_manual_ranks（按单位录入的团体手工名次，故意不挂通道外键， 避免规则包重导时级联删掉录入数据） - results.rank 语义收窄为「只表示个人名次」，只由 scope=athlete 通道写回； 团体手工名次的来源改为 TeamRanks 优先、团体报名项兜底， 个人报名项的名次绝不进团体通道 - writeLedgerTx 内重建 channel_ranks；buildRanked / export.loadRanked / realtime.loadRanked 三份同源 SQL 一起改读新表 - 回归：发布两次流水与名次逐字节一致（domain + httpapi 各一条，含变异验证） ## 奖牌结算开关与奖牌通道（P1(5)，新功能） - events.award_medals + 通道 count_to_medals / count_to_team_medals （迁移默认 1，升级不改变既有榜单） - 单位榜入选 = 小项结算奖牌 && 通道发奖牌 && 前三名 &&（团体项目 || 个人奖牌并入单位） - 个人榜只取个人通道；金牌榜与积分榜同源同数据、按通道过滤独立计算 - 前端：小项「该项启用奖牌结算」、通道「发奖牌/个人奖牌并入单位金牌榜」、 录入页新增「团体名次」区块（含新接口 GET/PUT .../team-ranks） ## 身份口径改回证件号（P1(15)，推翻第三十六轮） - 匹配顺序恢复 证件号 → 号码布 → 姓名+单位；新增 athleteByIDCard - 同表重复证件号 = 同一人报多个组别（notices 提示，不报错）； 只有「同证件号 + 同小项同组别」才是真重复（conflicts[].duplicate） - 补齐后端缺失但前端/文档已在依赖的三处契约 ## 其余 P1 - 安全：会话撤销断开 ws、实时层按角色裁剪、整库快照限流（含 hello 路径， 被限流的请求挂起并由心跳兜底补发，不丢刷新） - 错误分级：手填名次非正数 / gender / 组别年龄 / 导出不存在的小项与单位 / 积分模板 awardRanks → 400 或 404，不再 500 - 算分一致性：破纪录加分看得失状态；批量退赛·恢复·移出、作废成绩、 报名导入改状态一律无条件重算推榜（不受延迟结算约束，与实时模式逐字节等价） - 配置改动触发重算：通道 / 小项参数 / 积分模板 - 升级自愈：channel_ranks 空而已有已发布成绩时，启动时一次性全量重算 （服务对外监听之前完成，避免升级后奖牌榜全 0） - 示例数据模式下破坏性操作被阻断，不再假成功 - Console：修复「只剩一块屏」后屏幕监听器被永久摘掉 - 大屏模板引擎：嵌套深度与体积安全阀，任何输入都不抛异常 ## 文档 - docs/：使用手册（奖牌开关、奖牌通道、团体名次、枚举列留空口径）、 常见问题（奖牌排查、升级后奖牌榜为 0、历史重放已知限制）、 部署指南、上线检查清单 - 版本 dev_0.1.7 → dev_0.1.8（console/package.json 同步） 自检：服务端 13 包 ×2 全绿；前端 vue-tsc + 449 例 ×2 + pnpm build； Console 35 例 + 语法检查。
This commit is contained in:
AskaEth committed
1 parent
53a0cb225c
commit
45edfbeb71
115 files changed
+10104
-755
No files matched your search
+1
-1
@@ -119,7 +119,7 @@ electron-builder 生成的卸载器结尾是 `RMDir /r $INSTDIR`，而**覆盖
|
||||
|
||||
| 场景 | 行为 |
|
||||
| --- | --- |
|
||||
| 只有一块屏 | 窗口化（屏幕 80% 大小、居中），不做多屏编排，**不挂** `display-metrics-changed` 等监听（行为冻结）；`F11` 手动切换全屏，窗口级全屏状态经 `display-preload.js` 下发给页面，页面据此收起自绘标题栏 |
|
||||
| 只有一块屏 | 窗口化（屏幕 80% 大小、居中），不做多屏编排，**不跟随** `display-metrics-changed`（分辨率/缩放变化不重排，行为冻结）；`display-added` / `display-removed` 一直听着，电视插回来会自动排布回 kiosk。监听常驻、只有 `closeAll()`（服务停止 / 应用退出）才摘（回归测试见 `main/displays.test.js`）；`F11` 手动切换全屏，窗口级全屏状态经 `display-preload.js` 下发给页面，页面据此收起自绘标题栏 |
|
||||
| 模式与 URL | **必须永远一致**：模式（窗口化 / kiosk）记在窗口的 entry 上，谁改模式谁按新模式重载 URL。`layout()` 只对排布自己开的窗口套用全局 `single`，管理面板手动开的窗口保持自己的模式——否则会出现「窗口化窗口被改成 kiosk 全屏、URL 里还留着 `windowed=1`」这种页面认知与窗口真实模式脱钩、标题栏画反的问题（回归测试见 `main/displays.test.js`）|
|
||||
| 多块屏 | 除内置屏外的每块屏一个 kiosk 窗口，按 `display.bounds`（DIP）定位，窗口 `setIgnoreMouseEvents(true)`，光标由页面 CSS 隐藏 |
|
||||
| 选屏 | 运行时枚举，不写死坐标；`selection` 可选 `all-secondary`（默认，用 `display.internal` 排除内置屏）/ `all` / `specified` |
|
||||
|
||||
+18
-10
@@ -21,7 +21,6 @@ class DisplayManager {
|
||||
|
||||
this.enabled = false
|
||||
this.single = true
|
||||
this.boundSingle = null
|
||||
// entry.single 记这个窗口是以哪种模式建的（true=窗口化，false=kiosk），
|
||||
// entry.manual 记它是管理面板手动开的（不跟随自动排布改模式）
|
||||
this.windows = new Map() // displayId -> { win, page, single, manual, reloadTimer }
|
||||
@@ -89,7 +88,7 @@ class DisplayManager {
|
||||
if (!this.enabled) return
|
||||
const { single, displays } = this.pickDisplays()
|
||||
this.single = single
|
||||
this.bindScreenListeners(single)
|
||||
this.bindScreenListeners()
|
||||
|
||||
const wanted = new Set(displays.map((item) => item.id))
|
||||
for (const [displayId, entry] of [...this.windows]) {
|
||||
@@ -268,12 +267,12 @@ class DisplayManager {
|
||||
return `http://${healthHost(this.server)}:${this.server.port}/display?${params.toString()}`
|
||||
}
|
||||
|
||||
// 单屏模式要「行为冻结」：不跟随屏幕变化重排，所以连监听都不挂
|
||||
bindScreenListeners(single) {
|
||||
if (this.screenListeners.length && this.boundSingle === single) return
|
||||
this.unbindScreenListeners()
|
||||
this.boundSingle = single
|
||||
if (single) return
|
||||
// 屏幕监听常驻，只有 closeAll()（服务停止 / 应用退出）才摘：
|
||||
// 单屏态的「行为冻结」只冻结分辨率与缩放，display-added / display-removed 必须一直听着。
|
||||
// 否则「只剩一块屏」那次排布会把监听整个摘掉，扩展屏插回来再没人重排——
|
||||
// 大屏永远停在窗口化小窗，电视黑屏，只能重启 Console（审查日志 P1(18)）。
|
||||
bindScreenListeners() {
|
||||
if (this.screenListeners.length) return
|
||||
|
||||
const schedule = () => {
|
||||
if (this.layoutTimer) clearTimeout(this.layoutTimer)
|
||||
@@ -284,11 +283,18 @@ class DisplayManager {
|
||||
}, 600)
|
||||
}
|
||||
|
||||
screen.on('display-metrics-changed', schedule)
|
||||
// 单屏窗口化是现场调试态，分辨率/缩放变化不跟着重排（保留原有的冻结语义）；
|
||||
// 屏幕数量变化不能冻结，那是「电视被拔/被插」的唯一信号
|
||||
const metricsChanged = () => {
|
||||
if (this.single) return
|
||||
schedule()
|
||||
}
|
||||
|
||||
screen.on('display-metrics-changed', metricsChanged)
|
||||
screen.on('display-added', schedule)
|
||||
screen.on('display-removed', schedule)
|
||||
this.screenListeners = [
|
||||
['display-metrics-changed', schedule],
|
||||
['display-metrics-changed', metricsChanged],
|
||||
['display-added', schedule],
|
||||
['display-removed', schedule]
|
||||
]
|
||||
@@ -344,6 +350,8 @@ class DisplayManager {
|
||||
// 手动开的窗口也计入 enabled：服务停止时 closeAll 才会把它一起收走。
|
||||
// manual=true：自动排布不许改它的模式，否则面板开的小窗会被下一次排布顶成 kiosk
|
||||
this.enabled = true
|
||||
// 面板开窗同样是「管理已激活」，监听一并挂上：否则在这个状态下拔插电视没人听见
|
||||
this.bindScreenListeners()
|
||||
const entry = this.createWindow(display, 0, !kiosk, wantedPage, true)
|
||||
this.windows.set(display.id, entry)
|
||||
return { created: true, mode: this.modeOf(entry) }
|
||||
|
||||
@@ -109,19 +109,26 @@ class FakeBrowserWindow extends EventEmitter {
|
||||
restore() {}
|
||||
}
|
||||
|
||||
const fakeScreen = {
|
||||
displays: [],
|
||||
primaryId: 1,
|
||||
// screen 桩要让「挂监听 / 摘监听」可观察，否则 P1(18) 那类
|
||||
// 「监听被永久摘掉」的回归测不出来
|
||||
class FakeScreen extends EventEmitter {
|
||||
constructor() {
|
||||
super()
|
||||
this.displays = []
|
||||
this.primaryId = 1
|
||||
}
|
||||
|
||||
getAllDisplays() {
|
||||
return this.displays
|
||||
},
|
||||
}
|
||||
|
||||
getPrimaryDisplay() {
|
||||
return this.displays.find((item) => item.id === this.primaryId) || this.displays[0]
|
||||
},
|
||||
on() {},
|
||||
removeListener() {}
|
||||
}
|
||||
}
|
||||
|
||||
const fakeScreen = new FakeScreen()
|
||||
|
||||
const electronStub = { BrowserWindow: FakeBrowserWindow, screen: fakeScreen }
|
||||
const originalLoad = Module._load
|
||||
Module._load = function (request, parent, isMain) {
|
||||
@@ -141,6 +148,8 @@ function fakeDisplay(id, { internal = false } = {}) {
|
||||
function makeManager(t, { selection = 'all', kiosk = true } = {}) {
|
||||
fakeScreen.displays = []
|
||||
fakeScreen.primaryId = 1
|
||||
// 上一个用例若忘了收摊，残留的监听会串到这一个用例里
|
||||
fakeScreen.removeAllListeners()
|
||||
created = []
|
||||
const log = { lines: [], push(_scope, text) { this.lines.push(text) } }
|
||||
const manager = new DisplayManager({
|
||||
@@ -333,3 +342,177 @@ test('kiosk 窗口不挂 F11 处理', (t) => {
|
||||
|
||||
assert.equal(manager.windows.get(2).win.webContents.listeners('before-input-event').length, 0)
|
||||
})
|
||||
|
||||
// 屏幕监听的三条不变式，对应审查日志模块13 [1] P1：
|
||||
// ① 任何一次「屏幕数量变化」都不能把监听永久摘掉（只有 closeAll 摘）
|
||||
// ② 事件到达后 600ms 防抖重排，从 1 块恢复 2 块要自动回到 kiosk，从 2 块变 1 块要收回窗口化
|
||||
// ③ 单屏态只冻结「分辨率/缩放」，不冻结「插拔」
|
||||
|
||||
const SCREEN_EVENTS = ['display-metrics-changed', 'display-added', 'display-removed']
|
||||
|
||||
function screenListenerCounts() {
|
||||
return SCREEN_EVENTS.map((event) => fakeScreen.listenerCount(event))
|
||||
}
|
||||
|
||||
// 触发屏幕事件并跑完防抖定时器
|
||||
function emitScreen(t, event, display) {
|
||||
fakeScreen.emit(event, {}, display)
|
||||
t.mock.timers.tick(600)
|
||||
}
|
||||
|
||||
test('回归 P1(18)：出现过一次「只剩一块屏」之后，插回扩展屏仍会自动重排成 kiosk', (t) => {
|
||||
t.mock.timers.enable({ apis: ['setTimeout'] })
|
||||
const manager = makeManager(t)
|
||||
const primary = fakeDisplay(1, { internal: true })
|
||||
const external = fakeDisplay(2)
|
||||
fakeScreen.displays = [primary, external]
|
||||
manager.enable()
|
||||
assertModeConsistent(manager, 2, false)
|
||||
|
||||
// 电视待机 / HDMI 松动：系统报 display-removed，整机退化成单屏
|
||||
fakeScreen.displays = [primary]
|
||||
emitScreen(t, 'display-removed', external)
|
||||
|
||||
assert.equal(manager.windows.has(2), false, '只剩一块屏时扩展屏窗口要收掉，不能留在已消失的坐标上')
|
||||
assertModeConsistent(manager, 1, true)
|
||||
assert.deepEqual(screenListenerCounts(), [1, 1, 1], '退化成单屏也不许摘监听：这是唯一能听见电视插回来的通道')
|
||||
|
||||
// 电视再开机：没有任何人工干预，必须自己排布回去
|
||||
fakeScreen.displays = [primary, external]
|
||||
emitScreen(t, 'display-added', external)
|
||||
|
||||
assertModeConsistent(manager, 1, false)
|
||||
assertModeConsistent(manager, 2, false)
|
||||
assert.deepEqual(screenListenerCounts(), [1, 1, 1], '重排之后监听仍然只挂一份')
|
||||
})
|
||||
|
||||
test('反复插拔：监听既不被摘掉也不叠加', (t) => {
|
||||
t.mock.timers.enable({ apis: ['setTimeout'] })
|
||||
const manager = makeManager(t)
|
||||
const primary = fakeDisplay(1, { internal: true })
|
||||
const external = fakeDisplay(2)
|
||||
fakeScreen.displays = [primary, external]
|
||||
manager.enable()
|
||||
|
||||
for (let i = 0; i < 3; i += 1) {
|
||||
fakeScreen.displays = [primary]
|
||||
emitScreen(t, 'display-removed', external)
|
||||
fakeScreen.displays = [primary, external]
|
||||
emitScreen(t, 'display-added', external)
|
||||
}
|
||||
|
||||
assert.deepEqual(screenListenerCounts(), [1, 1, 1])
|
||||
assertModeConsistent(manager, 1, false)
|
||||
assertModeConsistent(manager, 2, false)
|
||||
})
|
||||
|
||||
test('单屏态冻结分辨率/缩放变化，但不冻结屏幕数量变化', (t) => {
|
||||
t.mock.timers.enable({ apis: ['setTimeout'] })
|
||||
const manager = makeManager(t)
|
||||
const primary = fakeDisplay(1, { internal: true })
|
||||
fakeScreen.displays = [primary]
|
||||
manager.enable()
|
||||
|
||||
const entry = assertModeConsistent(manager, 1, true)
|
||||
const loadsBefore = entry.win.webContents.loadCount
|
||||
|
||||
// 单屏调试态下调分辨率/缩放：不跟着重排，现场调窗口时不会被打断
|
||||
const resized = { ...primary, bounds: { x: 0, y: 0, width: 1280, height: 720 } }
|
||||
emitScreen(t, 'display-metrics-changed', resized)
|
||||
assert.equal(entry.win.webContents.loadCount, loadsBefore, '单屏态下分辨率变化不应触发重排')
|
||||
assert.deepEqual(screenListenerCounts(), [1, 1, 1])
|
||||
|
||||
// 但插上第二块屏必须重排——冻结分辨率不等于冻结插拔
|
||||
fakeScreen.displays = [primary, fakeDisplay(2)]
|
||||
emitScreen(t, 'display-added', fakeDisplay(2))
|
||||
assertModeConsistent(manager, 1, false)
|
||||
assertModeConsistent(manager, 2, false)
|
||||
})
|
||||
|
||||
test('从 2 块变 1 块：主屏窗口收回窗口化，不卡在 kiosk 全屏', (t) => {
|
||||
t.mock.timers.enable({ apis: ['setTimeout'] })
|
||||
const manager = makeManager(t)
|
||||
const primary = fakeDisplay(1, { internal: true })
|
||||
const external = fakeDisplay(2)
|
||||
fakeScreen.displays = [primary, external]
|
||||
manager.enable()
|
||||
|
||||
const entry = assertModeConsistent(manager, 1, false)
|
||||
// 真实 Electron 里 kiosk 窗口 isFullScreen() 也是 true
|
||||
entry.win.fullScreen = true
|
||||
|
||||
fakeScreen.displays = [primary]
|
||||
emitScreen(t, 'display-removed', external)
|
||||
|
||||
const after = assertModeConsistent(manager, 1, true)
|
||||
assert.equal(after.win, entry.win, '同一块屏上的窗口就地改模式，不重建')
|
||||
assert.equal(after.win.isFullScreen(), false, '必须退出全屏，否则窗口化模式会卡在黑屏全屏里')
|
||||
assert.deepEqual(after.win.getBounds(), { x: 192, y: 108, width: WIDTH - 2 * 192, height: HEIGHT - 2 * 108 })
|
||||
})
|
||||
|
||||
test('只有 closeAll（服务停止 / 应用退出）才摘监听，重新启用后自动挂回', (t) => {
|
||||
t.mock.timers.enable({ apis: ['setTimeout'] })
|
||||
const manager = makeManager(t)
|
||||
const primary = fakeDisplay(1, { internal: true })
|
||||
fakeScreen.displays = [primary, fakeDisplay(2)]
|
||||
manager.enable()
|
||||
assert.deepEqual(screenListenerCounts(), [1, 1, 1])
|
||||
|
||||
// 服务停止：窗口全收、监听全摘（此时没有大屏要维护了）
|
||||
manager.closeAll()
|
||||
assert.deepEqual(screenListenerCounts(), [0, 0, 0])
|
||||
assert.equal(manager.windows.size, 0)
|
||||
|
||||
// 服务再起来：enable() 必须把监听挂回来，否则后续拔插又没人听
|
||||
fakeScreen.displays = [primary, fakeDisplay(2)]
|
||||
manager.enable()
|
||||
assert.deepEqual(screenListenerCounts(), [1, 1, 1])
|
||||
assertModeConsistent(manager, 2, false)
|
||||
|
||||
// 重复 enable() 不能叠加监听
|
||||
manager.enable()
|
||||
assert.deepEqual(screenListenerCounts(), [1, 1, 1])
|
||||
})
|
||||
|
||||
test('面板手动开窗同样挂上监听：之后拔插屏幕不会失联', (t) => {
|
||||
t.mock.timers.enable({ apis: ['setTimeout'] })
|
||||
const manager = makeManager(t)
|
||||
const primary = fakeDisplay(1, { internal: true })
|
||||
fakeScreen.displays = [primary]
|
||||
|
||||
manager.openOn(primary, { single: true })
|
||||
assert.deepEqual(screenListenerCounts(), [1, 1, 1], '手动开窗也是「管理已激活」，必须能听见屏幕变化')
|
||||
|
||||
// 服务端一直没起来的情况下插上电视，也要自动排布；
|
||||
// 手动开的那块屏保持自己的窗口化模式，新插进来的屏按 kiosk 开
|
||||
fakeScreen.displays = [primary, fakeDisplay(2)]
|
||||
emitScreen(t, 'display-added', fakeDisplay(2))
|
||||
assertModeConsistent(manager, 1, true)
|
||||
assertModeConsistent(manager, 2, false)
|
||||
})
|
||||
|
||||
test('电视回来后 kiosk 仍开在 display.selection=specified 指定的那块屏上', (t) => {
|
||||
t.mock.timers.enable({ apis: ['setTimeout'] })
|
||||
const manager = makeManager(t, { selection: 'specified' })
|
||||
manager.display.displays = [2]
|
||||
const primary = fakeDisplay(1, { internal: true })
|
||||
const external = fakeDisplay(2)
|
||||
fakeScreen.displays = [primary, external]
|
||||
manager.enable()
|
||||
|
||||
assertModeConsistent(manager, 2, false)
|
||||
assert.equal(manager.windows.has(1), false, 'specified 模式下只该在指定的那块屏上开窗')
|
||||
|
||||
// 电视待机：只剩主屏，先退化成窗口化
|
||||
fakeScreen.displays = [primary]
|
||||
emitScreen(t, 'display-removed', external)
|
||||
assert.equal(manager.windows.has(2), false)
|
||||
assertModeConsistent(manager, 1, true)
|
||||
|
||||
// 电视回来：必须重新只开在 display=2 上，而不是把主屏也铺成 kiosk
|
||||
fakeScreen.displays = [primary, external]
|
||||
emitScreen(t, 'display-added', external)
|
||||
assertModeConsistent(manager, 2, false)
|
||||
assert.equal(manager.windows.has(1), false)
|
||||
})
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "scoreboard-console",
|
||||
"productName": "Scoreboard Console",
|
||||
"version": "0.1.1",
|
||||
"version": "0.1.8",
|
||||
"private": true,
|
||||
"author": "AskaEth",
|
||||
"description": "赛事积分榜 · 桌面宿主：守护 Go 服务端并把大屏投到扩展屏",
|
||||
|
||||
Reference in new issue
Block a user