共享茶室包间预约联动：如何将8 路远程包间电源管理模块集成到软件项目中_解决方案

CATALOG

1. 背景与需求分析

1.1 行业痛点

共享茶室作为24小时无人值守业态的代表，近年来发展迅速。但在实际运营中，以下痛点尤为突出：

能耗浪费严重：顾客离开现场时后未关闭空调、照明、茶炉等设备，导致大量电能空耗，部分门店月度电费支出超预期30%以上
管理效率低下：传统模式下需保洁人员逐间检查并手动断电，24小时营业场景下夜间无法有效管控
用户体验不佳：顾客预约后到场需等待工作人员开门通电，无法实现“即到即用”的自助体验
设备种类复杂：茶室包间涉及照明、空调、电磁炉/茶炉、排风扇、门禁等多种用电设备，需分类独立控制

1.2 解决方案定位

将芯步8路远程包间电源管理模块集成到共享茶室预约软件系统中，实现“预约即通电、离开现场时即断电”的全自动无人化运营闭环，单台设备即可覆盖单个包间的全部用电设备管理需求。

2. 硬件产品介绍

2.1 8路电源管理模块选型对比

芯步提供两款适配共享茶室场景的8路控制器，可根据实际需求选择：

对比维度	UNI-KZQ-AC-8	UNI-KZQ-TY-8
适用场景	共享茶室、棋牌室、自习室	售货柜、沙盘模型、集中控制
供电方式	AC 85-265V（直接接入市电）	DC 12V（需外接电源适配器）
控制路数	8路	8路
单路最大负载	2200W[阻性负载]/350W[感性负载]	2200W[阻性负载]/350W[感性负载]
总负载上限	4400W[阻性负载]/700W[感性负载]	4400W[阻性负载]/700W[感性负载]
待机功耗	0.4W（全断）-1W（全通/无负载）	1.1W（全断）-5.2W（全通）
产品尺寸	125×90×40mm	95×80×65.2mm
特殊功能	支持8路开关量信号输入（可外接物理开关）	体积更小，适合集成到设备内部

推荐选择：共享茶室场景优先选用UNI-KZQ-AC-8，因其可直接接入市电、待机功耗更低、且支持外接物理开关作本地应急控制。

2.2 典型第8路设备分配方案（单包间）

输出通道	推荐接入设备	功率要求	控制场景
第1路	包间主照明	≤500W	顾客入场自动开启
第2路	茶炉/电磁炉插座	≤2200W	顾客需使用时手动/自动开启
第3路	空调（壁挂式）	≤1500W	预约开始前15分钟预冷/预热
第4路	排风扇/新风系统	≤200W	全场开启，结束后延时关闭
第5路	饮水机/热水器	≤1500W	预约时段内保持通电
第6路	背景音乐/电视	≤500W	顾客可选开启
第7路	备用插座	≤2200W	预留扩展
第8路	门禁电磁锁	≤50W	扫码开门/预约时段内保持解锁

3. 软件集成技术方案

3.1 系统设计

采用“用户端小程序 + 后端服务 + 芯步云平台 + 8路控制器”的四层架构：

┌─────────────────────────────────────────────────────────────────┐
│                        用户端（微信小程序）                       │
│    包间浏览 → 时段选择 → 在线支付 → 扫码开门 → 一键续费           │
└───────────────────────────────┬─────────────────────────────────┘
                                │ HTTPS
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│                      业务后端（Java/Node.js）                     │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐              │
│  │ 订单管理模块 │  │ 计时计费模块 │  │ 设备调度模块 │              │
│  └─────────────┘  └─────────────┘  └──────┬──────┘              │
│  ┌─────────────┐  ┌─────────────┐         │                      │
│  │ 用户认证模块 │  │ 门店管理模块 │         │ HTTP API调用          │
│  └─────────────┘  └─────────────┘         │                      │
└────────────────────────────────────────────┼──────────────────────┘
                                             │
                                             ▼
┌─────────────────────────────────────────────────────────────────┐
│                   芯步云平台 / 私有化服务器                   │
│               • 设备状态管理  • 指令下发  • 签名鉴权              │
└───────────────────────────────┬─────────────────────────────────┘
                                │ MQTT/WiFi
                                ▼
