239 lines
10 KiB
Markdown
239 lines
10 KiB
Markdown
|
# 租户端数据统计分析看板 — 设计方案
|
|||
|
|
|
|||
|
|
> 所属端：租户端（机构管理端）
|
|||
|
|
> 状态：已实现
|
|||
|
|
> 创建日期：2026-03-31
|
|||
|
|
> 最后更新：2026-03-31
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 1. 需求背景
|
|||
|
|
|
|||
|
|
机构领导需要一个数据统计看板来了解：
|
|||
|
|
- 活动运营情况：活动办得怎么样，报名和参赛情况
|
|||
|
|
- 运营效率：审核速度、评审进度、整体运营时效
|
|||
|
|
- 评委工作量：每位评委评了多少作品、评分质量
|
|||
|
|
|
|||
|
|
## 2. 数据来源盘点
|
|||
|
|
|
|||
|
|
基于现有系统已实现的功能，可用的数据表和字段：
|
|||
|
|
|
|||
|
|
| 数据表 | 可用维度 | 可用指标 |
|
|||
|
|
|--------|----------|----------|
|
|||
|
|
| t_contest | 活动名称、类型、状态(ongoing/finished)、发布状态、各时间节点 | 活动数量、阶段分布 |
|
|||
|
|
| t_contest_registration | 活动ID、审核状态(pending/passed/rejected)、报名时间 | 报名数、通过率、时间分布 |
|
|||
|
|
| t_contest_work | 活动ID、状态(submitted/reviewing/accepted/awarded)、提交时间、最终得分、排名、奖项 | 作品数、评审状态分布、得分分布、获奖分布 |
|
|||
|
|
| t_contest_work_score | 作品ID、评委ID、分数、评分时间 | 评委评分量、评分时间分布 |
|
|||
|
|
| t_contest_work_judge_assignment | 作品ID、评委ID、状态 | 分配完成率 |
|
|||
|
|
| t_contest_judge | 活动ID、评委ID | 评委数量、评委-活动关联 |
|
|||
|
|
| t_contest_notice | 活动ID、发布时间 | 公告数量 |
|
|||
|
|
|
|||
|
|
## 3. 看板设计
|
|||
|
|
|
|||
|
|
### 3.1 整体结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
┌──────────────────────────────────────────────────────────────┐
|
|||
|
|
│ 数据统计 时间范围: [本月▾] [活动▾] │
|
|||
|
|
├──────────────────────────────────────────────────────────────┤
|
|||
|
|
│ │
|
|||
|
|
│ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ │
|
|||
|
|
│ │活动数│ │报名数│ │通过数│ │作品数│ │已评审│ │获奖数│ │
|
|||
|
|
│ └─────┘ └─────┘ └─────┘ └─────┘ └─────┘ └─────┘ │
|
|||
|
|
│ │
|
|||
|
|
│ ┌───── 报名转化漏斗 ─────┐ ┌────── 月度趋势 ──────────┐ │
|
|||
|
|
│ │ 报名 → 通过 → 提交 │ │ 📈 报名量/作品量折线图 │ │
|
|||
|
|
│ │ → 评审完成 → 获奖 │ │ │ │
|
|||
|
|
│ └────────────────────────┘ └──────────────────────────┘ │
|
|||
|
|
│ │
|
|||
|
|
│ ┌───── 活动对比 ─────────────────────────────────────────┐ │
|
|||
|
|
│ │ 表格：各活动 报名/通过率/作品提交率/评审完成率/获奖率 │ │
|
|||
|
|
│ └───────────────────────────────────────────────────────┘ │
|
|||
|
|
│ │
|
|||
|
|
│ ┌──── 评委工作量 ────────┐ ┌────── 奖项分布 ──────────┐ │
|
|||
|
|
│ │ 表格：评委 评审量/均分 │ │ 🥧 饼图：各奖项占比 │ │
|
|||
|
|
│ └────────────────────────┘ └──────────────────────────┘ │
|
|||
|
|
│ │
|
|||
|
|
│ ┌──── 评审效率 ──────────────────────────────────────────┐ │
|
|||
|
|
│ │ 平均评审周期 │ 日均评审量 │ 待评审积压 │ 评分标准差 │ │
|
|||
|
|
│ └───────────────────────────────────────────────────────┘ │
|
|||
|
|
└──────────────────────────────────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3.2 模块详细设计
|
|||
|
|
|
|||
|
|
#### 模块A：核心指标卡片（顶部）
|
|||
|
|
|
|||
|
|
6 个数字卡片，一行排列：
|
|||
|
|
|
|||
|
|
| 指标 | 数据来源 | 计算方式 |
|
|||
|
|
|------|----------|----------|
|
|||
|
|
| 活动总数 | t_contest | COUNT WHERE tenant 可见 |
|
|||
|
|
| 累计报名 | t_contest_registration | COUNT WHERE tenant_id |
|
|||
|
|
| 报名通过 | t_contest_registration | COUNT WHERE registration_state='passed' |
|
|||
|
|
| 作品总数 | t_contest_work | COUNT WHERE valid_state=1 |
|
|||
|
|
| 已完成评审 | t_contest_work | COUNT WHERE status IN ('accepted','awarded') |
|
|||
|
|
| 获奖作品 | t_contest_work | COUNT WHERE award_level IS NOT NULL AND award_level != 'none' |
|
|||
|
|
|
|||
|
|
#### 模块B：报名转化漏斗
|
|||
|
|
|
|||
|
|
展示从报名到获奖的转化路径和各环节转化率：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
报名人数 (12) → 通过审核 (10) → 提交作品 (8) → 评审完成 (5) → 获奖 (3)
|
|||
|
|
83.3% 80.0% 62.5% 60.0%
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
数据来源：
|
|||
|
|
- 报名人数：registration COUNT
|
|||
|
|
- 通过审核：registration COUNT WHERE state='passed'
|
|||
|
|
- 提交作品：work COUNT WHERE valid_state=1
|
|||
|
|
- 评审完成：work COUNT WHERE status IN ('accepted','awarded')
|
|||
|
|
- 获奖：work COUNT WHERE award_name IS NOT NULL
|
|||
|
|
|
|||
|
|
#### 模块C：月度趋势图
|
|||
|
|
|
|||
|
|
折线图，X轴为月份，Y轴双轴：
|
|||
|
|
- 左轴：报名数量（按 registration_time 月份分组）
|
|||
|
|
- 右轴：作品数量（按 submit_time 月份分组）
|
|||
|
|
|
|||
|
|
时间范围：最近6个月
|
|||
|
|
|
|||
|
|
数据来源：
|
|||
|
|
```sql
|
|||
|
|
-- 月度报名
|
|||
|
|
SELECT DATE_FORMAT(registration_time, '%Y-%m') as month, COUNT(*)
|
|||
|
|
FROM t_contest_registration WHERE tenant_id=?
|
|||
|
|
GROUP BY month ORDER BY month
|
|||
|
|
|
|||
|
|
-- 月度作品
|
|||
|
|
SELECT DATE_FORMAT(submit_time, '%Y-%m') as month, COUNT(*)
|
|||
|
|
FROM t_contest_work WHERE tenant_id=? AND valid_state=1
|
|||
|
|
GROUP BY month ORDER BY month
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 模块D：活动对比表
|
|||
|
|
|
|||
|
|
表格形式，每行一个活动：
|
|||
|
|
|
|||
|
|
| 列 | 数据来源 |
|
|||
|
|
|----|----------|
|
|||
|
|
| 活动名称 | t_contest.contest_name |
|
|||
|
|
| 报名数 | registration COUNT |
|
|||
|
|
| 通过率 | passed COUNT / total COUNT × 100% |
|
|||
|
|
| 作品提交率 | work COUNT / passed registration COUNT × 100% |
|
|||
|
|
| 评审完成率 | (accepted+awarded) COUNT / work COUNT × 100% |
|
|||
|
|
| 获奖率 | awarded COUNT / work COUNT × 100% |
|
|||
|
|
| 平均得分 | AVG(final_score) |
|
|||
|
|
|
|||
|
|
#### 模块E：评委工作量
|
|||
|
|
|
|||
|
|
表格形式，每行一个评委：
|
|||
|
|
|
|||
|
|
| 列 | 数据来源 |
|
|||
|
|
|----|----------|
|
|||
|
|
| 评委姓名 | users.nickname via t_contest_judge |
|
|||
|
|
| 关联活动数 | t_contest_judge COUNT DISTINCT contest_id |
|
|||
|
|
| 已分配作品数 | t_contest_work_judge_assignment COUNT |
|
|||
|
|
| 已评分作品数 | t_contest_work_score COUNT |
|
|||
|
|
| 评分完成率 | scored / assigned × 100% |
|
|||
|
|
| 平均打分 | AVG(total_score) |
|
|||
|
|
| 评分标准差 | STDDEV(total_score)（衡量评分一致性，越小越一致） |
|
|||
|
|
|
|||
|
|
#### 模块F：奖项分布
|
|||
|
|
|
|||
|
|
饼图/环形图，展示获奖作品中各奖项的占比：
|
|||
|
|
|
|||
|
|
数据来源：
|
|||
|
|
```sql
|
|||
|
|
SELECT award_name, COUNT(*)
|
|||
|
|
FROM t_contest_work
|
|||
|
|
WHERE tenant_id=? AND award_name IS NOT NULL AND valid_state=1
|
|||
|
|
GROUP BY award_name
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### 模块G：评审效率指标
|
|||
|
|
|
|||
|
|
4 个数字卡片：
|
|||
|
|
|
|||
|
|
| 指标 | 计算方式 |
|
|||
|
|
|------|----------|
|
|||
|
|
| 平均评审周期 | AVG(score_time - submit_time)，从作品提交到第一次评分的平均天数 |
|
|||
|
|
| 日均评审量 | 最近30天 score COUNT / 30 |
|
|||
|
|
| 待评审积压 | assignment COUNT WHERE status='assigned'（已分配未评分） |
|
|||
|
|
| 评分一致性 | 所有作品的评委间评分标准差的平均值（越小越好） |
|
|||
|
|
|
|||
|
|
### 3.3 筛选条件
|
|||
|
|
|
|||
|
|
顶部全局筛选栏：
|
|||
|
|
|
|||
|
|
| 筛选 | 类型 | 说明 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| 时间范围 | 下拉 | 本月/本季度/本年/全部/自定义时间段 |
|
|||
|
|
| 指定活动 | 下拉 | 全部活动 / 选择特定活动（切换后所有模块联动） |
|
|||
|
|
|
|||
|
|
### 3.4 交互设计
|
|||
|
|
|
|||
|
|
- 数字卡片可点击，跳转到对应管理页面（如点击「累计报名」跳到报名管理）
|
|||
|
|
- 活动对比表的活动名称可点击，切换筛选到该活动
|
|||
|
|
- 评委工作量表的评委名可点击查看评分明细
|
|||
|
|
- 所有图表支持 hover 显示详细数据
|
|||
|
|
- 支持将看板数据导出为 PDF/Excel
|
|||
|
|
|
|||
|
|
## 4. 菜单位置
|
|||
|
|
|
|||
|
|
新增一级菜单「数据统计」，放在「活动管理」之后：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
工作台
|
|||
|
|
活动管理
|
|||
|
|
├── ...
|
|||
|
|
数据统计（新增）
|
|||
|
|
├── 运营概览 — 核心卡片 + 漏斗 + 趋势 + 活动对比
|
|||
|
|
└── 评审分析 — 评委工作量 + 评审效率 + 奖项分布
|
|||
|
|
系统设置
|
|||
|
|
├── ...
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 5. 后端 API 设计
|
|||
|
|
|
|||
|
|
### 5.1 运营概览
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
GET /api/analytics/overview
|
|||
|
|
参数: timeRange(month/quarter/year/all), contestId?(可选)
|
|||
|
|
返回:
|
|||
|
|
{
|
|||
|
|
summary: { totalContests, totalRegistrations, passedRegistrations, totalWorks, reviewedWorks, awardedWorks },
|
|||
|
|
funnel: { registered, passed, submitted, reviewed, awarded },
|
|||
|
|
monthlyTrend: [{ month, registrations, works }],
|
|||
|
|
contestComparison: [{
|
|||
|
|
contestId, contestName,
|
|||
|
|
registrations, passRate, submitRate, reviewRate, awardRate, avgScore
|
|||
|
|
}]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 5.2 评审分析
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
GET /api/analytics/review
|
|||
|
|
参数: timeRange, contestId?
|
|||
|
|
返回:
|
|||
|
|
{
|
|||
|
|
efficiency: { avgReviewDays, dailyReviewCount, pendingAssignments, avgScoreStddev },
|
|||
|
|
judgeWorkload: [{
|
|||
|
|
judgeId, judgeName,
|
|||
|
|
contestCount, assignedCount, scoredCount, completionRate, avgScore, scoreStddev
|
|||
|
|
}],
|
|||
|
|
awardDistribution: [{ awardName, count, percentage }]
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 6. 技术方案
|
|||
|
|
|
|||
|
|
- 前端图表库：使用 ECharts 或 Ant Design Charts（@ant-design/charts）
|
|||
|
|
- 数据缓存：统计数据变化不频繁，后端可加 5 分钟缓存
|
|||
|
|
- 大数据量：月度趋势等聚合查询用 GROUP BY + 索引优化
|
|||
|
|
- 导出：前端生成 PDF（html2canvas + jsPDF）或 CSV
|