园区入园闸机控制服务程序

# 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         | inParkBracelet                                       |                  |

出参：

| **参数名** | **类 型** | **说  明** |
| ---------------- | --------------- | ---------------- |
| Json             | Object          | 进出园处理结果   |

## 5.3 **运动馆-入园**

调用：

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

入参：

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

出参：

| **参数名** | **类型** | **说明** |
| ---------------- | -------------- | -------------- |
| Json             | Object         | 进出园处理结果 |

## 5.4 **检查门店是否启用定位手环**

调用：

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

入参：

| **参数名** | **类型** | **说明**                | **备  注** |
| ---------------- | -------------- | ----------------------------- | ---------------- |
| Data             | string         | store_id | 门店ID                 |
| Method           | string         | checkEnablePositionBra               |                  |

出参：

| **参数名** | **类型** | **说明**         |
| ---------------- | -------------- | ---------------------- |
| Json             | Object         | 启用状态 |

## 5.5 **定位手环解绑归还**

调用：

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

入参：

| **参数名** | **类型** | **说明**                | **备  注** |
| ---------------- | -------------- | ----------------------------- | ---------------- |
| Data             | string         | qr_code,store_id | 手环RFID号，门店ID                 |
| Method           | string         | unbindBracelet               |                  |

出参：

| **参数名** | **类型** | **说明**         |
| ---------------- | -------------- | ---------------------- |
| 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：电脑权限验证通过后，从参数中解析出闸机配置数据，连接闸机设备；同时程序将自动识别并连接扫码头设备；设备连接失败程序将不继续运行，将给出提示到程序界面，由工作人员检查设备后重新启动程序；设备连接完成后程序将调用接口（调用接口5.4）获取当前门店类型，后面将会使用；

5：程序界面初始完成后，将在程序界面输入完成信息，可以接受入园扫码服务；

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

7：提示客户可以扫描手环，系统将会对识别到的信息进行本地格式验证，数据格式通过后，将再传入到后台接口（儿童店调用接口5.2或运动馆调用接口5.3）中进行有效性识别验证，通过手将会开启闸机，进入园区；

8：如果门店类型为运动馆门店，将会在闸机处配置一扫码头，用作快速归还电子手环设备使用，当客户出园手，即可在扫码头扫描电子手环，系统将会自动将手环在客户账号中进行解绑（调用接口5.5），成功手将会在程序中输入提示信息（提示信息在配置文件中进行配置）；

9：出园并归还手环后，整个进园、出园已经流程已经完成