┌─────────────────────────────────────────────────────────────────┐
│              芯步8路电源管理模块（UNI-KZQ-AC-8）             │
│      第1路    第2路    第3路    第4路    第5-8路                 │
│     照明      茶炉     空调     排风     扩展电器                │
└─────────────────────────────────────────────────────────────────┘

3.2 API接口调用规范

3.2.1 签名认证机制

芯步采用双重MD5签名机制保障接口安全，所有请求需携带动态签名

请求地址格式

https://api.thingboot.com/{AppId}/device/control/?sign={sign}&ts={ts}

签名算法

AppId：开发者应用ID（在芯步控制台获取）
AppSecret：开发者密钥
ts：当前Unix时间戳（秒）

签名计算示例（Node.js）

3.2.2 核心控制命令

操作场景	请求Body格式	说明
开启第1路（照明）	`{"device":"设备ID","order":{"power1":1}}`	1表示开启，0表示关闭
关闭第2路（茶炉）	`{"device":"设备ID","order":{"power2":0}}`	-
批量控制多路	`{"device":"设备ID","order":{"power1":1,"power3":1,"power4":1}}`	同时开启1、3、4路
查询设备状态	`{"device":"设备ID","order":{"status":1}}`	返回各路的通断状态
全开/全关	`{"device":"设备ID","order":{"power":"on"}}`	on通断，off关闭

3.3 业务代码集成示例

3.3.1 Java后端集成（Spring Boot）

@Service
@Slf4j
public class TearoomDeviceService {
    
    @Value("${yoyo.appId}")
    private String appId;
    
    @Value("${yoyo.appSecret}")
    private String appSecret;
    
    private final RestTemplate restTemplate;
    
    /**
     * 核心指令下发方法
     * @param deviceId 设备ID（8路控制器的设备编号）
     * @param commands 控制指令Map，如 {"power1":1, "power3":1}
     */
    public boolean sendCommand(String deviceId, Map<String, Object> commands) {
        long ts = System.currentTimeMillis() / 1000;
        String sign = generateSign(appSecret, ts);
        String url = String.format("https://api.thingboot.com/%s/device/control/?sign=%s&ts=%d", 
                                   appId, sign, ts);
        
        Map<String, Object> requestBody = new HashMap<>();
        requestBody.put("device", deviceId);
        requestBody.put("order", commands);
        
        try {
            HttpHeaders headers = new HttpHeaders();
            headers.setContentType(MediaType.APPLICATION_JSON);
            HttpEntity<Map<String, Object>> entity = new HttpEntity<>(requestBody, headers);
            
            ResponseEntity<String> response = restTemplate.postForEntity(url, entity, String.class);
            log.info("指令下发结果: deviceId={}, commands={}, response={}", deviceId, commands, response.getBody());
            return response.getStatusCode().is2xxSuccessful();
        } catch (Exception e) {
            log.error("指令下发失败: deviceId={}, error={}", deviceId, e.getMessage());
            return false;
        }
    }
    
    /**
     * 订单开始:包间通电（根据预约时段自动触发）
     * @param order 订单对象
     */
    @EventListener
    public void onOrderStart(OrderStartedEvent event) {
        TearoomOrder order = event.getOrder();
        String deviceId = order.getDeviceId();  // 对应包间的8路控制器ID
        
        // 根据时段和环境温度智能决定控制哪些设备
        Map<String, Object> startCommands = new HashMap<>();
        startCommands.put("power1", 1);  // 照明开启
        startCommands.put("power4", 1);  // 排风开启
        
        // 空调智能预判:夏季提前15分钟已由定时任务开启
        // 茶炉默认不开启，由顾客到店后自行通过小程序开启
        
        // 门禁控制:订单有效期内保持门锁通电（解锁状态）
        startCommands.put("power8", 1);  // 门禁电磁锁通电（门可开）
        
        sendCommand(deviceId, startCommands);
    }
    
