一、文档说明

本文档主要明确了游乐宝快捷迁移娱乐管家单店版中的工作内容、作业准则、工作要求以及禁止事项，请所有实施相关人员务必认真阅读。

二、可转换数据说明

1）可转换数据

• 会员个人信息，包括原会员卡号、手机号、会员生日、会员卡有效期、其他原有系统的个人信息等；
• 会员储值余额：代币、金币、彩票、积分、预存款、成长值；
• 会员卡芯片号（支持不需要换卡直接可以使用会员卡）；
• 商品资料：游戏币套餐，预存款套餐，游乐套票等商品
• 零售商品资料和零售商品库存
• 订单明细数据/游玩记录/报表数据等
• 机台项目及参数（转换成功设备可自动连接娱乐管家系统，无需重新配置）
• 账期做实数据
• 员工账号/角色权限
• 会员照片（仅导入会员资料里面的照片）

2）暂不支持转换数据

• 升降级策略
• 盈客宝小程序
• 线上核销平台：抖音美团快手等
• 卡丁车设置（无卡丁车可忽略）
• 零售商品图片
• 零售商品供应商
• 岗位权限设置

需注意：

1）转换前需要当天营业结束后，并对当日的账期进行做实才能开始转换；

2）游乐宝系统没有开通漫游功能或者漫游全部召回成功才可以使用迁移工具进行升级（漫游召回失败的情况下使用迁移工具升级，召回失败的数据会丢失）；

3）娱乐管家系统需要是新安装的系统，不能有营业数据，不支持在已经在营业的娱乐管家系统中进行转换。

三、版本要求

游乐宝版本： V8.1.6886版本及以上

娱乐管家版本： V10.3.6305版本及以上，但是需要低于V10.3.8

卡头建议版本（卡头版本过低，可能连接不上娱乐管家系统，如果低于该版本，需要提前升级卡头版本后再进行升级）：

• 果冻卡头：205及以上
• 反扫卡头：129及以上
• 钻石V2：219及以上
• 油菜盒子：18及以上

四.、提前准备事项（注意，这部分可以在营业结束前就完成，减少转换时间）

 准备内容清单（注意，这部分可以在营业结束前就完成，减少转换时间）

4.1 客户沟通部分

沟通内容一：沟通转换/导入详细内容

可参考第二点描述的内容来和客户沟通，并将以下注意事项可将以下图片发送给客户

沟通内容二：与客户确认升级时间，确认整体切换流程

（具体计划可自行编写同步到群里面）

4.2 升级工具下载

工具下载链接：（暂无）

由于近期工具还在不断更新，请确认工具是否最新版本，如果提示非最新版本，请找陈彦峰、高晓钦、梁建宁获取最新更新工具。

注意事项：工具下载完，请防止到D盘，并新建一个文件夹进行存放，切记不要放到桌面，会有异常。

4.3.1 安装娱乐管家系统

情况一：游乐宝系统和娱乐管家单店版都是本地服务器

需要在安装游乐宝系统的服务器电脑上面，安装娱乐管家单店版系统，娱乐管家单店版系统需升级到V10.3.6305 版本及以上

详情请查看：【同一个服务器下安装多个门店安装流程】

（重要）注意：娱乐管家安装的路径一定要更改！！一定要更改！！一定要更改！！避免和游乐宝相同路径，导致将游乐宝文件覆盖从而导致游乐宝系统异常。

情况二：游乐宝是云服务器，娱乐管家是本地服务器

本地服务器电脑上面安装娱乐管家系统，娱乐管家单店版系统需升级到V10.3.6305 版本及以上

详情请查看：【娱乐管家单店版服务器安装】

情况三：游乐宝是本地服务器，娱乐管家是云服务器（此情况需要全场设备重新配置联网）

需要提前确认好娱乐管家云服务器是否已经部署完毕（找助理确认），内部人员需提前获得访问云服务器的资格。

情况四：游乐宝和娱乐管家都是云服务器

需要提前确认好娱乐管家云服务器是否已经部署完毕（找助理确认），内部人员需提前获得访问云服务器的资格。

4.3.2 预设值娱乐管家系统部分参数

此部分内容全部需要娱乐管家完成，请先登录娱乐管家后台， 且需和游乐宝数据保持一致：

    1）构造【会员级别】数据
         a）总部系统后台登录：点击会员→会员级别，创建会员级别数据；
         b）需要依据游乐宝系统中的会员级别数据进行创建；
     2）构造【商品分类】数据
         a）系统后台登录：点击商品 → 商品分类，创建商品分类数据；
         b）需要依据游乐宝系统中的商品分类数据进行创建；
     3）构造【机台分类】数据
         a）系统后台登录：点击终端 → 项目分类，创建项目分类数据 （有碎票机则需要在娱乐管家项目分类添加碎票机项目）；

         b）需要依据游乐宝系统中的项目分类数据进行创建；

     4）构造【员工角色】数据

         a)  总部系统后台登录: 点击设置→角色管理，创建角色权限设置

         b）需要依据游乐宝系统中的角色权限数据进行创建；

