人才卡
blame | 历史 | 原始文档

自助洗车服务商详情页面操作说明

页面信息

  • 页面名称：自助洗车服务商详情
  • 路由：/pages/car-wash-merchant/car-wash-merchant
  • 源码：pages/car-wash-merchant/car-wash-merchant.uvue
  • 入口：行—畅行无忧页面切换“洗车服务”，点击洗车服务列表项。
  • 当前状态：已接入洗车服务详情接口和受控外部服务跳转；外部小程序 AppID、路径和网页域名仍由运营后台按实际上线目标配置。

功能点

功能 当前实现 后续接口目标
服务信息 根据 merchantId 请求并展示服务名称、适用人才卡、服务点和启用状态；加载失败只显示重试，不展示静态服务点。 后台维护服务 ID、名称、适用人才卡、服务点说明和启用状态。
服务提示 页面中部展示接口返回的纯文本提示，并限制在一屏可读范围。 后台返回安全纯文本提示文案。
外部服务跳转 页面底部仅保留“去洗车”按钮；支持后端确认的外部小程序或 HTTPS 网页。未配置时明确提示且不跳转。 后台配置经过校验的跳转类型及对应目标。
静态页控制 页面使用一屏布局并禁止纵向拖动。 后台文案超长时应限制长度或由产品确认改为可滚动布局。

操作说明

  1. 用户从畅行无忧切换“洗车服务”并进入详情页。
  2. 查看适用人才卡、洗车服务点和操作提示。
  3. 点击底部“去洗车”。
  4. 后台配置为 miniProgram 时打开指定外部小程序；配置为 web 时进入小程序内网页承载页。

异常处理

场景 页面处理要求
未配置外部链接 不执行跳转，提示“洗车服务链接暂未配置”。
外部小程序打开失败 提示“暂时无法打开洗车服务”，保留当前页面。
网页域名未加入白名单 不使用任意地址兜底；修正微信小程序业务域名配置后再启用。
服务停用 展示后台停用原因并禁用“去洗车”按钮。
服务详情加载失败 保留返回入口并提供重试，不展示错误的静态服务点。

接口预留

  • 已接入：GET /api/app/car-wash-merchants/{merchantId}。
  • 洗车服务详情：服务 ID、服务名称、适用人才卡、服务点纯文本、提示文案和启用状态。
  • 外链类型：externalLinkType，枚举为 miniProgram 或 web。
  • 外部小程序：externalMiniProgramAppId、externalMiniProgramPath；必须由可信后台配置真实目标。
  • 外部网页：externalWebUrl；必须使用 HTTPS 且域名已加入微信小程序业务域名白名单。
  • 安全要求：服务端只允许预先登记的 AppID、路径和域名，客户端不得接受并直跳任意 URL。

运营配置

  • 在 transport_car_wash_service 中配置 external_link_type、对应的小程序 AppID/路径或 HTTPS 网页地址。
  • 网页地址的域名还必须写入后端环境变量 CAR_WASH_ALLOWED_WEB_HOSTS（逗号分隔）并加入微信小程序业务域名白名单；未同时满足时接口会清空外链配置。
  • 当前迁移仅初始化服务文案，不预置虚构的 AppID 或网页地址，因此“去洗车”会提示链接暂未配置，直到运营提供真实可信目标。