    /**
     * 订单结束:包间断电（自动触发或手动保洁触发）
     * @param order 订单对象
     */
    @EventListener
    public void onOrderEnd(OrderEndedEvent event) {
        TearoomOrder order = event.getOrder();
        String deviceId = order.getDeviceId();
        
        Map<String, Object> endCommands = new HashMap<>();
        endCommands.put("power1", 0);  // 照明关闭
        endCommands.put("power2", 0);  // 茶炉关闭
        endCommands.put("power3", 0);  // 空调关闭
        endCommands.put("power8", 0);  // 门禁电磁锁断电（门上锁）
        
        sendCommand(deviceId, endCommands);
        
        // 排风扇延时关闭:单独发送指令，延时5分钟后执行
        scheduleTask(() -> {
            Map<String, Object> fanOff = new HashMap<>();
            fanOff.put("power4", 0);
            sendCommand(deviceId, fanOff);
        }, 5, TimeUnit.MINUTES);
    }
    
    /**
     * 顾客扫码开门（订单有效期内）
     * 注意:门禁控制依赖于第8路电磁锁的通电状态
     * 若订单已开始且未结束，第8路已通电，扫码即可触发门禁机开门
     */
    public boolean scanToOpenDoor(String orderId, String deviceId) {
        TearoomOrder order = orderService.getOrderById(orderId);
        if (order == null || order.getStatus() != OrderStatus.IN_PROGRESS) {
            log.warn("订单无效或未开始，无法开门: orderId={}", orderId);
            return false;
        }
        // 第8路已通电，门锁处于可开启状态，门禁机会响应扫码信号自动开门
        // 无需额外调用设备指令，门禁机独立工作
        return true;
    }
}

3.3.2 定时任务：预约前预开空调

3.3.3 小程序端扫码开门（前端示例）

// 微信小程序页面代码
Page({
  data: {
    orderId: '',
    deviceId: ''
  },
  
  // 用户点击"扫码开门"
  scanToOpen() {
    wx.scanCode({
      onlyFromCamera: true,
      success: (res) => {
        // 解析二维码内容，获取包间ID或设备ID
        const qrData = JSON.parse(res.result);
        this.openDoor(qrData.roomId, qrData.deviceId);
      }
    });
  },
  
  openDoor(roomId, deviceId) {
    wx.showLoading({ title: '开门中...' });
    
    wx.request({
      url: 'https://api.example.com/api/tearoom/openDoor',
      method: 'POST',
      data: {
        orderId: this.data.orderId,
        deviceId: deviceId,
        roomId: roomId
      },
      success: (res) => {
        wx.hideLoading();
        if (res.data.code === 200) {
          wx.showToast({ title: '开门成功', icon: 'success' });
          // 开门成功后，包间内设备已自动通电
        } else {
          wx.showToast({ title: res.data.msg || '开门失败', icon: 'none' });
        }
      },
      fail: () => {
        wx.hideLoading();
        wx.showToast({ title: '网络异常', icon: 'none' });
      }
    });
  }
});

3.4 自动化控制策略

3.4.1 全业务流程状态机

阶段	触发条件	第1路照明	第2路茶炉	第3路空调	第4路排风	第8路门禁
空闲	无人使用，订单结束	关	关	关	关（延时关）	关（门上锁）
预开启	预约开始前15分钟	关	关	开（预冷/预热）	关	关
使用中	订单进行中	开	顾客手动开	开	开	开（门解锁）
结束前提醒	结束前15分钟	开	开	开	开	开
超时续费	订单结束后5分钟内	延时关	关	关	开	开（缓冲期）
强制断电	订单结束+超时未续费	关	关	关	关（延时）	关

3.4.2 异常处理策略

异常场景	处理策略
网络中断无法下发指令	利用设备端存储的本地定时策略；恢复网络后自动同步状态
API调用超时	重试机制：间隔1秒重试3次，仍失败则告警通知运维
顾客提前离开现场时	小程序支持“提前结束”，主动关闭设备并释放包间
保洁清扫时段	保洁端小程序支持临时通电（照明+排风），清扫完成后一键断电

4. 部署实施要点

4.1 硬件安装规范

安装项	操作要求
安装位置	安装于包间内配电箱附近，确保8路输出线缆长度足够到达各设备
电气连接	由持证电工操作，严格区分零火线；每路输出负载不超过2200W
WiFi信号	确保信号强度≥-70dBm，每个包间独立部署，避免跨墙信号衰减
物理开关备用	利用控制器的8路开关量输入接口，外接物理轻触开关作应急控制

4.2 软件集成检查清单

