Tsinghua Automation Student Festival Lottery Program

清华大学自动化系 2025 & 2026 年 DreamAwake 学生节抽奖程序，基于 lottery 项目开发。

技术

技术：Node + Express + Three.js

后台通过 Express 实现

前端抽奖界面通过 Three.js 实现 3D 抽奖球，引用了 Three.js 的官方 3D 示例

功能描述

1. 可将抽奖结果进行保存实时下载到 Excel 中🎉
2. 已抽取人员不在参与抽取，抽中的人员不在现场可以重新抽取🎁
3. 刷新或者关掉服务器，会保存当前已抽取的数据，不会进行数据重置，只有点击界面上的重置按钮，才能重置抽奖数据🧧
4. 每次抽取的奖品数目可配置🎈
5. 抽取完所有奖品后还可以继续抽取特别奖(例如追加的奖品等)，此时默认一次抽取一个🧨

安装

git clone https://github.com/thuasta/dreamawake-lottery.git

cd dreamawake-lottery

# 服务端插件安装
cd server
npm install

# 前端插件安装
cd ../product
npm install

# 打包
npm run build

# 运行
npm run serve

# 开发调试
npm run dev

目录结构

dreamawake-Lottery
├── product
│   ├── src
│   │   ├── lottery
│   │   │   └── index.js
│   │   ├── lib
│   │   ├── img
│   │   ├── css
│   │   └── data
│   ├── package.json
│   └── webpack.config.js
├── server
│   ├── config.js
│   ├── server.js
│   └── package.js

1. product 为前端页面目录
2. package.josn web 项目配置文件
3. webpack.config.js 打包配置文件
4. server 为服务器目录
5. config 为奖品信息的配置文件

配置信息

抽奖用户信息配置

抽奖用户信息在 server/data/user.xlsx 文件中，按文件格式进行填充，不能修改文件名和列头

奖品信息配置

奖品的配置信息填写在 server/config.js 文件中，不能修改文件名。

其中奖品 prizes 的配置描述如下：

参数	值类型	描述
type	Number	奖品类型，唯一标识，0 是默认特别奖的占位符，其它奖品不可使用
count	Number	奖品数量
text	String	奖项名称
title	String	奖品描述
img	String	奖品的图片地址，图片在 img 目录下

// 奖品信息，第一项为预留项不可修改，其他项可根据需要修改
let prizes = [{
        type: 0,
        count: 1000,
        title: "",
        text: "特别奖"
    },
    {
        type: 1,
        count: 2,
        text: "特等奖",
        title: "神秘大礼",
        img: "../img/secrit.jpg"
    },
    {
        type: 2,
        count: 5,
        text: "一等奖",
        title: "Mac Pro",
        img: "../img/mbp.jpg"
    }
    ...
];

奖品每次抽取个数配置

EACH_COUNT用于配置每次的抽奖个数，与 prizes 奖品一一对应，例如上面的奖品配置对应的抽奖个数配置如下：

const EACH_COUNT = [1, 1, 5];

如上配置，表示一次抽取的奖品个数顺序为：特别奖每次抽一个，特等奖每次抽一个，一等奖每次抽五个

标识配置

该标识用于显示在抽奖卡片上

const COMPANY = "DreamAwake";

Docker部署方案

系统要求

确保已经安装以下软件：

• Docker（请参阅 Docker 的官方文档以获取安装说明）
• Docker Compose

安装

1. 下载并解压该项目的源代码。

2. 进入解压后的项目目录。

3. 执行以下命令以构建Docker镜像：

   ./build.sh [TAG]

   这将使用 Dockerfile 构建一个名为 lottery:[TAG] 的 Docker 镜像。如果未指定标签，则默认使用 latest 标签。

4. 执行以下命令以在本地运行容器：

   ./dev.sh [TAG]

   这将启动容器并将应用程序部署在 Docker 容器中。请注意，容器内部的应用程序将会监听 8888 端口和 443 端口。

5. 执行以下命令以将 Docker 镜像标记并推送到远程 Docker 仓库：

   ./tagpush.sh [TAG]

   这将为 Docker 镜像打上标签并将其推送到远程Docker仓库，如要使用 docker 官方的 hub 请先在 https://hub.docker.com/ 新建自己的 repo，然后将文件中的用户名改为自己。请注意，[TAG] 应替换为要使用的标签名称。

6. 确保有一个名为 docker-compose.yml 的文件，并添加以下内容：

   version: '3.8'
   
   volumes:
     lottery_log:
   
   services:
     lottery:
       container_name: lottery
       expose:
         - 8888
       ports:
         - "28458:8888"
         - "443:443"
       volumes:
         - "lottery_log:/var/log"
       image: "panda1024/lottery:[TAG]" 
       restart: always

   请注意，[TAG] 应替换为需推送到 Docker 仓库的镜像名称。

7. 在服务器上的项目目录中运行以下命令以使用 Docker Compose 部署应用程序：

docker-compose up -d

​这将启动一个 Docker Compose 堆栈，并将该项目部署在其中。请注意，此处将容器的 8888 端口和 443 端口映射到了服务器上的 8888 端口和 443 端口。如果希望使用其他端口，请相应地更改 docker-compose.yml 文件。

License

MIT