Skip to content

机器激活 — Hiro App

触发条件: 用户在 Hiro App 中选择机器或扫描二维码 涉及产品: Hiro App · Hiro Platform · Hiro Link 结果: 机器启动,用户在 App 中看到运行中的循环计时器


流程

用户打开 Hiro App

        ├─ 扫描机器上的二维码
        │       或
        └─ 浏览门店 → 选择机器


        App 向 Hiro Platform 发送激活请求
        (门店 ID、机器 ID、用户 ID、钱包余额)


        ┌─────────────────────────────────┐
        │  Hiro Platform:前置检查         │
        └─────────────────────────────────┘

                ├─ [1] 机器是否在线?
                │       (检查 Hiro Link 最近心跳 / 状态)
                │       否 → 返回错误 → App 显示「机器不可用」

                ├─ [2] 机器是否可用?
                │       Platform 先检查机器类型:
                │       │
                │       ├─ 洗衣机(WASHER)
                │       │       必须处于空闲状态才能激活
                │       │       运行中 → 返回错误 → App 显示「机器使用中」
                │       │
                │       └─ 烘干机(DRYER)
                │               空闲   → 正常激活
                │               运行中 → 允许加时(延长当前循环)
                │               App 显示剩余时间 +「加时」选项

                └─ [3] 用户钱包余额是否充足?
                        (循环价格 ≤ 钱包余额)
                        否 → 返回错误 → App 显示「余额不足」
                               + 提示充值

                ▼  所有检查通过
        Platform 从钱包余额中扣除循环费用


        Platform 向 Hiro Link 发送激活指令


        Hiro Link 激活机器

                ├─ 机器有响应(协议型)  → Link 向 Platform 发送循环启动确认 + 计时器数据

                └─ 机器无响应(脉冲型)  → Link 向 Platform 发送脉冲已发出的确认


        Platform 记录交易
        (时间戳、门店、机器、用户、金额、循环类型)


        Platform 向 App 发送激活确认
        (交易 ID、循环时长 / 计时器起始)


        App 显示运行中的循环计时器 + 订单确认

前置检查总结

检查项通过条件失败响应
机器在线Hiro Link 已连接且 Platform 可达「机器不可用,请尝试其他机器」
机器可用洗衣机:必须空闲。烘干机:空闲或运行中(允许加时)洗衣机运行中 → 「机器使用中」
余额充足钱包余额 ≥ 循环价格「余额不足」+ 充值提示

不同机器类型的行为差异

机器类型空闲运行中
洗衣机正常激活阻止激活,显示「机器使用中」
烘干机正常激活允许加时——延长当前运行的循环

激活后

  • 用户在 Hiro App 中看到倒计时计时器
  • 计时器数据来源:协议型机器通过 Platform 由 Hiro Link 提供。脉冲型机器的计时器为预设估算值加上偏移量(以补偿从支付到用户装载衣物之间的延迟),显示时带有"~"前缀表示为近似值
  • 交易记录在 Platform 中,用于订单历史与商家报表

相关流程

Hiro 内部 wiki — 为 LLM 摄取和 agent 编辑优化。