常见问题¶
服务员如何登录？¶
服务员打开应用并使用其员工凭据（用户名和密码）登录。这确保每次换电都与经授权的服务员关联。
如果客户的 QR 码无法扫描怎么办？¶
切换到录入订阅 ID 备用方式。服务员可以手动输入客户的订阅 ID。如果仍然找不到订阅，请与客户核实 ID。
应用如何读取电池？¶
应用扫描电池的 QR 码以识别它，然后通过蓝牙低功耗（BLE）连接。它读取两个服务：
- ATT 服务 — 提供电池 ID
- DTA 服务 — 提供剩余能量（千瓦时）
如果蓝牙连接失败怎么办？¶
确保服务员设备上的蓝牙已启用，且电池在范围内。重试连接。如果问题持续存在，重启应用或尝试不同的电池。
换电费用如何计算？¶
费用计算公式为：
energy_difference = floor(new_energy - old_energy, 2)
net_energy = energy_difference - quota_remaining
cost = net_energy × rate_per_kWh
能量差值向下取整到小数点后 2 位。在应用每千瓦时费率之前，先扣除客户的预付配额。
如果客户的配额覆盖全部费用会发生什么？¶
如果配额覆盖了整个能量差值，应付净额为零。服务员可以直接完成换电——步骤 5（付款）被跳过，流程直接进入步骤 6（完成）。
支持哪些付款方式？¶
付款通过 M-Pesa 收取，使用以下两种方式之一：
- 扫描 QR 码 — 服务员扫描客户的 M-Pesa 付款 QR
- 手动录入收据 — 服务员输入 M-Pesa 确认码
交易如何向后端报告？¶
付款确认后（或由于配额而跳过），应用向后端发送两条 MQTT 消息：
- 包含金额、收据码和时间戳的付款事件
- 包含电池换电详情（旧电池、新电池、能量、客户订阅）的服务事件
服务员可以返回更正错误吗？¶
可以。在任何步骤使用返回按钮可以回到上一步骤。选择和读取结果在更改之前保留。
离线时流程是否有效？¶
基于 BLE 的电池扫描和能量读取在没有互联网的情况下也能正常工作。但是，客户查询（步骤 1）和付款/MQTT 报告（步骤 5）需要网络连接。
服务员可以立即开始另一次换电吗？¶
可以。在步骤 6（完成）完成换电后，服务员点击新换电返回步骤 1，开始新的交易。