feat: 大屏控制可看局域网设备并逐台切页 + 两种新导出(单页成绩 / 单位积分总明细)
## 大屏控制(用户:管理面板只能看到本机显示器,看不到局域网设备;也不能给某块屏单独切页) - 服务端:`POST /api/display/command` 新增可选 `targets []string` —— 空 = 广播(公告语义不变), 非空 = 只发给点名的实例并返回命中数;命中 0 个返回 404 +「目标大屏已离线,请刷新在线列表」 (不落审计、公告也不落库)。`DisplaySender` 签名随之扩展,新增 `Hub.SendCommandToInstances`(与按房间的 SendCommand 并存)。 - 服务端:WS `hello` 新增可选 `screen`,`realtime.Instance` 新增 `Screen`(不带 omitempty, 局域网浏览器恒为空串),这样管理端能把「本机显示器」与「在线实例」精确对上。 - 管理端「大屏控制」:写死的「在线看板」占位换成真实列表(5 秒轮询、页面隐藏停表), 列出实例 id / 在线离线 / 落后 / 屏号或「局域网浏览器」/ 当前页 / 来源 / 心跳; 每行可单独切页;本机显示器卡片补「当前页」与逐屏切页;离线时控件置灰并说明原因。 页面下拉改为共用大屏那份页名清单(管理端两处标签随之变为「个人积分奖牌榜」「分项成绩」)。 ## 导出(用户:保留多页工作簿的同时,再要一种全平铺单页;积分榜明细也要能导出) - 新增 `GET /api/export/all-flat.xlsx` → `赛事成绩总表(单页).xlsx`:一个工作簿一张表, 列 = 大项/小项/组别/名次/号码/单位/运动员-队/成绩/积分/状态/备注;前三列取 `EventSheet` 的结构化字段(不解析标题),后 8 列就是 `eventColumns` 本身(append 拼出, 两处不可能漂移)。**既有「全部」(all.xlsx,多 sheet)一字未动。** - 新增 `GET /api/export/teams.xlsx` → `单位积分总明细.xlsx`:一张带「单位」列的总表 + 每个有明细行的单位一张分表;**无明细行的单位不出分表**(空表没信息量,且会把假删除的 隐藏单位名字重新印进导出件);已隐藏但有流水的单位照常出表(它在榜单上)。 - 积分榜页:页头「导出总明细」、单位明细面板「导出该单位明细」;导出页新增「全部(单页)」。 测试:服务端 12 包全绿 / 347 个测试函数;前端 vue-tsc 通过、184 例全过;Console 18 文件。 docs/ 与 devdocs/ 同步(含新增 Q65–Q70 与两轮进度记录)。
This commit is contained in:
1 parent
793d2ac064
commit
782a38f82f
33 files changed
+2473
-119
No files matched your search
+39
-3
@@ -137,8 +137,8 @@ Console 启动的多屏窗口默认每屏锁定一页。到「大屏控制」点
|
||||
|
||||
以前右上角还有一个 `vN` 数据版本号角标,**现在已经去掉,任何情况下都不再显示**。要核对某块屏有没有跟上服务端,看管理端仪表盘「实时连接」里的「版本 N」。
|
||||
|
||||
**Q28:「在线看板」为什么显示未知?**
|
||||
页面上那一块是本地占位节点:系统不按「指令送达」推断大屏是否在线,也不展示每块屏的实际上报状态,所以「在线」列恒为未知,卡片上写着「在线状态未知(占位)」;「最近下发」只是本机下发指令的时间,**不代表大屏在线**。以现场大屏的实际画面为准。
|
||||
**Q28:大屏控制页的「在线大屏」列表显示的是什么?**
|
||||
显示的是**真实**的在线大屏实例,直接读服务端 `GET /api/display/instances`,打开页面时每 5 秒自动刷新一次:本机用 Console 打开的大屏窗口、局域网设备打开 `/display` 连上的浏览器都在里面(后者没有屏号,标记为「局域网浏览器」),每行显示实例 ID、在线 / 离线、当前所在页、来源地址与最后心跳,服务端判定落后时还会多一个「落后」徽标。以前这里确实是本机占位、恒显示「未知」,**那个占位现在已经被真实列表取代了**。离线实例会在服务端保留一段时间;列表读不到时页面提示「读取在线大屏失败」,并保留上一次的结果,不会清空。
|
||||
|
||||
**Q29:安卓电视能用吗?**
|
||||
可以,用电视自带浏览器访问 `http://<主机IP>:19540/display`。但它不受 Console 的 kiosk、防熄屏控制,字体与动画表现以实际设备为准。
|
||||
@@ -219,7 +219,7 @@ Console 启动的多屏窗口默认每屏锁定一页。到「大屏控制」点
|
||||
## 导出与导入
|
||||
|
||||
**Q43:能导出哪些文件?**
|
||||
四类 Excel:总表、全部(多 sheet)、分项成绩表、单位积分明细;另外可导出赛事项目包(zip)与规则包(YAML)。
|
||||
结果导出现在有五类 Excel:**总表**(`总积分榜.xlsx`)、**全部**(`赛事成绩总表.xlsx`,多 sheet)、**全部(单页)**(`赛事成绩总表(单页).xlsx`,单张表平铺)、**分项成绩表**(`分项成绩表.xlsx`)、**单位积分明细**(`单位积分明细.xlsx`);「积分榜」页另有**导出总明细**(`单位积分总明细.xlsx`)与**导出该单位明细**(`单位积分明细.xlsx`)。另外可导出赛事项目包(zip)与规则包(YAML)。
|
||||
|
||||
**Q44:导出文件保存在哪?**
|
||||
浏览器默认下载目录。服务端生成的临时包位于 `data\exports\`,下载完成后自动删除。
|
||||
@@ -361,3 +361,39 @@ Console 启动的多屏窗口默认每屏锁定一页。到「大屏控制」点
|
||||
- 编辑这些运动员时,「所属单位」下拉里没有这个单位,**必须改选另一个单位才能保存**。
|
||||
|
||||
所以更稳妥的做法是:先把名下运动员调到别的单位(或者干脆用「停用」代替「彻底删除」),再决定要不要彻底删除这个单位。
|
||||
|
||||
**Q65:大屏控制页为什么看不到局域网那台电视?**
|
||||
先确认那台设备真的打开了 `http://<主机IP>:19540/display` 并且能连上主机(同一局域网、服务端端口 19540 已放行)。连上后它会出现在「大屏控制 → 在线大屏」列表里——这个列表每 5 秒自动刷新一次,刚打开时等几秒即可。另外注意:
|
||||
|
||||
- 列表里在线实例排在前,离线实例也会保留一段时间(挂在后面),别只看第一屏就以为没有;
|
||||
- 页面提示「读取在线大屏失败」时是列表没读出来,按提示刷新或检查登录状态(该接口需要记录员及以上),不是那台设备没连上;
|
||||
- 本机「显示器」卡片只列**本机接的显示器**,局域网设备没有屏号,不会出现在那张卡片里,只会在「在线大屏」列表里显示为「局域网浏览器」。
|
||||
|
||||
**Q66:怎么给某一块屏单独切页?**
|
||||
在「大屏控制 → 在线大屏」列表里找到那一行,用「当前页」旁的下拉选好页名,点「切到此页」——**只切这一台**,其他屏不受影响。本机显示器也可以直接在「显示器」卡片对应那一行的下拉 + 「切到此页」切。要让**所有大屏一起切**,才用上方「切页」卡片选页后点「立即跳转」。离线实例的下拉和按钮是灰的,切不了。
|
||||
|
||||
**Q67:切页时提示「目标大屏已离线」怎么办?**
|
||||
这条提示只在**点名切页、但一块屏都没收到指令**时出现,说明目标实例已经离线或实例 ID 失效。处理办法:
|
||||
|
||||
1. 在「在线大屏」列表里看那一行的状态与「最后心跳」,确认大屏窗口 / 浏览器还开着、网络正常;
|
||||
2. 等它重连(列表每 5 秒一刷,重连后会变回「在线」)再切;
|
||||
3. 列表里根本没有它时,说明大屏没连上服务端,先解决连接再切页。
|
||||
|
||||
离线实例切不动是正常的:指令发不到它,系统不会谎报「已切换」。
|
||||
|
||||
**Q68:导出里「全部」和「全部(单页)」有什么区别?**
|
||||
两者内容同源,覆盖的都是全部小项的全部报名 / 成绩,区别在排版:
|
||||
|
||||
- **全部**(`赛事成绩总表.xlsx`):一个工作簿里每个小项一张分表(多 sheet),适合归档打印;
|
||||
- **全部(单页)**(`赛事成绩总表(单页).xlsx`):一个工作簿**只有一张表**,把所有单位、所有项目、所有成绩平铺在一起;每行前面带「大项 / 小项 / 组别」三列,脱离分表也能看懂。列是:大项、小项、组别、名次、号码、单位、运动员/队、成绩、积分、状态、备注。适合筛选、排序与二次统计。
|
||||
|
||||
**Q69:怎么把一个单位的积分明细导出成表格?**
|
||||
两种方式:
|
||||
|
||||
1. **只导一个单位**:到「积分榜」页展开该单位的明细,点右侧明细面板头部的「导出该单位明细」,得到 `单位积分明细.xlsx`(逐条列出每一分的来源,末行是「合计」);
|
||||
2. **一次导全部单位**:点「积分榜」页右上角的「导出总明细」,得到 `单位积分总明细.xlsx`——一张带「单位」列的总表,外加每个**有数据**的单位一张分表(没有积分的单位不出分表)。
|
||||
|
||||
团体奖牌榜那一列的「明细」展开的是**同一个单位积分明细面板**,所以也用「导出该单位明细」。另外「导出 → 结果导出」里的「单位积分明细」也能先选一个单位再导出。这些导出都是只读下载,访客也能用。
|
||||
|
||||
**Q70:个人积分榜能导出明细吗?**
|
||||
不能。个人积分榜只有榜单(运动员、单位、个人总分与奖牌数),**没有明细列,也没有对应的明细导出**。需要看某个人 / 某个单位的得分来源时,用「导出总明细」或「导出该单位明细」:记到个人的流水会按折算系数并入所属单位的合计列出(见 Q14、Q18)。
|
||||
Reference in new issue
Block a user