如何快速搭建酷炫的3D球体抽奖程序？年会必备的Lottery终极指南 🎉

Lottery 是一款基于Express + Three.js开发的3D球体抽奖程序，专为年会、晚宴等活动设计。它支持Excel一键导入参与者信息、灵活配置奖品内容，并能自动导出抽奖结果，让你的活动抽奖环节既高效又充满科技感。

🚀 为什么选择Lottery 3D抽奖程序？

✨ 核心功能亮点

• 沉浸式3D抽奖体验：采用Three.js打造动态旋转的3D球体抽奖界面，支持自定义球体转速与动画效果
• 全流程数据管理：通过server/data/users.xlsx导入参与者信息，抽奖结果自动保存并导出Excel
• 零代码灵活配置：修改server/config.js即可自定义奖品类型、数量与展示图片
• 开箱即用部署：提供Docker容器化方案，3分钟完成环境搭建

🎭 适用场景

• 企业年会抽奖环节
• 校园活动幸运抽奖
• 社团聚会互动游戏
• 线上直播抽奖活动

📸 3D抽奖界面展示

图1：Lottery程序的3D球体抽奖界面，支持实时旋转与动态效果

图2：自定义奖品图片展示，支持jpg/png等格式

🔧 超简单安装步骤

1️⃣ 环境准备

确保已安装Node.js（v14+）和Git工具

2️⃣ 一键部署

git clone https://gitcode.com/gh_mirrors/lo/lottery
cd lottery
# 安装后端依赖
cd server && npm install
# 安装前端依赖
cd ../product && npm install
# 启动开发环境
npm run dev

3️⃣ Docker部署方案（推荐）

# 构建镜像
./build.sh latest
# 启动容器
docker-compose up -d

⚙️ 3分钟配置指南

📋 参与者信息配置

1. 打开server/data/users.xlsx文件
2. 按模板格式填写姓名、工号等信息
3. 保存文件即可自动加载数据

🎁 奖品信息配置

修改server/config.js文件设置奖品：

// 示例配置
{
  type: 2,          // 奖品类型ID
  count: 5,         // 奖品数量
  text: "一等奖",   // 奖品名称
  title: "MacBook Pro", // 奖品描述
  img: "../img/mbp.jpg" // 奖品图片路径
}

🏢 企业信息定制

修改server/config.js中的企业标识：

const COMPANY = "你的公司名称"; // 显示在抽奖卡片上的企业标识

💡 使用技巧与注意事项

• 性能优化：在product/lottery/canvas.js中调整球体分段数控制渲染性能
• 数据安全：抽奖结果自动保存在服务器，可通过server/data/目录备份
• 故障排除：运行异常时查看server/help.js获取常见问题解决方案

🎯 常见问题

Q: 如何修改抽奖动画速度？
A: 编辑product/lottery/index.js中的旋转速度参数

Q: 最多支持多少人参与抽奖？
A: 理论无上限，建议单次抽奖不超过1000人以保证流畅度

📄 许可证信息

本项目采用MIT开源协议，详细条款见项目根目录LICENSE文件

提示：项目源码结构清晰，前端代码位于product/目录，后端服务代码位于server/目录，二次开发友好！

通过Lottery抽奖程序，让你的年会抽奖环节告别传统纸质抽奖箱，拥抱科技感十足的3D互动体验吧！如有任何问题，欢迎查阅项目文档或提交Issue。