4.4 卡头版本升级（无卡头可跳过）

卡头需要在游乐宝系统上升级到最新版本（卡头版本联系硬件同事获取或推送），避免连接不上娱乐管家系统；在营业期间可提前将卡头版本进行推送，等待晚上营业结束后可一次性断电等待自动升级完成

    卡头建议版本（卡头版本过低，可能连接不上娱乐管家系统）：

• 果冻卡头：205及以上
• 反扫卡头：129及以上
• 钻石V2：219及以上
• 油菜盒子：18及以上

    卡头升级包存放路径：

• 果冻V2版本升级路径：YCHMall\CltUpdate\Firmware\90
• 反扫卡头路径：YCHMall\CltUpdate\Firmware\120
• 钻石v2路径：YCHMall\CltUpdate\Firmware\150
• 魔方/钻石V9卡头联系硬件同事推送

4.5 确认娱乐管家所在的服务器硬盘空间位置是否足够

检查服务器电脑磁盘空间，需要保证磁盘空间足够（单店升级至少需要50G的磁盘空间），否则会导致升级失败。

4.6 对客户进行培训

着重针对两个系统的差异性进行培训。

五、执行升级具体转换流程（营业结束后执行）

总体流程参考

5.1 升级游乐宝系统

游乐宝系统需升级到V8.1.6886版本及以上

1）本地服务器可在FXP自行下载升级包升级系统）

2）云服务器可推送升级后，在后台点自动升级

5.2 升级卡头（需要在前面步骤完成程序推送）

重启所有机台，等待卡头升级完成

注意事项：魔方/钻石V9娱乐版卡头升级版本后，有可能出现刷卡不上币的情况，如果出现该情况，需要调整白盒子中的拨码，如下图所示：

5.3 坐实结账

游乐宝系统必须做实结账之后在升级

5.4 备份游乐宝系统及娱乐管家系统数据库以及对应系统YCHMALL文件夹（非常重要）

数据库备份教程：《数据库备份教程》

5.5 游乐宝系统部分功能解绑，以及剩余菜籽确认

需要解绑的内容为：小程序、第三方平台、自助售货机/兑换柜

1）小程序解绑（游乐宝和娱乐管家使用同一个加密狗不需要解绑）：切换之前需要提前在游乐宝系统后台--线上--开通盈客宝--解绑微信小程序

2）抖音解绑：切换之前需要提前在游乐宝系统后台--线上--抖音配置--解绑抖音账号

3）美团解绑：需要登录美团开店宝后台取消第三方应用授权

4）售货机解绑：切换之前需要联系硬件同事解绑售货机（没有售货机可以忽略）

剩余菜籽数量确认

游乐宝系统菜籽余额截图发给运营助理（没有菜籽余额则不需要）

5.6 将数据迁移到同一个服务器上（仅适用于游乐宝和娱乐管家系统不在同一个服务器上适用，如果本身是同一个服务器则这个步骤可以跳过）

将游乐宝备份的数据库还原到娱乐管家的服务器中，具体步骤如下：

①将拷贝的游乐宝数据库放在服务器电脑D盘文件夹

②打开安装了娱乐管家系统服务器电脑的sql server，并连接到娱乐管家单店版数据库

③鼠标右击系统数据库，点击还原数据库

④在目标数据库输入YCH+游乐宝系统加密狗编号（目标数据库不能选择娱乐管家数据库），点击源设备

⑤点击添加

⑥选择拷贝的游乐宝数据库，点击确认还原，进行游乐宝数据库还原

注意事项：游乐宝系统是云服务器，娱乐管家是本地服务器。需要联系油菜花技术人员在云服务器上面拷贝游乐宝数据库文件，在娱乐管家本地服务器上面还原。反之，如果是游乐宝是本地服务器，娱乐管家是云服务器，则需要将游乐宝的数据给到油菜花技术人员上传到云服务器进行还原。

5.7 setting配置修改（仅在游乐宝与娱乐管家在同一个服务器的情况下才需要执行）

第一步：游乐宝系统Setting配置修改

1）系统都是本地服务器，打开游乐宝门店部署目录，停止游乐宝系统服务

2）打开游乐宝Setting文件，修改MacSvrPort的端口为1095、server IP 的端口和HOST端口修改为9995，不是则需修改成1095。不能和娱乐管家端口重复冲突。（如果没有MacSvrPort参数，则手动增加参数）

3）HOST里面的localhost改成*号

4）端口修改成功之后需重启一下游乐宝服务，检查系统是否正常运行。

 第二步：娱乐管家setting配置修改

1）打开娱乐管家门店部署目录，停止娱乐管家系统服务.

