# 星梦动漫

**Repository Path**: frailty/xingmeng

## Basic Information

- **Project Name**: 星梦动漫
- **Description**: 动漫网站练手项目，使用Python Django + Vue3
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-08
- **Last Updated**: 2026-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 星梦动漫

动漫库 + 视频社交平台。

## 技术栈

| 前端 | 后端 |
|------|------|
| Vue 3 + Vite | Django 6 + DRF |
| Pinia（状态管理） | djangorestframework-simplejwt（认证） |
| Ant Design Vue | django-cors-headers（跨域） |
| axios | MySQL / SQLite |
| xgplayer（视频播放） | PyMySQL |

## 项目结构

```
xingmeng/
├── xingmeng-vue/          # 前端（Vue 3）
│   ├── src/
│   │   ├── api/          # 接口封装
│   │   ├── components/   # 公共组件
│   │   ├── router/       # 路由配置
│   │   ├── stores/       # Pinia 状态管理
│   │   ├── utils/        # 工具函数
│   │   └── views/        # 页面视图
│   └── .env               # 环境变量（不提交）
│
├── xingmeng-server/       # 后端（Django）
│   ├── accounts/          # 用户、认证、社交模块
│   ├── videos/            # 视频、番剧模块
│   ├── xingmeng_server/  # 项目配置
│   ├── media/             # 上传媒体文件（不提交）
│   └── .env               # 环境变量（不提交）
│
└── README.md
```

## 快速启动

### 1. 后端

```bash
cd xingmeng-server

# 安装依赖
pip install -r requirements.txt

# 配置环境变量（复制并修改）
cp .env.example .env

# 初始化数据库
python manage.py migrate

# 初始化示例数据（可选）
python manage.py init_demo_data

# 启动开发服务器
python manage.py runserver
```

后端地址：`http://localhost:8000`

### 2. 前端

```bash
cd xingmeng-vue

# 安装依赖
pnpm install

# 配置环境变量（复制并修改）
cp .env.example .env

# 启动开发服务器
pnpm dev
```

前端地址：`http://localhost:5173`

### 登录账号

初始化示例数据后可使用以下任意账号登录，密码均为 `123456`：

```
星梦酱 / 樱落雨 / 追风少年 / 夜之铃 / 云游四方 / 萌新UP主
```

## 功能模块

- **首页**：番剧列表 + 投稿视频，支持分类筛选
- **搜索**：用户搜索（支持昵称）
- **视频播放页**：分集切换、点赞、收藏、评论、追番、推荐列表
- **个人空间**：投稿列表、追番列表、收藏夹、关注/粉丝列表
- **个人中心**：修改昵称/简介、头像上传、修改密码
- **历史记录**：观看历史时间线
- **商城**（静态展示）
- **私信**：用户间私信聊天
- **通知**：评论回复、点赞、@ 通知

## 环境变量说明

### 前端 `.env`

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `VITE_API_BASE_URL` | 后端 API 地址 | `http://localhost:8000` |

### 后端 `.env`

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `SECRET_KEY` | Django 密钥 | 内置开发密钥 |
| `CORS_ALLOWED_ORIGINS` | 允许的跨域前端地址 | `http://localhost:5173` |
| `MEDIA_BASE_URL` | 媒体文件访问地址 | `http://localhost:8000/media/` |
| `DB_ENGINE` | 数据库引擎 | `django.db.backends.sqlite3`（不配置 MySQL 时） |
| `DB_NAME` | MySQL 数据库名 | `xingmeng` |
| `DB_USER` | MySQL 用户名 | `root` |
| `DB_PASSWORD` | MySQL 密码 | - |
| `DB_HOST` | MySQL 主机 | `localhost` |
| `DB_PORT` | MySQL 端口 | `3306` |

## 开发规范

- Vue 组件使用 `<script setup>` + `scss`
- 组件代码块顺序：`script → template → style`
- CSS 变量：主题色 `--brand-blue`，背景 `var(--bg-primary)`
- 使用 `minixs.scss` 全局混入处理 flex / 响应式断点
- 后端跨域仅限配置的域名，禁止 `CORS_ALLOW_ALL_ORIGINS = True` 用于生产