Skip to content
codehuang0717Public

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

32 Commits

Folders and files

Repository files navigation

MovieHub - 电影管理系统

一个基于 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 电影推荐助手

功能介绍

右下角紫色按钮点击展开 AI 聊天界面,支持:

  • 🎯 智能推荐:基于你的收藏和评分数据智能推荐电影
  • 🧠 OpenAI GPT:接入 ChatGPT,更智能的个性化推荐
  • 📊 用户画像分析:自动分析你的观影偏好
  • 💬 自然语言交互:用自然语言描述想看的电影类型

使用方式

  1. 点击右下角紫色 AI 按钮打开聊天窗口
  2. 输入想看的电影类型(如:科幻、爱情、喜剧、悬疑等)
  3. AI 会根据你的观影历史推荐相关电影
  4. 点击推荐卡片直接查看电影详情

配置 OpenAI(可选)

  1. 点击右上角 设置 按钮
  2. 选择 OpenAI GPT 模式
  3. 输入你的 OpenAI API Key(sk-...格式)
  4. 保存后即可使用 GPT 进行更智能的推荐

注意:使用 OpenAI 需要 API Key 和额度。推荐使用 GPT-3.5,性价比更高。

推荐类型关键词

支持以下类型关键词:

  • 科幻、爱情、喜剧、悬疑
  • 动作、动画、恐怖、战争
  • 纪录片、家庭等

也可以用自然语言描述,如:

  • "给我推荐几部感人的爱情片"
  • "我想看刺激的悬疑电影"
  • "有什么好看的科幻动作片"

⚡ Performance Optimizations

This project has undergone several performance improvements to enhance user experience and Lighthouse scores.

Key Improvements

1. Element Plus Optimization (On-Demand Loading)

  • Tree-shaking: Implemented unplugin-vue-components and unplugin-auto-import with ElementPlusResolver to 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.

2. Image Loading & Layout Stability

  • CLS Reduction: Explicitly added width and height attributes 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 (w200 for lists, w780 for hero backgrounds) instead of defaulting to original, heavy resolutions.
  • Layout Stability: Replaced v-loading directives with el-skeleton and refined CSS container heights to eliminate layout jumps during initial data fetching.

3. Development Environment Tweaks

  • Production Build Optimization: Configured vite-plugin-vue-devtools to be active only in the development environment, reducing production bundle overhead.

📦 快速开始

环境要求

  • Node.js 18+
  • Python 3.12+
  • Git

1. 克隆项目

git clone https://github.com/codehuang0717/MovieHub.git
cd MyMovie

2. 后端配置

# 进入后端目录
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

3. 前端配置

# 1 新开一个终端,进入前端目录
cd frontend/movie-app

# 2 安装依赖
npm install

启动开发服务器:

npm run dev

🔧 开发配置

VS Code 推荐插件(可选)

  • Vue Language Features (Volar)
  • TypeScript Vue Plugin (Volar)
  • Python
  • Django
  • GitLens

端口配置

  • 前端:http://localhost:5173
  • 后端 API:http://localhost:8000
  • Django 管理:http://localhost:8000/admin

环境变量说明

前端 (.env)

VITE_TMDB_API_KEY=your_tmdb_api_key
VITE_API_BASE_URL=http://localhost:8000

后端环境变量(可选)

export DEBUG=True
export SECRET_KEY=your_secret_key_here
export TMDB_API_KEY=your_tmdb_api_key

📁 项目结构

MyMovie/
├── 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 3000

Nginx 配置示例

server {
    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:用户活动记录(用于推荐算法)

API 接口

  • 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/ - 趋势电影

🎨 UI/UX 特色

  • 🌙 暗色主题:现代化深色界面
  • ✨ 平滑动画:页面切换与交互动画
  • 📱 响应式:适配各种屏幕尺寸
  • 🎬 电影海报:优雅的网格布局
  • 🔍 智能搜索:实时搜索建议
  • ⭐ 交互评分:可视化评分分布
  • 🤖 AI 助手:右下角悬浮聊天按钮,自然语言推荐电影
  • 💬 对话式交互:气泡式对话 UI,推荐卡片可直接跳转

🤝 贡献指南

  1. Fork 本项目
  2. 创建功能分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

📝 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

🙋 FAQ

Q: 如何获取 TMDB API 密钥?

A: 访问 TMDB Developer Portal,注册并获取 API Key。

Q: 如何修改数据库?

A: 编辑 backend/movie_recommendation/settings.py 中的 DATABASES 配置。

Q: 如何添加新电影?

A: 系统自动从 TMDB 同步数据,无需手动添加。

Q: 为什么有些功能无法使用?

A: 确保已登录,相关功能需要用户认证。

Q: 如何配置跨域?

A: 开发环境已配置 CORS,生产环境请在 settings.py 中配置 CORS_ALLOWED_ORIGINS。

Q: AI 推荐助手如何使用?

A:

  1. 点击右下角紫色按钮打开 AI 聊天
  2. 输入想看的电影类型(科幻、爱情、喜剧等)
  3. AI 会基于你的收藏和评分数据推荐电影
  4. 可选配置 OpenAI API Key 获得更智能的推荐

Q: AI 推荐需要付费吗?

A: 不需要。系统默认使用内置的智能推荐算法,完全免费。如需使用 OpenAI GPT,可自行配置 API Key(需要付费)。

Q: AI 推荐的电影 ID 错误怎么办?

A: 系统内置了热门电影的 ID 映射表,同时支持按电影名搜索 TMDB 数据库作为后备,确保推荐的电影可以正常跳转。

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages