168 lines
7.7 KiB
Markdown
168 lines
7.7 KiB
Markdown
# 评审进度模块优化 — 设计方案
|
||
|
||
> 所属端：超管端
|
||
> 状态：已实现（待验收）
|
||
> 创建日期：2026-03-27
|
||
> 最后更新：2026-03-27
|
||
|
||
---
|
||
|
||
## 1. 背景与问题
|
||
|
||
超管端"评审进度"菜单是两层结构，问题模式与报名数据、作品数据一致：第一层是活动列表精简版（冗余），第二层围绕管理操作设计（开始评审/结束评审/替换评委），不符合超管只读监管定位。
|
||
|
||
### 核心问题
|
||
|
||
| 问题 | 说明 |
|
||
|------|------|
|
||
| 第一层与全部活动列表重复 | 活动列表已有评审进度列（已评/总数），两个入口功能重叠 |
|
||
| 写操作未隔离 | "开始评审""结束评审""替换评委"均为机构管理端操作 |
|
||
| 评审状态筛选无效 | 第一层评审状态下拉选了不生效（前端计算但未传后端） |
|
||
| 缺少全局统计 | 没有全平台评审总进度概览 |
|
||
| 无跨活动维度 | 不能跨活动查看所有作品的评审状态 |
|
||
| ~~TODO~~ 部分已补 | 未提交作品列表仍为 TODO；**评委替换**已由 `POST /api/contests/reviews/replace-judge` 实现（分配 ID + 新评委用户 ID，未评分前可换） |
|
||
| 样式不一致 | 主色 `#1890ff` |
|
||
|
||
---
|
||
|
||
## 2. 现状分析
|
||
|
||
### 2.1 第一层：评审进度（reviews/Progress.vue）
|
||
|
||
- 个人参与/团队参与 Tab
|
||
- 数据来源：`contestsApi.getList()` 按活动类型过滤
|
||
- 搜索：活动名称 + 评审状态（无效）
|
||
- 表格列：序号/活动名称/主办机构/评审状态/已评审÷作品数/评审时间/操作
|
||
- 操作：查看详情 → 跳转 ProgressDetail
|
||
|
||
### 2.2 第二层：评审进度详情（reviews/ProgressDetail.vue）
|
||
|
||
- 数据来源：`worksApi.getList({ contestId })`
|
||
- 搜索：作品编号/报名账号/评审进度
|
||
- 表格列：序号/作品编号/报名账号/评委评分/评审进度/操作
|
||
- 操作按钮：开始评审、结束评审、未提交作品、导出
|
||
- 评审详情 Drawer：每个评委评分 + 替换评委
|
||
- 评委替换 Drawer：选择新评委
|
||
|
||
---
|
||
|
||
## 3. 设计方案
|
||
|
||
### 3.1 整体思路
|
||
|
||
与报名/作品模块一致：**超管端两层合一为扁平作品评审列表**，展示全平台所有作品的评审状态和评分情况。隐藏所有写操作，只保留查看能力。机构端保持不变。
|
||
|
||
### 3.2 页面结构
|
||
|
||
```
|
||
┌─ 标题卡片 ──────────────────────────────────────────────┐
|
||
│ 评审进度 │
|
||
└─────────────────────────────────────────────────────────┘
|
||
|
||
┌─ 统计卡片 ──────────────────────────────────────────────┐
|
||
│ [全部 120] [未评审 60] [评审中 40] [已完成 20] │
|
||
└─────────────────────────────────────────────────────────┘
|
||
|
||
┌─ 筛选栏 ────────────────────────────────────────────────┐
|
||
│ 所属活动:[下拉搜索] 作品/作者:[______] 评审进度:[下拉] │
|
||
│ [搜索] [重置] │
|
||
└─────────────────────────────────────────────────────────┘
|
||
|
||
┌─ 数据表格 ──────────────────────────────────────────────┐
|
||
│ 所属活动 | 作品编号 | 提交者 | 报名账号 | │
|
||
│ 评审进度 | 平均分 | 递交时间 | 操作 │
|
||
└─────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
### 3.3 统计卡片
|
||
|
||
4 张卡片，可点击筛选：
|
||
|
||
| 卡片 | 数据 | 颜色 | 说明 |
|
||
|------|------|------|------|
|
||
| 全部 | 作品总数 | 主色 | validState=1 且 isLatest=true |
|
||
| 未评审 | 无评分记录的作品 | 灰色 | assignments 为空或 scores 为空 |
|
||
| 评审中 | 部分评委已评的作品 | 橙色 | 有评分但未全部评完 |
|
||
| 已完成 | 所有评委评完的作品 | 绿色 | reviewedCount >= totalJudgesCount |
|
||
|
||
复用作品 stats 接口数据即可（submitted≈未评审，reviewing≈评审中，reviewed≈已完成）。
|
||
|
||
### 3.4 筛选栏
|
||
|
||
| 筛选项 | 组件 | 说明 |
|
||
|--------|------|------|
|
||
| 所属活动 | Select（远程搜索） | 按活动名称搜索下拉 |
|
||
| 作品/作者 | Input | 搜索作品编号、提交者姓名 |
|
||
| 评审进度 | Select | 未评审 / 评审中 / 已完成 |
|
||
|
||
### 3.5 表格列
|
||
|
||
| 列 | 宽度 | 渲染方式 |
|
||
|----|------|----------|
|
||
| 所属活动 | 180 | 活动名称，可点击跳转活动详情 |
|
||
| 作品编号 | 130 | workNo，可点击查看作品详情 |
|
||
| 提交者 | 130 | 昵称 / 队伍名 |
|
||
| 报名账号 | 120 | username |
|
||
| 评审进度 | 100 | Tag：未评审（灰）/ 评审中 x/y（橙）/ 已完成（绿） |
|
||
| 平均分 | 80 | averageScore，已完成时显示分数，否则"-" |
|
||
| 递交时间 | 150 | YYYY-MM-DD HH:mm |
|
||
| 操作 | 100 | 查看详情 |
|
||
|
||
### 3.6 详情 Drawer
|
||
|
||
点击"查看详情"打开 Drawer，展示该作品的评审明细：
|
||
|
||
```
|
||
作品信息
|
||
├── 所属活动 / 作品编号
|
||
├── 提交者 / 报名账号
|
||
├── 平均分 / 评审进度（x/y）
|
||
|
||
评委评分列表（表格）
|
||
├── 评委姓名 / 所属单位 / 评分 / 评分时间
|
||
```
|
||
|
||
不提供"替换评委"操作。
|
||
|
||
### 3.7 URL 参数支持
|
||
|
||
- `/super/contests/reviews/progress` — 全部作品评审进度
|
||
- `/super/contests/reviews/progress?contestId=3` — 从活动列表跳转，筛选某活动
|
||
|
||
---
|
||
|
||
## 4. 后端改动
|
||
|
||
- **评委替换**：`POST /api/contests/reviews/replace-judge`（权限 `review:assign`），请求体 `{ "assignmentId": long, "newJudgeId": long }`；该分配下若已有有效评分则不允许替换。
|
||
- 其余复用已有能力：
|
||
- 统计：复用 `GET /api/contests/works/stats`（已有 submitted/reviewing/reviewed）
|
||
- 列表：复用 `GET /api/contests/works`（已返回 reviewedCount/totalJudgesCount/averageScore/assignments）
|
||
- 评分详情：复用 `GET /api/contests/reviews/work/{workId}/scores`（已有）
|
||
|
||
### 4.1 评审进度前端过滤
|
||
|
||
"评审进度"筛选（未评审/评审中/已完成）基于返回数据的 `reviewedCount` 和 `totalJudgesCount` 在前端过滤，或后端 works 接口增加 `reviewProgress` 参数。
|
||
|
||
简化方案：前端直接利用作品 status 字段 + scores 数据判定，不改后端。
|
||
|
||
---
|
||
|
||
## 5. 前端改动
|
||
|
||
| 文件 | 操作 | 说明 |
|
||
|------|------|------|
|
||
| `frontend/src/views/contests/reviews/Progress.vue` | 修改 | 超管端改为扁平评审进度列表（统计卡片+筛选+表格+评分Drawer），机构端保持不变 |
|
||
|
||
后端无需改动，完全复用已有的 works 接口和 stats 接口。
|
||
|
||
---
|
||
|
||
## 6. 实施记录
|
||
|
||
### 2026-03-27 — 首次实现
|
||
|
||
**后端改动：无**（完全复用 works 接口和 reviews/scores 接口）
|
||
|
||
**前端改动（1 个文件）：**
|
||
- `frontend/src/views/contests/reviews/Progress.vue` — 完全重写：超管端为扁平评审进度列表（统计卡片复用 worksApi.getStats + 筛选栏 + 全平台作品表格含评审进度/平均分 + 评分详情 Drawer 含评委评分明细），机构端保持原有两层结构；评审进度筛选为前端过滤（基于 reviewedCount/totalJudgesCount）；支持 URL 参数联动（?contestId=xx）
|