电小乐DEVELOPMENT SCOPE REVIEW

两轮电动车无线充电项目 · 2026.11.09

Java + uni-app
后端开发需求分析

建议按 14 个逻辑模块组织。开发重点在设备接入、充电订单与计费、资金及收益结算。模块数量不等于微服务数量。

依据：29 页项目 PDF，重点为第 11、13–19、23–25 页。方案描述与开发建议分列，供需求讨论及估工使用。

01 / 用户侧

小程序与移动工作台

登录与车辆绑定 → 地图找站 → 自动 / 扫码充电 → 查看状态与账单 → 充值、积分及报障。

02 / 经营侧

平台与合作方管理

平台、代理商、投资方与物业：站点资产、权限内经营数据、收益流水与提现、告警与运维工单。

03 / 设备侧

主机、点位与接收器

站点 → 主机 → 充电点位（TX）；车辆 → 接收脚撑（RX）。方案为一台主机带 10 个点位，建议数量可配置。

后端模块清单

共 14 个模块

点击模块展开详情。“商业运营”在涉及真实合作方收益时需纳入上线范围；“可后置”不代表删除需求。

01用户与车辆 / RX 绑定充电基础

文档已描述

账户、我的车辆、RX 编号绑定

建议开发内容

微信登录与手机号绑定；车辆档案；RX 接收器绑定、解绑、换绑；授权记录；自动充电开关。

边界与待确认

RX 必须能可靠识别到用户；绑定与自动扣费授权分开记录。

主要数据对象（建议）

uservehiclereceiver_binding

文档依据：第 16–17 页。数据对象和异常处理为开发建议。

02组织、角色与数据权限充电基础

文档已描述

平台、代理、投资方、物业多角色后台

建议开发内容

账号角色、组织归属、城市与站点可见范围、菜单权限、接口权限和操作审计。

边界与待确认

后台必须校验数据范围；隐藏前端入口不能替代鉴权。

主要数据对象（建议）

organizationroleuser_roledata_scope

文档依据：第 16–18 页。数据对象和异常处理为开发建议。

03站点、主机与充电点位充电基础

文档已描述

一台主机带 10 个点位；地图找桩及空闲位

建议开发内容

站点经纬度、开放时间、主机与点位台账、设备编号、二维码、投运 / 停用、附近站点查询。

边界与待确认

区分在线、空闲、占用、充电、故障；未知状态不直接展示为空闲。

主要数据对象（建议）

stationhost_devicecharge_point

文档依据：第 11、13、17 页。数据对象和异常处理为开发建议。

04物联网接入与设备指令充电基础

文档已描述

云端远控；温度、电压、电流、在线状态上云

建议开发内容

对接厂家平台 API 或设备通信协议；心跳、遥测、事件、启动 / 停止指令及回执；鉴权、去重与重连补报。

边界与待确认

PDF 没有给出 MQTT / TCP / HTTP 协议；蓝牙 5.0 的描述也不能直接推定为小程序直连。

主要数据对象（建议）

device_eventtelemetrydevice_command

文档依据：第 11、14、25 页。数据对象和异常处理为开发建议。

05充电会话与业务订单充电基础

文档已描述

一键启停、实时监测、充满自停、订单记录

建议开发内容

自动或扫码发起；检查用户 / 点位 / 余额资格；记录启动、充电、停止、结算及异常；历史订单与异常恢复。

边界与待确认

指令已发送不等于充电已启动；以回执和设备事件推进状态，超时进入待核查。

主要数据对象（建议）

charge_sessioncharge_ordersession_event

文档依据：第 14、16–17、25 页。数据对象和异常处理为开发建议。

06计费规则与费用计算充电基础

文档已描述

充电缴费与服务费收入

建议开发内容

确认按时长、按电量或套餐；站点费率、服务费、舍入规则、优惠顺序、费用上限；订单锁定费率版本。

边界与待确认

主机总电表是否能支持逐点计费尚不明确；需确认点位计量精度、计量边界和断网补报口径。

主要数据对象（建议）

tarifftariff_versionbilling_detail

文档依据：第 16、19 页涉及费用；规则待补。数据对象和异常处理为开发建议。

07支付、钱包与资金流水充电基础

文档已描述

账户充值、钱包与缴费

建议开发内容

微信支付下单与通知；充值账、消费账、余额冻结 / 扣减 / 释放、退款、主动查单和日对账。

边界与待确认

充值订单、充电订单分开；避免重复回调重复入账；钱包消费与微信原路退款分开处理。

主要数据对象（建议）

payment_orderwallet_accountwallet_ledgerrefund

文档依据：第 16–17 页。数据对象和异常处理为开发建议。

08合作主体、资产与协议商业运营

文档已描述

投资方资产台账、代理合作档案、协议权益

建议开发内容

代理 / 投资方 / 物业档案、区域、项目与资产关联、协议附件、合作期限、收益权与设备归属记录。

边界与待确认

区分设备产权、使用权与收益权，不简单把投资方等同于设备所有人。

主要数据对象（建议）

partnerprojectasset_interestagreement

文档依据：第 16、19、23–24 页。数据对象和异常处理为开发建议。

09分账、结算与收益提现商业运营

文档已描述

按协议自动分账、收益流水、提现、T+1 结算描述

建议开发内容

按站点 / 协议配置分配比例与生效时间；净收入基数、分账明细、退款冲正、结算批次、提现审核及出款结果。

边界与待确认

10% / 10% / 40% / 40% 是基准示例，不写死；内部记账分配与支付渠道实际出款分别建模。

