智能定位手环位置服务程序开发文档

# 1.   文档说明

本文档作为乐的文化管理系统的智能定位手环管理模块的开发文档，对项目中使用的技术标准和技术开发方案进行描述。

# 2.   项目目标

由于后期逐渐使用智能定位手环来代替传统纸质手环的使用，所以将会对于大量的智能定位手环资产有着很高的管理要求。首先门店需要随时掌握每一个手环当前的状态以及使用的情况。通过传统方式在Excel表中记录已经无法满足管理需求，多方数据无法串连在一起。将手环数据存入系统中，不仅门店可以随时随地的掌握手环最新信息，同时客户也可以在手机移动端（微信小程序）随时查看自己名下所有手环数据，以及手环在园区内的位置情况。对管理者管理起来更轻松，对使用者有更好的使用体验。

通过以上目标的实现，最终建立起智能定位手环数据完整性、统一性、安全性、可追溯性机制，从而满足工作需要，提高工作效率。

# 3.数据表设计

| 表 名    | 具体门店编号         |
| -------- | -------------------- |
| 中文描述 | 门店手环定位缓存表   |
| 建立日期 | 2022/12/23           |
| 列 名    | 中文描述             |
| Key      | 唯一键               |
| Value    | 键对应的值           |
| 补充说明 | 表名称以门店编号命名 |

| 表 名    | Battery_XXXXXXXXX                              |
| -------- | ---------------------------------------------- |
| 中文描述 | 手环电量缓存表                                 |
| 建立日期 | 2022/12/23                                     |
| 列 名    | 中文描述                                       |
| Key      | 唯一键                                         |
| Value    | 键对应的值                                     |
| 补充说明 | 表名称以“Battery_+门店编号”命名，30秒更新一次 |

| 表 名    | NL_XXXXXXXXXXXX                                                     |
| -------- | ------------------------------------------------------------------- |
| 中文描述 | 蓝牙系统需要监控的手环临时表                                              |
| 建立日期 | 2022/12/23                                                          |
| 列 名    | 中文描述                                                            |
| Key      | 唯一键                                                              |
| Value    | 键对应的值                                                          |
| 补充说明 | 表名称以“NL_+门店编号”命名，当服务程序收到定位数据后清除此缓存数据 |

| 表 名    | RM_XXXXXXXXXXXX             |
| -------- | --------------------------- |
| 中文描述 | 蓝牙系统需要取消监控的手环临时表  |
| 建立日期 | 2022/12/23                  |
| 列 名    | 中文描述                    |
| Key      | 唯一键                      |
| Value    | 键对应的值                  |
| 补充说明 | 表名称以“RM_+门店编号”命名 |

| 表 名    | MNL_XXXXXXXXXXXX                                                     |
| -------- | ------------------------------------------------------------------- |
| 中文描述 | 蓝牙系统需要上传定位手环临时表                                              |
| 建立日期 | 2023/09/05                                                          |
| 列 名    | 中文描述                                                            |
| Key      | 唯一键                                                              |
| Value    | 键对应的值                                                          |
| 补充说明 | 表名称以“MNL_+门店编号”命名，当服务程序收到定位数据后清除此缓存数据 |

| 表 名    | MRM_XXXXXXXXXXXX             |
| -------- | --------------------------- |
| 中文描述 | 蓝牙系统需要取消上传定位手环临时表  |
| 建立日期 | 2023/09/05                  |
| 列 名    | 中文描述                    |
| Key      | 唯一键                      |
| Value    | 键对应的值                  |
| 补充说明 | 表名称以“MRM_+门店编号”命名 |

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

4.1 数据字典

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

4.2 全局变量

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

# 5.接口设计

### 5.1

**说明：**

调用：

| **调用****URL** |  |
| --------------------- | - |

入参：

| **参数名** | **类型** | **说明** | **备注** |
| ---------------- | -------------- | -------------- | -------------- |
|                  |                |                |                |

出参：