检查项	说明
AppId/AppSecret获取	登录芯步控制台注册应用获取凭证
设备配网与绑定	将8路控制器接入WiFi并在控制台绑定到对应包间
签名算法验证	使用Postman测试签名计算正确性
接口调用测试	逐一测试8路独立控制和批量控制
订单状态联动测试	模拟预约→开始→结束全流程，验证自动通断电
异常场景测试	模拟断网、超时、续费等边界情况
保洁端功能测试	验证保洁人员扫码进入清扫的临时通电逻辑

4.3 负载功率安全提醒

⚠️ 安全重要提示
单路输出负载不得超过2200W[阻性负载]/350W[感性负载]
8路全接通时的总负载不得超过4400W[阻性负载]/700W[感性负载]
LED灯、节能灯、电机属于感性负载，需按照感性负载限值计算

5. 预期效益

通过将芯步8路远程包间电源管理模块集成到共享茶室预约软件中，可实现：

效益维度	效果指标
能耗降低	月度电费支出降低25%-35%，空调、照明等设备避免空转浪费
人力成本优化	无需夜间值守人员，单店可节省1-2人的人力成本
翻台率提升	保洁清扫后一键复位，包间周转效率提升约20%
用户体验提升	即到即用、自助续费、无需等待，用户满意度显著提升
设备使用寿命	规范化的通断管理减少设备异常损耗，延长电器寿命

6. 扩展能力：支持TTS语音播报

若选用带TTS功能的包间控制器（UNI-KZQ-BJ-MINI-TTS），可在以下场景增加语音播报

场景	播报内容示例
订单开始	“欢迎光临，包间设备已通电，祝您品茶愉快”
结束前提醒	“您的订单将在15分钟后结束，如需续费请在小程序操作”
超时提醒	“订单已超时，设备即将断电，请及时续费或离开现场时”
异常告警	“检测到茶炉长时间未使用，已自动关闭以节约用电”

该方案以单台8路控制器覆盖单个包间的全部用电设备管理需求，通过标准HTTP API与现有预约软件深度集成，是共享茶室实现24小时无人值守运营的核心技术支持。

1. 背景与需求分析

1.1 行业痛点

1.2 解决方案定位

2. 硬件产品介绍

2.1 8路电源管理模块选型对比

2.2 典型第8路设备分配方案（单包间）

3. 软件集成技术方案

3.1 系统设计

3.2 API接口调用规范

3.2.1 签名认证机制

3.2.2 核心控制命令

3.3 业务代码集成示例

3.3.1 Java后端集成（Spring Boot）

3.3.2 定时任务：预约前预开空调

3.3.3 小程序端扫码开门（前端示例）

3.4 自动化控制策略

3.4.1 全业务流程状态机

3.4.2 异常处理策略

4. 部署实施要点

4.1 硬件安装规范

4.2 软件集成检查清单

4.3 负载功率安全提醒

5. 预期效益

6. 扩展能力：支持TTS语音播报

控制器产品方案：

厂房多设备集中控制：怎样把24 路智能分体远程电源控制器对接到软件项目中

共享自习室独立包间控制：怎样把共享空间智能控制器对接到软件项目中

怎样在照明控制中对接智能硬件以实现多达24路独立线路控制

如何接入8路包间综合管理控制器以实现包间消费时长电源联动

无人售货机两路设备控制：如何把智能2路交流远程控制模块集成到软件项目中

共享茶室场景方案：

如何在共享茶室电器线路控制中集成智能设备以实现线路状态反馈控制

共享茶室灯光控制：怎样把2路HTTP接口智能开关对接到自己的项目中

共享茶室灯光控制：如何将2路物理按键墙壁开关集成到自己的项目中

如何在共享茶室人走断电与安全检测中对接智能设备以实现火灾烟雾报警

共享茶室电路管理：怎样把25A定时控制断路器接入到项目中

预约用途方案：

怎么在图书馆自习室座位预约语音通知场景中接入智能硬件以实现场景联动收款播报

会议室预约签到语音提示场景：怎么将20W API 接口语音音柱接入到软件项目中

如何在共享台球室叫号预约提示场景中接入智能硬件以实现远程 TTS 语音播报

共享台球室叫号预约提示场景：怎么把30W 远程 TTS 语音壁挂音箱接入到软件项目中

会议室预约状态语音提示场景：怎样将智能语音联动台卡集成到软件项目中