面向充电站、换电驿站、骑手驻点等一线加盟商（以及家谱产品的未来城市合伙人），涵盖建站落地、设备值守、电池流转与日常收益操作
| 维度 | 区域代理商 | 门店/驿站加盟商 |
|---|---|---|
| 角色定位 | 区域独家运营，负责招商与拓展 | 一线站点经营者，负责建站与值守 |
| 收益来源 | 区域流水分润 + 设备差价 | 站点流水分成 + 增值服务（如骑手驻点） |
| 管理范围 | 多站点、多加盟商 | 单店/单驿站 |
| 后台权限 | 区域级多租户管理 | 本站设备管理 + 本店订单/收益查看 |
📦 三套产品与加盟范围说明：本手册的建站、值守、电池流转与收益条款主要面向 充电平台「快充侠」 与 换电平台「智汇e充」 的门店/驿站加盟商。家谱产品「pedigree」 为直营 C 端 SaaS，无硬件建站与电池流转环节；若未来开放家谱城市合伙人（机构拓客、家族活动承办等），将另行发布专项加盟条款，不套用本手册的电力报装与柜控流程。
选择车流/人流充足、具备电力容量的点位；充电桩需三相电容量，换电柜需独立零线排与消防间距。
与区域代理商签订加盟协议，由代理商在平台开通站点租户并分配加盟商操作员账号。
按规范布线、接地、安装配电箱与柜体；换电柜需预留散热与消防通道，张贴安全标识。
代理商后台录入站点与设备（桩号/柜号、通信密钥、二维码），使用批量配置工具一键生成。
设备联网后平台自动识别，扫码充电/换电实测通过即上线；可用出厂自动验收工具生成验收报告。
保持现场整洁与设备可视，引导用户规范操作，异常及时报修。
换电柜的押金、套餐、换电计费均通过微信 JSAPI 支付收款。平台支持两种通道，加盟商是否自己收钱决定要准备哪些参数：
🧭 模式如何判定（代码逻辑）：平台读取后台「加盟商子商户号 sub_mch_id」——
• 填了 sub_mch_id → 服务商(SP)模式：资金直接清分到加盟商自己的微信子商户账户，用平台服务商号证书签名；
• 留空 → 普通商户模式：资金先进平台商户号，再按分润报表线下结算给加盟商。
⚠️ 关键限制：下单用的 AppID 必须与收款商户号在微信商户平台绑定一致，且支付 openid 必须是该 AppID 对应小程序的 openid，否则报「JSAPI 支付必须传 openid」或支付失败。
| 参数 | 配置项 | 说明 |
|---|---|---|
| 小程序 AppID | mini_app.app_id | 加盟商自有小程序的 AppID，C 端用户在此下单；必须与支付 AppID 同源 |
| 小程序 AppSecret | mini_app.secret | 用于 code2session 换取用户 openid（小程序 /user/wxlogin 登录） |
| 商户号绑定 | 微信公众平台后台 | 该小程序须绑定到收款商户号（SP 模式绑服务商号、普通模式绑平台商户号） |
| 参数 | 配置位置 | 说明 |
|---|---|---|
| 加盟商子商户号 | 后台 ev_franchisee.sub_mch_id | 加盟商在微信支付申请的特约商户号；填了即切 SP 模式 |
| 子商户小程序 AppID（sub_appid） | 由登录 openid 反推 | 必须与 sub_mch_id 在商户平台绑定 |
| 服务商 AppID | wechat.sp_app_id | 平台方服务商应用 ID（已认证并关联服务商号） |
| 服务商商户号 | wechat.sp_mch_id | 平台方服务商号 |
| 服务商证书序列号 | wechat.sp_serial_no | 服务商号 API 证书序列号 |
| 服务商私钥文件 | wechat.sp_private_key_path | 服务商号证书私钥(PEM)，与证书配对 |
只需平台侧已配好 wechat.app_id / mch_id / api_v3_key / serial_no / private_key_path / notify_url，加盟商不必提供商户号；资金进平台账户，加盟商靠分润报表结算。两种模式都依赖的平台级参数：
| 参数 | 配置项 | 说明 |
|---|---|---|
| APIv3 密钥 | wechat.api_v3_key | 32 字节，用于回调 AES 解密与平台证书解密 |
| 支付回调地址 | wechat.notify_url | 公网可达 HTTPS，如 https://域名/api/wx/pay/notify |
| 平台证书 | 自动下载 | /v3/certificates 自动拉取缓存，无需手动配 |
AppID + Secret，并在微信后台绑定到收款商户号。
微信支付特约商户号 sub_mch_id，且该小程序已绑定到平台服务商号。
notify_url 必须 HTTPS 公网可访问（支付回调）。
📌 部署分工：服务商私钥/证书由平台运维写入 config.yaml 的 wechat.sp_* 段；加盟商子商户号由后台管理员在加盟商管理中填写 sub_mch_id。参数不全时下单会直接报错（不会静默失败），按报错补齐即可。
满电电池入取电仓、亏电电池入还电仓，按型号分区；禁止混放不同规格电池，避免用户领错。
柜门卡阻或开仓失败，先重启柜控；平台「远程开门」可下发指令，仍失败联系代理商运维现场处置。
关注平台电池健康报告，鼓包/高温/低循环寿命电池立即下架并标记故障，防止安全事故。
引导骑手使用小程序扫码换电，押金/套餐门禁自动校验；新用户协助完成实名与电池型号选择。
移动管理端实时查看本站当日流水、订单数、在线设备数，支持自定义时段筛选。
站点分成按协议周期入账；提现申请在后台提交，财务审核后打款，明细可一键导出。
充电异常自动终止、占位费阶梯提醒、超时自动停充均由平台自动处理，值守人员关注告警推送即可。
站点信息同步百度/高德/腾讯地图，配合省平台引流；可参与总部统一活动提升单量。
换电柜须远离明火、配备灭火器，定期巡检电气线路；枪线温度≥90℃平台自动建议停充并告警。
配电箱加装漏保，雷雨天气关注离线告警；严禁私拉乱接，施工须由持证电工完成。
操作员账号专人专用，离职及时停用；平台操作全程审计，异常登录实时预警。