c742cc7070af8afefe97dbf7a9de5ec4102a547b
fix: 修复实验页面中实验状态未正确更新的问题,确保实验状态在前端和后端之间保持一致。 docs: 添加了SCPI文档和总程序设计架构
物理实验教学平台 (PhyExp)
项目概述
PhyExp 是一个交互式物理实验教学平台,支持学生在线完成实验预习、测验、数据记录和 AI 辅助分析。平台采用前后端分离架构,前端基于 Vue 3 + TypeScript,后端基于 Python FastAPI。
核心功能
- 分阶段实验流程:预习 → 测验 → 实验 → 考试 → 总结
- Excel 风格数据表:网格布局的数据录入界面,支持 LaTeX 数学公式渲染
- AI 助教:基于 SSE 的流式对话,支持实验数据评价、答疑和错题分析
- 自动计算与验证:前端 mathjs 即时计算,后端 Pydantic 验证,背景色可视化反馈
- PDF 导出:实验数据导出为 A4 格式 PDF
- 示波器集成:可选的 PyUSB 示波器数据采集(含模拟模式回退)
技术栈
| 层 | 技术 |
|---|---|
| 前端 | Vue 3, TypeScript, Vite, Pinia, KaTeX, mathjs |
| 后端 | Python, FastAPI, Pydantic v2, Uvicorn |
| 硬件 | PyUSB, libusb (可选) |
| AI | REST + SSE (Server-Sent Events) |
快速开始
环境要求
- Node.js >= 18
- Python >= 3.10
- uv (Python 包管理器)
- yarn (Node.js 包管理器)
启动后端
cd backend
uv sync
uv run python -m app.main
# 默认监听 http://0.0.0.0:8000
启动前端
cd frontend
yarn install
yarn dev
# 默认监听 http://localhost:5173
目录结构
PhyExpRefactor/
├── backend/ # Python FastAPI 后端
│ ├── app/
│ │ ├── main.py # FastAPI 应用入口
│ │ ├── models.py # 模型兼容导出
│ │ ├── schemas/ # Pydantic 数据模型
│ │ ├── api/ # REST API 路由
│ │ ├── core/ # 业务逻辑层
│ │ └── hardware/ # 示波器硬件驱动
│ ├── config/experiments/ # 实验 JSON 配置
│ └── ARCHITECTURE.md # 后端架构文档
├── frontend/ # Vue 3 前端
│ ├── src/
│ │ ├── components/ # 可复用组件
│ │ ├── pages/ # 页面组件
│ │ ├── stores/ # Pinia 状态管理
│ │ ├── types/ # TypeScript 类型定义
│ │ └── utils/ # 工具函数
│ └── ARCHITECTURE.md # 前端架构文档
├── docs/ # 本目录 - 项目文档
└── .vscode/ # VS Code 配置
相关文档
仓库描述
编程语言
Python
53.2%
Vue
30.9%
TypeScript
15.8%