会员自助取卡机程序开发文档

# 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         | 二维码信息（qrcode） |                  |
| Method           | string         | outTempCardCheck                                       |                  |

出参：

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

## 5.3 **临时卡发卡**

调用：

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

入参：

| **参数名** | **类型** | **说明**                                 | **备注** |
| ---------------- | -------------- | ---------------------------------------------- | -------------- |
| Data             | string         | 会员及卡片信息（qrcode，cardno_inside，cardno_physics） |                |
| Method           | string         | outTempCard                                  |                |

出参：

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

## 5.4 **临时卡回收**

调用：

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

入参：

| **参数名** | **类型** | **说明**                | **备  注** |
| ---------------- | -------------- | ----------------------------- | ---------------- |
| Data             | string         | 卡片信息（cardno_inside，cardno_physics） |                  |
| Method           | string         | returnTempCard               |                  |

出参：

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

# 6.实施内容

## 6.1 概况描述

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

## 6.2程序初始化

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

### 6.2.2 模块路径：自助取卡程序 > 程序初始化

### 6.2.3 逻辑描述：

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

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

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

4：电脑权限验证通过后，将从根据配置参数定义的图片地址，下载到本地，将图片设置为程序窗口背景图片；程序默认连接COM1上的卡机设备，COM2口的扫码头设备；设备连接失败程序将不继续运行，将给出提示到程序界面，由工作人员检查设备后重新启动程序；

5：程序界面初始完成后，将会读取卡机的状态，如：发卡箱状态，收卡箱状态等；

6：程序设备准备完成后，启动任务，实时检查设备与服务器之间的连接状态是否通畅，当程序无法与服务器进行通信时，将无法进行存票操作；

7：提示会员客户可以扫描微信小程序中的二维码，进行自助取卡（调用接口5.3），取卡成功后，将在屏幕居中位置显示成功信息提示；

8：会员在使用完临时卡后，需要在自助发卡机上进行临时卡的归还（调用接口5.4），还卡成功后，将在屏幕居中位置显示成功信息提示；

9：5秒钟之后，程序将会继续提示会员客户可以扫描微信小程序二维码。