# lottery

**Repository Path**: idnex/lottery

## Basic Information

- **Project Name**: lottery
- **Description**: 大转盘
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-20
- **Last Updated**: 2026-03-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 自定义抽奖转盘（Vue + Node + MySQL）

这是一个支持手机端/平板端的自定义抽奖转盘系统：
- 前端：Vue 3 + Vite
- 后端：Node.js + Express
- 数据库：MySQL

## 功能清单

- 前端漂亮转盘展示，适配移动端
- 后台奖品管理（名称、概率、库存、颜色、图片）
- 后台页面风格配置（标题、主题色、按钮色、背景图等）
- 后台批量生成抽奖码
- 前台必须凭抽奖码抽奖
- 后台可查询抽奖码状态（unused/used/redeemed）
- 后台可执行核销，并查看中奖奖品

---

## 目录结构

- `frontend/`：Vue 前端
- `backend/`：Node 后端
- `backend/sql/init.sql`：数据库初始化脚本

---

## 1）初始化数据库

1. 创建数据库并导入：
   - 执行 `backend/sql/init.sql`
2. 修改后端环境变量：
   - 复制 `backend/.env.example` 为 `backend/.env`
   - 按你的 MySQL 配置修改账号密码

---

## 2）启动后端

```bash
cd backend
npm install
npm run dev
```

默认后端地址：`http://localhost:3000`

---

## 3）启动前端

```bash
cd frontend
npm install
npm run dev
```

默认前端地址：`http://localhost:5173`

---

## 页面说明

- 抽奖页：`/`
  - 输入抽奖码后抽奖
- 后台页：`/admin`
  - 配置样式
  - 管理奖品和概率
  - 生成抽奖码
  - 查询/核销抽奖码

---

## 注意事项

1. 概率是相对权重，不要求总和必须 100。比如 5、10、35、50。
2. 抽奖码只能使用一次，使用后可核销。
3. 核销后状态从 `used` 变为 `redeemed`。
4. 建议生产环境把 `/admin` 增加登录鉴权（当前示例未加）。