公仔标签批量解锁程序

# 1.   文档说明

本文档作为乐的文化管理系统的“公仔标批量激活/解锁程序”的开发文档，对项目中使用的技术标准和技术开发方案进行描述。

# 2.   项目目标

由于在电玩门店的娃娃机经营过程中，首先需要将所有娃娃进行入库后再装备娃娃机中，客户通过在玩耍过程中获取到娃娃。如客户不想将获取到的娃娃带回家，可以将它们拿到前台进入积分兑换，已经兑换的娃娃将被锁定，不再放入娃娃机中继续使用。到下一次使用之前，需要特定权限的工作人员通过公仔解锁程序来对已经兑换过的娃娃进行的解锁，解锁后的娃娃才可以再次被放入到娃娃机中，以供客户继续抓取，否则如果客户在兑换公仔积分时会提示该公仔娃娃无效。

通过以上目标的实现，最终建立起门店的“公仔积分”情况的实时性，完整性、统一性、安全性、可追溯性机制，从而满足工作需要，提高工作效率。

# 3.数据表设计

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

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

## 4.1 数据字典

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

## 4.2 全局变量

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

# 5.接口设计

### 5.1 客户端程序验证和参数获取

**说明：**

调用：

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

入参：

| **参数名** | **类型** | **说明**                                   | **备注** |
| ---------------- | -------------- | ------------------------------------------------ | -------------- |
| hdd             | string         | 硬盘编号 |                |
| mac             | string         | 网卡编号 |                |
| pc_name         | string         | 电脑名称 |                |
| dev_type        | string         | 设备业务类型 |                |

出参：

| **参数名** | **类型** | **说明**                           |
| ---------------- | -------------- | ---------------------------------------- |
| Object           | Json           | 处理结果（结果代码、结果提示、返回数据） |

### 5.2 客户端程序登录

**说明：**

调用：

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

入参：

| **参数名** | **类型** | **说明**                                   | **备注** |
| ---------------- | -------------- | ------------------------------------------------ | -------------- |
| username         | string         | 用户账号  |                |
| password         | string         | 用户密码  |                |

出参：

| **参数名** | **类型** | **说明**                           |
| ---------------- | -------------- | ---------------------------------------- |
| Object           | Json           | 处理结果（结果代码、结果提示、返回数据） |

### 5.3 标签指激活/解锁

**说明：**

调用：

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

入参：

| **参数名** | **类型** | **说明**   | **备注** |
| ---------- | -------- | ---------- | ---------- |
| store_id   | string   | 门店ID     |            |
| user_id    | string   | 用户ID     |            |
| doll_id   | 数组     | 解锁标签ID集合 |          |

出参：

| **参数名** | **类型** | **说明**                           |
| ---------------- | -------------- | ---------------------------------------- |
| Object           | Json           | 处理结果（结果代码、结果提示、返回数据） |

### 5.4 激活/解锁日志查询

**说明：**

调用：

| **调用URL** | https://cash.melands.cn/select-doll-log |
| ----------------- | ----------------------------------------- |

入参：

| **参数名** | **类型** | **说明**   | **备注** |
| --------- | -------- | ---------- | ----------- |
| store_id  | string   | 门店ID     |             |
| user_id   | string   | 用户ID     |             |
| start_date | date     | 开始时间   |            |
| end_date   | date     | 结束时间   |            |

出参：

| **参数名** | **类型** | **说明**                           |
| ---------------- | -------------- | ---------------------------------------- |
| Object           | Json           | 处理结果（结果代码、结果提示、返回数据） |

# 6.实施内容

## 6.1 概况描述

由于门店中的公仔使用数量较大，如果通过桌面扫描程序逐个扫描，将会使用大量的时间，导致工作人员工作量加大。因此需要使用批量解锁方式来进行批量解锁，在解锁时，只需要核对解锁数量即可。

固此，在解锁时借助批量读取设备来读取公仔娃娃随身附带的标签，即可完成批量操作整个过程将会极大节约时间和人力，最后将数据保存系统，以保证数据的完整性，准确性。

## 6.2 公仔批量激活/解锁程序

### （1）模块名称：公仔批量激活/解锁程序

### （2）模块路径：公仔批量激活/解锁程序

### （3）逻辑描述：

1：“公仔标签激活解锁程序”主要是负责对所有“未使用”过的公仔进行激活和所有“已兑换”积分的公仔进行解锁；

2：程序在运行时，会读当当前运行电脑硬件信息做为参数，获取硬件在系统中所对应的门店信息；如果后台无当前电脑信息时，则会自动在系统中新增一条信息，然后由管理员进行审核通过，并设置对应门店以及参数信息，如果已经存在并且已经通过，则直接返回对应参数及信息;

3：系统启动后，进入登录界面；输入登录账号和账号密码提交到接口5.2进行验证；接口将会对当前用户权限进行验证判断，是否有运行“公仔激活解锁程序”权限；无权限时，则在程序界面下方提示，有权限则直接进入主界面，并在本地记录当前登录账号，以便下次登录时只需要登录登录密码进行快速登录；

4：程序进入主界面后，将会自动连接扫描器并开启扫描模式，此时只要将公仔放置在扫描设备扫描范围之内，将会被读取成功，并将扫描公仔数量显示在程序界面；当所有公仔都扫描成功后，点击“激活/解锁”按钮，提交公仔信息到接口5.3，接口识别处理“激活”，“解锁”，“重复解锁”公仔数量，并返回数据，客户端将分别对几个数据进行展示；

5：公仔扫描后，扫描到的公仔有可能是不需要进行激活或解锁的，此时只需要点击“重置扫描”按钮，即可将扫描结果清除，将可以继续进行公仔扫描。

6：门店需要对以往公仔激活解锁情况进行查询，时可进入到“历史记录”页面，通过选择时间段查询日志；默认查询时间段为近7天内的，最大查询数据范围为开始时间到结束时间相差30天以内；并以日志时间倒序排序显示；