酒店 PMS · 手机版入口对接说明（给小齐）

用途：C 端小程序（miniprogram-v2，小齐域）只需提供一个入口，把商户员工引导到 B 端商户工作台 H5（b-workbench）。

这份 H5 已做「手机版 / 电脑版」响应式双形态，无需小程序单独开发房务功能。

1. 一句话结论

• B 端 H5 一个 URL 同时服务手机和电脑：同一套代码，按屏幕宽度自动切换形态。
• 手机（<1024px）：底部 tabBar（工作台 / 订单 / 核销 / 评价 / 我的）+ 工作台首页「今日房务」快速操作面板（今日入住 / 在住 / 今日退房 + 一键办理）。
• 电脑（≥1024px）：左侧分组侧边栏（按业态包过滤菜单）+ 完整功能页。
• 小程序只负责「打开」这个 H5，不负责登录态打通。商户员工在 web-view 内用「手机号 + 密码」登录一次即可（token 在 web-view 内缓存 1 天）。

2. 小程序侧对接（小齐做）

2.1 入口放置

在 C 端小程序的合适位置（建议「我的」页或商家工具区）放一个入口，点击后用微信 web-view 组件打开：

https://b.kailashi.cn/workbench/

备选域名（同一份部署）：https://doc.kailashi.cn/workbench/

注：当前 staging/生产都实测可访问，b.kailashi.cn 为首选。

2.2 代码片段（示意）

<!-- miniprogram 页面 wxml -->
<web-view src="https://b.kailashi.cn/workbench/" wx:if="{{showBizH5}}"></web-view>

// 点击「商家房务后台」→ 设置 showBizH5=true 即可

2.3 可选：带跳转锚点

如果希望打开后直接落到某个功能页（如入住台），可在 URL 后追加 # 路由（仅客户端导航有效，刷新可能回首页，属已知限制）：

https://b.kailashi.cn/workbench/#/hotel-checkin

3. 登录与登录态（重要）

3.1 现状：web-view 内独立登录（推荐，已就绪）

• 微信 web-view 的存储与小程序 storage 互相隔离，C 端游客 token 不能直接用于 B 端。
• 商户员工（前台/店长）在 web-view 里用「手机号 + 密码」登录 B 端，登录成功后 token 写入 web-view 的 localStorage，有效期 1 天。
• 当天再次打开（同设备同 web-view）免登录；隔天需重新登录一次。

3.2 为什么不做「小程序一键免登录」

• B 端登录身份 = 商户员工账号（由管理员开通），与 C 端游客不是同一套账号体系。
• 因此从 C 端游客态「带 token 跳 B 端」在逻辑上不成立，必须员工独立登录。
• 若未来想做「员工在小程序内登录后免重复登录 B 端 H5」，需要：
• 小程序侧拿到员工 JWT；
• B 端 App.tsx 在启动时读取 ?token= 参数并写入 localStorage（当前版本未实现，需波波补一小段）。
• 安全上建议改用「一次性 ticket 换 token」，避免 JWT 明文出现在 URL / 服务器日志。

结论：当前阶段用 3.1 的独立登录即可，简单且安全。3.2 是后续优化，不影响上线。

4. 手机版形态速览（给测试的验收点）

「今日房务」面板（住宿包商户可见）会调用：

GET /api/miniapp/merchant-console/hotel/bookings?check_out_from=今天

前端按状态/日期归并出「今日入住 / 在住 / 今日退房」三个数，点击直达入住台 / 房态日历。

5. 安全与合规提醒

• 不要在 web-view URL 里拼 JWT / 敏感参数：会被服务器访问日志、网关记录。
• web-view 与小程序 storage 隔离，C 端游客数据不会泄露到 B 端。
• B 端所有写操作（入住/退房/收款/房态）都走 merchant_staff 鉴权，非员工账号会被后端 403 拒绝。

6. 自测清单（小齐验收）

• [ ] 小程序入口点击能打开 https://b.kailashi.cn/workbench/
• [ ] 手机尺寸下看到底部 tabBar + 今日房务面板
• [ ] 用员工手机号+密码能登录，登录后看到住宿包菜单（入住台/房态/客账等）
• [ ] 电脑浏览器打开同一 URL，看到左侧分组侧边栏
• [ ] 今日房务三个数字与实际预订一致（可用 staging 测试商户验证）
• [ ] 退出 web-view 当天再进免登录