69 lines
1.9 KiB
Markdown
69 lines
1.9 KiB
Markdown
|
# taiko.su
|
||
|
|
|
||
|
|
`taiko.su` 是 [taiko.asia](https://taiko.asia) 的彩蛋站点代码仓库。
|
||
|
|
|
||
|
|
当前站点提供一个精简的单曲活动入口：页面完成开屏加载和 setup 后，自动进入管理员指定的歌曲；游玩结束后生成并保存彩蛋码，用户领取后返回加载完成页面。
|
||
|
|
|
||
|
|
## 功能
|
||
|
|
|
||
|
|
- 开屏加载与 setup 完成页
|
||
|
|
- 管理员指定单首歌曲和固定难度
|
||
|
|
- 单人游玩与结算
|
||
|
|
- 彩蛋码生成、持久化及领取
|
||
|
|
- Token + 彩蛋码双认证 API
|
||
|
|
- 管理员活动设置与彩蛋码记录
|
||
|
|
|
||
|
|
站点版本标识为 `vSU? ??.??.??`。
|
||
|
|
|
||
|
|
## 运行
|
||
|
|
|
||
|
|
项目需要 MongoDB。Redis 为可选依赖，未连接时使用本地文件会话。
|
||
|
|
|
||
|
|
```bash
|
||
|
|
python -m pip install -r requirements.txt
|
||
|
|
python app.py 34801 -b 127.0.0.1
|
||
|
|
```
|
||
|
|
|
||
|
|
生产环境可使用：
|
||
|
|
|
||
|
|
```bash
|
||
|
|
sudo bash setup.sh
|
||
|
|
```
|
||
|
|
|
||
|
|
首次部署时，脚本会引导创建管理员。管理员入口为 `/1128admin1128`，后台可以选择数据库中已启用的歌曲、固定游玩难度，并设置彩蛋码验证 Token。
|
||
|
|
|
||
|
|
## 彩蛋码验证 API
|
||
|
|
|
||
|
|
```http
|
||
|
|
POST /api/easter-eggs/verify
|
||
|
|
Authorization: Bearer <管理员设置的 Token>
|
||
|
|
Content-Type: application/json
|
||
|
|
|
||
|
|
{"code":"AI4-XXXX-XXXX"}
|
||
|
|
```
|
||
|
|
|
||
|
|
也可以通过 `X-Verification-Token` 请求头传递 Token。
|
||
|
|
|
||
|
|
- Token 与彩蛋码均正确：返回 HTTP 200 和 `{"success":true}`
|
||
|
|
- Token 缺失或错误：返回 HTTP 401
|
||
|
|
- Token 正确但彩蛋码无效：返回 HTTP 200 和 `{"success":false}`
|
||
|
|
|
||
|
|
## 数据集合
|
||
|
|
|
||
|
|
- 歌曲：`songs`
|
||
|
|
- 活动设置：`experience_settings`
|
||
|
|
- 彩蛋码：`easter_egg_codes`
|
||
|
|
- 管理员：`users` 集合中 `user_level >= 50` 的账号
|
||
|
|
|
||
|
|
## 项目范围
|
||
|
|
|
||
|
|
本仓库只维护 `taiko.su` 彩蛋站点所需的加载、单曲游玩、彩蛋码和管理员配置功能，不包含歌曲上传、用户中心、排行榜、社交、多人、AI 对战或谱面编辑器。
|
||
|
|
|
||
|
|
## 仓库
|
||
|
|
|
||
|
|
项目现已迁移至：
|
||
|
|
|
||
|
|
```text
|
||
|
|
https://code.taiko.im/Superories/taiko.su.git
|
||
|
|
```
|