| **参数名** | **类型** | **说明** |
| ---------------- | -------------- | -------------- |
|                  |                |                |

# 6.实施内容
## 6.1 概况描述

会员客户可以在微信小程序中查看当前自己名下所有手环状态，并对其手环在地图上的头像进行个性化设，提升客户使用体验。
手环的定位数据需要在微信小程序中展现，需要将手环与系统进行交互，将定位信息实时更新到系统后台，以提供给微信小程序调用展示。

## 6.2 手环定位数据请求
### （1）模块名称：手环定位数据请求
### （2）模块路径：手环服务程序 > 手环定位请求
### （3）逻辑描述：

1：收银人员将手环发放给会员后，门店相应缓存表（NL_XXXXXXXXX）数据将新增手环记录数据,服务程序将此缓存表发送到门店蓝牙定位系统，门店蓝牙系统将会对此列表的手环进行监控（数据：{“t”:0,“b”：mac}）；
2：当会员归还智能手环后，门店相应缓存表（RM_XXXXXXXXXX）数据将新增手环记录数据（已解绑缓存表），服务程序将此缓存表发送到门店蓝牙定位系统，门店蓝牙定位系统将会对此列表的手环监控进行移除（数据：{“t”:1,“b”：mac}）；
3：客户通过微信小程序进入智能手环地图展示界面，系统会生成相应缓存数据（MNL_XXXXXXXXX）,此缓存表即为，需要门店定位系统对此列表数据进行返回的手环列表（数据：{“t”:2,“b”：mac}）；
4：当客户退出地图展示界面时，同时也将会生成MRM_XXXXXXXXXX（已解绑缓存表）表数据，将传送到门店定位系统，从手环从返回数据列表中移除（数据：{“t”:3,“b”：mac}）；
5：每间隔30秒钟执行一次；

## 6.3手环电量数据请求
### （1）模块名称：手环电量数据请求
### （2）模块路径：手环服务程序 > 手环电量请求
### （3）逻辑描述：

1：客户在将手环绑定到自己的会员账号前，门店工作人员在发放手环前，需要对手环的电量进行确认，当手环电量低于多少时，此手环将不予发放，避免客户在使用过程中电量耗尽，断电关机；
2：手环服务程序会在每间隔一段时间，向门店手环定位系统发送一次获取电量请求命令，此时定位系统，将门店当前可读的所有手环电量信息读取并返回；
3：每间隔30秒钟执行一次；

## 6.4手环数据接收处理
### （1）模块名称：手环数据接收处理
### （2）模块路径：手环服务程序 > 手环数据接收处理
### （3）逻辑描述：

定位手环数据处理服务程序启动手，各门店的定位系统即可以连接到服务器，将门店定位手环生成的数据发送到服务程序，由程序进行识别、处理，分别保存在不同的缓存数据表中，以代客户和门店业务人员调用使用；
定位数据：门店定位手环系统发送数据中t为0数据，即为定位数据，服务程序会将该手环此类型数据新增保存在缓存表中，如果已存在则更新；
报警数据：门店定位手环系统发送数据中t为1数据，即为定位报警数据（手环位置已在园区外围处），服务程序会将该手环此类型数据新增保存在缓存表中，如果已存在则更新；并对手环位置作出预警提示，提示客户如果游乐完成，即可将手环归还，当客户在未请求定位情况下，蓝牙系统将会自行主动传会报警信息到服务端；
信号丢失：门店定位手环系统发送数据中t为2数据，即为定位数据读取失败（客户将手环带离门店范围），服务程序会将该手环最后定位保存在缓存表中，将“正常”和“预警”状态调整为信号丢失，如果手环重新回到门店，定位状态将会重新调整到“报警”或“正常”定位状态，当客户在未请求定位情况下，蓝牙系统将会自行主动传会报警信息到服务端；

在数据进行接收处理时，通过以缓存连接池来保存更新数据，以提高高并发时的数据处理能力，默认连接池大小为30个，可以服务程序主界面状态栏查看。