aurak/docs/assessment-screen-map.md

人才测评系统 — 画面地图

版本: 2026-06-17
覆盖: 所有测评相关画面、功能模块、API 端点、测试脚本

---

一、画面全景

┌────────────────────────────────────────────────────────────────┐
│                     AuraK 人才测评系统画面                       │
├────────────────────────────────────────────────────────────────┤
│                                                                │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────────┐ │
│  │  考核评估      │  │  评估统计     │  │  题库管理              │ │
│  │  /assessment  │  │  /stats      │  │  /question-banks      │ │
│  ├──────────────┤  ├──────────────┤  ├──────────────────────┤ │
│  │  答题交互画面  │  │  统计面板     │  │  题库列表              │ │
│  │  · MC选择     │  │  雷达图展示    │  │  题库详情/题目管理      │ │
│  │  · 简答输入   │  │  趋势图表     │  │  题目CRUD弹窗          │ │
│  │  · 追问流程   │  │  筛选区      │  │  AI生成弹窗             │ │
│  │  · 结果展示   │  │              │  │  审核流程               │ │
│  │  · 证书弹窗   │  │              │  │  创建题库抽屉            │ │
│  └──────────────┘  └──────────────┘  └──────────────────────┘ │
│                                                                │
│  ┌────────────────────────────────────────────────────────┐   │
│  │  系统设置 → 测评模板                                     │   │
│  │  /settings → Tab: assessment_templates                  │   │
│  ├────────────────────────────────────────────────────────┤   │
│  │  模板创建/编辑弹窗                                       │   │
│  │  维度配置（添加/删除/权重）                               │   │
│  │  基本设置（题数/时间/及格分/P2字段）                        │   │
│  └────────────────────────────────────────────────────────┘   │
│                                                                │
└────────────────────────────────────────────────────────────────┘

---

二、画面清单

2.1 考核评估 /assessment

画面	文件名	功能
考核首页	AssessmentView.tsx	选择模板 → 开始评估
答题交互	AssessmentView.tsx (renderAssessment)	选择题(选项按钮+确认)、简答题(textarea+发送)、追问流程
进度导航	AssessmentView.tsx	题序圆点(当前蓝/标记黄/其他灰) + 🏷️标记回头按钮
提交确认	AssessmentView.tsx (submitConfirm modal)	未答完时弹窗确认
结果展示	AssessmentView.tsx (renderCompletion)	等级、分数、每题详情、报告
证书弹窗	AssessmentView.tsx (cert modal)	等级、总分、维度得分、题目列表
历史侧栏	AssessmentView.tsx (右栏)	考评历史列表
答题回顾	AssessmentView.tsx (review button)	reviewMode开启时查看答案+解析

组件文件: web/components/views/AssessmentView.tsx
页面入口: web/src/pages/workspace/AssessmentPage.tsx
路由: Route path="assessment"
服务: web/services/assessmentService.ts

2.2 评估统计 /assessment-stats

画面	文件名	功能
统计面板	AssessmentStatsView.tsx	通过率、平均分、最高/最低分
雷达图	AssessmentStatsView.tsx	各维度平均分
趋势图	AssessmentStatsView.tsx	分数趋势
筛选区	AssessmentStatsView.tsx	时间/模板/组织筛选

组件文件: web/components/views/AssessmentStatsView.tsx
路由: Route path="assessment-stats"

2.3 题库管理 /question-banks

画面	文件名	功能
题库列表	QuestionBankView.tsx	题库卡片列表/搜索/筛选Tab(全部/已发布/草稿/待审核)
创建题库抽屉	QuestionBankView.tsx (drawer)	名称/描述/模板选择 → 创建提交
题库详情	QuestionBankDetailView.tsx	题库信息/状态/统计/题目列表
题目卡片	QuestionBankDetailView.tsx	题型/难度/维度/状态标签 + hover操作按钮
添加/编辑题目弹窗	QuestionBankDetailView.tsx	题干/类型/难度/维度/评分要点
AI生成弹窗	QuestionBankDetailView.tsx	生成数量设置 → AI出题
批量审核	QuestionBankDetailView.tsx	全选/单题通过驳回/批量通过驳回
提交审核	QuestionBankDetailView.tsx	题库状态 DRAFT→PENDING_REVIEW
发布	QuestionBankDetailView.tsx	PENDING_REVIEW→PUBLISHED

组件文件: web/components/views/QuestionBankView.tsx, web/components/views/QuestionBankDetailView.tsx
路由: Route path="question-banks", Route path="question-banks/:id"
服务: web/services/questionBankService.ts

