web-danmu/README.md

# Django弹幕活动系统

## 项目简介

这是一个基于Django框架开发的弹幕活动系统，用于在活动现场展示实时弹幕消息。系统支持用户扫码提交弹幕，管理员审核后在主页面展示。

## 主要功能

1. **活动设置**
   - 支持上传背景图片或视频
   - 支持上传二维码图片并设置位置
   - 支持自定义弹幕字体颜色和背景颜色
   - 支持设置全局背景颜色

2. **弹幕提交**
   - 用户扫码进入提交页面
   - 支持输入姓名和祝福语
   - 支持上传图片
   - 提供随机祝福语参考

3. **弹幕审核**
   - 管理员可查看待审核弹幕
   - 支持审核通过或拒绝弹幕
   - 按时间倒序展示待审核弹幕

4. **弹幕展示**
   - 主页面实时展示已审核的弹幕
   - 支持展示图片弹幕
   - 按时间倒序展示弹幕

5. **API接口**
   - 提供获取实时弹幕的API接口
   - 支持获取最近50条已审核弹幕

## 技术栈

- 后端框架：Django
- 数据库：SQLite3
- 前端技术：HTML、CSS、JavaScript
- 图片存储：本地文件系统

## 项目结构

```
弹幕活动/
├── activity/            # 活动应用
│   ├── migrations/      # 数据库迁移文件
│   ├── templates/       # 模板文件
│   ├── __init__.py
│   ├── admin.py         # 后台管理配置
│   ├── apps.py          # 应用配置
│   ├── forms.py         # 表单定义
│   ├── models.py        # 数据模型
│   ├── tests.py         # 测试文件
│   ├── urls.py          # 路由配置
│   ├── utils.py         # 工具函数
│   └── views.py         # 视图函数
├── danmu_activity/      # 项目配置
│   ├── __init__.py
│   ├── asgi.py
│   ├── settings.py      # 项目设置
│   ├── urls.py          # 项目路由
│   └── wsgi.py
├── media/               # 媒体文件存储
│   └── activity_media/  # 活动媒体文件
├── add_default_blessings.py  # 添加默认祝福语脚本
├── add_test_danmus.py   # 添加测试弹幕脚本
├── create_setting.py    # 创建活动设置脚本
├── db.sqlite3           # SQLite数据库文件
├── manage.py            # Django管理脚本
└── .gitignore           # Git忽略配置
```

## 安装与运行

### 环境要求

- Python 3.7+
- Django 3.0+

### 安装步骤

1. 克隆项目到本地

2. 进入项目目录

3. 创建虚拟环境（可选）
   ```bash
   python -m venv venv
   ```

4. 激活虚拟环境
   - Windows：
     ```bash
     venv\Scripts\activate
     ```
   - Linux/macOS：
     ```bash
     source venv/bin/activate
     ```

5. 安装依赖
   ```bash
   pip install -r requirements.txt
   ```
   （注：如果没有requirements.txt文件，可运行`pip install django`安装Django）

6. 数据库迁移
   ```bash
   python manage.py migrate
   ```

7. 创建超级用户（可选，用于后台管理）
   ```bash
   python manage.py createsuperuser
   ```

8. 添加默认数据
   ```bash
   python add_default_blessings.py
   python create_setting.py
   ```

9. 运行开发服务器
   ```bash
   python manage.py runserver
   ```

10. 访问项目
    - 主页面：http://localhost:8000
    - 扫码提交页面：http://localhost:8000/submit
    - 管理员审核页面：http://localhost:8000/admin-review
    - 活动设置页面：http://localhost:8000/setting
    - 弹幕API：http://localhost:8000/api/danmu

## 使用说明

1. **活动前准备**
   - 进入活动设置页面（/setting）上传背景图片/视频和二维码图片
   - 根据需要调整二维码位置和弹幕样式

2. **活动现场**
   - 在大屏幕上展示主页面（/）
   - 用户扫码进入提交页面（/submit）提交弹幕
   - 管理员在后台实时审核弹幕（/admin-review）

3. **活动结束**
   - 可通过后台管理查看所有弹幕数据

## 注意事项

1. 建议在生产环境中使用MySQL或PostgreSQL数据库
2. 建议配置静态文件和媒体文件的CDN加速
3. 建议定期备份数据库和媒体文件
4. 生产环境中请修改SECRET_KEY和DEBUG设置

## 许可证

本项目采用MIT许可证。