会员自助存票机程序开发文档

# 1.   文档说明

本文档作为乐的文化管理系统的会员自助存票机程序，对会员客户在电玩区内实现自助存票功能程序的开发文档，对项目中使用的技术标准和技术开发方案进行描述。

# 2.   项目目标

由于会员在电玩区娱乐时，可能会有多次存票需求，当在节假日期间，客户较多，从而存票需求增大，此时就可能存在长时间排队等待的情况，当会员有存票需求时，可以自行到自助存票机台，提供会员二维码进行存票操作即可，减少客户的等候时间，进一步提升客户使用感受。

通过以上目标的实现，最终客户在不需要等待或长时等待即可自助存票，以达到整个数据完整性、统一性、安全性、可追溯性机制，从而满足工作需要，提高工作效率。

# 3.数据表设计

| 表 名    |          |          |         |          |  |
| -------- | -------- | -------- | ------- | -------- | - |
| 中文描述 |          |          |         |          |  |
| 建立日期 |          |          |         | 修改日期 |  |
| 列 名    | 中文描述 | 数据类型 | 空/非空 | 主键     |  备  注 |
|          |          |           |         |           |                            |
| 补充说明 |          |           |         |           |                            |

# 4.数据字典/全局变量

4.1 数据字典

| **字典名称** | **类  型** | **键** | **值** |
| ------------------ | ---------------- | ------------ | ------------ |
|                    |                  |              |              |

4.2 全局变量

| 变量名称 | 访问路径 |值|说  明
| - | - | - | - |
|  |  |  |  |

# 5.接口设计

## 5.1 获取机台配置信息

调用：

| **调用URL** | https://cash.melands.cn/api |
| ----------------- | ------------------------------- |

入参：

| **参数名** | **类型** | **说明**                                   | **备  注** |
| ---------------- | -------------- | ------------------------------------------------ | ---------------- |
| Data             | string         | 机台信息（hdd，mac，pc_name，dev_type，version） |                  |
| Method           | string         | deviceParams                                     |                  |

出参：

| **参数名** | **类型** | **说明**     |
| ---------------- | -------------- | ------------------ |
| Json             | Object         | 自助提币机配置参数 |

## 5.2 **会员卡验证**

调用：

| **调用URL** | https://cash.melands.cn/api |
| ----------------- | ------------------------------- |

入参：

| **参数名** | **类型** | **说明**                                       | **备  注** |
| ---------------- | -------------- | ---------------------------------------------------- | ---------------- |
| Data             | string         | 卡片信息（type，leagno，card_no，card_id，card_pwd） |                  |
| Method           | string         | entityCardInfo                                       |                  |

出参：

| **参数名** | **类 型** | **说  明** |
| ---------------- | --------------- | ---------------- |
| Json             | Object          | 当前会员卡信息   |

## 5.3 **临时卡验证**

调用：

| **调用URL** | https://cash.melands.cn/api |
| ----------------- | ------------------------------- |

入参：

| **参数名** | **类型** | **说明**                                 | **备注** |
| ---------------- | -------------- | ---------------------------------------------- | -------------- |
| Data             | string         | 卡片信息（temp_id，entity_id，pwd，check_pwd） |                |
| Method           | string         | checkTempCard                                  |                |

出参：

| **参数名** | **类型** | **说明** |
| ---------------- | -------------- | -------------- |
| Json             | Object         | 当前临时卡信息 |

## 5.4 **临时卡提币**

调用：

| **调用URL** | https://cash.melands.cn/api |
| ----------------- | ------------------------------- |

入参：

| **参数名** | **类型** | **说明**                | **备  注** |
| ---------------- | -------------- | ----------------------------- | ---------------- |
| Data             | string         | 卡片信息（card_id，draw_num） |                  |
| Method           | string         | extractCoinTemp               |                  |

出参：

| **参数名** | **类型** | **说明**         |
| ---------------- | -------------- | ---------------------- |
| Json             | Object         | 当前临时卡提币结果信息 |

## 5.5 **会员二维码验证**

调用：

| **调用URL** | https://cash.melands.cn/api |
| ----------------- | ------------------------------- |

入参：

| **参数名** | **类型** | **说明** | **备  注** |
| ---------------- | -------------- | -------------- | ---------------- |
| Data             | string         | qr_code        |                  |
| Method           | string         | cardInfo       |                  |

出参：

| **参数名** | **类型** | **说明**                               |
| ---------------- | -------------- | -------------------------------------------- |
| Json             | Object         | 当前验证会员码结果信息（成功后返回会员信息） |

## 5.6 **会员存票**

调用：

| **调用URL** | https://cash.melands.cn/api |
| ----------------- | ------------------------------- |

入参：

| **参数名** | **类型** | **说明**                     | **备  注** |
| ---------------- | -------------- | ---------------------------------- | ---------------- |
| Data             | string         | 会员卡号：card_no；存票数量：coins |                  |
| Method           | string         | saveTicket                         |                  |

