Meland Club-手环自助打印程序开发文档

# 1.   文档说明

本文档作为乐的文化管理系统的手环自助打印程序的开发文档，对项目中使用的技术标准和技术开发方案进行描述。

# 2.   项目目标

由于在节假日人流量高峰期间，会员以及非会员人员较多，为了解决顾客的长时间等待问题，将顾客入园前的销售，兑换工作进行分流，会员客户可以通过微信小程序进行入园预约，预约完成后，打开预约信息进入二维码页面可以使用二维码，在园区内设置的手环自助打印机上进行自助打印入园手环，可以进一步减少顾客的等待时间，加快入园步骤。

# 3.数据表设计

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

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

## 4.1 数据字典

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

## 4.2 全局变量

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

# 5.接口设计

## 5.1 机台设备验证接口

调用：

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

入参：

| **参数名** | **类型** | **说明**                                                                                  | **备注** |
| ---------------- | -------------- | ----------------------------------------------------------------------------------------------- | -------------- |
| Data             | string         | hdd(硬盘编码):XXXXX; mac(网卡地址):XXXXX; pc_name(电脑名称):XXXXX; dev_type(设备类型)：bracelet |                |
| Method           | string         | deviceParams                                                                                    |                |

出参：

| **参数名** | **类型** | **说明**                       |
| ---------------- | -------------- | ------------------------------------ |
| Json             | Object         | 通过电脑信息验证成功后的配置参数信息 |

## 5.2 获取预约码手环接口

调用：

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

入参：

| **参数名** | **类型** | **说明** | **备注** |
| ---------------- | -------------- | -------------- | -------------- |
| Data             | string         | Code：xxxx     | 小程序预约码   |
| Method           | string         | takeBracelet   |                |

出参：

| **参数名** | **类型** | **说明**               |
| ---------------- | -------------- | ---------------------------- |
| Json             | Object         | 小程序预约码所对应的手环列表 |

# 6.实施内容

## 6.1概况描述

会员客户在入园前，通过微信小程序提前进行入园预约，到店后通过微信小程序预约信息中生成的预约二维码自行在门店内设置的手环自助打印机进行入园手环打印，将打印的二维码扫码，在园区门口的闸机扫码，开启闸机，即可进入园区。

## 6.2程序初始化
### （1）模块名称：程序初始化
### （2）模块路径：手环自助打印程序 > 程序初始化
### （3）逻辑描述：

1、在自助打印程序运行前，还需要运行PrinterConfig.exe程序，对打印程序所需要的打印机进行配置（分别配置打印小孩手环打印机；打印大人手环打印机；切刀执行延时时间（单位：毫秒）），选择好打印机及延时时间后确认，关闭打印机配置程序即可；

2、启动自助打印程序，程序会通过接口5.1进行授权，授权通过后，程序会将机台参数返回，程序将根据返回参数对程序进行初始化设置（程序展示预设的置背景图片，门店名称及版本号），并循环遍历系统中所有串口，自动发送命令识别并连接“二维码扫码器（0x55, 0xAA, 0x01, 0x00, 0x00, 0xFE）”和“手环切纸刀（0x02, 0x53, 0x54, 0x03, 0x06, 0x05）”设备，并启动任务检测机台与系统服务器的连接，如连接不通时提示“网络故障”，程序将不识别预约二维码；

3、程序初始化成功之后，将提示用户可以扫描二维码打印手环，创建任务侦听用户扫码动作，具体逻辑如下：

A、程序以每秒100次的频率侦听用户扫描二维码动作；

B、程序将对接收到的二维码信息进行识别判断（扫码数据信息以“book|”字符开关），当不满足数据格式，从程序端就将数据抛弃并提示；

C、二维码内容格式验证通过后，程序将调用接口5.2，将二维码发送到后台系统进行二维码的有效性验证，验证无误后则将预约码所对应的“手环编码”列表返回到程序端进行后续打印；如果验证失败，程序端则给出提示，失败原因，后续打印将终止;

D、程序将接收到的手环列表分别调用预先配置好的2台打印机进行打印，默认第一个打印机打印儿童手环（手环列表中的第一个）；第二个打印机打印成人手环（第2个到最后一个）；

E、手环打印完成后，程序将延时预设置时间后，发送命令（切刀1：0x02, 0x51, 0x31, 0x03, 0x61, 0x05；切刀2：0x02, 0x51, 0x32, 0x03, 0x61, 0x05；切刀1和2：0x02, 0x54, 0x53, 0x03, 0x06, 0x05）调用切刀将手环裁切，执行完成后，提示用户可以拿取手环；

F、提示手环可以拿取后，继续重复执行步骤A-E。