2）打开娱乐管家Setting文件，检查端口是否修改成功，MacSvrPort的端口（原游乐宝默认为1016）、server IP 的端口（原游乐宝默认为9999）和HOST端口（原游乐宝默认为9999）是否改成原本记录的游乐宝端口，确保一致，方可保证终端设备可以自动连接。

3）HOST里面的localhost改成*号

4）端口修改成功之后需重启一下娱乐管家服务，检查系统是否正常运行。

5.8 停止所有服务器的服务

5.9 娱乐管家数据进行备份（非常重要）

游乐宝系统和娱乐管家系统转换前都需备份好数据库文件，避免操作失误可还原数据库重新操作。

详情请查看：【数据库备份操作】

5.10 使用工具对数据转换

1.鼠标右击点击以管理员身份运行（注意，如果将工具放到桌面，或者D盘的根目录情况下有可能出现异常）

2. （数据转换之前请再次确认游乐宝和娱乐管家系统都停止服务），在数据库地址输入服务器IP地址，账号密码输入数据库账户密码，点击连接数据库

3.连接数据库之后，选择对应的游乐宝和娱乐管家数据库（注意不要选择错数据库）

4.核对目标门店是否正确

5.选择记录保留的时间（一般保留12个月，数据量多的情况下可和客户沟通保留时间），选择门店，点击获取资料

6.核对之前数据构造的会员级别，机台分类，商品分类，游乐宝系统和娱乐管家系统是否一致。不一致可以点击娱乐管家商品分类下拉框进行修改，确保构造的数据一一对应。

8.转换成功之后，重新启动娱乐管家系统（本地服务器改了Setting文件的情况下，设备会自动连接），有需要也可以重新启动游乐宝系统方便核对数据。

六、数据转换完后对系统进行设置

6.1收银台设置

1）收银电脑需安装娱乐管家单店版收银台软件

2）商品收银台分组需要重新设置，转换之后收银台分组默认都是未分组

6.2 微信小程序绑定

1）微信小程序需要重新绑定到娱乐管家系统，菜籽余额需要转到娱乐管家系统，需联系运营助理处理

详情请查看：【小程序开通流程说明】

2）微信小程序套餐需要重新发布

3）微信小程序装修需要重新设置

6.3 抖音美团快手绑定

抖音美团账号和套餐需重新绑定到娱乐管家系统，才可以正常核销

详情请查看：【抖音团购核销对接】【美团团购对接】

特别注意：抖音团购一定需要重新绑定门店ID，否则会出现抖音对账问题

6.4 设备重新绑定

1）部分连接不上娱乐管家系统的硬件设备，需重置重新绑定到娱乐管家系统

详情请查看：【卡头类调试目录】【自助设备类安装调试】

2）部分特殊机台有在游乐宝系统修改机台参数的机台，需要重新设置机台参数重新调试

七、数据和设备检查

7.1 数据检查

  1）检查会员数据是否一致（包括会员储值余额，会员个人信息）；

      a)  登录游乐宝后台--会员--会员资料查询/会员储值余额查询数据，和娱乐管家系统后台--会员--会员查询/会员管理数据是否一致

      b）登录娱乐管家收银台，读取游乐宝会员实体会员卡，查询会员数据是否和游乐宝系统数据一致

  2）检查商品资料数据是否一致（游戏币套餐，游乐套票，组合商品，入会套餐等）

      a)  登录娱乐管家后台--商品--游乐宝套餐等商品，和游乐宝系统后台--商品--商品管理，核对商品资料数据是否一致

      b)  登录娱乐管家收银台核对收银台上架的商品是否一致

  3）检查零售商品资料和库存数据是否一致

      a）登录娱乐管家后台--仓库--库存查询，和游乐宝系统后台--商品--库存查询，核对商品库存是否一致

  4）检查财务数据报表是否一致（主要账期做实，商品订单报表）

  5)  检查员工账号是否能正常登录娱乐管家系统

7.2 设备检查

  1）检查游乐项目和端口是否一致

       a)  登录娱乐管家后台--终端--游乐项目，和游乐宝--设备--游乐项目是否一致

  2）检查测试卡头设备是否正常连接

       a)  登录娱乐管家后台--终端--项目监控--查看卡头连接情况，用实体会员卡刷卡头测试能否正常扣费启动机台，娱乐管家系统后台是否有对应测试数据

   3）测试自助设备是否正常连接

       a)  用实体会员卡测试自助设备，看能否正常使用，且娱乐管家系统后台是否有对应数据记录

7.3 支付测试

  1）测试微信支付和支付宝支付是否正常收款

       a)  在收银台软件测试微信支付和支付宝支付能否正常收款

       b) 在自助兑币机上测试微信和支付宝能否正常收款

       c) 查看客户的收款账号是否到帐，使用汇付则查询汇付平台

  2）需要将游乐宝系统的支付方式禁用，避免收银员登录游乐宝收银台收银

八、常见问题

【游乐宝升级娱乐管家常见问题合集】