2.4 设置 → 测评模板 /settings (Tab: assessment_templates)

画面	文件名	功能
模板列表	SettingsView.tsx + AssessmentTemplateManager.tsx	所有模板列表
创建/编辑模板弹窗	AssessmentTemplateManager.tsx	名称/描述/题数/时间/及格分
维度配置	AssessmentTemplateManager.tsx	添加/删除维度 + 权重
P2配置	AssessmentTemplateManager.tsx	attemptLimit/reviewMode/shuffleQuestions/预约时段

组件文件: web/components/views/AssessmentTemplateManager.tsx
路由: Route path="settings" (Tab: assessment_templates)
服务: web/services/templateService.ts

---

三、画面关系图

侧栏导航
  │
  ├── 考核评估 ─────── AssessmentView
  │                     ├── 答题交互 (MC/SA/追问)
  │                     ├── 结果展示 (+ 证书弹窗)
  │                     └── 历史侧栏
  │
  ├── 评估统计 ─────── AssessmentStatsView
  │                     ├── 统计面板
  │                     ├── 雷达图
  │                     └── 趋势图
  │
  ├── 题库管理 ─────── QuestionBankView ──→ QuestionBankDetailView
  │                     │                     ├── 题目列表 (CRUD)
  │                     │                     ├── AI生成弹窗
  │                     │                     └── 审核流程
  │                     └── 创建题库抽屉
  │
  └── 系统设置 ─────── SettingsView
                        └── 测评模板 Tab ── AssessmentTemplateManager
                                             ├── 模板列表
                                             └── 创建/编辑弹窗
                                                  └── 维度配置

---

四、后端 API 端点对照

前端画面	后端 API	Controller
考核进行	POST /assessment/start → GET /assessment/:id/state → POST /assessment/:id/answer	assessment.controller.ts
证书	GET /assessment/:id/certificate	assessment.controller.ts
回顾	GET /assessment/:id/review	assessment.controller.ts
历史	GET /assessment/history	assessment.controller.ts
统计	GET /assessment/stats	assessment.controller.ts
模板CRUD	POST/GET/PUT/DELETE /assessment/templates	template.controller.ts
题库CRUD	POST/GET/PUT/DELETE /question-banks	question-bank.controller.ts
题目CRUD	POST/GET/PUT/DELETE /question-banks/:bankId/items	question-bank.controller.ts
AI生成	POST /question-banks/:id/generate	question-bank.controller.ts
审核	POST /question-banks/:id/items/batch-review	question-bank.controller.ts

---

五、已存在测试脚本

测试文件	覆盖画面	项数	通过率
tests/assessment.e2e.spec.ts	考核评估 UI	8	100% ✅
tests/full-assessment.e2e.spec.ts	考核全流程(API+UI)	18	83% ✅(1 flaky)
tests/question-bank.e2e.spec.ts	题库管理全按钮	33	100% ✅
test-assessment-smoke.mjs	烟雾测试(全模块)	29	100% ✅
test-e2e-assessment-full-flow.mjs	端到端全流程	29	100% ✅
test-p2-advanced.mjs	P2高级功能	20	100% ✅
test-concurrent-assessments.mjs	并发考核	20人	✅
test-multiround.mjs	多轮对话	—	✅
test-question-distribution.mjs	出题分布	—	✅
exam-organizer.mjs	考试组织场景	—	✅

---

六、未测试画面

画面	组件	测试覆盖	风险
评估统计 /assessment-stats	AssessmentStatsView.tsx	❌ 无测试	🔴 统计面板/雷达图/趋势图
设置→测评模板 Tab	AssessmentTemplateManager.tsx	❌ 无单独测试	🟡 维度配置/P2字段/模板CRUD

待补充测试: AssessmentStatsView 和 AssessmentTemplateManager 两个画面还未覆盖。

---

七、技术栈

层	技术	文件行数
前端画面	React 19 + TypeScript + Tailwind CSS v4	~6,000 行
后端 API	NestJS 11 + TypeORM	~3,500 行
测试	Playwright 1.61.0	~3,800 行

前端组件总行数:

• AssessmentView.tsx — ~1,100 行 (最大)
• QuestionBankDetailView.tsx — ~530 行
• QuestionBankView.tsx — ~380 行
• SettingsView.tsx(测评部分) — ~200 行
• AssessmentStatsView.tsx — ~? (待读)
• AssessmentTemplateManager.tsx — ~540 行

---

下一步建议: 补充评估统计画面 + 测评模板配置画面 的 Playwright 全按钮测试。