增加了项目说明

README.md

@@ -0,0 +1,159 @@
+# 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许可证。