Docker-Lottery(抽奖程序)

[Lottery](https://github.com/moshang-xc/lottery) 是一个年会抽奖程序，3D 球体抽奖，支持奖品信息配置，参与抽奖人员信息Excel导入，抽奖结果Excel导出

**相关链接：**
体验地址：https://moshang-xc.github.io/lottery
GitHub：https://github.com/moshang-xc/lottery
GitHub(合并前后端)：https://github.com/GAtomis/lottery-web
其他抽奖：[lucky-draw](https://github.com/vitozyf/lucky-draw)

## Docker 版
官方有 [详细教程](https://github.com/moshang-xc/lottery/blob/master/DockerfileREADME.md)，根据教程搭建

## Node 版
这个可以做成可执行的，放U盘里在任何电脑都可用
```bat
git clone https://ghproxy.com/https://github.com/moshang-xc/lottery.git && cd lottery		# 拉取最新并进入

# 服务端插件安装
cd server		# 进入服务端文件夹
npm install		# 安装服务端环境

# 前端插件安装
cd ../product		# 进入前端文件夹
npm install		# 安装前端环境

# 必须在前端文件夹下运行才有效
npm run dev		# 开发调试，保存修改后会自动更新服务
npm run build		# 打包
npm run serve		# 运行，如果有修改先运行打包才有效
```
打包可执行文件，这里使用 Windows 举例
把 `node.exe` 可执行文件放到 `lottery` 根目录下，编写个脚本辅助运行
```bat
REM 移动到项目执行文件夹，查看 product\package.json 可知
cd product/dist
REM 执行运行，因为要调用指定 node可执行文件，写的是运行对应代码，查看 product\package.json 可知
REM 执行运行前需要先正常执行一次打包命令，不然可能不是最新的
..\..\node.exe ..\..\server\index.js 8888
```

## 抽奖相关修改项
**相关修改项所对应路径**
- `server\data\users.xlsx`，修改 人员名单
- `server\config.js`，修改 奖项设置，公司标识
- `product\src\img`，图片存放路径
- `product\src\lottery\index.js`，抽奖逻辑主体，抽奖算法修改就修改这个

### 修改抽奖算法
原版的是纯看脸的，对于我这种非洲脸非常不友好，我们可以认为做一些小小的调整
算法这种东西有很多种实现方式，这里我就举例我的一个实现思路，肯定不是最优解就是个记录
>修改算法前首先说下如何查看调试
> 程序中 `console.log(<输出内容>);` 就是输出调试信息，可在 `浏览器F12-控制台(Console)` 中进行查看

`基于一个人只能中奖一次来做的`，修改文件是 `product\src\lottery\index.js`
**思路详解：**
1. 确定抽奖主体
这里抽奖主体是 `function lottery()`函数
所有的抽奖，以及返回抽奖信息都是在这个函数中进行的
2. 准备黑白名单
白名单自然是为了增加中奖概率，黑名单是为了干掉那些非常欧气或是厌恶的
```javascript
// 文件开头添加
var whitelist = [['编号1','人员1','区域'],['编号2','人员2','区域'],['编号3','人员3','区域'],['编号4','人员4','区域'],['编号5','人员5','区域']];		//白名单必须要带详细信息
var blacklist = ['人员1','人员2','人员3','人员4','人员5'];		//黑名单只需要名称或是编号就行
```
3. 抽奖名单剔除
两个作用：1.防止白名单的折在辣鸡奖项上；2.剔除黑名单人员
```javascript
// 之前说过，抽奖主体是 function lottery() 函数，所以在这个函数下修改就行
rotateBall().then(() => {
// 添加到这个下面👆
  // 判断当前阶段，是否是刚开始抽，实际剔除一次就行了
  if (currentPrize.type > 2){
    // 遍历所有白名单和当前未中奖名单，查找相同人员
    for(let x=0;x<whitelist.length;x++){
      for(let y=0;y<basicData.leftUsers.length;y++){
        // 判断是否是相同人员，[1]是名字，[0]是序号，根据需求选用
        if(whitelist[x]==basicData.leftUsers[y][1]){
          // 查找到列表中对应人员就从列表中删除，1是删除一次
          basicData.leftUsers.splice(y,1);
        }
      }
    }
    // 遍历所有黑名单和当前未中奖名单，查找相同人员
    for(let x=0;x<blacklist.length;x++){
      for(let y=0;y<basicData.leftUsers.length;y++){
        // 判断是否是相同人员，[1]是名字，[0]是序号，根据需求选用
        if(blacklist[x]==basicData.leftUsers[y][1]){
          // 查找到列表中对应人员就从列表中删除，1是删除一次
          basicData.leftUsers.splice(y,1);
        }
      }
    }
  }
  // 在这个下面也要添加上白名单剔除，防止出现在白名单中和未中奖中的同时被抽中
  if (leftCount < perCount) {
    // 白名单剔除
    for(let x=0;x<whitelist.length;x++){
      for(let y=0;y<basicData.leftUsers.length;y++){
        if(whitelist[x]==basicData.leftUsers[y][1]){
          basicData.leftUsers.splice(y,1);
        }
      }
    }
  }
}
```
4. 修改白名单优先
```javascript
// 修改 function lottery() 函数下的抽奖逻辑
for (let i = 0; i < perCount; i++) {
  // let luckyId = random(leftCount);    // 从未中奖中随机一个数
  // currentLuckys.push(basicData.leftUsers.splice(luckyId, 1)[0]);    // 把中奖人添加到当前抽中名单中
  // 把上面👆原有的两条抽奖替换成下列👇程序
  // 多条件一起判断：抽奖阶段(奖越大优先级越大);白名单列表不能为空;白名单中抽奖人数小于待抽奖指定人数
  // 注意，如果算法有Bug，如果前面没有把白名单抽完，最后的大奖中奖率贼高，基本每次都会抽中
  if(currentPrize.type==0 && Math.random()>0.3 && whitelist.length!=0){
    let id = Math.round(Math.random()*(whitelist.length-1))
    currentLuckys.push(whitelist[id]);
    whitelist.splice(id,1);
  }else if(currentPrize.type==1 && Math.random()>0.5 && whitelist.length!=0 && i<perCount/2){
    let id = Math.round(Math.random()*(whitelist.length-1))
    currentLuckys.push(whitelist[id]);
    whitelist.splice(id,1);
  }else if(currentPrize.type==2 && Math.random()>0.7 && whitelist.length!=0 && i<perCount/2){
    let id = Math.round(Math.random()*(whitelist.length-1))
    currentLuckys.push(whitelist[id]);
    whitelist.splice(id,1);
  }else if(currentPrize.type==3 && Math.random()>0.9 && whitelist.length!=0 && i<perCount/2){
    let id = Math.round(Math.random()*(whitelist.length-1))
    currentLuckys.push(whitelist[id]);
    whitelist.splice(id,1);
  }else{
    let luckyId = random(leftCount);    // 从未中奖中随机一个数
    currentLuckys.push(basicData.leftUsers.splice(luckyId, 1)[0]);    // 把中奖人添加到当前抽中名单中
  }
}
```
5. 重置白名单
白名单在中奖过就会剔除，这样重置后优先级就失效了
```javascript
// 随着重置按键重置白名单
// 添加到 按键重置 项目下
case "reLottery":
  // ...，放在下面这条下面
  currentPrize = basicData.prizes[currentPrizeIndex];
  whitelist = [['编号1','人员1','区域'],['编号2','人员2','区域'],['编号3','人员3','区域'],['编号4','人员4','区域'],['编号5','人员5','区域']];		//白名单
```
```javascript
// 抽奖人不够时随着名单一起重置
// 重置后继续保持优先级，如果不需要优先级了就不进行重置，这样概率就全部一样了
rotateBall().then(() => {
  if (leftCount < perCount) {
    // ...，放在下面这条下面
    leftCount = basicData.leftUsers.length;
    whitelist = [['编号1','人员1','区域'],['编号2','人员2','区域'],['编号3','人员3','区域'],['编号4','人员4','区域'],['编号5','人员5','区域']];
  }
}
```
6. 修复中奖高概率 Bug
随着抽奖增加概率，然后如果中大奖了概率骤减，防止频繁出大奖
```javascript
// 函数最外层定义一个用于存储倍率的全局变量
var probability = 0;
// 修改 function lottery()，rotateBall().then(()=>{}) 函数下的抽奖逻辑
// 设置倍率，不同阶段倍率不一样，大奖设置为倍率增加，中过就减小倍率
switch (currentPrize.type){
  case 3:
    probability = 0.1;
    break;
  case 2:
    probability = 0.3;
    break;
  case 1:
    probability += 0.5;
    break;
  case 0:
    probability += 0.3;
    break;
}
// 上面👆这添加到 for (let i = 0; i<perCount; i++) {} 上面
// for (let i = 0; i<perCount; i++) 下的替换为以下参数
for (let i = 0; i<perCount; i++) {
  if(Math.random()<probability && whitelist.length!=0){
    let id = Math.round(Math.random()*(whitelist.length-1))
    currentLuckys.push(whitelist[id]);
    whitelist.splice(id,1);
    probability -= 0.6;
    if(probability<0) probability = 0;
  }else{
    let luckyId = random(leftCount);    // 从未中奖中随机一个数
    currentLuckys.push(basicData.leftUsers.splice(luckyId, 1)[0]);    // 把中奖人添加到当前抽中名单中
  }
  // ... 上方 For 循环外的保持不变
}
```