主要数据对象（建议）

share_ruleshare_ledgersettlementwithdrawal

文档依据：第 19、23–25 页。数据对象和异常处理为开发建议。

10积分、优惠与兑换商城可后置

文档已描述

充电积分、好礼兑换；界面出现优惠券

建议开发内容

积分发放 / 消耗 / 退回、兑换商品、库存、兑换订单、核销或物流；优惠券规则另确认。

边界与待确认

先确认虚拟券 / 线下核销 / 实物发货范围；文档未定义完整电商交易链路。

主要数据对象（建议）

point_ledgerreward_skuredeem_ordercoupon

文档依据：第 17 页及界面示意。数据对象和异常处理为开发建议。

11告警、报障与运维工单充电基础

文档已描述

用户报障、离线与异常告警、代理工单处理

建议开发内容

温度 / 电流等告警阈值、设备离线检测、告警去重、报障图片、派单、处理、回访、关闭与超时升级。

边界与待确认

电气保护与异常断电由设备本地保障；后台承担监控、处置与记录。

主要数据对象（建议）

alarmfault_reportwork_order

文档依据：第 16、23–25 页。数据对象和异常处理为开发建议。

12消息与服务通知充电基础

文档已描述

消息通知入口、安全告警提示

建议开发内容

启动结果、结束、低余额、退款、工单、结算的站内消息；按渠道能力接入小程序订阅通知及运维通知。

边界与待确认

文档未指定通知渠道；失败重试与重复通知控制属于实现建议。

主要数据对象（建议）

messagesubscriptiondelivery_log

文档依据：第 17 页界面；告警需求见第 25 页。数据对象和异常处理为开发建议。

13运营报表与多角色看板商业运营

文档已描述

站点日报、经营收益、设备资产及账单查询

建议开发内容

订单量、充电量、消费收入、退款、在线率、点位利用率、合作方收益；按权限筛选和导出。

边界与待确认

充值额、消费收入、分账额、可提现额分别统计；报表与订单 / 资金流水核对。

主要数据对象（建议）

daily_station_statpartner_statement

文档依据：第 16、18、25 页。数据对象和异常处理为开发建议。

14平台配置与后台基础能力充电基础

文档已描述

用户端与 B 端品牌分层、后台管理

建议开发内容

品牌与协议配置、字典、文件存储、后台菜单、任务调度、关键操作日志、接口限流、备份及监控。

边界与待确认

这是公共能力清单，不表示每一项都要单独部署服务。

主要数据对象（建议）

configfile_recordaudit_logjob

文档依据：第 18 页后台定位；细项为实现建议。数据对象和异常处理为开发建议。

建议的一期闭环与架构

PHASE 01充电试点

账号 / RX 绑定、找站、设备接入、启停、订单、计费、充值 / 扣费 / 退款、基础后台与告警。

上线前提：有真实硬件、完整协议和可复现的计量数据；通过启动失败、设备断网、重复事件、余额不足等联调。

PHASE 02合作经营上线

合作主体与资产、分账明细、权限内账单、对账与结算；按确认的方式完成出款。

上线前提：协议明确收益基数和比例；退款可冲正；确认实际资金通道和出款状态。涉及真实合作方收益时需同期交付。

PHASE 03增强功能

积分商城、优惠活动、自动派单、高级看板、多城市推广。

优先把电充成功、费用算准、账对得上，再扩展运营能力。

架构建议：先按业务拆模块

uni-app 承担用户小程序及移动工作台；Java 后端按业务包拆分；PC 管理后台单独规划。初期采用 Spring Boot 模块化单体 + 关系数据库 + Redis，设备接入层按厂家 API / 协议适配，需要时再独立部署。消息队列按事件量和补偿需求引入。

这是针对本项目的设计建议，未指定版本、设备容量或部署规模。客户端支付需要服务端配合，支付凭据及处理逻辑应按实际渠道确定。

充电订单的关键状态

资格校验→待启动→设备确认启动→充电中→待停止→设备确认结束→待结算→已完成

启动失败：核查设备是否实际供电，再释放冻结金额或退款。断网或停止未确认：进入异常核查，依赖设备本地保护与恢复后的事件补报，避免仅凭接口超时推断设备已停。

建议将充电会话、业务订单、支付订单、钱包流水、合作方分账流水分开记录。计费起止点、计量值、费率版本、停止原因及每次状态变化均保留记录。

报价与排期前，补齐这 6 项

  1. 先确认重建还是对接

    PDF 第 16 页称已有自研数字平台。能否拿到现有 SaaS 的接口、账号和数据？只做小程序对接与整个平台重建，工作量差异很大。

  2. 无感充电与扫码如何并存

    第 14 页写无需扫码，第 17 页写扫码 / RX 绑定与一键启停。建议澄清首次绑定、后续自动识别、用户授权、余额不足及手动扫码兜底。

  3. 硬件能提供什么

    索取协议、事件字段、错误码、点位计量方式、测试设备及厂家联调支持；确认 RX 身份、充满事件和指令回执是否都有。

  4. 计费和扣费如何定义

    明确按电量 / 时长 / 套餐，充值预存或按次支付，未启动退款、提前结束、断网和设备故障如何结算。

  5. 分账与实际出款怎么做

    明确收款主体、收入基数、电费和手续费承担、规则生效、退款冲正、结算周期与提现方式；T+1 是方案描述，不能视为已接通的能力。

  6. 一期到底包含哪些端

    用户小程序是否加投资 / 代理 / 物业工作台？是否另做 PC 后台、实物积分商城、优惠券和高级运营报表？