PastpaperMaster/memory/project_pastpaper_master.md

name, description, type

name	description	type
PastPaper Master 项目概览	项目技术栈、当前开发状态、已完成工作流及下一步优先级	project

AI 辅助学习平台，支持 COMP2211 试卷练习。核心功能：题目工作台、AI 三件套、相似题推荐、错题本、变式题生成。

技术栈

• Frontend: React 19 + TypeScript + Vite 7 + Tailwind v4
• Backend: FastAPI + Python 3.12 + uv
• DB: Supabase PostgreSQL（RLS 已预留，当前用 temp user id）
• LLM: GPT-4o (laozhang proxy) + Qwen-plus fallback

当前 DB 状态（2026-04-10）

COMP2211 共 7 份 status=ready 试卷，250 道 subquestion 级题目，均有 knowledge_reminder / ai_hint / solution / analytics_topic / topic_tags / skill_tags。

已完成的工作（本次 session）

Workstream A：相似题检索 + 移除 demo fallback

• backend/app/routers/questions.py：
  • skill_tags 加入 SELECT 和 question_topics() 计算
  • 修复 isinstance(target_score, int) → (int, float) 支持 NUMERIC 小数分
  • similarity_score() 返回 (score, reasons) tuple
  • 过滤阈值从 <= 0 改为 < 10
  • 响应增加 match_reasons 字段
• frontend/src/types/api.ts：SimilarQuestion 加 match_reasons?: string[]
• frontend/src/components/workbench/SimilarHistoryPanel.tsx：移除全部 demo fallback，改为真实 empty/error 状态，显示 match_reasons chip

下一步优先级（来自 HANDOFF_COMP2211.md）

1. ✅ Workstream A: 相似题检索 + 移除 demo fallback — 已完成
2. Workstream B: Analytics 深化（per-paper drill-down、topic 频率时序、高频话题）
3. Workstream C: LaTeX/KaTeX 渲染质量（集中归一化、剔除 OCR 噪声）
4. Workstream D: 用户上传去重（对比 course_library 已有试卷）
5. Workstream E: UI/UX pass（QuestionNav、状态 badge、workbench 层级）

Why: HANDOFF 文档中建议的开发顺序，以数据稳定性为先。 How to apply: 下次 session 从 Workstream B（Analytics 深化）开始。