38 lines
2.0 KiB
Markdown
38 lines
2.0 KiB
Markdown
---
|
||
name: PastPaper Master 项目概览
|
||
description: 项目技术栈、当前开发状态、已完成工作流及下一步优先级
|
||
type: 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 深化）开始。
|