会员自助提币机程序开发文档

# 1.   文档说明

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

# 2.   项目目标

由于同一会员在电玩区娱乐时，可能会有多次提币需求，当在节假日期间，客户较多，从而兑换实币需求增大，其中必有部分客户为非会员，而非会员的实币兑换过程相对耗时，而且还必须要由店员来操作进行售卖和兑换，此时就可能存在长时间排队等待的情况，当会员有提币需求时，可以自行到提币机台，提供会员二维码和提币码进行提币操作即可，减少客户的等候时间，进一步提升客户使用感受。

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

# 3.数据表设计

| 表 名    |          |                            |         |          |  |
| -------- | -------- | :------------------------: | ------- | -------- | - |
| 中文描述 |          |                            |         |          |  |
| 建立日期 |          |                            |         | 修改日期 |  |
| 列 名    | 中文描述 | 数据类型<br />（精度范围） | 空/非空 | 是否主键 | 备 注|
|          |          |                            |         |      |     |
| 补充说明 |          |                            |         |      |     |

# 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/a*pi |
| ----------------- | ------------------------------- |

入参：

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

出参：

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

## 5.4 **临时卡验证**

调用：

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

入参：

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

出参：

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

## 5.5 **临时卡提币**

调用：

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

入参：

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

出参：

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

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

调用：

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

入参：

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

出参：

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

# 6.实施内容

## 6.1 概况描述

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

## 6.2程序初始化

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

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

### 6.2.3 逻辑描述：

1. 程序运行前，将读取与程序同名的ini类型配置文件（配置项有：程序连接数据库）；
2. 启动程序时，会读取ini配置文件所指向的数据库（正式/测试）；
3. 获取数据库指向后，建立数据库连接，将进行运行程序电脑权限验证，当运行电脑未在后台系统中有注册且通过允许，将会在运行程序时进行提示，程序将返回，不再继续执行后续业务逻辑；
4. 程序电脑权限验证通过后，将自动识别扫码器硬件设备，如果扫码器识别或打开失败，程序将会提示连接设备失败，需要进行硬件设备检查处理；
5. 扫码器连接成功后，将在程序界面提示客户可以进行提币二维码或会员二维码的扫描进行提币；
6. 程序在运行过程中，会定期向后台接口服务器发送心跳包，检查当前与服务器连接是否通畅，只有在通畅的情况下，才可以扫码核销进行提币操作（因为在扫描会员二维码后，需要在系统中对会员的资产进行相应的扣减）；
7. 扫描二维码时，正确二维码会有两种类型（提币二维码，会员二维码），系统会根据识别到的二维码类型进行判断，当非本系统二维码将会给出提醒；
8. 扫描二维码为提币码时，将自动提取出二维码对应的全部实币，出币后，对二维码进行核销处理；当扫描二维码为会员码时，系统显示当前会员可提实币数，由会员自行输入提币数量，确认后，进行出币，出币后，对会员的资产进行相应扣减。