一个基于 Vue 3 + Django REST Framework 的现代化电影信息管理与推荐系统,集成了 TMDB(The Movie Database)数据源,支持用户收藏、评分、评论、想看列表等完整功能,还有 AI 智能电影推荐助手!
- 🎬 电影浏览:热门、高分、即将上映电影展示
- 🎪 轮播首页:大屏英雄区轮播展示精选电影
- 🔍 智能搜索:支持标题、演员、导演等多维度搜索
- 📁 收藏系统:创建多个收藏夹,管理私人/公开收藏
- ⭐ 评分评论:1-5星评分,支持长评/短评与点赞
- 📝 想看清单:标记想看、在看、已看状态
- 👤 用户系统:注册/登录、头像上传、个人主页
- 🎭 分类浏览:按电影类型筛选
- 🤖 AI 推荐助手:智能电影推荐,可选择智能推荐或 OpenAI GPT
- 🎨 响应式 UI:基于 Element Plus,暗色主题
- 📱 移动适配:完美支持手机/平板端
- Vue 3 + TypeScript
- Vite - 构建工具
- Pinia - 状态管理
- Vue Router - 路由管理
- Element Plus - UI 组件库
- Axios - HTTP 客户端
- Django 5.x + Django REST Framework
- SQLite / PostgreSQL(可配置)
- JWT 认证
- TMDB API 集成
- Django CORS Headers 跨域支持
右下角紫色按钮点击展开 AI 聊天界面,支持:
- 🎯 智能推荐:基于你的收藏和评分数据智能推荐电影
- 🧠 OpenAI GPT:接入 ChatGPT,更智能的个性化推荐
- 📊 用户画像分析:自动分析你的观影偏好
- 💬 自然语言交互:用自然语言描述想看的电影类型
- 点击右下角紫色 AI 按钮打开聊天窗口
- 输入想看的电影类型(如:科幻、爱情、喜剧、悬疑等)
- AI 会根据你的观影历史推荐相关电影
- 点击推荐卡片直接查看电影详情
- 点击右上角 设置 按钮
- 选择 OpenAI GPT 模式
- 输入你的 OpenAI API Key(sk-...格式)
- 保存后即可使用 GPT 进行更智能的推荐
注意:使用 OpenAI 需要 API Key 和额度。推荐使用 GPT-3.5,性价比更高。
支持以下类型关键词:
- 科幻、爱情、喜剧、悬疑
- 动作、动画、恐怖、战争
- 纪录片、家庭等
也可以用自然语言描述,如:
- "给我推荐几部感人的爱情片"
- "我想看刺激的悬疑电影"
- "有什么好看的科幻动作片"
This project has undergone several performance improvements to enhance user experience and Lighthouse scores.
- Tree-shaking: Implemented
unplugin-vue-componentsandunplugin-auto-importwithElementPlusResolverto ensure that only components and icons actually used in the code are bundled. - Style Optimization: Switched from a global Element Plus CSS import to automatic, per-component style injection, drastically reducing initial CSS payload.
- CLS Reduction: Explicitly added
widthandheightattributes to all image tags to prevent layout shifts during content loading. - LCP Enhancement: Added
fetchpriority="high"to hero images and key components to prioritize critical assets. - Intelligent Resizing: Updated the TMDB API integration to request appropriate image sizes (
w200for lists,w780for hero backgrounds) instead of defaulting to original, heavy resolutions. - Layout Stability: Replaced
v-loadingdirectives withel-skeletonand refined CSS container heights to eliminate layout jumps during initial data fetching.
- Production Build Optimization: Configured
vite-plugin-vue-devtoolsto be active only in the development environment, reducing production bundle overhead.
- Node.js 18+
- Python 3.12+
- Git
git clone https://github.com/codehuang0717/MovieHub.git
cd MyMovie# 进入后端目录
cd backend
# 创建虚拟环境
python -m venv venv
# 激活venv虚拟环境
# Windows
venv\Scripts\activate
#当然你也可以用conda来管理环境
# macOS / Linux
source venv/bin/activate
# 安装依赖
pip install -r requirements.txt
# 运行数据库迁移
python manage.py migrate
# 启动后端服务
python manage.py runserver# 1 新开一个终端,进入前端目录
cd frontend/movie-app
# 2 安装依赖
npm install启动开发服务器:
npm run dev- Vue Language Features (Volar)
- TypeScript Vue Plugin (Volar)
- Python
- Django
- GitLens
- 前端:
http://localhost:5173 - 后端 API:
http://localhost:8000 - Django 管理:
http://localhost:8000/admin
VITE_TMDB_API_KEY=your_tmdb_api_key
VITE_API_BASE_URL=http://localhost:8000export DEBUG=True
export SECRET_KEY=your_secret_key_here
export TMDB_API_KEY=your_tmdb_api_keyMyMovie/
├── backend/ # Django 后端
│ ├── movies/ # 电影模块
│ ├── reviews/ # 评分评论模块
│ ├── users/ # 用户模块
│ ├── recommendations/ # 推荐模块
│ └── movie_recommendation/ # 项目配置
├── frontend/ # Vue 前端
│ └── movie-app/
│ ├── src/
│ │ ├── components/ # 通用组件
│ │ ├── layouts/ # 布局组件
│ │ ├── router/ # 路由配置
│ │ ├── stores/ # Pinia 状态管理
│ │ ├── views/ # 页面组件
│ │ └── main.ts # 入口文件
│ ├── public/ # 静态资源
│ └── index.html # HTML 模板
├── README.md # 项目文档
└── .env.example # 环境变量模板
# 1. 安装生产依赖
pip install gunicorn
# 2. 收集静态文件
python manage.py collectstatic --noinput
# 3. 使用 Gunicorn 启动
gunicorn movie_recommendation.wsgi:application \
--bind 0.0.0.0:8000 \
--workers 4 \
--access-logfile -
--error-logfile -# 1. 构建生产版本
npm run build
# 2. 部署 dist/ 目录到 Web 服务器(Nginx/Apache)
npm install -g serve
serve -s dist -l 3000server {
listen 80;
server_name yourdomain.com;
location /api/ {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
location / {
root /path/to/frontend/movie-app/dist;
try_files $uri $uri/ /index.html;
}
}- 使用 JWT Token 认证
- Token 存储在
localStorage - 自动 Token 刷新机制
- 受保护路由需要登录
- Movie:电影信息(含 TMDB ID 映射)
- User:用户信息
- UserProfile:用户扩展(头像、简介)
- Rating:评分(1-5 星)
- Comment:评论(支持长评标记)
- Collection:收藏夹
- Watchlist:想看列表
- Recommendation:用户推荐记录
- UserActivity:用户活动记录(用于推荐算法)
GET /api/movies/- 电影列表GET /api/movies/{id}/- 电影详情POST /api/auth/login/- 用户登录POST /api/auth/register/- 用户注册GET /api/reviews/collections/- 收藏夹列表POST /api/reviews/ratings/- 提交评分POST /api/reviews/comments/- 提交评论GET /api/recommendations/similar/{movie_id}/- 相似电影推荐GET /api/recommendations/personalized/- 个性化推荐GET /api/recommendations/popular/- 热门电影GET /api/recommendations/trending/- 趋势电影
- 🌙 暗色主题:现代化深色界面
- ✨ 平滑动画:页面切换与交互动画
- 📱 响应式:适配各种屏幕尺寸
- 🎬 电影海报:优雅的网格布局
- 🔍 智能搜索:实时搜索建议
- ⭐ 交互评分:可视化评分分布
- 🤖 AI 助手:右下角悬浮聊天按钮,自然语言推荐电影
- 💬 对话式交互:气泡式对话 UI,推荐卡片可直接跳转
- Fork 本项目
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情
A: 访问 TMDB Developer Portal,注册并获取 API Key。
A: 编辑 backend/movie_recommendation/settings.py 中的 DATABASES 配置。
A: 系统自动从 TMDB 同步数据,无需手动添加。
A: 确保已登录,相关功能需要用户认证。
A: 开发环境已配置 CORS,生产环境请在 settings.py 中配置 CORS_ALLOWED_ORIGINS。
A:
- 点击右下角紫色按钮打开 AI 聊天
- 输入想看的电影类型(科幻、爱情、喜剧等)
- AI 会基于你的收藏和评分数据推荐电影
- 可选配置 OpenAI API Key 获得更智能的推荐
A: 不需要。系统默认使用内置的智能推荐算法,完全免费。如需使用 OpenAI GPT,可自行配置 API Key(需要付费)。
A: 系统内置了热门电影的 ID 映射表,同时支持按电影名搜索 TMDB 数据库作为后备,确保推荐的电影可以正常跳转。