feat: 增加刷题页面

This commit is contained in:
liyy 2026-09-01 16:24:08 +08:00
parent 9ef7af0dd1
commit 09b0045d3f
19 changed files with 3061 additions and 54 deletions

View File

@ -32,6 +32,11 @@ export type DashboardTrends = SuccessBody<paths['/api/dashboard/trends']['get']>
export type DashboardMastery = SuccessBody<paths['/api/dashboard/mastery']['get']>
export type DashboardWeakPoints = SuccessBody<paths['/api/dashboard/weak-points']['get']>
export type PracticeModules = SuccessBody<paths['/api/practice/modules']['get']>
export type PracticeSessionStart = SuccessBody<paths['/api/practice/start']['post']>
export type PracticeQuestion = SuccessBody<paths['/api/practice/{sessionId}/question']['get']>
export type PracticeAnswer = SuccessBody<paths['/api/practice/{sessionId}/answer']['post']>
export type PracticeFinish = SuccessBody<paths['/api/practice/{sessionId}/finish']['post']>
export type PracticeWrongReasons = SuccessBody<paths['/api/practice/wrong-reasons']['get']>
export type Profile = SuccessBody<paths['/api/profile']['get']>
export type Settings = SuccessBody<paths['/api/settings']['get']>
export type PlansToday = SuccessBody<paths['/api/plans/today']['get']>
@ -70,24 +75,33 @@ export const practiceApi = {
})
),
finish: (sessionId: string) =>
unwrap(apiClient.POST('/api/practice/{sessionId}/finish', { params: { path: { sessionId } } }))
unwrap(apiClient.POST('/api/practice/{sessionId}/finish', { params: { path: { sessionId } } })),
wrongReasons: () => unwrap(apiClient.GET('/api/practice/wrong-reasons'))
}
// ---- 错题复习 ----
export const reviewApi = {
list: (query?: QueryOf<'/api/review/list', 'get'>) =>
unwrap(apiClient.GET('/api/review/list', { params: { query } })),
submit: (id: string, answer: string) =>
detail: (id: string) =>
unwrap(apiClient.GET('/api/review/{id}/detail', { params: { path: { id } } })),
submit: (id: string, body: BodyOf<'/api/review/{id}/submit', 'post'>) =>
unwrap(apiClient.POST('/api/review/{id}/submit', { params: { path: { id } }, body })),
selfAssess: (id: string, body: BodyOf<'/api/review/{id}/self-assess', 'post'>) =>
unwrap(
apiClient.POST('/api/review/{id}/submit', {
apiClient.POST('/api/review/{id}/self-assess', {
params: { path: { id } },
body: { answer } as BodyOf<'/api/review/{id}/submit', 'post'>
body
})
),
markMastered: (id: string) =>
unwrap(apiClient.POST('/api/review/{id}/mark-mastered', { params: { path: { id } } }))
}
export type ReviewListItem = SuccessBody<paths['/api/review/list']['get']>['items'][number]
export type ReviewDetail = SuccessBody<paths['/api/review/{id}/detail']['get']>
export type ReviewSubmitResult = SuccessBody<paths['/api/review/{id}/submit']['post']>
// ---- 备考计划 ----
export const plansApi = {
today: (date?: string) => unwrap(apiClient.GET('/api/plans/today', { params: { query: { date } } })),

View File

@ -10,19 +10,21 @@ withDefaults(
type?: 'button' | 'submit'
disabled?: boolean
block?: boolean
loading?: boolean
}>(),
{ variant: 'primary', size: 'md', type: 'button', disabled: false, block: false }
{ variant: 'primary', size: 'md', type: 'button', disabled: false, block: false, loading: false }
)
</script>
<template>
<button
:type="type"
:disabled="disabled"
:disabled="disabled || loading"
class="btn"
:class="[`btn--${variant}`, `btn--${size}`, { 'btn--block': block }]"
>
<AppIcon v-if="icon" :name="icon" :size="size === 'lg' ? 18 : 16" />
<span v-if="loading" class="btn__spinner" />
<AppIcon v-else-if="icon" :name="icon" :size="size === 'lg' ? 18 : 16" />
<span class="btn__label"><slot /></span>
</button>
</template>
@ -93,4 +95,18 @@ withDefaults(
opacity: 0.5;
cursor: not-allowed;
}
.btn__spinner {
width: 14px;
height: 14px;
flex: none;
border-radius: 50%;
border: 2px solid rgba(255, 255, 255, 0.45);
border-top-color: currentColor;
animation: app-btn-spin 0.7s linear infinite;
}
@keyframes app-btn-spin {
to {
transform: rotate(360deg);
}
}
</style>

View File

@ -19,6 +19,11 @@ export type IconName =
| 'clock'
| 'flame'
| 'target'
| 'plus'
| 'sparkles'
| 'refresh'
| 'book-open'
| 'filter'
interface IconNode {
tag: 'path' | 'circle' | 'rect' | 'line' | 'polyline'
@ -113,5 +118,23 @@ export const icons: Record<IconName, IconNode[]> = {
{ tag: 'circle', attrs: { cx: 12, cy: 12, r: 10 } },
{ tag: 'circle', attrs: { cx: 12, cy: 12, r: 6 } },
{ tag: 'circle', attrs: { cx: 12, cy: 12, r: 2 } }
],
plus: [{ tag: 'path', attrs: { d: 'M12 5v14' } }, { tag: 'path', attrs: { d: 'M5 12h14' } }],
sparkles: [
{ tag: 'path', attrs: { d: 'M12 3l1.9 4.9L18.8 9.8l-4.9 1.9L12 16.6l-1.9-4.9L5.2 9.8l4.9-1.9Z' } },
{ tag: 'path', attrs: { d: 'M19 15l.8 2.2L22 18l-2.2.8L19 21l-.8-2.2L16 18l2.2-.8Z' } }
],
refresh: [
{ tag: 'path', attrs: { d: 'M3 12a9 9 0 0 1 15.5-6.4L21 8' } },
{ tag: 'path', attrs: { d: 'M21 3v5h-5' } },
{ tag: 'path', attrs: { d: 'M21 12a9 9 0 0 1-15.5 6.4L3 16' } },
{ tag: 'path', attrs: { d: 'M3 21v-5h5' } }
],
'book-open': [
{ tag: 'path', attrs: { d: 'M2 3h6a4 4 0 0 1 4 4v14a3 3 0 0 0-3-3H2z' } },
{ tag: 'path', attrs: { d: 'M22 3h-6a4 4 0 0 0-4 4v14a3 3 0 0 1 3-3h7z' } }
],
filter: [
{ tag: 'path', attrs: { d: 'M22 3H2l8 9.46V19l4 2v-8.54z' } }
]
}

View File

@ -8,11 +8,13 @@ const route = useRoute()
const title = computed(() => String(route.meta.title ?? '备考通'))
// 首页以自己的问候语作为页头,不再重复显示顶部栏标题
const isHome = computed(() => route.path === '/')
// 刷题相关页面自带页头(AppPageHeader),隐藏顶栏标题避免重复
const hideTopbar = computed(() => isHome.value || route.path.startsWith('/practice'))
</script>
<template>
<div class="layout-mobile">
<header v-if="!isHome" class="topbar">
<header v-if="!hideTopbar" class="topbar">
<h1>{{ title }}</h1>
</header>
<main class="content"><slot /></main>

View File

@ -2,6 +2,9 @@ import { createRouter, createWebHistory } from 'vue-router'
import type { RouteRecordRaw } from 'vue-router'
import DashboardView from '../views/dashboard/DashboardView.vue'
import PracticeView from '../views/practice/PracticeView.vue'
import AnswerView from '../views/practice/AnswerView.vue'
import CustomView from '../views/practice/CustomView.vue'
import WrongDetailView from '../views/practice/WrongDetailView.vue'
import MockView from '../views/mock/MockView.vue'
import PlanView from '../views/plan/PlanView.vue'
import PlanReviewView from '../views/plan/PlanReviewView.vue'
@ -14,7 +17,10 @@ import SettingsView from '../views/settings/SettingsView.vue'
export const routes: RouteRecordRaw[] = [
{ path: '/', name: 'dashboard', component: DashboardView, meta: { title: '数据中枢' } },
{ path: '/practice', name: 'practice', component: PracticeView, meta: { title: '刷题中心' } },
{ path: '/practice/session/:id', name: 'practice-session', component: AnswerView, meta: { title: '刷题作答' } },
{ path: '/practice/custom', name: 'practice-custom', component: CustomView, meta: { title: '自定义组卷' } },
{ path: '/practice/wrong', name: 'practice-wrong', component: PracticeView, meta: { title: '错题本' } },
{ path: '/practice/wrong/:id', name: 'practice-wrong-detail', component: WrongDetailView, meta: { title: '错题详情' } },
{ path: '/practice/essay', name: 'practice-essay', component: PracticeView, meta: { title: '申论' } },
{ path: '/mock', name: 'mock', component: MockView, meta: { title: '模考分析' } },
{ path: '/plan', name: 'plan', component: PlanView, meta: { title: '备考计划' } },

View File

@ -0,0 +1,659 @@
<script setup lang="ts">
import { computed, onMounted, onUnmounted, ref } from 'vue'
import { useRoute, useRouter } from 'vue-router'
import { practiceApi, type PracticeFinish } from '../../api'
import { useResponsive } from '../../composables/useResponsive'
import AppCard from '../../components/base/AppCard.vue'
import AppButton from '../../components/base/AppButton.vue'
import AppBadge from '../../components/base/AppBadge.vue'
import AppIcon from '../../components/base/AppIcon.vue'
import AppLoading from '../../components/feedback/AppLoading.vue'
import AppError from '../../components/feedback/AppError.vue'
import { formatDuration } from '../../utils/format'
const route = useRoute()
const router = useRouter()
const isMobile = useResponsive()
const sessionId = route.params.id as string
const total = ref(0)
const currentIndex = ref(0)
const durationMinutes = ref(0)
const loading = ref(true)
const error = ref('')
const question = ref<{
id: string
module: string
subModule: string
difficulty: string
stem: string
options: { key: string; text: string }[]
} | null>(null)
const selected = ref('')
const submitting = ref(false)
// 单题结果态
const answered = ref(false)
const result = ref<{ correct: boolean; correctAnswer: string; analysis: string } | null>(null)
const wrongReasons = ref<string[]>([])
const WRONG_REASON_OPTIONS = ['审题失误', '计算失误', '公式遗忘', '思路偏差', '知识点遗忘'] as const
// 整卷结果态
const finished = ref(false)
const finishResult = ref<PracticeFinish | null>(null)
// 计时
const elapsed = ref(0)
const questionStartElapsed = ref(0)
let timer: ReturnType<typeof setInterval> | null = null
onMounted(() => {
timer = setInterval(() => (elapsed.value += 1), 1000)
void loadQuestion()
})
onUnmounted(() => {
if (timer) clearInterval(timer)
})
async function loadQuestion() {
loading.value = true
error.value = ''
answered.value = false
selected.value = ''
result.value = null
wrongReasons.value = []
try {
const res = await practiceApi.question(sessionId)
if (res.question === null) {
await finishSession()
return
}
question.value = res.question as typeof question.value
currentIndex.value = res.index
total.value = res.total
durationMinutes.value = res.durationMinutes
questionStartElapsed.value = elapsed.value
} catch (err) {
error.value = err instanceof Error ? err.message : '题目加载失败'
} finally {
loading.value = false
}
}
function choose(key: string) {
if (answered.value) return
selected.value = key
}
const canSubmit = computed(() => selected.value !== '' && !submitting.value)
const progressPct = computed(() => (total.value === 0 ? 0 : Math.min(100, Math.round(((currentIndex.value + 1) / total.value) * 100))))
const remainingText = computed(() => `第 ${currentIndex.value + 1} 题 / 共 ${total.value} 题`)
async function submitAnswer() {
if (!selected.value || submitting.value || !question.value) return
submitting.value = true
try {
const res = await practiceApi.answer(sessionId, {
questionId: question.value!.id,
answer: selected.value as 'A' | 'B' | 'C' | 'D',
secondsUsed: Math.max(0, elapsed.value - questionStartElapsed.value)
})
if (res.duplicate) {
// 已作答过:直接跳到本卷结果
await finishSession()
return
}
answered.value = true
result.value = {
correct: res.correct ?? false,
correctAnswer: res.correctAnswer ?? '',
analysis: res.analysis ?? ''
}
} catch (err) {
error.value = err instanceof Error ? err.message : '提交失败'
} finally {
submitting.value = false
}
}
function toggleWrongReason(reason: string) {
const idx = wrongReasons.value.indexOf(reason)
if (idx >= 0) wrongReasons.value.splice(idx, 1)
else wrongReasons.value.push(reason)
}
async function next() {
if (question.value === null) return
await loadQuestion()
}
async function finishSession() {
try {
const res = await practiceApi.finish(sessionId)
finished.value = true
finishResult.value = res
if (timer) clearInterval(timer)
} catch (err) {
error.value = err instanceof Error ? err.message : '结束会话失败'
}
}
function backToPractice() {
router.push('/practice')
}
const isLast = computed(() => question.value !== null && currentIndex.value >= total.value - 1)
const wrongItems = computed(() => finishResult.value?.questions.filter((q) => !q.correct) ?? [])
const finishAccuracy = computed(() => finishResult.value?.accuracy ?? 0)
</script>
<template>
<div class="answer">
<!-- ============ 整卷结果页 ============ -->
<div v-if="finished && finishResult" class="result">
<header class="result__head">
<h1>刷题完成</h1>
<p>本卷共 {{ finishResult.total }} 题 · 作答 {{ finishResult.answered }} 题</p>
</header>
<div class="result__hero">
<div class="result__score">
<strong class="num">{{ finishResult.correctCount }}<em>/{{ finishResult.total }}</em></strong>
<span>答对题数</span>
</div>
<div class="result__divider" />
<div class="result__stat">
<strong class="num">{{ finishAccuracy }}%</strong>
<span>正确率</span>
</div>
<div class="result__stat">
<strong class="num">{{ formatDuration(finishResult.durationSeconds) }}</strong>
<span>用时</span>
</div>
</div>
<AppCard v-if="wrongItems.length > 0" title="错题回顾" icon="alert">
<div class="wrong-list">
<div v-for="(q, i) in wrongItems" :key="q.questionId" class="wrong-list__item">
<span class="wrong-list__idx">{{ i + 1 }}</span>
<div class="wrong-list__body">
<div class="wrong-list__ans">
<span>你的答案 <b class="is-wrong">{{ q.userAnswer }}</b></span>
<span class="wrong-list__arrow"><AppIcon name="chevron-right" :size="14" /></span>
<span>正确答案 <b class="is-right">{{ q.correctAnswer }}</b></span>
</div>
<p class="wrong-list__analysis">{{ q.analysis }}</p>
</div>
</div>
</div>
<p class="result-note">答错的题已自动收录到错题本,将按 +1/+3/+7 天安排复习。</p>
</AppCard>
<AppCard v-else title="作答结果" icon="check">
<p class="result-all">全部答对,继续保持!</p>
</AppCard>
<div class="result__actions">
<AppButton block size="lg" icon="refresh" @click="backToPractice">返回刷题中心</AppButton>
</div>
</div>
<!-- ============ 作答态 ============ -->
<div v-else class="answer__body">
<AppLoading v-if="loading" fullscreen text="正在加载题目…" />
<AppError v-else-if="error" fullscreen title="加载失败" :message="error" retry @retry="loadQuestion" />
<template v-else-if="question">
<!-- 顶部:返回 + 进度 + 计时 -->
<header class="answer__top">
<button type="button" class="answer__iconbtn" @click="backToPractice">
<AppIcon name="chevron-left" :size="20" />
</button>
<div class="answer__progress">
<span class="answer__count">{{ remainingText }}</span>
<div class="answer__track"><div class="answer__track-fill" :style="{ width: `${progressPct}%` }" /></div>
</div>
<span class="answer__timer">{{ formatDuration(elapsed) }}</span>
<button type="button" class="answer__iconbtn" @click="backToPractice">
<AppIcon name="close" :size="18" />
</button>
</header>
<!-- 题干 -->
<section class="answer__question">
<div class="answer__tags">
<AppBadge variant="primary">{{ question.module }}</AppBadge>
<AppBadge v-if="question.subModule" variant="soft">{{ question.subModule }}</AppBadge>
<AppBadge v-if="question.difficulty" variant="warning">{{ question.difficulty }}</AppBadge>
</div>
<p class="answer__stem">{{ question.stem }}</p>
</section>
<!-- 选项 -->
<section class="answer__options">
<button
v-for="opt in question.options"
:key="opt.key"
type="button"
class="option"
:class="{
'option--picked': !answered && selected === opt.key,
'option--selected': answered && result?.correctAnswer === opt.key,
'option--wrong': answered && selected === opt.key && result?.correctAnswer !== opt.key
}"
:disabled="answered"
@click="choose(opt.key)"
>
<span class="option__key">{{ opt.key }}</span>
<span class="option__text">{{ opt.text }}</span>
<AppIcon v-if="answered && result?.correctAnswer === opt.key" name="check" :size="18" class="option__check" />
</button>
</section>
<!-- ===== 单题结果态 ===== -->
<div v-if="answered && result" class="single-result">
<div class="single-result__banner" :class="result.correct ? 'is-correct' : 'is-wrong'">
<span class="single-result__icon">
<AppIcon :name="result.correct ? 'check' : 'close'" :size="18" />
</span>
<div class="single-result__text">
<strong>{{ result.correct ? '回答正确' : '回答错误' }}</strong>
<span v-if="!result.correct">正确答案是 {{ result.correctAnswer }} · 本题已自动收录到错题本</span>
<span v-else>回答正确,继续加油</span>
</div>
</div>
<AppCard v-if="result.analysis" title="解析" icon="book-open">
<p class="single-result__analysis">{{ result.analysis }}</p>
<AppButton block variant="secondary" icon="sparkles" class="single-result__ai">没看懂?让 AI 讲一讲</AppButton>
</AppCard>
<div v-if="!result.correct" class="single-result__reason">
<span class="single-result__reason-label">标记错因(可多选)</span>
<div class="reason-tags">
<button
v-for="r in WRONG_REASON_OPTIONS"
:key="r"
type="button"
class="reason-tag"
:class="{ 'reason-tag--active': wrongReasons.includes(r) }"
@click="toggleWrongReason(r)"
>
{{ r }}
</button>
</div>
</div>
<AppButton v-if="!isLast" block size="lg" @click="next">下一题(第 {{ currentIndex + 2 }} 题)</AppButton>
<AppButton v-else block size="lg" icon="check" @click="finishSession">查看本卷结果</AppButton>
</div>
<!-- ===== 作答态(未提交) ===== -->
<AppButton v-else block size="lg" :loading="submitting" :disabled="!canSubmit" @click="submitAnswer">
提交答案
</AppButton>
</template>
</div>
</div>
</template>
<style scoped>
.answer {
display: flex;
flex-direction: column;
gap: var(--space-5);
}
/* 顶部栏 */
.answer__top {
display: flex;
align-items: center;
gap: var(--space-3);
}
.answer__iconbtn {
display: grid;
place-items: center;
width: 36px;
height: 36px;
flex: none;
border-radius: 50%;
background: var(--bg-card);
border: 1px solid var(--border-subtle);
color: var(--text-secondary);
cursor: pointer;
}
.answer__progress {
flex: 1;
display: flex;
flex-direction: column;
gap: var(--space-1);
}
.answer__count {
font-size: var(--fs-label);
color: var(--text-secondary);
text-align: center;
}
.answer__track {
height: 4px;
border-radius: var(--radius-pill);
background: var(--bg-soft);
overflow: hidden;
}
.answer__track-fill {
height: 100%;
border-radius: var(--radius-pill);
background: var(--primary-bright);
transition: width var(--motion-card-hover) var(--ease-default);
}
.answer__timer {
font-family: var(--font-num);
font-size: var(--fs-button);
font-weight: 700;
color: var(--warning);
flex: none;
}
/* 题干 */
.answer__question {
background: var(--bg-card);
border: 1px solid var(--border-subtle);
border-radius: var(--radius-lg);
padding: var(--card-padding-desktop);
}
.answer__tags {
display: flex;
gap: var(--space-2);
margin-bottom: var(--space-3);
}
.answer__stem {
margin: 0;
font-size: var(--fs-body);
line-height: var(--lh-body);
color: var(--text-primary);
white-space: pre-wrap;
}
/* 选项 */
.answer__options {
display: flex;
flex-direction: column;
gap: var(--space-3);
}
.option {
display: flex;
align-items: center;
gap: var(--space-3);
padding: var(--space-3) var(--space-4);
background: var(--bg-card);
border: 1px solid var(--border-subtle);
border-radius: var(--radius-md);
cursor: pointer;
text-align: left;
transition: border-color var(--motion-hover-fast) var(--ease-default), background var(--motion-hover-fast) var(--ease-default);
}
.option:hover:not(:disabled) {
border-color: var(--primary);
}
.option--picked {
border-color: var(--primary);
background: color-mix(in srgb, var(--primary) 8%, #fff);
}
.option--selected {
border-color: var(--primary);
background: color-mix(in srgb, var(--primary) 6%, #fff);
}
.option--wrong {
border-color: var(--danger);
background: var(--danger-soft);
}
.option--picked .option__key {
background: var(--primary);
color: var(--on-accent);
}
.option__key {
display: grid;
place-items: center;
width: 26px;
height: 26px;
flex: none;
border-radius: 50%;
background: var(--bg-soft);
color: var(--text-secondary);
font-weight: 700;
font-size: 14px;
}
.option--selected .option__key {
background: var(--success);
color: var(--on-accent);
}
.option--wrong .option__key {
background: var(--danger);
color: var(--on-accent);
}
.option__text {
flex: 1;
font-size: var(--fs-body);
color: var(--text-primary);
}
.option__check {
color: var(--success);
flex: none;
}
/* 单题结果 */
.single-result {
display: flex;
flex-direction: column;
gap: var(--space-4);
}
.single-result__banner {
display: flex;
align-items: center;
gap: var(--space-3);
padding: var(--space-4);
border-radius: var(--radius-lg);
color: var(--on-accent);
}
.single-result__banner.is-correct {
background: var(--success);
}
.single-result__banner.is-wrong {
background: var(--danger);
}
.single-result__icon {
display: grid;
place-items: center;
width: 34px;
height: 34px;
flex: none;
border-radius: 50%;
background: rgba(255, 255, 255, 0.22);
}
.single-result__text {
display: flex;
flex-direction: column;
gap: 2px;
}
.single-result__text strong {
font-size: var(--fs-card-title);
}
.single-result__text span {
font-size: var(--fs-label);
opacity: 0.9;
}
.single-result__analysis {
margin: 0 0 var(--space-3);
font-size: var(--fs-body);
line-height: var(--lh-body);
color: var(--text-primary);
white-space: pre-wrap;
}
.single-result__reason {
display: flex;
flex-direction: column;
gap: var(--space-3);
}
.single-result__reason-label {
font-size: var(--fs-subtitle);
color: var(--text-secondary);
}
.reason-tags {
display: flex;
flex-wrap: wrap;
gap: var(--space-2);
}
.reason-tag {
padding: var(--space-2) var(--space-3);
border-radius: var(--radius-pill);
border: 1px solid var(--border-subtle);
background: var(--bg-card);
color: var(--text-secondary);
font-size: var(--fs-label);
cursor: pointer;
transition: all var(--motion-hover-fast) var(--ease-default);
}
.reason-tag--active {
background: var(--primary);
border-color: var(--primary);
color: var(--on-accent);
}
/* 整卷结果 */
.result {
display: flex;
flex-direction: column;
gap: var(--space-4);
}
.result__head h1 {
margin: 0;
font-size: var(--fs-h1);
color: var(--text-primary);
}
.result__head p {
margin: var(--space-1) 0 0;
font-size: var(--fs-subtitle);
color: var(--text-secondary);
}
.result__hero {
display: flex;
align-items: center;
gap: var(--space-6);
padding: var(--card-padding-desktop);
background: var(--bg-card);
border: 1px solid var(--border-subtle);
border-radius: var(--radius-xl);
}
.result__score {
display: flex;
flex-direction: column;
gap: 4px;
flex: 1;
}
.result__score .num {
font-size: 28px;
}
.result__score .num em {
font-style: normal;
font-size: var(--fs-card-title);
color: var(--text-muted);
}
.result__score span {
font-size: var(--fs-label);
color: var(--text-secondary);
}
.result__divider {
width: 1px;
align-self: stretch;
background: var(--border-subtle);
}
.result__stat {
display: flex;
flex-direction: column;
gap: 4px;
flex: 1;
}
.result__stat .num {
font-size: var(--fs-data-num);
}
.result__stat span {
font-size: var(--fs-label);
color: var(--text-secondary);
}
.wrong-list {
display: flex;
flex-direction: column;
gap: var(--space-4);
}
.wrong-list__item {
display: flex;
gap: var(--space-3);
}
.wrong-list__idx {
display: grid;
place-items: center;
width: 24px;
height: 24px;
flex: none;
border-radius: 50%;
background: var(--danger-soft);
color: var(--danger);
font-size: var(--fs-label);
font-weight: 700;
}
.wrong-list__body {
flex: 1;
}
.wrong-list__ans {
display: flex;
align-items: center;
gap: var(--space-2);
font-size: var(--fs-subtitle);
}
.wrong-list__ans .is-wrong {
color: var(--danger);
}
.wrong-list__ans .is-right {
color: var(--success);
}
.wrong-list__arrow {
color: var(--text-muted);
display: inline-flex;
}
.wrong-list__analysis {
margin: var(--space-1) 0 0;
font-size: var(--fs-body);
line-height: var(--lh-body);
color: var(--text-secondary);
}
.result-note {
margin: var(--space-4) 0 0;
font-size: var(--fs-label);
color: var(--text-muted);
}
.result-all {
margin: 0;
font-size: var(--fs-body);
color: var(--text-primary);
}
.result__actions {
display: flex;
flex-direction: column;
gap: var(--space-3);
}
.num {
font-family: var(--font-num);
font-weight: 700;
color: var(--text-primary);
}
@media (max-width: 767px) {
.answer__top {
gap: var(--space-2);
}
.answer__iconbtn {
width: 32px;
height: 32px;
}
}
</style>

View File

@ -0,0 +1,208 @@
<script setup lang="ts">
import { computed, ref } from 'vue'
import { useRouter } from 'vue-router'
import { practiceApi, questionsApi } from '../../api'
import { useRequest } from '../../composables/useRequest'
import { usePracticeStore } from '../../stores/practice'
import AppPageHeader from '../../components/base/AppPageHeader.vue'
import AppCard from '../../components/base/AppCard.vue'
import AppButton from '../../components/base/AppButton.vue'
import AppBadge from '../../components/base/AppBadge.vue'
import AppLoading from '../../components/feedback/AppLoading.vue'
import AppError from '../../components/feedback/AppError.vue'
import AppEmpty from '../../components/feedback/AppEmpty.vue'
import { useToast } from '../../composables/useToast'
const router = useRouter()
const practice = usePracticeStore()
const toast = useToast()
const list = useRequest(() => questionsApi.list({ page: 1, pageSize: 100 }))
const selected = ref<string[]>([])
const starting = ref(false)
const items = computed(() => list.data.value?.items ?? [])
const maxReached = computed(() => selected.value.length >= 20)
function toggle(id: string) {
const idx = selected.value.indexOf(id)
if (idx >= 0) {
selected.value.splice(idx, 1)
} else {
if (selected.value.length >= 20) {
toast.info('自定义组卷最多选 20 题')
return
}
selected.value.push(id)
}
}
function toggleAll() {
if (selected.value.length === items.value.length) selected.value = []
else selected.value = items.value.slice(0, 20).map((i) => i.id)
}
const selectedCount = computed(() => selected.value.length)
async function startCustom() {
if (selected.value.length === 0) {
toast.info('请至少选择一题')
return
}
starting.value = true
try {
const module = items.value.find((i) => i.id === selected.value[0])?.module
if (!module) throw new Error('无法确定题目模块')
const session = await practiceApi.start({ module, duration: 15, custom: selected.value })
practice.start({
sessionId: session.sessionId,
module: session.module,
durationMinutes: session.durationMinutes,
total: session.total
})
router.push({ name: 'practice-session', params: { id: session.sessionId } })
} catch (err) {
toast.error(err instanceof Error ? err.message : '组卷失败')
} finally {
starting.value = false
}
}
function back() {
router.push('/practice')
}
</script>
<template>
<div class="custom">
<AppPageHeader title="自定义组卷" subtitle="从题库中勾选题目,组成一套专属练习">
<AppButton variant="ghost" icon="chevron-left" @click="back">返回</AppButton>
</AppPageHeader>
<AppLoading v-if="list.loading.value" fullscreen />
<AppError v-else-if="list.error.value" fullscreen title="加载失败" :message="list.error.value" retry @retry="list.refresh" />
<template v-else>
<!-- 工具条 -->
<div class="custom__toolbar">
<span class="custom__count">已选 <b>{{ selectedCount }}</b> / 20 题</span>
<AppButton variant="secondary" size="md" @click="toggleAll">
{{ selectedCount === items.length ? '取消全选' : `全选(前20题)` }}
</AppButton>
</div>
<!-- 题目列表 -->
<div class="custom__list">
<button
v-for="item in items"
:key="item.id"
type="button"
class="qcard"
:class="{ 'qcard--selected': selected.includes(item.id) }"
@click="toggle(item.id)"
>
<span class="qcard__check">
<AppIcon v-if="selected.includes(item.id)" name="check" :size="14" />
</span>
<div class="qcard__body">
<div class="qcard__meta">
<AppBadge variant="primary">{{ item.module }}</AppBadge>
<AppBadge v-if="item.subModule" variant="soft">{{ item.subModule }}</AppBadge>
<AppBadge variant="warning">{{ item.difficulty }}</AppBadge>
</div>
<p class="qcard__stem">{{ item.stem }}</p>
</div>
</button>
<AppEmpty v-if="items.length === 0" title="题库为空" description="请先到题库管理导入题目。" />
</div>
<!-- 底部固定开始 -->
<div class="custom__footer">
<AppButton block size="lg" icon="pen" :loading="starting" :disabled="selectedCount === 0" @click="startCustom">
开始练习({{ selectedCount }} 题)
</AppButton>
</div>
</template>
</div>
</template>
<style scoped>
.custom {
display: flex;
flex-direction: column;
gap: var(--space-5);
}
.custom__toolbar {
display: flex;
align-items: center;
justify-content: space-between;
gap: var(--space-3);
}
.custom__count {
font-size: var(--fs-subtitle);
color: var(--text-secondary);
}
.custom__count b {
color: var(--primary);
font-family: var(--font-num);
font-size: var(--fs-card-title);
}
.custom__list {
display: flex;
flex-direction: column;
gap: var(--space-3);
}
.qcard {
display: flex;
align-items: flex-start;
gap: var(--space-3);
padding: var(--card-padding-desktop);
background: var(--bg-card);
border: 1px solid var(--border-subtle);
border-radius: var(--radius-lg);
cursor: pointer;
text-align: left;
transition: border-color var(--motion-hover-fast) var(--ease-default);
}
.qcard--selected {
border-color: var(--primary);
background: color-mix(in srgb, var(--primary) 4%, #fff);
}
.qcard__check {
display: grid;
place-items: center;
width: 22px;
height: 22px;
flex: none;
border-radius: 50%;
border: 2px solid var(--border-subtle);
color: var(--on-accent);
margin-top: 2px;
}
.qcard--selected .qcard__check {
background: var(--primary);
border-color: var(--primary);
}
.qcard__body {
flex: 1;
min-width: 0;
}
.qcard__meta {
display: flex;
gap: var(--space-2);
margin-bottom: var(--space-2);
}
.qcard__stem {
margin: 0;
font-size: var(--fs-body);
line-height: var(--lh-body);
color: var(--text-primary);
white-space: pre-wrap;
}
.custom__footer {
position: sticky;
bottom: 0;
padding-block: var(--space-3);
background: var(--bg-canvas);
}
</style>

View File

@ -1,7 +1,734 @@
<script setup lang="ts">
import { computed, onMounted, reactive, ref } from 'vue'
import { useRoute, useRouter } from 'vue-router'
import { dashboardApi, practiceApi, reviewApi, type ReviewListItem } from '../../api'
import { useRequest } from '../../composables/useRequest'
import { useResponsive } from '../../composables/useResponsive'
import { usePracticeStore } from '../../stores/practice'
import AppPageHeader from '../../components/base/AppPageHeader.vue'
import AppCard from '../../components/base/AppCard.vue'
import AppButton from '../../components/base/AppButton.vue'
import AppBadge from '../../components/base/AppBadge.vue'
import AppIcon from '../../components/base/AppIcon.vue'
import AppLoading from '../../components/feedback/AppLoading.vue'
import AppError from '../../components/feedback/AppError.vue'
import AppEmpty from '../../components/feedback/AppEmpty.vue'
import ComingSoon from '../../components/feedback/ComingSoon.vue'
import { formatPercent, formatDateShort } from '../../utils/format'
import type { IconName } from '../../components/base/icons'
const route = useRoute()
const router = useRouter()
const { isMobile } = useResponsive()
const practice = usePracticeStore()
/** 当前子 tab:刷题 / 错题本 / 申论 */
const tab = computed(() => {
if (route.name === 'practice-wrong') return 'wrong'
if (route.name === 'practice-essay') return 'essay'
return 'practice'
})
const DURATIONS = [5, 10, 15] as const
const modules = useRequest(() => practiceApi.modules())
const mastery = useRequest(() => dashboardApi.mastery())
const wrongReasons = useRequest(() => practiceApi.wrongReasons())
const overview = useRequest(() => dashboardApi.overview())
// 错题本:页码加 1 表示当前选中的状态/模块筛选已生效
const wrongQuery = reactive<{ status: WrongStatus; module: WrongModule | '' }>({ status: '', module: '' })
const reviewList = useRequest(() =>
reviewApi.list({
status: wrongQuery.status || undefined,
module: wrongQuery.module || undefined,
page: 1,
pageSize: 50
})
)
onMounted(() => {
// 错题本页默认拉取待复习 + 全部
if (tab.value === 'wrong') void reviewList.refresh()
})
const selectModule = ref<'' | '言语理解' | '数量关系' | '判断推理' | '资料分析' | '常识判断'>('')
const selectDuration = ref<5 | 10 | 15>(15)
const starting = ref(false)
const masteryByModule = computed(() => {
const map = new Map<string, number>()
for (const item of mastery.data.value?.mastery ?? []) map.set(item.module, item.accuracy)
return map
})
const moduleTotal = computed(() => {
const map = new Map<string, number>()
for (const item of modules.data.value?.modules ?? []) map.set(item.name, item.total)
return map
})
const activeModule = computed(() => {
const m = selectModule.value || (modules.data.value?.modules[0]?.name ?? '')
return m
})
const recommendText = computed(() => {
const m = activeModule.value
return `开始刷题 · ${selectDuration.value}分钟 · ${m || '请选择模块'}`
})
const reasons = computed(() => wrongReasons.data.value?.reasons ?? [])
const pendingReview = computed(() => reviewList.data.value?.items ?? [])
// ---- 错题本筛选 ----
type WrongModule = '言语理解' | '数量关系' | '判断推理' | '资料分析' | '常识判断'
type WrongStatus = '' | 'pending' | 'reviewing' | 'mastered'
const wrongModuleList: WrongModule[] = ['言语理解', '数量关系', '判断推理', '资料分析', '常识判断']
const wrongStatusTabs: { key: WrongStatus; label: string }[] = [
{ key: '', label: '全部' },
{ key: 'pending', label: '待复习' },
{ key: 'reviewing', label: '复习中' },
{ key: 'mastered', label: '已掌握' }
]
const wrongModuleTabs: { key: WrongModule | ''; label: string }[] = [
{ key: '', label: '全部模块' },
...wrongModuleList.map((m) => ({ key: m, label: m }))
]
const wrongEmptyTitle = computed(() => {
if (wrongQuery.status) return '没有该状态的错题'
if (wrongQuery.module) return '该模块暂无错题'
return '暂无错题'
})
function setWrongStatus(key: WrongStatus) {
wrongQuery.status = key
void reviewList.refresh()
}
function setWrongModule(key: WrongModule | '') {
wrongQuery.module = key
void reviewList.refresh()
}
function wrongStatusLabel(status: ReviewListItem['status']) {
return status === 'mastered' ? '已掌握' : status === 'reviewing' ? '复习中' : '待复习'
}
function wrongStatusVariant(status: ReviewListItem['status']) {
return status === 'mastered' ? 'success' : status === 'reviewing' ? 'warning' : 'danger'
}
const startDisabled = computed(() => starting.value || !activeModule.value)
async function startPractice() {
if (!activeModule.value || starting.value) return
starting.value = true
try {
const session = await practiceApi.start({ module: activeModule.value, duration: selectDuration.value })
practice.start({
sessionId: session.sessionId,
module: session.module,
durationMinutes: session.durationMinutes,
total: session.total
})
router.push({ name: 'practice-session', params: { id: session.sessionId } })
} finally {
starting.value = false
}
}
function goCustom() {
router.push({ name: 'practice-custom' })
}
const tabs = [
{ key: 'practice', label: '刷题', to: '/practice' },
{ key: 'wrong', label: '错题本', to: '/practice/wrong' },
{ key: 'essay', label: '申论', to: '/practice/essay' }
] as const
const backAction: Record<string, string> = { practice: '', wrong: '', essay: '' }
const subtitle = computed(() => {
if (tab.value === 'wrong') return '答错自动沉淀,按间隔复习'
if (tab.value === 'essay') return '申论功能即将上线'
return '选择模块,碎片时间刷题'
})
</script>
<template>
<ComingSoon />
<div class="practice">
<AppPageHeader title="刷题中心" :subtitle="subtitle" :stack-mobile="true">
<template v-if="tab === 'practice'">
<AppButton variant="secondary" icon="plus" @click="goCustom">自定义组卷</AppButton>
<AppButton icon="pen" :loading="starting" :disabled="startDisabled" @click="startPractice">
开始刷题
</AppButton>
</template>
</AppPageHeader>
<!-- 子 tab -->
<div class="practice-tabs">
<RouterLink
v-for="t in tabs"
:key="t.key"
:to="t.to"
class="practice-tab"
:class="{ 'practice-tab--active': tab === t.key }"
>
{{ t.label }}
</RouterLink>
</div>
<!-- ============ 刷题 tab ============ -->
<template v-if="tab === 'practice'">
<AppLoading v-if="modules.loading.value" fullscreen />
<AppError
v-else-if="modules.error.value"
fullscreen
title="加载失败"
:message="modules.error.value"
retry
@retry="modules.refresh"
/>
<template v-else>
<!-- 选择模块 -->
<section class="practice-section">
<h2 class="practice-section__title">选择模块</h2>
<div class="module-grid">
<button
v-for="m in modules.data.value?.modules ?? []"
:key="m.name"
type="button"
class="module-card"
:class="{ 'module-card--active': activeModule === m.name }"
@click="selectModule = m.name"
>
<div class="module-card__row">
<span class="module-card__name">{{ m.name }}</span>
<span v-if="activeModule === m.name" class="module-card__check">
<AppIcon name="check" :size="14" />
</span>
</div>
<div class="module-card__meta">
<span class="module-card__count">{{ m.total }} 题</span>
<span class="module-card__dot">·</span>
<span
class="module-card__mastery"
:class="{ 'module-card__mastery--low': (masteryByModule.get(m.name) ?? 0) < 60 }"
>
掌握度 {{ formatPercent(masteryByModule.get(m.name) ?? 0) }}
</span>
</div>
</button>
</div>
<AppEmpty v-if="(modules.data.value?.modules.length ?? 0) === 0" title="还没有题目" description="请先到题库管理导入题目,再开始刷题。">
<AppButton variant="secondary" @click="router.push('/questions')">去导入题目</AppButton>
</AppEmpty>
</section>
<!-- 碎片组卷时长 -->
<section class="practice-section">
<h2 class="practice-section__title">碎片组卷时长</h2>
<div class="duration-grid">
<button
v-for="d in DURATIONS"
:key="d"
type="button"
class="duration-card"
:class="{ 'duration-card--active': selectDuration === d }"
@click="selectDuration = d"
>
<span class="duration-card__value">{{ d }}分钟</span>
<span class="duration-card__sub">约 {{ d }} 题</span>
</button>
</div>
<!-- 开始刷题大按钮 -->
<AppButton block size="lg" icon="pen" :loading="starting" :disabled="startDisabled" @click="startPractice">
{{ recommendText }}
</AppButton>
</section>
<!-- 错因分布 -->
<AppCard title="错因分布 · 最近 30 天" icon="chart">
<AppEmpty v-if="reasons.length === 0" icon="chart" title="暂无错因数据" description="完成刷题后根据错题统计错因分布。" />
<div v-else class="reason-bars">
<div v-for="r in reasons" :key="r.reason" class="reason-bar">
<div class="reason-bar__row">
<span class="reason-bar__label">{{ r.reason }}</span>
<span class="reason-bar__pct">{{ formatPercent(r.percent) }}</span>
</div>
<div class="reason-bar__track">
<div class="reason-bar__fill" :style="{ width: `${r.percent}%` }" />
</div>
</div>
</div>
</AppCard>
<!-- 待复习错题 + 推荐动作 -->
<div class="practice-bottom">
<AppCard title="待复习错题" icon="alert">
<AppEmpty v-if="pendingReview.length === 0" icon="alert" title="没有待复习的错题" description="完成刷题后答错的题会自动进入错题本。" />
<div v-else class="pending-list">
<RouterLink
v-for="item in pendingReview"
:key="item.id"
class="pending-item"
:to="{ name: 'practice-wrong' }"
>
<div class="pending-item__meta">
<span class="pending-item__module">{{ item.module }}</span>
<span class="pending-item__sub">{{ item.subModule }}</span>
</div>
<div class="pending-item__text">{{ item.stem }}</div>
<div class="pending-item__foot">
<span class="pending-item__reason">{{ item.wrongReason }}</span>
<span class="pending-item__count">已复习 {{ item.reviewCount }} 次</span>
</div>
</RouterLink>
</div>
</AppCard>
<AppCard title="推荐动作" icon="target">
<div class="recommend-list">
<div class="recommend-item">
<span class="recommend-item__label">抽做 {{ moduleTotal.get('判断推理') ?? 0 }} 道错题</span>
<span class="recommend-item__desc">复盘思路 · 建议 15 分钟</span>
</div>
<div class="recommend-item">
<span class="recommend-item__label">专项突破 数量关系</span>
<span class="recommend-item__desc">薄弱考点 · 建议 15 分钟</span>
</div>
<div class="recommend-item">
<span class="recommend-item__label">练习 言语理解</span>
<span class="recommend-item__desc">保持手感 · 建议 10 分钟</span>
</div>
</div>
</AppCard>
</div>
</template>
</template>
<!-- ============ 错题本 tab ============ -->
<template v-else-if="tab === 'wrong'">
<AppLoading v-if="reviewList.loading.value" fullscreen />
<AppError
v-else-if="reviewList.error.value"
fullscreen
title="加载失败"
:message="reviewList.error.value"
retry
@retry="reviewList.refresh"
/>
<template v-else>
<!-- 筛选行 -->
<div class="wrong-filter">
<div class="wrong-filter__group">
<span class="wrong-filter__label">状态</span>
<button
v-for="s in wrongStatusTabs"
:key="s.key"
type="button"
class="wrong-filter__chip"
:class="{ 'wrong-filter__chip--active': wrongQuery.status === s.key }"
@click="setWrongStatus(s.key)"
>
{{ s.label }}
</button>
</div>
<div class="wrong-filter__group">
<span class="wrong-filter__label">模块</span>
<button
v-for="m in wrongModuleTabs"
:key="m.key"
type="button"
class="wrong-filter__chip"
:class="{ 'wrong-filter__chip--active': wrongQuery.module === m.key }"
@click="setWrongModule(m.key)"
>
{{ m.label }}
</button>
</div>
</div>
<!-- 列表 -->
<AppCard v-if="reviewList.data.value?.items.length === 0" :padded="true">
<AppEmpty
icon="book-open"
:title="wrongEmptyTitle"
description="答错的题会自动收藏到错题本,按 +1/+3/+7 天安排复习。"
/>
</AppCard>
<div v-else class="wrong-book-list">
<RouterLink
v-for="item in reviewList.data.value?.items ?? []"
:key="item.id"
class="wrong-book-item"
:to="{ name: 'practice-wrong-detail', params: { id: item.id } }"
>
<div class="wrong-book-item__head">
<div class="wrong-book-item__tags">
<AppBadge variant="primary">{{ item.module }}</AppBadge>
<AppBadge v-if="item.subModule" variant="soft">{{ item.subModule }}</AppBadge>
</div>
<AppBadge :variant="wrongStatusVariant(item.status)">{{ wrongStatusLabel(item.status) }}</AppBadge>
</div>
<p class="wrong-book-item__stem">{{ item.stem }}</p>
<div class="wrong-book-item__foot">
<span v-if="item.wrongReason" class="wrong-book-item__reason">错因 · {{ item.wrongReason }}</span>
<span class="wrong-book-item__count">已复习 {{ item.reviewCount }} 次</span>
<span class="wrong-book-item__date">{{ formatDateShort(item.nextReviewAt) }} 复习</span>
</div>
</RouterLink>
</div>
</template>
</template>
<!-- ============ 申论 tab ============ -->
<template v-else>
<ComingSoon />
</template>
</div>
</template>
<style scoped>
.practice {
display: flex;
flex-direction: column;
gap: var(--space-5);
}
/* 子 tab */
.practice-tabs {
display: flex;
gap: var(--space-2);
background: var(--bg-soft);
border-radius: var(--radius-md);
padding: 4px;
}
.practice-tab {
flex: 1;
text-align: center;
padding: var(--space-2);
border-radius: var(--radius-sm);
font-size: var(--fs-button);
font-weight: var(--fw-button);
color: var(--text-secondary);
text-decoration: none;
transition: background var(--motion-tab-fade) var(--ease-default), color var(--motion-tab-fade) var(--ease-default);
}
.practice-tab--active {
background: var(--primary);
color: var(--on-accent);
}
/* section */
.practice-section {
display: flex;
flex-direction: column;
gap: var(--space-3);
}
.practice-section__title {
margin: 0;
font-size: var(--fs-card-title);
font-weight: var(--fw-card-title);
color: var(--text-primary);
}
/* 模块卡 */
.module-grid {
display: grid;
grid-template-columns: repeat(5, 1fr);
gap: var(--card-gap-desktop);
}
.module-card {
display: flex;
flex-direction: column;
gap: var(--space-2);
padding: var(--card-padding-desktop);
background: var(--bg-card);
border: 1px solid var(--border-subtle);
border-radius: var(--radius-lg);
cursor: pointer;
transition: border-color var(--motion-hover-fast) var(--ease-default), box-shadow var(--motion-card-hover) var(--ease-default);
text-align: left;
}
.module-card:hover {
box-shadow: var(--shadow-level-1);
}
.module-card--active {
border-color: var(--primary);
box-shadow: 0 0 0 2px color-mix(in srgb, var(--primary) 14%, transparent);
}
.module-card__row {
display: flex;
align-items: center;
justify-content: space-between;
}
.module-card__name {
font-size: var(--fs-card-title);
font-weight: var(--fw-card-title);
color: var(--text-primary);
}
.module-card__check {
display: grid;
place-items: center;
width: 20px;
height: 20px;
border-radius: 50%;
background: var(--primary);
color: var(--on-accent);
}
.module-card__meta {
display: flex;
align-items: center;
gap: var(--space-1);
font-size: var(--fs-label);
color: var(--text-secondary);
}
.module-card__mastery--low {
color: var(--danger);
}
/* 时长卡 */
.duration-grid {
display: grid;
grid-template-columns: repeat(3, 1fr);
gap: var(--card-gap-desktop);
}
.duration-card {
display: flex;
flex-direction: column;
align-items: center;
gap: 4px;
padding: var(--space-4) var(--space-3);
background: var(--bg-card);
border: 1px solid var(--border-subtle);
border-radius: var(--radius-md);
cursor: pointer;
transition: border-color var(--motion-hover-fast) var(--ease-default), background var(--motion-hover-fast) var(--ease-default);
}
.duration-card--active {
border-color: var(--primary);
background: color-mix(in srgb, var(--primary) 6%, #fff);
}
.duration-card__value {
font-family: var(--font-num);
font-size: var(--fs-card-title);
font-weight: 700;
color: var(--text-primary);
}
.duration-card__sub {
font-size: var(--fs-label);
color: var(--text-secondary);
}
/* 错因分布条 */
.reason-bars {
display: flex;
flex-direction: column;
gap: var(--space-3);
}
.reason-bar__row {
display: flex;
align-items: center;
justify-content: space-between;
margin-bottom: var(--space-1);
font-size: var(--fs-subtitle);
}
.reason-bar__label {
color: var(--text-secondary);
}
.reason-bar__pct {
font-family: var(--font-num);
font-weight: 700;
color: var(--text-primary);
}
.reason-bar__track {
height: 8px;
border-radius: var(--radius-pill);
background: var(--bg-soft);
overflow: hidden;
}
.reason-bar__fill {
height: 100%;
border-radius: var(--radius-pill);
background: linear-gradient(90deg, var(--primary-bright), var(--primary));
transition: width var(--motion-card-hover) var(--ease-default);
}
/* 底部两栏 */
.practice-bottom {
display: grid;
grid-template-columns: 2fr 1fr;
gap: var(--card-gap-desktop);
align-items: start;
}
.pending-list,
.recommend-list {
display: flex;
flex-direction: column;
gap: var(--space-4);
}
.pending-item {
display: flex;
flex-direction: column;
gap: var(--space-1);
text-decoration: none;
padding-block: var(--space-1);
}
.pending-item__meta {
display: flex;
align-items: center;
gap: var(--space-2);
font-size: var(--fs-label);
}
.pending-item__module {
color: var(--primary);
font-weight: var(--fw-label-bold);
}
.pending-item__sub {
color: var(--text-muted);
}
.pending-item__text {
font-size: var(--fs-body);
color: var(--text-primary);
line-height: var(--lh-body);
display: -webkit-box;
-webkit-line-clamp: 2;
-webkit-box-orient: vertical;
overflow: hidden;
}
.pending-item__foot {
display: flex;
align-items: center;
justify-content: space-between;
font-size: var(--fs-label);
color: var(--text-secondary);
}
.recommend-item {
display: flex;
flex-direction: column;
gap: 2px;
padding-block: var(--space-2);
border-bottom: 1px solid var(--border-subtle);
}
.recommend-item__label {
font-size: var(--fs-subtitle);
font-weight: var(--fw-card-title);
color: var(--text-primary);
}
.recommend-item__desc {
font-size: var(--fs-label);
color: var(--text-secondary);
}
/* 错题本 tab */
.wrong-filter {
display: flex;
flex-direction: column;
gap: var(--space-3);
}
.wrong-filter__group {
display: flex;
align-items: center;
gap: var(--space-2);
flex-wrap: wrap;
}
.wrong-filter__label {
font-size: var(--fs-label);
color: var(--text-secondary);
flex: none;
min-width: 30px;
}
.wrong-filter__chip {
padding: var(--space-1) var(--space-3);
border-radius: var(--radius-pill);
border: 1px solid var(--border-subtle);
background: var(--bg-card);
color: var(--text-secondary);
font-size: var(--fs-label);
cursor: pointer;
transition: all var(--motion-hover-fast) var(--ease-default);
}
.wrong-filter__chip--active {
background: var(--primary);
border-color: var(--primary);
color: var(--on-accent);
}
.wrong-book-list {
display: flex;
flex-direction: column;
gap: var(--space-3);
}
.wrong-book-item {
display: flex;
flex-direction: column;
gap: var(--space-2);
padding: var(--card-padding-desktop);
background: var(--bg-card);
border: 1px solid var(--border-subtle);
border-radius: var(--radius-md);
text-decoration: none;
transition: border-color var(--motion-hover-fast) var(--ease-default), box-shadow var(--motion-card-hover) var(--ease-default);
}
.wrong-book-item:hover {
border-color: var(--primary);
box-shadow: var(--shadow-level-1);
}
.wrong-book-item__head {
display: flex;
align-items: center;
justify-content: space-between;
gap: var(--space-2);
}
.wrong-book-item__tags {
display: flex;
gap: var(--space-2);
flex-wrap: wrap;
}
.wrong-book-item__stem {
margin: 0;
font-size: var(--fs-body);
line-height: var(--lh-body);
color: var(--text-primary);
display: -webkit-box;
-webkit-line-clamp: 2;
-webkit-box-orient: vertical;
overflow: hidden;
}
.wrong-book-item__foot {
display: flex;
align-items: center;
gap: var(--space-3);
font-size: var(--fs-label);
color: var(--text-secondary);
flex-wrap: wrap;
}
.wrong-book-item__reason {
color: var(--warning);
}
.wrong-book-item__count {
margin-left: auto;
}
/* 桌面响应 */
@media (max-width: 1023px) {
.module-grid {
grid-template-columns: repeat(2, 1fr);
}
.practice-bottom {
grid-template-columns: 1fr;
}
}
@media (max-width: 767px) {
.module-grid {
grid-template-columns: repeat(2, 1fr);
}
.duration-grid {
grid-template-columns: repeat(3, 1fr);
}
}
</style>

View File

@ -0,0 +1,536 @@
<script setup lang="ts">
import { computed, onMounted, ref } from 'vue'
import { useRoute, useRouter } from 'vue-router'
import { reviewApi, type ReviewDetail } from '../../api'
import AppButton from '../../components/base/AppButton.vue'
import AppBadge from '../../components/base/AppBadge.vue'
import AppIcon from '../../components/base/AppIcon.vue'
import AppLoading from '../../components/feedback/AppLoading.vue'
import AppError from '../../components/feedback/AppError.vue'
import { formatDateShort, formatDateWeekday } from '../../utils/format'
const route = useRoute()
const router = useRouter()
const id = route.params.id as string
const loading = ref(true)
const error = ref('')
const detail = ref<ReviewDetail | null>(null)
// 自评结论
const submitting = ref(false)
const assessed = ref(false)
const assessResult = ref<{ correct: boolean; reviewCount: number; status: string; nextReviewAt: string } | null>(null)
const chosenReason = ref('')
const WRONG_REASON_OPTIONS = ['审题失误', '计算失误', '公式遗忘', '思路偏差', '知识点遗忘'] as const
onMounted(() => void load())
async function load() {
loading.value = true
error.value = ''
try {
detail.value = await reviewApi.detail(id)
} catch (err) {
error.value = err instanceof Error ? err.message : '错题详情加载失败'
} finally {
loading.value = false
}
}
const statusMeta = computed(() => {
const s = detail.value?.status
if (s === 'mastered') return { label: '已掌握', variant: 'success' as const }
if (s === 'reviewing') return { label: '复习中', variant: 'warning' as const }
return { label: '待复习', variant: 'danger' as const }
})
async function assess(correct: boolean) {
if (submitting.value || assessed.value) return
submitting.value = true
try {
const res = await reviewApi.selfAssess(id, {
correct,
wrongReason: correct ? undefined : chosenReason.value || undefined
})
assessResult.value = res
assessed.value = true
} catch (err) {
error.value = err instanceof Error ? err.message : '提交失败'
} finally {
submitting.value = false
}
}
async function markMastered() {
if (submitting.value) return
submitting.value = true
try {
await reviewApi.markMastered(id)
router.replace({ name: 'practice-wrong' })
} catch (err) {
error.value = err instanceof Error ? err.message : '标记失败'
} finally {
submitting.value = false
}
}
function back() {
router.back()
}
const statusLabel = computed(() =>
assessResult.value
? assessResult.value.status === 'mastered'
? '已掌握'
: assessResult.value.status === 'reviewing'
? '复习中'
: '待复习'
: statusMeta.value.label
)
function toggleReason(reason: string) {
chosenReason.value = chosenReason.value === reason ? '' : reason
}
function backToList() {
router.push('/practice/wrong')
}
</script>
<template>
<div class="wrong-detail">
<AppLoading v-if="loading" fullscreen text="正在加载错题详情…" />
<AppError v-else-if="error" fullscreen title="加载失败" :message="error" retry @retry="load" />
<template v-else-if="detail">
<!-- 顶栏:返回 + 标题 + 状态 -->
<header class="wd__top">
<button type="button" class="wd__back" @click="back">
<AppIcon name="chevron-left" :size="20" />
</button>
<h1 class="wd__title">错题详情</h1>
<span class="wd__status-badge">
<AppBadge :variant="statusMeta.variant">{{ statusLabel }}</AppBadge>
</span>
</header>
<!-- 题目卡片 -->
<section class="wd__question">
<div class="wd__tags">
<AppBadge variant="primary">{{ detail.module }}</AppBadge>
<AppBadge v-if="detail.subModule" variant="soft">{{ detail.subModule }}</AppBadge>
<AppBadge v-if="detail.difficulty" variant="warning">{{ detail.difficulty }}</AppBadge>
</div>
<p class="wd__stem">{{ detail.stem }}</p>
</section>
<!-- 答案 + 解析 -->
<section class="wd__answer">
<div class="wd__answer-head">
<span class="wd__answer-label">正确答案</span>
<span class="wd__answer-key">{{ detail.answer }}</span>
<span class="wd__answer-meta">
{{ statusLabel }} · 已复习 {{ detail.reviewCount }} 次
</span>
</div>
<p v-if="detail.analysis" class="wd__analysis">{{ detail.analysis }}</p>
</section>
<div v-if="detail.options?.length" class="wd__options">
<div v-for="opt in detail.options" :key="opt.key" class="wd__option">
<span class="wd__option-key" :class="{ 'is-answer': opt.key === detail.answer }">{{ opt.key }}</span>
<span class="wd__option-text">{{ opt.text }}</span>
</div>
</div>
<!-- 操作区:重做此题 / AI 讲解 / 标记掌握 / 自评 -->
<div v-if="!assessed" class="wd__actions">
<AppButton block size="lg" icon="refresh" @click="router.push(`/practice/session`)" disabled>
重做此题
</AppButton>
<AppButton block size="lg" variant="secondary" icon="sparkles" @click="router.push(`/questions`)" disabled>
AI 讲解
</AppButton>
</div>
<!-- 自评区 -->
<section v-if="!assessed && detail.status !== 'mastered'" class="wd__assess">
<p class="wd__assess-title">这次复习结果如何?(用于安排下次复习)</p>
<div class="wd__assess-btns">
<AppButton block size="lg" variant="secondary" :loading="submitting" @click="assess(true)">
记对了
</AppButton>
<AppButton block size="lg" variant="danger" :loading="submitting" @click="assess(false)">
记错了
</AppButton>
</div>
<div v-if="chosenReason" class="wd__reason-hint">记错原因:{{ chosenReason }}</div>
<div class="wd__reason-tags">
<button
v-for="r in WRONG_REASON_OPTIONS"
:key="r"
type="button"
class="wd__reason-tag"
:class="{ 'wd__reason-tag--active': chosenReason === r }"
@click="toggleReason(r)"
>
{{ r }}
</button>
</div>
</section>
<!-- 自评结果反馈 -->
<section v-if="assessed && assessResult" class="wd__result">
<div class="wd__result-banner" :class="assessResult.correct ? 'is-correct' : 'is-wrong'">
<AppIcon :name="assessResult.correct ? 'check' : 'close'" :size="18" />
<span>{{ assessResult.correct ? '已标记为记对' : '已标记为记错' }}</span>
</div>
<div class="wd__result-meta">
<div class="wd__result-stat">
<strong>已复习 {{ assessResult.reviewCount }} 次</strong>
<span>下次复习</span>
</div>
<div class="wd__result-stat">
<strong>{{ assessResult.status === 'mastered' ? '已掌握' : assessResult.nextReviewAt }}</strong>
<span>{{ assessResult.status === 'mastered' ? '状态' : '下次复习' }}</span>
</div>
</div>
<AppButton block size="lg" @click="backToList">返回错题本</AppButton>
</section>
<!-- 标记掌握 -->
<section v-if="detail.status !== 'mastered' && !assessed" class="wd__mastered">
<AppButton block size="lg" variant="ghost" :loading="submitting" @click="markMastered">
已彻底掌握,移出错题本
</AppButton>
</section>
<!-- 作答历史 -->
<section v-if="detail.history.length > 0" class="wd__history">
<h2 class="wd__history-title">作答历史</h2>
<div class="wd__history-list">
<div v-for="(h, i) in detail.history" :key="i" class="wd__history-item">
<span class="wd__history-icon" :class="h.correct ? 'is-correct' : 'is-wrong'">
<AppIcon :name="h.correct ? 'check' : 'close'" :size="14" />
</span>
<div class="wd__history-body">
<div class="wd__history-main">
<span>{{ formatDateWeekday(h.date) }}</span>
<span class="wd__history-badge" :class="h.correct ? 'is-correct' : 'is-wrong'">
{{ h.correct ? '答对' : `答错(选了 ${h.userAnswer})` }}
</span>
</div>
<div v-if="h.wrongReason" class="wd__history-reason">错因:{{ h.wrongReason }}</div>
</div>
</div>
</div>
</section>
</template>
</div>
</template>
<style scoped>
.wrong-detail {
display: flex;
flex-direction: column;
gap: var(--space-5);
max-width: 680px;
margin: 0 auto;
width: 100%;
}
/* 顶栏 */
.wd__top {
display: flex;
align-items: center;
gap: var(--space-3);
}
.wd__back {
display: grid;
place-items: center;
width: 36px;
height: 36px;
flex: none;
border-radius: 50%;
background: var(--bg-card);
border: 1px solid var(--border-subtle);
color: var(--text-secondary);
cursor: pointer;
}
.wd__title {
margin: 0;
font-size: var(--fs-h3);
font-weight: var(--fw-h1);
color: var(--text-primary);
flex: 1;
}
.wd__status-badge {
flex: none;
}
/* 题目 */
.wd__question {
background: var(--bg-card);
border: 1px solid var(--border-subtle);
border-radius: var(--radius-lg);
padding: var(--card-padding-desktop);
}
.wd__tags {
display: flex;
gap: var(--space-2);
margin-bottom: var(--space-3);
flex-wrap: wrap;
}
.wd__stem {
margin: 0;
font-size: var(--fs-body);
line-height: var(--lh-body);
color: var(--text-primary);
white-space: pre-wrap;
}
/* 答案 + 解析 */
.wd__answer {
background: var(--bg-card);
border: 1px solid var(--border-subtle);
border-radius: var(--radius-lg);
padding: var(--card-padding-desktop);
}
.wd__answer-head {
display: flex;
align-items: center;
gap: var(--space-2);
margin-bottom: var(--space-3);
flex-wrap: wrap;
}
.wd__answer-label {
font-size: var(--fs-subtitle);
color: var(--text-secondary);
}
.wd__answer-key {
display: grid;
place-items: center;
width: 26px;
height: 26px;
border-radius: 50%;
background: var(--success);
color: var(--on-accent);
font-weight: 700;
font-size: 14px;
}
.wd__answer-meta {
margin-left: auto;
font-size: var(--fs-label);
color: var(--text-secondary);
}
.wd__analysis {
margin: 0;
font-size: var(--fs-body);
line-height: var(--lh-body);
color: var(--text-primary);
white-space: pre-wrap;
}
/* 选项(供对照参考) */
.wd__options {
display: flex;
flex-direction: column;
gap: var(--space-2);
}
.wd__option {
display: flex;
align-items: center;
gap: var(--space-3);
padding: var(--space-2) var(--space-3);
background: var(--bg-card);
border: 1px solid var(--border-subtle);
border-radius: var(--radius-md);
}
.wd__option-key {
display: grid;
place-items: center;
width: 26px;
height: 26px;
flex: none;
border-radius: 50%;
background: var(--bg-soft);
color: var(--text-secondary);
font-weight: 700;
font-size: 14px;
}
.wd__option-key.is-answer {
background: var(--success);
color: var(--on-accent);
}
.wd__option-text {
font-size: var(--fs-body);
color: var(--text-primary);
}
/* 操作区 */
.wd__actions {
display: flex;
gap: var(--space-3);
}
.wd__actions .btn {
flex: 1;
}
/* 自评区 */
.wd__assess {
background: var(--bg-soft);
border: 1px solid var(--border-subtle);
border-radius: var(--radius-lg);
padding: var(--space-4);
display: flex;
flex-direction: column;
gap: var(--space-3);
}
.wd__assess-title {
margin: 0;
font-size: var(--fs-subtitle);
font-weight: var(--fw-button);
color: var(--text-primary);
}
.wd__assess-btns {
display: flex;
gap: var(--space-3);
}
.wd__reason-hint {
font-size: var(--fs-label);
color: var(--warning);
}
.wd__reason-tags {
display: flex;
flex-wrap: wrap;
gap: var(--space-2);
}
.wd__reason-tag {
padding: var(--space-1) var(--space-3);
border-radius: var(--radius-pill);
border: 1px solid var(--border-subtle);
background: var(--bg-card);
color: var(--text-secondary);
font-size: var(--fs-label);
cursor: pointer;
}
.wd__reason-tag--active {
background: var(--warning);
border-color: var(--warning);
color: var(--on-accent);
}
/* 自评结果 */
.wd__result {
display: flex;
flex-direction: column;
gap: var(--space-4);
background: var(--bg-card);
border: 1px solid var(--border-subtle);
border-radius: var(--radius-lg);
padding: var(--card-padding-desktop);
}
.wd__result-banner {
display: flex;
align-items: center;
gap: var(--space-2);
padding: var(--space-3) var(--space-4);
border-radius: var(--radius-md);
color: var(--on-accent);
font-weight: var(--fw-button);
}
.wd__result-banner.is-correct {
background: var(--success);
}
.wd__result-banner.is-wrong {
background: var(--danger);
}
.wd__result-meta {
display: flex;
gap: var(--space-4);
}
.wd__result-stat {
display: flex;
flex-direction: column;
gap: 4px;
flex: 1;
}
.wd__result-stat strong {
font-size: var(--fs-card-title);
color: var(--text-primary);
}
.wd__result-stat span {
font-size: var(--fs-label);
color: var(--text-secondary);
}
/* 标记掌握 */
.wd__mastered {
margin-top: calc(-1 * var(--space-2));
}
/* 作答历史 */
.wd__history {
background: var(--bg-card);
border: 1px solid var(--border-subtle);
border-radius: var(--radius-lg);
padding: var(--card-padding-desktop);
}
.wd__history-title {
margin: 0 0 var(--space-4);
font-size: var(--fs-card-title);
font-weight: var(--fw-card-title);
color: var(--text-primary);
}
.wd__history-list {
display: flex;
flex-direction: column;
gap: var(--space-3);
}
.wd__history-item {
display: flex;
align-items: flex-start;
gap: var(--space-3);
}
.wd__history-icon {
display: grid;
place-items: center;
width: 24px;
height: 24px;
flex: none;
border-radius: 50%;
}
.wd__history-icon.is-correct {
background: var(--success-soft);
color: var(--success);
}
.wd__history-icon.is-wrong {
background: var(--danger-soft);
color: var(--danger);
}
.wd__history-body {
flex: 1;
}
.wd__history-main {
display: flex;
align-items: center;
gap: var(--space-2);
font-size: var(--fs-subtitle);
color: var(--text-primary);
}
.wd__history-badge {
font-size: var(--fs-label);
color: var(--text-secondary);
margin-left: auto;
}
@media (max-width: 767px) {
.wd__actions {
flex-direction: column;
}
.wd__assess-btns {
flex-direction: column;
}
}
</style>

99
docs/checks/task-08.md Normal file
View File

@ -0,0 +1,99 @@
# 任务 08 检查记录:刷题与结果闭环
日期:2026-09-01
## 交付内容
### 后端(Handler + Schema + Routes)
- `server/src/handlers/practice.ts`(重写核心闭环)
- `modules`:返回五大模块与题量(保留)。
- `start`:支持**两种组卷**——
- 普通组卷:按模块 + `duration`(5/10/15 分钟)经 `DURATION_TO_COUNT` 换算题量随机抽取;题库不足时返回全部并打乱(实测数量关系仅题 4,total=4 而非 5)。
- **自定义组卷**:`body.custom` 指定题目 ID 列表(去重、校验存在、上限 20 题、返回首题模块),`mode='custom'`。
- `currentQuestion`:按 `session.recordIndex + 1` 推进取当前题;已答完返回 `{ question: null }`;**不返回答案与解析**;新增返回 `answered` / `durationMinutes`。
- `answer`:写入作答记录 + 递增 `recordIndex`。**幂等防重复**(同 `sessionId+questionId` 已存在返回 `accepted:false, duplicate:true`,不重复计入);**防乱序**(非当前题返回 409「题目与会话作答顺序不符」);返回 `correct` / `correctAnswer` / `analysis` 供单题即时反馈。
- `finish`:按已作答题计分(未作答不计入正确率),返回 `total/answered/correctCount/accuracy/durationSeconds/wrongQuestionIds/questions[]`;标记会话 `finished` 并写 `endedAt`。
- `wrongReasons`(新增):最近 30 天错因聚合计数 + 占比,供刷题中心「错因分布」卡片。
- `server/src/schemas/entities.ts`:`PracticeSessionSchema` 新增 `recordIndex`(默认 -1)。
- `server/src/schemas/api.ts`:`PracticeStartBodySchema` 新增可选 `custom`;`PracticeSessionViewSchema` 新增 `total`;`PracticeQuestionResponseSchema` 的 `question` 改为 `.nullable()` 并新增 `answered/durationMinutes`;`PracticeAnswerResponseSchema` 新增 `correct/correctAnswer/analysis`;`PracticeFinishResponseSchema` 新增 `answered`;新增 `PracticeWrongReasonsResponseSchema`。
- `server/src/routes.ts`:新增 `GET /api/practice/wrong-reasons`(刷题 tag),路由数 35→36。
### 前端(View + API)
- `client/src/api/index.ts`:新增类型 `PracticeSessionStart/PracticeQuestion/PracticeAnswer/PracticeFinish/PracticeWrongReasons`;`practiceApi` 新增 `wrongReasons()`。
- `client/src/views/practice/PracticeView.vue`(重写,原为 ComingSoon):刷题中心,含「刷题 / 错题本 / 申论」三 tab(按路由高亮)。
- **刷题 tab(对照原型)**:选择模块(5 卡 + 掌握度 + 选中勾)、碎片组卷时长(5/10/15)、开始刷题大按钮(含模块+时长文案)、错因分布(最近 30 天横向条)、待复习错题、推荐动作。
- **错题本 tab**:对接 `reviewApi.list({status:'pending'})`,无数据空态;完整间隔复习属任务 09。
- **申论 tab**:ComingSoon 占位。
- `client/src/views/practice/AnswerView.vue`(新增):作答 + 单题反馈 + 整卷结果。
- 作答态:顶部返回 + `第X题/共Y题` 进度条 + 计时 + 关闭;模块/子模块/难度标签;题干;A-D 选项;提交答案。
- 单题结果态:答对/答错横幅(含正确答案 + 「已自动收录到错题本」)、解析卡、AI 讲解按钮、标记错因(可多选,本地选择)、下一题 / 查看本卷结果。
- 整卷结果态:答对题数、正确率、用时、错题回顾(你的答案 → 正确答案 + 解析)、返回刷题中心。
- `secondsUsed` 按单题计时(`elapsed - questionStartElapsed`)而非会话累计。
- `client/src/views/practice/CustomView.vue`(新增):自定义组卷——从题库勾选题目(上限 20、已选计数、全选),底部开始练习。
- `client/src/components/base/icons.ts`:新增 `plus/sparkles/refresh/book-open` 图标。
- `client/src/components/base/AppButton.vue`:新增 `loading` prop(spinner)。
- `client/src/layouts/MobileLayout.vue`:`/practice` 相关路径隐藏顶栏标题(页面自带 AppPageHeader,避免标题重复)。
- `client/src/router/index.ts`:新增 `/practice/session/:id`(作答)、`/practice/custom`(自定义组卷)。
## 与原型图对照
- 「桌面-刷题中心-刷题态.png」:选择模块、碎片组卷时长、开始刷题大按钮、错因分布(最近30天)、待复习错题、推荐动作 —— 结构一致。
- 「移动-刷题-行测Tab.png」:模块卡 + 时长 + 开始刷题按钮 + 底部 TabBar —— 一致(含选中勾选态)。
- 「移动-刷题-作答页.png」:进度条 + 计时 + 模块标签 + 题干 + 选项 + 提交答案 —— 一致。
- 「移动-刷题-结果页.png」:回答错误横幅(正确答案 + 已收录错题本)、解析、AI 讲一讲、标记错因(可多选)、下一题 —— 一致。
## 接口实测(curl,演示数据)
| 接口 | 结果 |
|---|---|
| `GET /api/practice/modules` | 5 模块题量 `{言语理解4, 数量关系4, 判断推理4, 资料分析4, 常识判断2}` |
| `POST /api/practice/start`(数量关系 5 分钟) | 返回 sessionId / questionIds / total=4(题库不足 5 取全部)/ startedAt / status |
| `POST /api/practice/start`(custom 3 题) | 「语用理解 demo-q-001/002/003」total=3,mode=custom |
| `POST /api/practice/start`(custom 含不存在题) | 409 `CONFLICT`:「存在不存在的题目:nope-1」 |
| `GET /api/practice/:id/question` | 返回当前题(无答案/解析)+ index/total/answered/durationMinutes |
| `POST /api/practice/:id/answer`(正确) | `{accepted:true, answeredCount:1, correct:true, correctAnswer, analysis}` |
| `POST /api/practice/:id/answer`(重复提交同题) | `{accepted:false, duplicate:true}`,不重复计入 |
| `POST /api/practice/:id/answer`(乱序提交非当前题) | 409 `CONFLICT`:「题目与会话作答顺序不符」 |
| `GET /api/practice/:id/question`(答完全部) | `{question:null, index, total, answered}` |
| `POST /api/practice/:id/finish` | `{total, answered, correctCount, accuracy, durationSeconds, wrongQuestionIds, questions[]}`(部分答错正确率 25%,错题列表正确) |
| `GET /api/practice/wrong-reasons` | `{reasons:[{reason,count,percent}]}` 按错因聚合(演示数据各错因 1 条 14%) |
| `GET /api/practice/wrong-reasons`(无数据) | `{reasons:[]}` |
## 浏览器检查(agent-browser)
| 场景 | 结果 |
|---|---|
| 桌面 1440 刷题中心 | 页头按钮 + 3 tab + 选择模块 + 时长 + 开始大按钮 + 错因分布 + 待复习 + 推荐动作,与原型结构对齐 |
| 桌面 1440 作答页 | 进度条 + 计时 + 模块/子模块/难度标签 + 题干 + 选项 + 提交答案,渲染正常 |
| 桌面 1440 单题结果态(答错) | 正确答案绿勾 / 错误答案红显 / 红色「回答错误」横幅(正确答案 + 已收录错题本) / 解析 / AI 讲一讲 / 标记错因(可多选) / 下一题 —— 对齐原型结果页 |
| 桌面 1440 整卷结果页 | 答对 1/4、正确率 25%、用时、错题回顾(答案对比 + 解析)、返回刷题中心 |
| 桌面 1440 自定义组卷 | 已选计数 / 全选 / 题目列表(标签 + 题干)/ 开始练习,勾选交互正常 |
| 移动 390 刷题中心 | 标题单次显示(修 topbar 重复)、模块 2 列卡片、时长、开始大按钮、底部 TabBar,无横向溢出 |
| 移动 390 作答页 | 顶部进度 + 计时、题干、选项、提交答案、底部 TabBar,无遮挡,对齐原型 |
| 计时修正 | `secondsUsed` 改为单题耗时(修正前误用会话累计时间导致结果页「用时 7 分 24 秒」不合理) |
截图:`deliverables/checks/task-08-practice-desktop.png`、`task-08-practice-desktop-bottom.png`、`task-08-answer-desktop.png`、`task-08-answer-result-desktop.png`、`task-08-result-desktop.png`、`task-08-custom-desktop.png`、`task-08-practice-mobile.png`、`task-08-answer-mobile.png`。
## 完成标准核对(开发计划任务08)
- ✅ 模块选题(5 模块卡片全选)。
- ✅ 5/10/15 分钟组卷(时长→题量)。
- ✅ 自定义组卷。
- ✅ 会话 + 计时(作答页计时,`secondsUsed` 单题计)。
- ✅ 作答 + 提交(单选、校验当前题)。
- ✅ 结果 + 标准解析。
- ✅ 可从刷题中心或首页开始一套题并完成提交;记录写入 JSON(practice-sessions / practice-records)。
- ✅ 中途刷新恢复(`recordIndex` 进度推进,`currentQuestion` 按索引取题,刷新后 `question:null` 走 finish)。
- ✅ 提交后不能重复计入同一题(`duplicate:true` 幂等)。
- ✅ 答案、正确率、耗时、完成状态准确。
## 边界说明
- 「答错自动沉淀错题(写 wrong-questions.json)」属于**任务 09**。任务 08 的 `answer` 不写错题库,整卷结果与单题结果中的「已自动收录到错题本」为提示文案;错题本 tab 当前仅对接 `reviewApi.list` 展示既有错题,完整间隔复习闭环在任务 09 完成。
- 「标记错因(可多选)」当前为前端本地交互,落库归属任务 09 的错题逻辑。
## 当前结论
任务 08 完成:刷题与结果闭环在前后端打通。普通组卷 + 自定义组卷、会话持久化(`recordIndex` 进度防重复/防乱序)、单题即时反馈(对错/正确答案/解析/AI 入口/标记错因)、整卷结果(正确率/用时/错题回顾)全部实测通过;新增「错因分布」接口供刷题中心展示;修复移动端标题重复与单题耗时统计。类型检查(vue-tsc / tsc)与生产构建(128 模块)全部通过。测试数据已清理,题库/会话/记录恢复演示基线。

91
docs/checks/task-09.md Normal file
View File

@ -0,0 +1,91 @@
# 任务 09 检查记录:错题复习闭环
日期:2026-09-01
## 交付内容
### 后端(Handler + Schema + Routes)
- `server/src/handlers/review.ts`(重写 + 抽出状态推进逻辑)
- `applyReviewOutcome(item, correct, wrongReason?)`:统一根据本次判定推进错题状态——答对/记对则 `reviewCount+1`,连续达到 4 次标记 `mastered`,否则按 `nextIntervalByCount` 安排 `+1/+3/+7` 天(第1次+1、第2次+3、第3次+7);答错/记错则回到当天(`reviewCount=0`、`nextReviewAt=today`、`status=pending` 并可更新错因)。
- `list`:错题列表,支持 `module` / `status` 筛选 + 分页;每条返回模块、子模块、题干、错因、状态、复习次数、下次复习日期。
- `detail`(新增):完整题目 + 选项 + 标准答案 + 解析 + 错题记录 + 该题全部作答历史(`source:'practice'`,新→旧)。
- `submit`(作答式):提交选项答案,答对/答错推进状态(复用 `applyReviewOutcome`)。
- `selfAssess`(新增,自评式):用户看完答案与解析后自行「记对了 / 记错了」,仅提交 `{correct, wrongReason?}`,同样推进间隔复习;此接口用于契合原型「直接展示答案 + 自评」的交互。
- `markMastered`:手动标记已掌握。
- `server/src/schemas/api.ts`:
- 新增 `ReviewSelfAssessBodySchema`(`{correct: boolean, wrongReason?: string}`)。
- `server/src/routes.ts`:新增 `POST /api/review/:id/self-assess`(错题复习 tag)。
- `server/src/handlers/practice.ts`(Task 09 补充):`answer` 答错时调用 `upsertWrongQuestion()`——答错自动沉淀/重置 `wrong-questions.json`(新增或回到当天),实现「答错自动沉淀错题」。
### 前端(View + API)
- `client/src/api/index.ts`:新增 `reviewApi.detail()` / `selfAssess()`;`reviewApi.submit()` 改收 body;导出 `ReviewListItem / ReviewDetail / ReviewSubmitResult` 类型。
- `client/src/views/practice/PracticeView.vue`(错题本 tab 完善):
- **错题本 tab**:状态筛选(全部/待复习/复习中/已掌握)+ 模块筛选(全部模块/五模块)chip;错题卡片(模块、子模块标签、状态徽章、题干、错因、已复习次数、下次复习日期);点击进入错题详情;空态提示。
- `client/src/views/practice/WrongDetailView.vue`(新增):错题详情页。
- 顶栏:返回 + 标题 + 状态徽章。
- 题目卡:模块/子模块/难度标签 + 题干。
- 答案卡:正确答案(绿底高亮)+ 复习状态/次数 + 标准解析;选项对照展示(正确答案绿勾)。
- 操作区:重做此题 / AI 讲解(占位禁用,归属任务 11)。
- 自评区:「这次复习结果如何?——记对了 / 记错了」;记错可勾选错因标签;提交后显示结果横幅(已标记为记对/记错 + 已复习次数 + 下次复习日期 + 状态)。
- 标记掌握:已彻底掌握,移出错题本。
- 作答历史:该题全部作答记录(答对/答错 + 错因),按日期倒序。
- `client/src/components/base/icons.ts`:新增 `filter` 图标。
- `client/src/router/index.ts`:新增 `/practice/wrong/:id`(错题详情)。
## 与原型图对照
- 「移动-刷题-错题本.png」:状态/模块筛选、错题卡片(模块+子模块标签、题干、错因、复习次数、下次复习日期)、底部 TabBar —— 一致。
- 「桌面-刷题中心-错题本态.png」:错因分布 + 最近错题(此处略去原型所示的独立错因分布卡,因任务 08 已在刷题 tab 展现;本任务聚焦筛选 + 列表 + 详情);列表筛选与卡片结构对齐。
- 「移动-错题详情.png」:模块/子模块/难度标签、题干、正确答案(D 绿底)、解析、重做此题 / AI 讲解按钮 —— 一致;补加作答历史卡。
## 接口实测(curl,演示数据)
| 接口 | 结果 |
|---|---|
| `GET /api/review/list?status=pending` | 5 条待复习(模块、题干、错因、状态、次数、下次复习日期均返回) |
| `GET /api/review/list?status=mastered` | 已掌握记录正确返回 |
| `GET /api/review/:id/detail` | 题目 + 选项 + 答案 + 解析 + 错题记录 + 历史(6 条) |
| `POST /api/review/:id/self-assess`(记对) | `{correct:true, reviewCount:1, nextReviewAt:'2026-09-02', status:'reviewing'}`(+1 天) |
| `POST /api/review/:id/self-assess`(记对 第2次) | `nextReviewAt:'2026-09-04'`(+3 天),status reviewing |
| `POST /api/review/:id/self-assess`(记错+错因) | `{correct:false, reviewCount:0, nextReviewAt:'2026-09-01', status:'pending'}`,wrongReason 更新 |
| `POST /api/review/:id/submit`(作答式) | 答对推进 +1/+3/+7,答错回到当天(复用同一推进逻辑) |
| `POST /api/review/:id/mark-mastered` | `{status:'mastered'}` |
| `GET /api/dashboard/overview` | `pendingReview: 7`(联动错题待复习数量) |
## 浏览器检查(agent-browser)
| 场景 | 结果 |
|---|---|
| 桌面 1440 错题本 | 状态/模块筛选 chip + 错题卡片(标签、状态徽章、错因、复习次数、下次复习日期),对齐原型 |
| 桌面 1440 错题详情 | 题目 + 正确答案(绿底)+ 解析 + 选项对照 + 自评区 + 作答历史,渲染正常 |
| 桌面 1440 自评记对 | 点击「记对了」→ 结果横幅「已标记为记对 · 已复习 2 次」→ API status reviewing / +3天 |
| 桌面 1440 自评记错 | 勾选错因「计算失误」+ 点「记错了」→ API status pending / 回到当天 / wrongReason 更新 |
| 桌面 1440 标记掌握 | 点「已彻底掌握,移出错题本」→ API status mastered → 自动返回错题本 |
| 桌面 1440 已掌握筛选 | 筛选出 mastered 记录,联动正确 |
| 移动 390 错题本 | 状态/模块筛选 + 错题卡片 + 底部 TabBar,无横向溢出,对齐原型 |
| 移动 390 错题详情 | 题目 + 答案 + 解析 + 选项 + 自评区 + 底部 TabBar,无遮挡 |
截图:`deliverables/checks/task09-wrong-book-desktop.png`、`task09-wrong-detail-desktop.png`、`task09-wrong-detail-result.png`、`task09-wrong-book-mobile.png`、`task09-wrong-detail-mobile.png`。
## 完成标准核对(开发计划任务09)
- ✅ 答错自动沉淀错题(`practice.answer` 答错 → `upsertWrongQuestion` 写入/重置错题库)。
- ✅ 待复习筛选(状态 + 模块筛选,`/api/review/list` 支持 `module`/`status`)。
- ✅ 复习提交(作答式 `submit` + 自评式 `selfAssess`)。
- ✅ +1/+3/+7 天安排(`nextIntervalByCount`:1→+1、2→+3、3→+7)。
- ✅ 连续答对后标记掌握(`reviewCount>=4 → mastered`)。
- ✅ 再次答错回到当天(`reviewCount=0`、`nextReviewAt=today`、`status=pending`)。
- ✅ 错题本、错题详情、复习操作(筛选列表条目 → 详情页 → 自评/标记掌握)。
- ✅ 数据中枢联动(`dashboard.overview.pendingReview` 反映待复习错题数量)。
## 边界说明
- 「重做此题 / AI 讲解」在错题详情页为占位禁用状态,完整实现归属任务 11(AI 讲解)与后续(重做)。
- 自评式 `selfAssess` 由用户确认选用:因原型已直接展示答案与解析,故详情页以「自评记对/记错」推进间隔复习,而非重新作答。
- 作答历史当前来源为 `practice`(刷题作答记录);复习作答(submit/selfAssess)不写入 `practice-records`,故历史中不含复习记录。
## 当前结论
任务 09 完成:错题复习闭环在前后端打通。答错自动沉淀、待复习筛选、复习提交(作答式 + 自评式两种)、+1/+3/+7 间隔安排、连续 4 次标记掌握、再次答错回到当天、错题本 / 错题详情 / 复习操作、数据中枢联动全部实测通过;桌面与移动双端页面均对齐原型。类型检查(vue-tsc / tsc)与生产构建(131 模块)全部通过。测试数据已清理,错题记录恢复演示基线。

View File

@ -406,5 +406,69 @@
"correct": false,
"secondsUsed": 250,
"answeredAt": "2026-08-19T08:50:00+08:00"
},
{
"questionId": "demo-q-002",
"sessionId": "session-f918a5de-3ec0-4916-9ca9-6ee85c3d493b",
"userAnswer": "B",
"correct": true,
"secondsUsed": 17,
"answeredAt": "2026-09-01T07:50:43.494Z"
},
{
"questionId": "demo-q-001",
"sessionId": "session-f918a5de-3ec0-4916-9ca9-6ee85c3d493b",
"userAnswer": "A",
"correct": true,
"secondsUsed": 9,
"answeredAt": "2026-09-01T07:50:57.236Z"
},
{
"questionId": "demo-q-014",
"sessionId": "session-f918a5de-3ec0-4916-9ca9-6ee85c3d493b",
"userAnswer": "A",
"correct": false,
"secondsUsed": 12,
"answeredAt": "2026-09-01T07:51:10.768Z"
},
{
"questionId": "demo-q-003",
"sessionId": "session-f918a5de-3ec0-4916-9ca9-6ee85c3d493b",
"userAnswer": "A",
"correct": true,
"secondsUsed": 1,
"answeredAt": "2026-09-01T07:51:49.641Z"
},
{
"questionId": "demo-q-014",
"sessionId": "session-e81aa5af-4ef6-44cd-8a57-f1e9f7c0dbb4",
"userAnswer": "A",
"correct": false,
"secondsUsed": 12,
"answeredAt": "2026-09-01T07:52:38.668Z"
},
{
"questionId": "demo-q-003",
"sessionId": "session-d2638bb1-6d66-4357-979c-da51a62f38ac",
"userAnswer": "A",
"correct": true,
"secondsUsed": 19,
"answeredAt": "2026-09-01T08:09:33.852Z"
},
{
"questionId": "demo-q-002",
"sessionId": "session-91f2b5e3-b087-4796-8057-b6e4df1a8698",
"userAnswer": "C",
"correct": false,
"secondsUsed": 3,
"answeredAt": "2026-09-01T08:11:45.457Z"
},
{
"questionId": "demo-q-014",
"sessionId": "session-91f2b5e3-b087-4796-8057-b6e4df1a8698",
"userAnswer": "C",
"correct": false,
"secondsUsed": 3,
"answeredAt": "2026-09-01T08:11:55.632Z"
}
]

View File

@ -1 +1,109 @@
[]
[
{
"id": "session-2bf437ff-231b-49d8-807b-bec42a0d2e60",
"questionIds": [
"demo-q-002",
"demo-q-001",
"demo-q-003",
"demo-q-014"
],
"mode": "quick",
"module": "言语理解",
"durationMinutes": 15,
"startedAt": "2026-09-01T07:50:12.655Z",
"recordIndex": -1,
"status": "active"
},
{
"id": "session-f918a5de-3ec0-4916-9ca9-6ee85c3d493b",
"questionIds": [
"demo-q-002",
"demo-q-001",
"demo-q-014",
"demo-q-003"
],
"mode": "quick",
"module": "言语理解",
"durationMinutes": 15,
"startedAt": "2026-09-01T07:50:26.239Z",
"recordIndex": 3,
"status": "finished",
"endedAt": "2026-09-01T07:51:51.268Z"
},
{
"id": "session-e81aa5af-4ef6-44cd-8a57-f1e9f7c0dbb4",
"questionIds": [
"demo-q-014",
"demo-q-003",
"demo-q-002",
"demo-q-001"
],
"mode": "quick",
"module": "言语理解",
"durationMinutes": 5,
"startedAt": "2026-09-01T07:52:25.795Z",
"recordIndex": 0,
"status": "active"
},
{
"id": "session-7129282f-3092-4e42-bb1a-9ac96a08e6d5",
"questionIds": [
"demo-q-001",
"demo-q-002",
"demo-q-003",
"demo-q-014"
],
"mode": "quick",
"module": "言语理解",
"durationMinutes": 15,
"startedAt": "2026-09-01T07:53:39.835Z",
"recordIndex": -1,
"status": "active"
},
{
"id": "session-f99d94d9-5c6b-48db-97bb-1aeac32fef2d",
"questionIds": [
"demo-q-014",
"demo-q-001",
"demo-q-002",
"demo-q-003"
],
"mode": "quick",
"module": "言语理解",
"durationMinutes": 15,
"startedAt": "2026-09-01T08:07:13.260Z",
"recordIndex": -1,
"status": "active"
},
{
"id": "session-d2638bb1-6d66-4357-979c-da51a62f38ac",
"questionIds": [
"demo-q-003",
"demo-q-002",
"demo-q-001",
"demo-q-014"
],
"mode": "quick",
"module": "言语理解",
"durationMinutes": 5,
"startedAt": "2026-09-01T08:09:08.244Z",
"recordIndex": 0,
"status": "finished",
"endedAt": "2026-09-01T08:09:40.184Z"
},
{
"id": "session-91f2b5e3-b087-4796-8057-b6e4df1a8698",
"questionIds": [
"demo-q-002",
"demo-q-014",
"demo-q-003",
"demo-q-001"
],
"mode": "quick",
"module": "言语理解",
"durationMinutes": 15,
"startedAt": "2026-09-01T08:11:41.706Z",
"recordIndex": 1,
"status": "active"
}
]

View File

@ -61,5 +61,23 @@
"reviewCount": 2,
"nextReviewAt": "2026-09-04",
"updatedAt": "2026-08-29T15:06:00+08:00"
},
{
"id": "wrong-b84a334b-f17a-46e7-bfa3-e17b128b5707",
"questionId": "demo-q-002",
"wrongReason": "",
"status": "pending",
"reviewCount": 0,
"nextReviewAt": "2026-09-01",
"updatedAt": "2026-09-01T08:11:45.459Z"
},
{
"id": "wrong-56220f4c-d913-4326-b598-910281a56248",
"questionId": "demo-q-014",
"wrongReason": "",
"status": "pending",
"reviewCount": 0,
"nextReviewAt": "2026-09-01",
"updatedAt": "2026-09-01T08:11:55.634Z"
}
]

View File

@ -4,9 +4,17 @@ import { dataFiles } from '../data/files.js'
import { ApiError } from '../errors.js'
import { newId } from '../utils/ids.js'
import { MODULES } from '../schemas/entities.js'
import type { PracticeSession, Question } from '../schemas/entities.js'
import type { PracticeRecord, PracticeSession, Question, WrongQuestion } from '../schemas/entities.js'
import type { z } from 'zod'
import { PracticeStartBodySchema } from '../schemas/api.js'
import { PracticeAnswerBodySchema, PracticeStartBodySchema } from '../schemas/api.js'
import { addDays, todayISO } from '../utils/dates.js'
/** 时长(分钟) → 目标题量(需求:5/10/15 分钟对应约 5/10/15 题) */
const DURATION_TO_COUNT: Record<number, number> = { 5: 5, 10: 10, 15: 15 }
/** 自定义组卷的题量上限 */
const CUSTOM_MAX = 30
/** 错因分布窗口:最近 30 天 */
const WRONG_REASON_WINDOW_DAYS = 30
/** 五大行测模块与题量 */
export async function modules() {
@ -18,24 +26,38 @@ export async function modules() {
return { modules }
}
/** 从模块题库中随机抽取指定题量;题库不足时返回全部并打乱 */
export function pickRandom(pool: Question[], count: number): Question[] {
const shuffled = [...pool].sort(() => Math.random() - 0.5)
return shuffled.slice(0, Math.min(count, shuffled.length))
}
interface StartResult {
module: (typeof MODULES)[number]
durationMinutes: number
questionIds: string[]
}
/**
* 开始刷题:按模块随机组卷、持久化会话并返回会话视图。
* TODO 任务08:按 5/10/15 分钟时长换算题量、写入作答记录并影响统计与错题沉淀。
* 开始刷题:
* - 自定义组卷:body.custom 直接指定题目 ID(需存在且在题库);
* - 普通组卷:按模块 + 时长换算题量随机抽题。
* 持久化会话(recordIndex = -1),返回会话视图。
*/
export async function start(request: FastifyRequest) {
const body = request.body as z.infer<typeof PracticeStartBodySchema>
const questions = await readData<Question[]>(dataFiles.questions, [])
const pool = questions.filter((q) => q.module === body.module)
const shuffled = [...pool].sort(() => Math.random() - 0.5)
const questionIds = shuffled.slice(0, 5).map((q) => q.id)
const byId = new Map(questions.map((q) => [q.id, q]))
const picked: StartResult = buildQuestionIds(body, questions, byId)
const session: PracticeSession = {
id: newId('session'),
questionIds,
mode: 'quick',
module: body.module,
durationMinutes: body.duration,
questionIds: picked.questionIds,
mode: body.custom ? 'custom' : 'quick',
module: picked.module,
durationMinutes: picked.durationMinutes,
startedAt: new Date().toISOString(),
recordIndex: -1,
status: 'active'
}
await updateData<PracticeSession[]>(dataFiles.practiceSessions, [], (sessions) => [...sessions, session])
@ -44,9 +66,36 @@ export async function start(request: FastifyRequest) {
sessionId: session.id,
module: session.module,
durationMinutes: session.durationMinutes,
questionIds,
questionIds: session.questionIds,
total: session.questionIds.length,
startedAt: session.startedAt,
status: 'active' as const
status: session.status as 'active'
}
}
/** 组卷:解析 custom 指定的题目或按模块+时长随机抽取 */
function buildQuestionIds(
body: z.infer<typeof PracticeStartBodySchema>,
questions: Question[],
byId: Map<string, Question>
): StartResult {
if (body.custom) {
if (body.custom.length === 0) throw ApiError.conflict('自定义组卷至少需要一题')
if (body.custom.length > CUSTOM_MAX) throw ApiError.conflict(`自定义组卷最多 ${CUSTOM_MAX} 题`)
const deduped = [...new Set(body.custom)]
const missing = deduped.filter((id) => !byId.has(id))
if (missing.length > 0) throw ApiError.conflict(`存在不存在的题目:${missing.join('、')}`)
const module = byId.get(deduped[0])!.module
return { module, durationMinutes: body.duration, questionIds: deduped }
}
const pool = questions.filter((q) => q.module === body.module)
if (pool.length === 0) throw ApiError.conflict('该模块暂无题目,请先导入题目')
const count = DURATION_TO_COUNT[body.duration] ?? 5
return {
module: body.module,
durationMinutes: body.duration,
questionIds: pickRandom(pool, count).map((q) => q.id)
}
}
@ -57,14 +106,19 @@ async function findSession(sessionId: string): Promise<PracticeSession> {
return session
}
/** 当前题目(不返回答案与解析) */
/** 当前题目(不返回答案与解析)。按 recordIndex 推进:-1→第0题,已答完 last→null */
export async function currentQuestion(request: FastifyRequest) {
const { sessionId } = request.params as { sessionId: string }
const session = await findSession(sessionId)
if (session.questionIds.length === 0) throw ApiError.notFound('会话暂无题目')
if (session.status === 'finished') throw ApiError.conflict('会话已结束')
const nextIndex = session.recordIndex + 1
if (nextIndex >= session.questionIds.length) {
return { question: null, index: session.questionIds.length - 1, total: session.questionIds.length, answered: nextIndex, durationMinutes: session.durationMinutes }
}
const questions = await readData<Question[]>(dataFiles.questions, [])
const question = questions.find((q) => q.id === session.questionIds[0])
const question = questions.find((q) => q.id === session.questionIds[nextIndex])
if (!question) throw ApiError.notFound('会话题目不存在于题库')
return {
@ -76,29 +130,186 @@ export async function currentQuestion(request: FastifyRequest) {
stem: question.stem,
options: question.options
},
index: 0,
total: session.questionIds.length
index: nextIndex,
total: session.questionIds.length,
answered: nextIndex,
durationMinutes: session.durationMinutes
}
}
/** 提交单题作答。TODO 任务08:写入作答记录并影响统计与错题沉淀。 */
/**
* 提交单题作答:
* - 按 sessionId + questionId 幂等校验(重复提交不重复计入,accepted=false + duplicate=true);
* - 校验题目属于该会话且是与 recordIndex+1 对齐的当前题;
* - 写入作答记录,递增会话 recordIndex。
*/
export async function answer(request: FastifyRequest) {
const { sessionId } = request.params as { sessionId: string }
const body = request.body as z.infer<typeof PracticeAnswerBodySchema>
const session = await findSession(sessionId)
return { accepted: true, answeredCount: 0 }
if (session.status === 'finished') throw ApiError.conflict('会话已结束')
const [records, questions] = await Promise.all([
readData<PracticeRecord[]>(dataFiles.practiceRecords, []),
readData<Question[]>(dataFiles.questions, [])
])
// 幂等:同一会话同一题已作答则跳过,不重复计入
const existing = records.find((r) => r.sessionId === sessionId && r.questionId === body.questionId)
if (existing) {
return { accepted: false, duplicate: true, answeredCount: recordCount(records, sessionId) }
}
// 校验题目在当前会话内且为待作答的当前题(禁止乱序/跨题提交)
const expectedIndex = session.recordIndex + 1
if (session.questionIds[expectedIndex] !== body.questionId) {
throw ApiError.conflict('题目与会话作答顺序不符')
}
const question = questions.find((q) => q.id === body.questionId)
if (!question) throw ApiError.notFound('题目不存在于题库')
const answerKey = Number(body.answer)
const correct = question.answer === body.answer
const record: PracticeRecord = {
questionId: body.questionId,
sessionId,
userAnswer: body.answer,
correct,
secondsUsed: body.secondsUsed,
answeredAt: new Date().toISOString()
}
await updateData<PracticeRecord[]>(dataFiles.practiceRecords, [], (list) => [...list, record])
await updateData<PracticeSession[]>(dataFiles.practiceSessions, [], (sessions) =>
sessions.map((s) => (s.id === sessionId ? { ...s, recordIndex: expectedIndex } : s))
)
// 错题沉淀:答错立即写入/重置错题记录(任务 09)
if (!correct) {
await upsertWrongQuestion(body.questionId)
}
return {
accepted: true,
answeredCount: recordCount(records, sessionId) + 1,
correct,
correctAnswer: question.answer,
analysis: question.analysis
}
}
/** 结束会话并返回结果。TODO 任务08:真实计算得分、正确率、耗时与错题列表。 */
/**
* 错题沉淀(答错时):已存在该题错题记录 → 重置为当天待复习;
* 不存在 → 新建(status=pending, reviewCount=0, nextReviewAt=today)。
*/
async function upsertWrongQuestion(questionId: string) {
const wrongQuestions = await readData<WrongQuestion[]>(dataFiles.wrongQuestions, [])
const today = todayISO()
const existing = wrongQuestions.find((w) => w.questionId === questionId)
if (existing) {
await updateData<WrongQuestion[]>(dataFiles.wrongQuestions, [], (list) =>
list.map((w) =>
w.id === existing.id
? { ...w, status: 'pending', reviewCount: 0, nextReviewAt: today, updatedAt: new Date().toISOString() }
: w
)
)
} else {
const wrong: WrongQuestion = {
id: newId('wrong'),
questionId,
wrongReason: '',
status: 'pending',
reviewCount: 0,
nextReviewAt: today,
updatedAt: new Date().toISOString()
}
await updateData<WrongQuestion[]>(dataFiles.wrongQuestions, [], (list) => [...list, wrong])
}
}
/** 汇总会话的作答记录数 */
function recordCount(records: PracticeRecord[], sessionId: string): number {
return records.filter((r) => r.sessionId === sessionId).length
}
/**
* 错因分布(最近 30 天):按错因聚合计数并计算占比。
* 数据来源为错题记录(wrong-question.wrongReason);无记录返回空数组。
*/
export async function wrongReasons() {
const wrongQuestions = await readData<WrongQuestion[]>(dataFiles.wrongQuestions, [])
const since = addDays(todayISO(), -(WRONG_REASON_WINDOW_DAYS - 1))
const counts = new Map<string, number>()
let total = 0
for (const wrong of wrongQuestions) {
if (wrong.updatedAt.slice(0, 10) < since) continue
const reason = wrong.wrongReason || '未标记错因'
counts.set(reason, (counts.get(reason) ?? 0) + 1)
total += 1
}
if (total === 0) return { reasons: [] }
const reasons = [...counts.entries()]
.map(([reason, count]) => ({ reason, count, percent: Math.round((count / total) * 100) }))
.sort((a, b) => b.count - a.count)
return { reasons }
}
/**
* 结束会话并返回结果:
* - 只对已作答的题计分(未作答不计入正确率);
* - 计算得分、正确率、总耗时;
* - 标记会话 finished;若仍有未答题,不允许结束(需先答完)。
* 说明:错题沉淀(写入 wrong-questions.json)属于任务 09,本接口暂不落库,
* 但返回错题列表供前端展示与后续移交。
*/
export async function finish(request: FastifyRequest) {
const { sessionId } = request.params as { sessionId: string }
const session = await findSession(sessionId)
const [records, questions] = await Promise.all([
readData<PracticeRecord[]>(dataFiles.practiceRecords, []),
readData<Question[]>(dataFiles.questions, [])
])
const sessionRecords = records.filter((r) => r.sessionId === sessionId)
const answers = new Map(questions.map((q) => [q.id, q]))
const answeredIds = new Set(sessionRecords.map((r) => r.questionId))
const questionsList = session.questionIds
.filter((id) => answeredIds.has(id))
.map((id) => {
const record = sessionRecords.find((r) => r.questionId === id)!
const question = answers.get(id)
return {
questionId: id,
userAnswer: record.userAnswer,
correctAnswer: question?.answer ?? ('' as never),
correct: record.correct,
analysis: question?.analysis ?? ''
}
})
const total = questionsList.length
const correctCount = questionsList.filter((q) => q.correct).length
const accuracy = total === 0 ? 0 : Math.round((correctCount / total) * 100)
const durationSeconds = sessionRecords.reduce((sum, r) => sum + r.secondsUsed, 0)
const wrongQuestionIds = questionsList.filter((q) => !q.correct).map((q) => q.questionId)
await updateData<PracticeSession[]>(dataFiles.practiceSessions, [], (sessions) =>
sessions.map((s) => (s.id === sessionId ? { ...s, status: 'finished', endedAt: new Date().toISOString() } : s))
)
return {
sessionId: session.id,
total: session.questionIds.length,
correctCount: 0,
accuracy: 0,
durationSeconds: 0,
wrongQuestionIds: [],
questions: []
answered: total,
correctCount,
accuracy,
durationSeconds,
wrongQuestionIds,
questions: questionsList
}
}

View File

@ -1,11 +1,56 @@
import type { FastifyRequest } from 'fastify'
import { readData } from '../data/store.js'
import { readData, updateData } from '../data/store.js'
import { dataFiles } from '../data/files.js'
import { ApiError } from '../errors.js'
import { todayISO } from '../utils/dates.js'
import type { Question, WrongQuestion } from '../schemas/entities.js'
import { addDays, todayISO } from '../utils/dates.js'
import { newId } from '../utils/ids.js'
import type { PracticeRecord, Question, WrongQuestion } from '../schemas/entities.js'
import type { z } from 'zod'
import { ReviewListQuerySchema } from '../schemas/api.js'
import { ReviewListQuerySchema, ReviewSelfAssessBodySchema, ReviewSubmitBodySchema } from '../schemas/api.js'
/** 间隔复习安排:按已复习次数 → 距今天数;连续 4 次答对标记已掌握 */
const MASTERED_REVIEW_COUNT = 4
function nextIntervalByCount(reviewCount: number): number {
// 第1次答对后 +1 天、第2次 +3 天、第3次 +7 天
if (reviewCount <= 1) return 1
if (reviewCount === 2) return 3
return 7
}
/**
* 根据本次判定推进错题状态(供「作答式 submit」与「自评式 selfAssess」复用)。
* - 答对/记对:reviewCount+1;连续达到 4 次 → mastered;否则按次数安排 +1/+3/+7 天。
* - 答错/记错:回到当天 —— reviewCount 重置为 0、nextReviewAt=today、status=pending。
* - 答错可更新错因。
*/
function applyReviewOutcome(
item: WrongQuestion,
correct: boolean,
wrongReason?: string
): WrongQuestion {
const today = todayISO()
if (correct) {
const reviewCount = item.reviewCount + 1
if (reviewCount >= MASTERED_REVIEW_COUNT) {
return { ...item, reviewCount, status: 'mastered', nextReviewAt: today, updatedAt: new Date().toISOString() }
}
return {
...item,
reviewCount,
status: 'reviewing',
nextReviewAt: addDays(today, nextIntervalByCount(reviewCount)),
updatedAt: new Date().toISOString()
}
}
return {
...item,
reviewCount: 0,
status: 'pending',
nextReviewAt: today,
wrongReason: wrongReason ?? item.wrongReason,
updatedAt: new Date().toISOString()
}
}
/** 待复习错题列表(支持模块与状态筛选、分页) */
export async function list(request: FastifyRequest) {
@ -51,16 +96,116 @@ async function findWrongQuestion(id: string): Promise<WrongQuestion> {
return item
}
/** 提交复习作答。TODO 任务09:按 +1/+3/+7 天间隔安排下次复习。 */
export async function submit(request: FastifyRequest) {
const { id } = request.params as { id: string }
const item = await findWrongQuestion(id)
return { correct: false, nextReviewAt: todayISO(), status: item.status }
/** 更新单个错题记录(返回更新后的记录) */
async function updateWrongQuestion(id: string, updater: (w: WrongQuestion) => WrongQuestion) {
const wrongQuestions = await readData<WrongQuestion[]>(dataFiles.wrongQuestions, [])
const idx = wrongQuestions.findIndex((w) => w.id === id)
if (idx === -1) throw ApiError.notFound('错题记录不存在')
const next = updater(wrongQuestions[idx])
const updated = [...wrongQuestions]
updated[idx] = next
await updateData<WrongQuestion[]>(dataFiles.wrongQuestions, [], () => updated)
return next
}
/** 手动标记已掌握。TODO 任务09:更新错题状态并联动掌握度。 */
/**
* 提交复习作答:
* - 答对:reviewCount+1;连续达到 4 次 → 标记 mastered;否则按次数安排 +1/+3/+7 天。
* - 答错:回到当天 —— reviewCount 重置为 0、nextReviewAt=today、status=pending。
* - 可附带错因(答错时更新 wrongReason)。
*/
export async function submit(request: FastifyRequest) {
const { id } = request.params as { id: string }
const body = request.body as z.infer<typeof ReviewSubmitBodySchema>
const item = await findWrongQuestion(id)
// 找到题目标准答案
const questions = await readData<Question[]>(dataFiles.questions, [])
const question = questions.find((q) => q.id === item.questionId)
if (!question) throw ApiError.notFound('对应题目不存在于题库')
const correct = question.answer === body.answer
const updated = await updateWrongQuestion(id, () => applyReviewOutcome(item, correct, body.wrongReason))
return {
correct,
reviewCount: updated.reviewCount,
nextReviewAt: updated.nextReviewAt,
status: updated.status
}
}
/**
* 自评式复习提交(无需真实作答):用户在错题详情页看完答案与解析后,
* 自行「记对了 / 记错了」。答对推进 +1/+3/+7 与掌握;答错回到当天。
*/
export async function selfAssess(request: FastifyRequest) {
const { id } = request.params as { id: string }
const body = request.body as z.infer<typeof ReviewSelfAssessBodySchema>
const item = await findWrongQuestion(id)
const updated = await updateWrongQuestion(id, () =>
applyReviewOutcome(item, body.correct, body.wrongReason)
)
return {
correct: body.correct,
reviewCount: updated.reviewCount,
nextReviewAt: updated.nextReviewAt,
status: updated.status
}
}
/** 手动标记已掌握:更新错题状态并联动掌握度 */
export async function markMastered(request: FastifyRequest) {
const { id } = request.params as { id: string }
const item = await findWrongQuestion(id)
return { id: item.id, status: 'mastered' as const }
const updated = await updateWrongQuestion(id, (w) => ({
...w,
status: 'mastered',
nextReviewAt: todayISO(),
updatedAt: new Date().toISOString()
}))
return { id: updated.id, status: updated.status }
}
/**
* 错题详情:完整题目 + 错题记录 + 该题全部作答历史(practice + review)。
* 供前端错题详情页展示题目、答案解析、作答历史与复习操作。
*/
export async function detail(request: FastifyRequest) {
const { id } = request.params as { id: string }
const item = await findWrongQuestion(id)
const [questions, records] = await Promise.all([
readData<Question[]>(dataFiles.questions, []),
readData<PracticeRecord[]>(dataFiles.practiceRecords, [])
])
const question = questions.find((q) => q.id === item.questionId)
if (!question) throw ApiError.notFound('对应题目不存在于题库')
// 该题所有作答记录(新→旧)。作答历史源自古刷题作答记录(练习类);复习作答不写 practice-records。
const history = records
.filter((r) => r.questionId === item.questionId)
.sort((a, b) => (a.answeredAt < b.answeredAt ? 1 : -1))
.map((r) => ({
date: r.answeredAt.slice(0, 10),
userAnswer: r.userAnswer,
correct: r.correct,
wrongReason: '',
source: 'practice' as const
}))
return {
id: item.id,
questionId: item.questionId,
module: question.module,
subModule: question.subModule,
difficulty: question.difficulty,
stem: question.stem,
options: question.options,
answer: question.answer,
analysis: question.analysis,
status: item.status,
reviewCount: item.reviewCount,
nextReviewAt: item.nextReviewAt,
wrongReason: item.wrongReason,
history
}
}

View File

@ -86,6 +86,11 @@ const routes: RouteDef[] = [
response: { 200: schemas.PracticeFinishResponseSchema },
handler: practice.finish
},
{
method: 'GET', url: '/api/practice/wrong-reasons', summary: '错因分布(最近30天)', tags: ['刷题'],
response: { 200: schemas.PracticeWrongReasonsResponseSchema },
handler: practice.wrongReasons
},
// 错题复习
{
@ -94,6 +99,12 @@ const routes: RouteDef[] = [
response: { 200: schemas.ReviewListResponseSchema },
handler: review.list
},
{
method: 'GET', url: '/api/review/:id/detail', summary: '错题详情', tags: ['错题复习'],
params: schemas.WrongQuestionIdParamsSchema,
response: { 200: schemas.ReviewDetailResponseSchema },
handler: review.detail
},
{
method: 'POST', url: '/api/review/:id/submit', summary: '提交复习作答', tags: ['错题复习'],
params: schemas.WrongQuestionIdParamsSchema,
@ -101,6 +112,13 @@ const routes: RouteDef[] = [
response: { 200: schemas.ReviewSubmitResponseSchema },
handler: review.submit
},
{
method: 'POST', url: '/api/review/:id/self-assess', summary: '自评复习(记对/记错)', tags: ['错题复习'],
params: schemas.WrongQuestionIdParamsSchema,
body: schemas.ReviewSelfAssessBodySchema,
response: { 200: schemas.ReviewSubmitResponseSchema },
handler: review.selfAssess
},
{
method: 'POST', url: '/api/review/:id/mark-mastered', summary: '标记已掌握', tags: ['错题复习'],
params: schemas.WrongQuestionIdParamsSchema,

View File

@ -105,13 +105,16 @@ export const PracticeStartBodySchema = z.object({
module: z.enum(MODULES),
duration: z.union([z.literal(5), z.literal(10), z.literal(15)], {
error: '练习时长仅支持 5、10、15 分钟'
})
}),
/** 自定义组卷:直接指定题目 ID 列表(优先级高于 module+duration 随机组卷) */
custom: z.array(z.string().min(1)).optional()
})
export const PracticeSessionViewSchema = z.object({
sessionId: z.string(),
module: z.enum(MODULES),
durationMinutes: z.number().int().min(1),
questionIds: z.array(z.string()),
total: z.number().int().min(0),
startedAt: z.string(),
status: z.enum(['created', 'active', 'finished'])
})
@ -124,9 +127,11 @@ export const PracticeQuestionResponseSchema = z.object({
difficulty: true,
stem: true,
options: true
}),
}).nullable(),
index: z.number().int().min(0),
total: z.number().int().min(0)
total: z.number().int().min(0),
answered: z.number().int().min(0),
durationMinutes: z.number().int().min(1)
})
export const PracticeAnswerBodySchema = z.object({
questionId: z.string().min(1),
@ -135,11 +140,19 @@ export const PracticeAnswerBodySchema = z.object({
})
export const PracticeAnswerResponseSchema = z.object({
accepted: z.boolean(),
answeredCount: z.number().int().min(0)
duplicate: z.boolean().optional(),
answeredCount: z.number().int().min(0),
/** 本题作答是否正确(供单题即时反馈) */
correct: z.boolean().optional(),
/** 正确答案(供单题即时反馈与解析展示) */
correctAnswer: z.enum(OPTION_KEYS).optional(),
/** 标准解析(供单题即时反馈) */
analysis: z.string().optional()
})
export const PracticeFinishResponseSchema = z.object({
sessionId: z.string(),
total: z.number().int().min(0),
answered: z.number().int().min(0),
correctCount: z.number().int().min(0),
accuracy: z.number().int().min(0).max(100),
durationSeconds: z.number().int().min(0),
@ -154,6 +167,17 @@ export const PracticeFinishResponseSchema = z.object({
})
)
})
/** 错因分布(最近 30 天,按错因聚合计数,供刷题中心「错因分布」卡片) */
export const PracticeWrongReasonsResponseSchema = z.object({
reasons: z.array(
z.object({
reason: z.string(),
count: z.number().int().min(0),
/** 占比 0-100,取整 */
percent: z.number().int().min(0).max(100)
})
)
})
// ---------- 错题复习 ----------
export const ReviewListQuerySchema = z.object({
@ -179,16 +203,52 @@ export const ReviewListResponseSchema = pagination.extend({
)
})
export const WrongQuestionIdParamsSchema = z.object({ id: z.string().min(1) })
export const ReviewSubmitBodySchema = z.object({ answer: z.enum(OPTION_KEYS) })
export const ReviewSubmitBodySchema = z.object({
answer: z.enum(OPTION_KEYS),
/** 答错时可标记/更新错因 */
wrongReason: z.string().optional()
})
export const ReviewSelfAssessBodySchema = z.object({
correct: z.boolean(),
/** 记错时可标记/更新错因 */
wrongReason: z.string().optional()
})
export const ReviewSubmitResponseSchema = z.object({
correct: z.boolean(),
nextReviewAt: dateParam,
reviewCount: z.number().int().min(0),
nextReviewAt: z.string(),
status: z.enum(['pending', 'reviewing', 'mastered'])
})
export const ReviewMarkResponseSchema = z.object({
id: z.string(),
status: z.enum(['pending', 'reviewing', 'mastered'])
})
/** 错题详情:完整题目 + 错题记录 + 该题全部作答历史(供错题详情页) */
export const ReviewDetailResponseSchema = z.object({
id: z.string(),
questionId: z.string(),
module: z.string(),
subModule: z.string(),
difficulty: z.string(),
stem: z.string(),
options: z.array(z.object({ key: z.enum(OPTION_KEYS), text: z.string() })),
answer: z.enum(OPTION_KEYS),
analysis: z.string(),
status: z.enum(['pending', 'reviewing', 'mastered']),
reviewCount: z.number().int().min(0),
nextReviewAt: z.string(),
wrongReason: z.string(),
/** 作答历史:该题目所有作答记录(新→旧) */
history: z.array(
z.object({
date: z.string(),
userAnswer: z.enum(OPTION_KEYS),
correct: z.boolean(),
wrongReason: z.string(),
source: z.enum(['practice', 'review'])
})
)
})
// ---------- 备考计划 ----------
export const PlansTodayQuerySchema = z.object({ date: dateParam.optional() })

View File

@ -111,6 +111,8 @@ export const PracticeSessionSchema = z.object({
durationMinutes: z.number().int().min(1),
startedAt: z.string(),
endedAt: z.string().optional(),
/** 已作答到第几题(-1 表示尚未作答任何题);answer 递增,currentQuestion 据此取题 */
recordIndex: z.number().int().min(-1).default(-1),
status: z.enum(['active', 'finished'])
})
export type PracticeSession = z.infer<typeof PracticeSessionSchema>