全部操作指南
按场景筛选,或直接搜索功能、设备和故障现象。
基础配置
小程序配置 小程序支付配置 腾讯地图配置 公众号模板消息 小程序订阅消息 团购提点 实名验证 押金功能 分销中心 商城设置 涂鸦 通通锁 TCP 腾讯语音通知 微信服务商 喇叭提醒 散台订阅消息配置
小程序配置
将从微信公众平台获取的小程序appid和密钥填入对应位置 在微信公众平台添加百货/超市/便利店 类目,选择订单下单提醒订阅消息,注意不配置订单消息会导致无法拉起支付
小程序支付配置
将从微信商户里面获取的商户ID和密钥以及支付证书填入后台,注意微信商户需和微信小程序关联。 备注:小程序微信支付秘钥请选择V2秘钥 备注:支付证书等也需要配置正确
腾讯地图配置
从腾讯位置服务获取地图key,注意未配置key可能会导致距离不显示 登录腾讯位置服务站点 1、浏览器访问申请地址:https://lbs.qq.com/有账号直接登录,无账号注册后登录 2、登录后,点击控制台按钮 申
商家门店管理
商家账号设置 门店管理 房间管理 商家账号
商家账号设置
小程序端申请加盟入驻后,后台在商家账号位置手动添加商家登录账号密码,商家登录账号推荐用手机号码 商家账号添加成功后一定要在门店管理位置进行绑定,否则添加设置的商家账号无效 同一个账号绑定多家门店,就可以实现一个账号管
门店管理
商家可以在手机端对门店进行管理设置 平台方可以在后台对门店进行总设置,包括门店账号的绑定
美团团购北极星对接
在美团北极星(注册地址:https://open.dianping.com)注册账号后创建工具型应用 创建应用成功后在应用设置获取key和密钥并填入对应位置 回调域名一定要设置,回调域名就是当前使用域名,必须配置ss
腾讯语音通知
先在腾讯云语音消息内创建应用,设置好基础配置 先申请企业资质后申请号码 在申请语音模板 然后点击右上角进入访问管理获取API密钥 将上面获取的各类信息填入对应位置 腾讯语音通知主要应用于订单结束后通知打扫员,打扫员的
TCP 电控配置与运行中断排查
TCP 电控使用总览 本专题覆盖 TCP 设备选型、服务进程、端口、控制命令、关联设备、运行中断排查和自定义命令。首次接入请按下列顺序完成,不要只配置设备而跳过服务进程与端口放行。 一、接入前确认 1、向设备厂家确认
TCP设备配置
先查看TCP配置部分,配置好TCP运行和端口,再配置设备。 如何配置设备 1、询问厂家设备如何配置服务器ip和端口。 2、将后台添加的端口和服务器ip填写进设备之中。 3、确保设备是以TCP客户端模式运行。 如上便完
守护进程
网站命令,打开宝塔 进程守护管理器 第一步:点开宝塔左侧软件管理,搜索:进程守护 如果没有安装进程守护管理器,点击安装就行,安装完成点击设置进去。 点击添加守护进程, 名称随便填写 运行目录 填写 /www/wwwr
套餐设置
套餐设置在房间管理里面完成,可以设置套餐是否支持会员折扣
会员折扣
在会员管理充值优惠规则里面完成充值优惠和会员折扣设置
添加计划任务
系统搭建完成后需在计划任务处添加一个执行访问url的计划任务,每1分钟一次执行 https://域名/addons/ymq changdi/public/index.php/addons/ymqchangdi/api
抖音团购对接
首先在抖音服务商平台注册认证 https://partner.open-douyin.com/ 注册认证通过后在控制台创建第三方生活服务商家应用 应用创建成功后进入应用内开通解决方案中到综行业解决方案,开通团购核销以
涂鸦硬件对接
先在涂鸦平台注册账号 进入平台后选择云开发,创建云项目 云项目创建完成后进入云项目添加云授权获取ID和密钥 然后将涂鸦平台获取的ID和密钥填入对应的位置 ID和密钥填写完成后新增服务API,将图上6个API进行新增添
绑定设备
首先按照硬件说明书给硬件连上网,然后下载智能生活APP,将已经配好网的硬件添加到智能生活APP 然后使用关联涂鸦APP的方式将硬件绑定到涂鸦平台 在涂鸦平台上可以查看到硬件的ID 也可以通过智能生活PP获取硬件的ID
硬件添加到后台
这是涂鸦门禁,添加的时候按照上图格式在门店设置进行添加 这个是涂鸦的电控门禁,可以对接其他品牌的门禁,只需要正确接好输出电源就可以,添加的时候按照上图格式在门店设置进行添加 这个是涂鸦的通断器,控制房间里面所有的电器
云喇叭配置
使用账号密码登录商为平台 http://www.sw-aiot.com/ 在商为平台获取密钥 没有账号自行注册一个就行了。 将登录账号和密钥填入后台对应的位置 获取喇叭的ID,硬件背面红框位置为喇叭的ID 将获取的喇
常见问题
手机号无法授权登录 无法拉起手机号授权 无法定位 无法支付 升级报错 后台登录无法进去 更新升级 更新之后门锁无法打开 更新之后美团无法核销 更新之后不自动断电等 数据库5.7 时长卡不显示 余额支付不显示 商家后台
手机号无法授权登录
当点击登录拉起获取手机号授权却无法登录时,需检查以下方面的配置 1.检查系统后台以及管理设置里面的ID和密钥是否正确,把握不准的情况下可以重置 2.检查小程序后台付费管理中的手机号验证组件数量 3.检查小程序后台 设
无法拉起手机号授权
出现点击登录就提示快捷登录失败就到微信公众平台小程序后台设置检查用户隐私协议
无法定位
出现小程序无法定位的情况需检查位置接口以及隐私协议
无法支付
出现支付失败的情况先检查是否开启了第三方支付,没有对接第三方支付的需要关闭第三方支付,然后按照下面的步骤检查支付设置 更新之后出现不能支付,可以尝试清除下日志,删除目录/addons/ymq changdi/runt
升级报错
升级中出现这个报错,需要在宝塔里面将PHP7.4的超时限制延长(下面是具体位置)
积分商品
积分商品设置前需要设置好分类 设置好分类后添加积分商品,注意虚拟和实物的区别,虚拟物品不需要发货,实物是用户要填写收货地址,运营方进行发货的
V2版本功能
时长卡 分销推广 弹窗通知
时长卡
购买时长卡 美团和抖音兑换时长卡
购买时长卡
时长卡提供购买的方式,要选择好对应的门店以及使用的时间
美团和抖音兑换时长卡
系统提供抖音以及美团验券的方式兑换系统内的时长卡 首先要在设置中心 系统配置 基础配置里面将是否开启兑换时长卡开启,然后按照上面操作说明内的美团团购和抖音团购进行对接好 在设置美团和抖音兑换时长卡的时候需要注意,要将
分销推广
V2新增分销推广,通过二维码发展下级可以得到下级消费后台设置比例的积分
弹窗通知
弹窗通知为进入门店是会出现一个弹窗,作为一种公告或者展示的形式,可以选择弹窗的频率以及弹窗可以跳转页面,也可以不用设置跳转的页面
后台登录无法进去
请检查是否开启https,并使用https访问,宝塔请开启强制https
硬件设备方案
房间硬件设备 大门硬件设备
定制方案
支持联系我们定制方案
守护进程2
按照第一步的教程新添加一个进程, 命令换成:php think YmqchangdiOrderStock
通通锁和喇叭硬件对接教程
云喇叭配置 注册通通锁平台 注册通通锁APP 门锁连接
房间硬件设备
涂鸦通断器 tcp继电器(电控) 喇叭
涂鸦通断器
:-: 涂鸦方案和tcp方案二选一使用就行。 https://detail.1688.com/offer/673985901701.html?share token=sb9lRUdp2p7NjX+rZeFDNcoB0
tcp继电器(电控)
tcp设备网上自行购买就行 支持市场几乎所有tcp继电器或设备 无论是4G还是wifi 单路还是多路控制 只要支持tcp控制就行 所有硬件设备不限制购买渠道 比如这个:https://item.taobao.com/
喇叭
房间通知喇叭 本硬件作用:主要实现消费时间即将到期提前播放到期提醒。 购买地址: https://detail.1688.com/offer/682296470074.html?share token=sb9lRUd
大门硬件设备
涂鸦门禁 通通锁大门
涂鸦门禁
大门门禁 购买地址: 也也可以自行购买,只要是涂鸦接口的就行 https://detail.1688.com/offer/745319641083.html?share token=sb9lRUdp2p7NjX+rZ
通通锁大门
房间门锁 也可以自行购买,只要是通通锁接口的就行 自行淘宝搜索也行。 门锁购买地址 https://m.tb.cn/h.5F9tAQl?tk=kCIpWO09dGO 通通锁公寓酒店民宿日租房智能锁远程密码锁防盗门木门
安装遇到问题
环境要求 更新出现502
环境要求
环境要求php7.4 + mysql 5.6 、5.7 宝塔php禁用函数取消:putenv、proc 开头的。
更新出现502
如果更新出现502,检测下php超时时间设定,如果是100,修改为500或者更多。
更新升级
更新升级请在左侧点击升级,一直升级到最新即可
更新之后门锁无法打开
新版本将锁的账号加到房间管理-关联设备-选择通通锁-然后填入账号
更新之后美团无法核销
如果更新之后美团无法核销,检测是否在设置-开启时长卡功能,开启了时长卡功能之后需要添加好时长卡。不需要时长卡请关闭。 兑换消费优惠卷请关闭时长卡功能,看自己选择,那种方法适合就使用那种
更新之后不自动断电等
注意查看任务进程是否更新,每次更新之后请手动重启下进程
数据库5.7
如果是宝塔数据库5.7,请把这个删除 sql-mode= 后面的都删除,然后重启数据库
时长卡不显示
添加时长卡如果小程序端不显示,检查添加的时候是否填写了美团或抖音商品id,如果填写了则是兑换时长卡,不填写才能在小程序内部显示购买。
余额支付不显示
注意检查微信支付基础设置里面余额支付开关是否打开
商家后台登录提示创建门店或空白
商家后台登录提示创建门店或空白,注意创建商家账号之后,需要绑定门店
新版TCP配置
旧版本升级注意: 1、按下面流程操作。 2、删除之前旧版所有端口的tcp进程 3、把之前设备端口重新添加到后台,添加完重启一下进程。 4、关联设备里面端口改成设备端口,比如之前是25001-35001,新版不需要网站
注册通通锁平台
第一步: 需要去通通锁开放平台:https://cnopen.ttlock.com/index注册账号并创建应用 第二步 创建应用通过审核后即可获取通通锁的ID和密钥 并将获取到的ID和密钥填入相应的位置
注册通通锁APP
将通通锁APP账号和密码填入门店设置关联设备里面,添加设备里面选择硬件厂商为通通锁,需对接门店自己的通通锁账户密码 锁的ID为 / 后的数字 将锁的ID填入相应的位置 注意:后台填的通通锁app账号密码就是登录账户和
门锁连接
注意 门锁需要按购买门锁时候里面的教程对接好网关,连上网,查看通通锁app里面,设置按钮,确保里面网关连上网,并且远程开锁功能打开。 对接好之后点击打开和关闭功能测试,如果无法控制门锁,请仔细看教程检查配置
美团抖音团购对接
美团团购北极星对接 抖音团购对接 美团开放平台申请建议 美团开放平台对接教程 美团平台借用 抖音开放平台自研申请(无法申请服务商) 美团棋牌室接口直订对接
公众号模板消息
公众号类目设置为这几种 进入模板消息,搜索以下几种模板。 提醒保洁打扫通知: 通知商家订单被取消 通知商家新订单 把设置好的模板id,填到后台。 注意请填写正确的的APPID和秘钥,以及ip白名单和公众号授权域名等。
更新升级之后出现一些问题
更新之后建议清除一下缓存,如果出现硬件设备方面的问题,请重启一下进程。
小程序订阅消息
小程序订阅消息 小程序类目选择,生活服务-百货/超市/便利店,工具-信息查询 订单下单提醒(模板编号:585):订单编号、商品详情 活动开始提醒(模板编号:4495):活动名称、开始时间、结束时间、活动地点、温馨提示
团购提点
团购提点 团购提点的作用主要是针对美团、抖音团购订单进行提点,开启之后商家提现,必须先清空提点,清空提点则会自动从余额中扣除相对应的提点金额。 只有当提点等于0的时候,商家才能提现
每个月需要重置权限导致无法支付
请把任务进程的执行用户换成www
实名验证
实名验证 实名验证接口地址:https://market.aliyun.com/products/57000002/cmapi026109.html?spm=5176.2020520132.101.3.6400721
押金功能
押金功能 押金功能开启之后,在商家后台设置的押金即可生效,用户下单将会增加押金金额,在消费完成之后,将根据在商户门店设置里面设置的押金退款时间,自动进行退返押金。 押金:如果押金没有自动退还,请检查下计划任务。
功能详解
1、优惠卷 优惠卷和商家分成方式为,依据在那个商家消费则分成给那个商家。 优惠卷二维码使用说明,用户个人中心扫优惠卷二维码即可直接获得该二维码。 基础设置开启时长卡,则美团抖音兑换则改变为时长卡,关闭默认为优惠卷,时
新版本更新注意
1、更新请先备份数据库和代码。 2、新版进行重构不兼容旧版本前端,更新后需要发布前端。 3、更新后新版本基础设置需要重新配置,请提前保存好之前的配置。 4、更新之后计划任务和进程有变化,需要重新配置。 更新之后注意问
旧版升级下单不弹出授权框,出现假登录情况。
打开数据库 清空:ymqcd user token和ymqcd user两个表即可
云储存设置
开启云储存的方法 网站目录/addons/ymq changdi/.env 打开里面将debug = false,改为debug = true。 修改完之后查看运出位置会多一个开关,开启即可。 注意:开启之后所有平台
升级更新一定要注意
如果宝塔安装了什么防篡改之类的软件,升级的时候请注意关闭,以免导致某些文件或者数据库写入失败
如果设备出现不兼容
如果检测配置没错,设备大概不兼容,可以在涂鸦设备处 更改指令模式,两种都试试,那种能用就用那种。
自定义TCP
注意:自定义tcp步骤和tcp设备相同,区别在与命令不同。 解释: 执行方式: 手动:选择手动之后,命令不会随着订单自动发送,显示在前端订单中心,操作里面,点击发送命令。 自动:选择自动之后,命令会随着执行场景的设置
分销中心
分销中心 1、订阅消息 类目:体育场馆服务 模板编号:5298 标题:提现审核结果通知 详细内容 提现金额:{{amount1.DATA}} 申请时间:{{date2.DATA}} 审核结果:{{phrase3.DA
商城设置
商城小程序订阅消息 商城下单成功提醒 类目:百货/超市/便利店 标题:下单成功通知 模板编号:1461 订单类型:{{thing1.DATA}} 下单时间:{{date4.DATA}} 店铺名称:{{thing5.D
涂鸦
第一步:先在涂鸦平台注册账号 第二步:进入平台后选择云开发,创建云项目 第三步:云项目创建完成后进入云项目添加云授权获取ID和密钥 第四步:然后将涂鸦平台获取的ID和密钥填入后台对应位置 第五步:ID和密钥填写完成后
通通锁
第一步: 需要去通通锁开放平台:https://cnopen.ttlock.com/index注册账号并创建应用 第二步 创建应用通过审核后即可获取通通锁的ID和密钥 并将获取到的ID和密钥填入相应的位置 提示:这里
TCP
tcp设备中的内容。 地址填写0.0.0.0 端口随意:比如35001
房间管理
房间管理中的价格,为每小时的价格。 会员价:为充值优惠中设置的充值赠送会员折扣。 套餐:套餐为固定多少小时的价格。
商家账号
这里可以打开商家独立PC后台登录地址,在这里添加了账号,需要去门店里面绑定添加的账号,否则登录会提示门店不存在。
独立后台登录
可以添加管理员,独立后台登录。
打扫端收不到模板消息
请注意打扫人员状态需要是上班中,才会收到模板消息
美团开放平台申请建议
申请不过的时候可以找当前美团营业部帮忙申请
微信服务商
说明:相关配置请到微信支付服务商获取。 配置服务商之后,需要每个门店在PC商户端申请。 配置完成之后该门店的订单支付、商城支付、充值支付、购买该门店时长卡和优惠卷都将使用子商户支付。 分账比例如果门店设置里面没有单独
美团开放平台对接教程
前提:需要入驻好美团开放平台 https://developer.meituan.com 入驻说明:自营或服务商都可以。 请先开通这些接口权限。 第一步:获取美团信息developerId和SignKey 第二步:把
商家端和打扫端关注公众号提示打不开
如果提示这个:请进入微信公众平台 https://mp.weixin.qq.com 登录小程序之后,左侧找到开发管理。 拉倒下面找到业务域名,将你的域名加上去。 备注:如果提示下面错误,请下载校检文件,上传到网站根目
小程序隐私协议
隐私协议请参考如下:
注意进程和文件权限问题
1、建议进程设置www用户运行。 2、文件权限设置www用户755权限。 如果进程用root用户运行,会生成root权限的日志或日志目录,会导致系统无法写入日志,就会造成诸如:无法支付、支付无回调等。 设置方法:1、
系统守护进程
守护进程 守护进程2 添加计划任务
MQTT设备配置
MQTT设备说明 第一步-服务器安装MQTT 第二步-设备对接MQTT 第三步-后台添加MQTT设备 相关其他说明 第四步-运行进程
第一步-服务器安装MQTT
安装 (如果服务器系统版本比较老发现安装不了,请看第二种方式) 第一步:远程连接你的服务器。可以通过远程工具或者宝塔左侧的终端连接。 第二步:打开网址:https://www.emqx.com/zh/download
第二步-设备对接MQTT
第一步:联系设备厂家询问如果配置MQTT。 打开配置页,以下仅做参考, 地址填写你的服务器ip或者域名 发布订阅默认填:pub/你设置的设备id,设备id:上面图中你设置的。 订阅:sub/你设置的设备id,设备id
第三步-后台添加MQTT设备
第一步:总后台或者商家后台打开门店(门店里面配置的关联设备为门店设备,不受具体场地控制)或者场地管理。 第二步:点击添加 第三步 添加选择MQTT设备,先忽视其他,填写你的设备id和设备命令即可,设备命令找厂家要,注
相关其他说明
设备局限:设备不局限那种类型,可以支持添加MQTT、继电器、门锁、或者其他相关的 安全性:MQTT相关账号密码请自行修改成自己的专属密码,建议不要太简单。 设备命令不会填? ----- 厂家给到命令之后, 删除到命令
喇叭提醒
基础设置-左侧消息提醒,为系统自带的喇叭接口提醒,在此添加
第四步-运行进程
备注:php需要安装Swoole扩展。 新添加一个进程:运行命令:php think YmqchangdiMqtt (可选,运行mqtt时需要,不需要mqtt不用运行) 添加教程查看菜单-系统守护进程章节
TCP设备说明
购买TCP设备说明:不局限于什么设备,支持包括MQTT协议的喇叭、继电器、门禁、空调、锁球器。只要协议正确就可以使用。 注意和卖家沟通是否支持tcp控制 注意和卖家沟通每个设备是否可以区分设备id,如果不能区分,那么
MQTT设备说明
购买MQTT设备说明:不局限于什么设备,支持包括MQTT协议的喇叭、继电器、门禁、空调、锁球器。只要协议正确就可以使用。
程序运行不正常?
如果遇到各种问题,比如进程配置进程了,订单不自动进入消费中,请检查设置里面基础设置是否完善,如appid或秘钥请不要留空
订单中心地址
pages/order/order
美团平台借用
借出方 借入方
借出方
第一步:首先新建一个美团授权(注意:需要新建,每个店铺一个美团授权信息) 备注:按钮美团开放平台对接教程对接。 第二步:添加完之后,点击发起授权,登录借入方的账号密码,授权好店铺。 第三步:授权之后在左侧美团授权共享
借入方
第一步:添加美团授权: 填好借出方给到你的信息,填到如图处。 借用请求链接:https://域名/addons/ymq changdi/public/index.php/addons/ymqchangdi 借用请求参
平台商城
1、平台可在平台商城上传产品,用户购买之后快递发货。 2、平台商城提点,门店可生成平台商城二维码,或将链接加到门店菜单,从门店页面进入到平台商城购买产品,门店将享受提点分成。
DIY装修
1、首页:需要在基础设置中,首页模板设置为自定义,且在diy装修菜单中选择一个页面设置为首页,才可生效。 2、个人中心:需要在基础设置中,个人中心模板设置为自定义,且在diy装修菜单中选择一个页面设置为个人中心,才可
预定模式
1、套餐预定:套餐支持高级套餐和普通套餐,可在pc商家端场地设置当前启用高级套餐,高级套餐支持新人专享,根据周几周期可用,可用时间点限制。 2、自助预定:用户自由选择时间点预定。 3、预存预定:选择支付金额,微信支付
部分功能讲解
预定模式 平台商城 套餐设置 会员折扣 积分商品 DIY装修 功能详解
微信开放平台配置
说明 第一步:申请开放平台 第二步:配置开放平台 第三步:伪静态和计划任务 开放平台说明 如果上传代码失败 新版框架开放平台计划任务
说明
配置作用:用户扫码显示是自己的开放平台服务商。
第一步:申请开放平台
1、打开微信开放平台地址:https://open.weixin.qq.com/;如果没有,请先注册并认证。 2、创建一个第三方平台。 其他资料自行填写。
第二步:配置开放平台
第一步:获取微信开放平台appid和秘钥。 第二步:打开开发配置,点编辑。 首先点代开发小程序,绑定好一个小程序。 第三步:配置 后台:选择自己的第三方开放平台,将后台信息复制到微信开放平台配置。 小程序域名需要加入
第三步:伪静态和计划任务
5.5之后版本忽视以下内容,查看新版本框架计划任务 站点需要配置一个伪静态: 打开宝塔: 微信授权平台 location ^/web/index.php/openwechat/appid/ { rewrite ^/w
开放平台说明
配置之后,之后每次更新,需要点击上传小程序更新。
小程序审核失败
如果小程序审核失败。 可以把基础设置-分销设置;分销类型改为积分。
无法授权上传小程序
请检查总后台 控制台-设置-开放平台,请根据自行情况选择好使用官方平台还是自己的微信开放平台。
系统日志查看
查看系统运行日志,可以在下面目录查看。 addons/ymq changdi/runtime/log/最新的日期/
如果上传代码失败
如果上传失败,请在对接好微信开放平台之后,点这里的授权,授权一下你的开发微信小程序。
如果tcp运行一段时间之后停止了
WARNING Server::accept\ connection(): accept() failed, Error: Too many open files 如果提示这类报错,表示服务器描述符耗尽了。 解决办法
saas框架升级
升级请注意,请一定提前备份。 升级完成之后一定需要操作的部分,否则站点打不开: 第一步:伪静态,新版本框架需要配置伪静态,配置方法。 打开宝塔左侧网站菜单。 找到你的站点,点击设置。 其他影响:站点名称和logo,以
新版框架开放平台计划任务
计划任务:如果有使用开放平台,宝塔新增一个计划任务,删除旧版的开放平台计划任务。 https://域名/openwechat/doSubmit 周期选择每分钟执行一次
抖音开放平台自研申请(无法申请服务商)
无法申请服务商可以查看抖音官网文档开通自研 https://developer.open-douyin.com/docs/resource/zh-CN/local-life/guide/ka-guide
萤石云摄像头
萤石云摄像头对接教程 AI精彩视频
萤石云摄像头对接教程
第一步:获取萤石云开放平台信息 打开地址:https://open.ys7.com 输入你的萤石云账号密码,没有的请先注册。 第二步: 获取相关信息填到后台。基础设置-萤石云位置。 摄像头对接:请先在萤石云开放平台添
AI精彩视频
提示:账号如果要使用精彩视频,请先联系萤石云工作人员进行开通。 精彩视频配置: 请在基础设置-萤石云中配置。 回调地址配置:https://open.ys7.com/help/566,按萤石云教程开通消息推送。 回调
散台订阅消息配置
散台成台通知模板ID: 模板编号: 11979 标题:组局成功通知 类目: 休闲娱乐 详细内容 门店名称: {{thing11.DATA}} 组局状态: {{thing1.DATA}} 成局时间: {{time2.D
美团棋牌室接口直订对接
1、美团开放平台开通服务零食、预订接口。如果未开通,请先开通,如图: 2、美团开放平台配置回调地址,如图: 需要配置这些接口:取消预订、预订结果同步、用户撤销退款通知、取消预订审核、开始预订、查询三方房间信息、核销状
操作中心