# surprise-service

**Repository Path**: dlcoolcat/surprise-service

## Basic Information

- **Project Name**: surprise-service
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2020-12-17
- **Last Updated**: 2020-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 年会抽奖程序 - 服务器端
Web浏览器版抽奖程序，采用Spring Boot + Sqlite + ReactJS搭建。

此工程是服务器端程序，前端工程请查看[surprise-web](https://gitee.com/dlcoolcat/surprise-web)。

## 介绍
### DB
请编辑`src/main/resources/db/{env}/init-data.sql`文件内容，初始化基础数据。

`s_round`存储轮次信息。

`s_user`存储参与抽奖的人员信息，表里`status`为`1`的所有用户都会参与每个轮次的抽奖，`is_grand_winner`标识是否中过贵重奖品，曾经获得过贵重奖品者在其他轮次无法再次得到贵重奖品。

`s_prize`存储所有奖品，分轮次存，轮次内也可以重复同款奖品。`is_grand`标识是否是贵重奖品。

`s_winning_hist`存储中奖记录

### application.yml
```
spring.datasource.initialization-mode: always
```
默认每次都会用`schema.sql`和`init-data.sql`重新创建数据库并初始化数据，
若想禁用，请把`always`改为`never`即可。

### APIs
|  Path   |  Method   | 说明  |
|  ----  |  ----  | ----  |
| /round/list  | GET | 获取轮次列表 |
| /user/list  | GET | 获取用户列表 |
| /round/{roundID}/prize/list  | GET | 获取某个轮次的奖品列表 |
| /round/{roundID}/surprise  | GET | 抽奖 |

### ERROR CODE定义
|  CODE   |  名称   | 说明  |
|  ----  |  ----  | ----  |
|  10000 | DEFAULT | 缺省 |
|  10001 | RETRIEVE_ERROR | 读取错误 |
|  10002 | CREATE_ERROR | 增加错误 |
|  10003 | UPDATE_ERROR | 更新错误 |
|  10004 | DELETE_ERROR | 删除错误 |
|  20000 | DEFAULT | 缺省 |
|  20001 | ILLEGAL_ARGUMENT | 非法参数 |
|  20005 | NOT_FOUND | 数据不存在 |
|  20007 | HAS_BEEN_DISABLED | 数据已被禁用 |