出参：

| **参数名** | **类型** | **说明**                               |
| ---------------- | -------------- | -------------------------------------------- |
| Json             | Object         | 当前验证会员码结果信息（成功后返回会员信息） |

## 5.7 **会员存币**

调用：

| **调用URL** | https://cash.melands.cn/api |
| ----------------- | ------------------------------- |

入参：

| **参数名** | **类型** | **说明**                     | **备  注** |
| ---------------- | -------------- | ---------------------------------- | ---------------- |
| Data             | string         | 会员卡号：card_no；存币数量：coins |                  |
| Method           | string         | saveCoin                           |                  |

出参：

| **参数名** | **类型** | **说明**                               |
| ---------------- | -------------- | -------------------------------------------- |
| Json             | Object         | 当前验证会员码结果信息（成功后返回会员信息） |

## 5.8 **临时卡存票**

调用：

| **调用URL** | https://cash.melands.cn/api |
| ----------------- | ------------------------------- |

入参：

| **参数名** | **类型** | **说明**                       | **备  注** |
| ---------------- | -------------- | ------------------------------------ | ---------------- |
| Data             | string         | 会员卡号：card_id；存票数量：tickets |                  |
| Method           | string         | saveTicketTemp                       |                  |

出参：

| **参数名** | **类型** | **说明**                               |
| ---------------- | -------------- | -------------------------------------------- |
| Json             | Object         | 当前验证会员码结果信息（成功后返回会员信息） |

## 5.9 **临时卡存币**

调用：

| **调用URL** | https://cash.melands.cn/api |
| ----------------- | ------------------------------- |

入参：

| **参数名** | **类型** | **说明**                     | **备  注** |
| ---------------- | -------------- | ---------------------------------- | ---------------- |
| Data             | string         | 会员卡号：card_id；存票数量：coins |                  |
| Method           | string         | saveCoinTemp                       |                  |

出参：

| **参数名** | **类型** | **说明**                               |
| ---------------- | -------------- | -------------------------------------------- |
| Json             | Object         | 当前验证会员码结果信息（成功后返回会员信息） |

## 5.10 **获取助力卡信息**

调用：

| **调用URL** | https://cash.melands.cn/api |
| ----------------- | ------------------------------- |

入参：

| **参数名** | **类型** | **说明**     | **备  注** |
| ---------------- | -------------- | ------------------ | ---------------- |
| Data             | string         | 门店编号：store_id |                  |
| Method           | string         | saveTicketSelect   |                  |

出参：

| **参数名** | **类型** | **说明**         |
| ---------------- | -------------- | ---------------------- |
| Json             | Object         | 当前门店开启助力卡信息 |

# 6.实施内容

## 6.1 概况描述

会员自助提币程序主要就是解决客户在娱乐前时，需要兑换实币的过程中，由于客户过多，从而以自助提币方式减少客户在提币时的排队等待时间，给客户节约时间，提升客户使用感受，同时也能减轻门店员工的工作压力。

## 6.2程序初始化

### 6.2.1 模块名称：程序初始化

### 6.2.2 模块路径：自助提币程序 > 程序初始化

### 6.2.3 逻辑描述：

1：程序运行前，将读取与程序同名的ini类型配置文件（配置项有：程序连接数据库）；

2：启动程序时，会读取ini配置文件所指向的数据库：link_system（正式系统/待上线系统/测试系统）；

3：获取数据库指向后，建立数据库连接，将进行运行程序电脑权限验证，当运行电脑未在后台系统中有注册且通过允许，将会在运行程序时进行提示，程序将返回，不再继续执行后续业务逻辑；

4：电脑权限验证通过后，将从根据配置参数定义的“存票机”参数初始化程序界面应该显示的存票机窗口（1，2个存票机），同时将分别在远程地址下载对应1，2个存票机程序的背景图片作为程序背景；

5：程序界面初始完成后，将会依次将每个“存票机”所对应的扫码头启动，如果其中有一个扫码头启动失败，程序将给将会给出提示，并定时结束程序；

6：程序设备准备完成后，启动任务，实时检查设备与服务器之间的连接状态是否通畅，当程序无法与服务器进行通信时，将不能在存票机上进行存票操作，此时程序将会在程序界面给出提示；

7：程序会创建任务，检查错误标识，确定当前程序是否可以退出；

8：会员在存票之前，需要扫描会员的“会员IC卡”或“会员二维码”，最后彩票数据将会存入到“会员IC卡”或“二维码”所对应的会员账号中；

9：程序会在每30秒做一次存票动作，将当前机台读取到的彩票数量保存到系统中，存票数据通过接口成功保存后，会将程序界面存票会员信息进行重置，以方便下一次或其他顾客进行存票操作，如还需要继续存票，需要会员再次扫码或刷卡，如果保存彩票数据失败则会给出提示。