智涌君 - AI驱动的课程学习一体化平台

SmartCode Course Platform 是一个现代化的在线课程学习平台，集成了AI助手功能，为用户提供个性化的学习体验。

• 🔐 用户认证系统 - JWT令牌认证，角色权限管理
• 📚 课程管理 - 完整的课程创建、编辑、查看功能
• 📖 课时学习 - 结构化的课时内容和学习进度跟踪
• 🤖 AI助手 - 集成CopilotKit，提供智能学习辅助
• 📱 响应式设计 - 支持桌面和移动设备
• 🎨 现代UI - 基于Tailwind CSS的美观界面

• FastAPI - 现代、快速的Web框架
• MongoDB - NoSQL数据库
• Beanie - 异步MongoDB ODM
• JWT - 身份认证
• Pydantic - 数据验证

• Next.js 15 - React全栈框架
• TypeScript - 类型安全
• Tailwind CSS - 实用优先的CSS框架
• React Query - 数据获取和状态管理
• Zustand - 轻量级状态管理

• Python 3.11+
• Node.js 18+
• MongoDB (已配置远程数据库)

1. 克隆项目

git clone <repository-url>
cd course-platform

2. 启动后端

cd backend
source $HOME/.local/bin/env
uv run python main.py

3. 启动前端

cd frontend
npm install
WATCHPACK_POLLING=true npx next dev --port 5006 --hostname 0.0.0.0

4. 访问应用

• 前端: http://localhost:5006
• 后端API: http://localhost:8000
• API文档: http://localhost:8000/docs

• 用户名: admin
• 密码: admin123

📚 完整使用指南 →

包含详细的：

• 环境配置说明
• 常见问题排查
• JWT认证问题解决
• 部署指南
• API测试方法
• 项目启动经验总结

欢迎提交Issue和Pull Request来改进这个项目。

本项目采用MIT许可证。

如果遇到"Failed to fetch courses: 500"错误，通常是JWT token过期导致的。解决方法：

1. 重新登录获取新token
2. 查看 完整指南 获取详细解决方案

如果服务无法启动，请检查：

1. 环境文件是否存在（.env 和 .env.local）
2. 端口是否被占用（8000和5006）
3. 依赖是否正确安装

---

状态: 🟢 项目已成功配置并运行 最后更新: 2025-10-14