运动馆 - 自助取票服务程序开发文档（宝比打印机版本）

# 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            | 自助取材机配置参数 |

## 5.2 会员/三方平台核销二维码**验证**

调用：

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

入参：

| **参数名** | **类型** | **说明**    | **备  注** |
| ---------------- | -------------- | ----------------- | ---------------- |
| Data             | String         | {qrcode:xxxxxxxx} |                  |
| Method           | string         | checkMemberQRCode | 需要新增接口     |

出参：

| **类 型** | **说明** |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Json | 门票信息列表，如： {"errCode":0,"errMsg":"","assets":[ {"item_id":"XXXXXXXXXXXXX","item_name":"门店名称-时间","m_id":"XXXXXXXXXXXXX","maturity_date":"2024-05-22 00:00:00","ticket_type":"times","allow_time":0,"warm_prompt":"取票须知提醒"}, {"item_id":"XXXXXXXXXXXXX","item_name":"门店名称-XX次","m_id":"XXXXXXXXXXXXX","maturity_date":"2023-07-02 00:00:00","ticket_type":"count","count":10}, {"item_id":"XXXXXXXXXXXXX","item_name":"运动馆门店名称","m_id":"XXXXXXXXXXXXX","maturity_date":"2023-06-04 11:17:51","ticket_type":"entranceTicket","time_limit":1,"is_show":1,"count":"1"} ],"success":true} 返回数据statu_code为0，即为通过；其中 ticket_type 类型为 times 门票中的 allow_time 属性为0时，提示到吧台取票； 其中 ticket_type 类型为 entranceTicket 时门票中的 is_show 属性为1时，提示取票须知，为0时则不提示； |

# 6.实施内容

## 6.1 概况描述

会员自助取票程序主要就是解决顾客在进入运动馆前时，需要对顾客的门票进行领取和验证，由于客户过多，从而以自助取票方式减少客户在取票时的排队等待时间，给顾客节约时间，提升客户使用感受，同时也能减轻门店员工的工作压力。

## 6.2程序初始化

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

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

### 6.2.3 逻辑描述：

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

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

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

4：电脑权限验证，未通过时，将提示原因，终止后执行；通过时，程序将进入程序主界面；同时将通在验证权限返回数据中提取“取票须知”，以用于在取票时，告知顾客入园后的注意事项；检查当前程序配置的打印机在系统中是否存在，如果不存在则提示工作人员进行重新配置（运行程序目录下的 PrinterConfig.exe 程序进行儿童手环和大人手环打印机指定）；

5：进入主界面时，显示预设置主页的背景图片，此时程序将会定时对打印机纸线进行检查，用户可以选择点击程序界面的“自助取票”按钮，进入会员二维码扫码接收界面；同时系统将自动连接二维码扫码器，准备接收会员的二维码信息；

6：进入到“待扫码取票”界面时，界面提示用户如何操作扫描微信小程序会员二维码，如果用户在一定时间（60秒）内无扫码动作，程序将自动返回到上一页面（主页），界面上方将有倒计时提示，也可点击右上方的“返回”按钮返回到主页面；扫码头将用户提供的二维码（门票码，会员码）读取成功后，将调用接口（5.2）获取会员名下拉有资产或二维码对应门票信息，成功将跳转到资产信息或门票列表展示界面；如门票信息获取失败时，程序将会给出失败原因；

7：进入到“门票信息”界面时，程序将罗列出顾客名下所有类型（时间，单次，次数票）所有门票信息；时间门票，将显示门票状态以及到期时间；单次票则直接显示门票名称既可，1张单次票即显示1条；多张即显示多条；次票则在名称下显示当前可用次数；如果用户在一定时间（60秒）内无取票动作，程序将自动返回到主页面；同时界面上方将有倒计时提示，也可点击右上方的“返回”按钮返回到主页面；

8：在项目列表中勾选门票项目时，同一时间只允许选择一条，如果用户扫码为单次票二维码，进入界面时程序将默认选中当前门票项目，以方便用户直接点击“立即取票”按钮即可取票；
项目列表勾选单次门票时，点击“立即取票”按钮后，弹出窗口，显示“取票须知”信息，在用户确认后，再点击“确认取票”按钮（也可点击“返回”按钮，取消本次取票），注：显示“取票须知”提示，是需要在后台系统中进行设置是否提示，如果设置不提示，此处则不会弹出提示框，将会直接进入打印；
此时程序将调用专用（宝比 BB720打印机）打印机；儿童手环，程序将调用配置文件中指定的儿童打印机名称的打印机进行打印，成人手环，程序将调用打印机配置文件中指定的的成人打印机进行打印，每次使用时，都需要临时建立打印机连接，打印完成后需要关闭连接；将运动馆门票信息（门票编号，门票类型，出票门店，出票时间(系统当前时间) ，出票客户(微信用户手机号，中间4位做隐藏)，图形二维码(门票ID号)）打印在手环上，打印输出完成后，提示“请取走手环，将继续打印剩余手环”（如打印机缺手环纸带，程序将无法进行手环打印，直到工作人员将手环补充后可继续使用），关闭当前使用打印机连接，如果已经到最后一张时则提示“请取票”，提示信息显示一段时间（5秒）后，将自动返回到主页面；如果勾选列表为年卡门票，则提示顾客到“服务台”进行办理打印；

9：完整的自助取票流程，已经完成

手环样式：
![86c82942305be29e9d730b296ca5f67.png](https://foruda.gitee.com/images/1688956982260055848/f23937b1_9374197.png)