一个基于AI的智能教育平台,提供个性化学习体验、智能题库、学习分析等功能。
Windows用户:
start.batLinux/Mac用户:
chmod +x start.sh
./start.shcd backend
# 创建虚拟环境
python -m venv venv
# 激活虚拟环境
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate
# 安装依赖
pip install -r requirements.txt
# 启动服务
python main.pycd frontend
# 安装依赖
npm install
# 启动开发服务器
npm run dev- 前端应用: http://localhost:5173
- 后端API: http://localhost:8111
- API文档: http://localhost:8111/docs
- Python 3.8+
- Node.js 16+
- npm 或 pnpm
aiedu/
├── backend/ # 后端服务 (FastAPI)
│ ├── app/
│ │ ├── api/ # API路由
│ │ ├── models/ # 数据模型
│ │ ├── services/ # 业务逻辑
│ │ └── schemas/ # 数据验证
│ ├── database/ # 数据库配置
│ └── main.py # 应用入口
├── frontend/ # 前端应用 (Vue 3 + TypeScript)
│ ├── src/
│ │ ├── api/ # API调用
│ │ ├── components/ # Vue组件
│ │ ├── views/ # 页面视图
│ │ └── stores/ # 状态管理
│ └── package.json
└── README.md
- 多角色用户管理(学生、教师、管理员)
- JWT身份认证
- 用户注册和登录
- 题目分类管理
- 难度分级
- 智能推荐算法
- AI生成题目
- 学习进度跟踪
- 能力评估
- 学习风格分析
- 个性化学习计划
- 智能评分
- 学习动机激励
- 难度分析
- 学习模式识别
问题原因:
- 前后端端口不匹配
- API路径配置错误
- 代理设置问题
解决方案:
- 确保后端运行在8111端口
- 检查前端API调用路径是否包含
/api/v1前缀 - 验证Vite代理配置正确
解决方案:
cd backend
python -c "from database import engine; print('数据库连接正常')"解决方案:
cd frontend
rm -rf node_modules package-lock.json
npm install解决方案:
cd backend
pip install --upgrade pip
pip install -r requirements.txt启动后端服务后,访问 http://localhost:8111/docs 查看完整的API文档。
- Fork 项目
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 打开 Pull Request
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
如有问题或建议,请提交 Issue 或联系开发团队。