autumn/jsowell-charger-web
1
0
Fork 0
mirror of https://codeup.aliyun.com/67c68d4e484ca2f0a13ac3c1/ydc/jsowell-charger-web.git synced 2026-04-19 18:45:03 +08:00
Code Issues Packages Projects Releases Wiki Activity

commit

Browse Source
This commit is contained in:
JSOWELL-PC\autum
2023-03-04 16:29:55 +08:00
commit 397ba75479
1007 changed files with 109050 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
doc/2022年11月17日逻辑改动.md Normal file
View File

@@ -0,0 +1,11 @@
充电桩
1. 充电桩桩类型全部都是运营桩
2. 充电桩必须绑定计费模板才能使用
3. 充电桩桩对白名单用户免费
4. 创建订单时，判断是否为白名单用户
站点白名单

134
doc/接口文档.md Normal file
View File

@@ -0,0 +1,134 @@
# 根据充电桩id查询详情接口
>根据充电桩id查询相关信息，包括运营商信息、充电站信息、充电枪信息、协议信息、sim卡信息等。
入参
| 字段名 | 类型 | 是否必传 | 备注 |
| ------ | ------ | -------- | -------- |
| pileId | String | Y | 充电桩id |
反参
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------------- | ------ | -------- | ---------------------------- |
| sn | String | Y | sn号 |
| stationName | String | Y | 站点名称 station |
| merchantName | String | Y | 运营商名称 merchant |
| pileType | String | Y | 设备类型(1-汽车桩，2-电单车) model |
| gunNum | int | Y | 枪数量 model |
| interfaceStandard | String | Y | 接口标准 model |
| ratedPower | int | Y | 额定功率(单位W) model |
| outputCurrent | int | Y | 输出电流(单位A) model |
| ICCID | String | Y | sim卡信息 |
| registrationTime | String | Y | 注册时间 licence |
| expireTime | String | Y | 到期时间 licence |
![image-20220924155754954](C:\Users\李苗苗\AppData\Roaming\Typora\typora-user-images\image-20220924155754954.png)
## 站点管理列表
#### 反参
PileStationVO
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------------- | ------- | -------- | :----------: |
| id | String | | 站点id |
| stationName | string | | 站点名称 |
| areaCode | S | | 省市辖区编码 |
| area | S | | 地区 |
| address | S | | 地址 |
| PileNum | Integer | | 充电设备数量 |
| merchantId | S | | 运营商ID |
| merchantName | S | | 运营商名称 |
| merchantAdminName | S | | 运营商管理员 |
| stationStatus | Integer | | 站点状态 |
| stationType | s | | 站点类型 |
| createTime | s | | 创建时间 |
| stationTel | s | | 站点电话 |
| matchCars | s | | 适用车型描述 |
| stationLng | s | | 经度 |
| stationLat | s | | 纬度 |
| construction | s | | 建设场所 |
| businessHours | s | | 营业时间描述 |
| organizationCode | s | | 组织结构代码 |
| publicFlag | s | | 是否对外开放 |
| openFlag | s | | 是否营业中 |
## BatchCreatePileDTO
| 字段名 | 类型 | | 备注 |
| ---------------- | ---- | ---- | ---------------------------- |
| merchantId | s | | 运营商id |
| stationId | s | | 充电站id |
| modelId | s | | 型号id |
| softwareProtocol | s | | 软件协议（1-云快充；2-永联） |
| productionDate | Date | | 生成日期 |
| connectorNum | int | | 接口数量 |
| num | int | | 生成台数 |
| remark | s | | 备注 |
### 计费模板时段详情
```
CreateBillingTemplateDTO
```
| 字段名 | 类型 | | 备注 |
| ----------------- | -------------------------------------- | ---- | ---------------------------------------- |
| name | s | | 模板名称 |
| type | s | | 时段类型 |
| electricityPriceA | BigDecimal | | 尖时段电费 |
| servicePriceA | BigDecimal | | 尖时段服务费 |
| electricityPriceB | BigDecimal | | 峰时段电费 |
| servicePriceB | | | 峰时段服务费 |
| electricityPriceC | | | 平时段电费 |
| servicePriceC | | | 平时段服务费 |
| electricityPriceD | | | 谷时段电费 |
| servicePriceD | | | 谷时段服务费 |
| remark | s | | 备注 |
| 时段清单 | private List<BillingTimeDTO> timeList; | | |
| type | String | | 时段类型（1-尖时；2-峰时；3-平时；4-谷时 |
| timeDesc | s | | 时段 例如：00：00-05：00 |
### 快速建站DTO FastCreateStationDTO
| 字段名 | | | 备注 |
| ----------- | ---- | ---- | ------------ |
| merchantId | S | | 所属运营商id |
| stationName | S | | 名称 |
| address | S | | 地址 |
| areaCode | S | | 区域 |
### 站点导入计费模板dto ImportBillingTemplateDTO
| 字段名 | 类型 | | 备注 |
| ----------------- | ---- | ---- | ---------- |
| stationId | | | 站点id |
| billingTemplateId | | | 计费模板id |
### 查询充电枪返回前台参数
PileConnectorInfoVO
| 字段名 | 类型 | | 备注 |
| ------------------ | ---- | ---- | --------------------------- |
| connectorId | S | | 充电枪口id |
| connectorCode | S | | 枪口编号，由充电桩SN+01生成 |
| connectorQrCodeUrl | S | | 充电二维码 |
| status | int | | 状态 |
| type | S | | 类型 |
| instantPower | B | | 即时功率 |
| electricity | big | | 电量 |
| SOC | S | | SOC |
| plantformOrderNum | S | | 平台订单 |
| equipmentOrderNum | S | | 设备订单号 |
| chargingTime | S | | 充电时长 |
| voltage | B | | 电压 |
| current | B | | 电流 |
| temperature | B | | 温度 |
| userInfo | S | | 用户信息 |
| orderId | S | | 订单id |
| carNo | S | | 车牌号 |

621
doc/接口文档New.md Normal file
View File

@@ -0,0 +1,621 @@
# 小程序接口
## 接口返回格式
| 字段名 | 类型 | 是否必传 | 备注 |
| ------- | ------ | -------- | ---------- |
| resCode | String | Y | 返回码 |
| msg | String | Y | 返回信息 |
| obj | Object | Y | 返回的数据 |
以下接口反参，指的是obj中的数据，接口返回都有resCode，msg，obj这三个字段。
### 示例
~~~json
# 入参
{
"pageSize": "10",
"pageNum": "1",
"stationLng": "55.96",
"stationLat": "155.77"
}
# 反参
{
"resCode": "00100000",
"msg": "操作成功",
"obj": {
"pageNum": 1,
"pageSize": 10,
"list": [
{
"stationId": "2",
"stationName": "测试仓库",
"stationAddress": "华新镇华隆路1777号6幢D座",
"distance": "10745.74",
"electricityPrice": null,
"servicePrice": null,
"fastTotal": 0,
"fastFree": 0,
"slowTotal": 3,
"slowFree": 0
},
{
"stationId": "1",
"stationName": "测试",
"stationAddress": "黄埔江南路278号举视新能源",
"distance": "10762.94",
"electricityPrice": null,
"servicePrice": null,
"fastTotal": 0,
"fastFree": 0,
"slowTotal": 0,
"slowFree": 0
}
],
"total": 2,
"pages": 1
}
}
# 错误反参
{
"resCode": "00100010",
"msg": "查询充电站信息列表异常",
"obj": null
}
~~~
## 1001 登录注册接口
## 1002 查询会员信息
> 接口地址：http://localhost:8080/uniapp/member/getMemberInfo
>
> 请求方式：GET
### 入参
null，在Header中需传Authorization
### 反参
| 字段名 | 类型 | 是否必传 | 备注 |
| -------- | ------ | -------- | ------------ |
| MemberVO | Object | Y | 用户信息对象 |
### MemberVO
| 字段名 | 类型 | 是否必传 | 备注 |
| ------------------ | ------ | -------- | --------------------------- |
| memberId | String | Y | 会员Id |
| status | String | Y | 状态(1-正常;0-停用) |
| nickName | String | Y | 用户昵称 |
| mobileNumber | String | Y | 手机号码 |
| principalPrice | Number | Y | 本金金额 |
| giftPrice | Number | Y | 赠送金额 |
| totalAccountAmount | Number | Y | 总金额(本金金额 + 赠送金额) |
## 1003 修改会员信息
## 2001 根据经纬度查询充电站列表（分页排序）
> 接口地址：http://localhost:8080/uniapp/pile/queryStationInfos
>
> 请求类型：POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------- | ------ | -------- | ---------------- |
| stationLng | String | N | 经度 |
| stationLat | String | N | 纬度 |
| pageNum | Number | Y | 页码 |
| pageSize | Number | Y | 每页数量 |
| stationName | String | y | 站点名称（搜索） |
### 反参
| 字段名 | 类型 | 是否必传 | 备注 |
| -------- | ---------------- | -------- | ---------- |
| pageNum | Number | Y | 页码 |
| pageSize | Number | Y | 每页数量 |
| list | Array<StationVO> | Y | 充电站列表 |
| total | Number | Y | 总数 |
| pages | Number | Y | 总页数 |
StationVO
| 字段名 | 类型 | 是否必传 | 备注 |
| ---------------- | ------------- | -------- | --------------------- |
| stationId | String | Y | 站点id |
| stationName | String | Y | 站点名称 |
| stationAddress | String | Y | 站点地址 |
| stationImgList | Array<String> | N | 站点图片 |
| distance | String | N | 距离 单位千米 |
| electricityPrice | String | Y | 电费 每度单价 |
| servicePrice | String | Y | 服务费 每度单价 |
| totalPrice | String | Y | 总金额（电费+服务费） |
| fastTotal | Number | Y | 快充枪口总数 |
| fastFree | Number | Y | 快充枪口空闲数 |
| slowTotal | Number | Y | 慢充枪口总数 |
| slowFree | Number | Y | 慢充枪口空闲数 |
| stationLng | String | Y | 经度 |
| stationLat | String | Y | 纬度 |
## 3001 查询充电桩详情
## 3002 查询充电桩枪口详情
> 接口地址：http://localhost:8080/uniapp/pile/selectConnectorListByParams
>
> 请求类型：POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------------- | ------------- | -------- | --------------------------- |
| pageNum | Number | Y | 页码 |
| pageSize | Number | Y | 每页数量 |
| merchantId | String | N | 运营商id ==接口暂未支持== |
| stationIdList | Array<Long> | N | 站点id列表 |
| pileIds | Array<Long> | N | 充电桩id列表 |
| connectorIdList | Array<Long> | N | 枪口id列表 |
| connectorCodeList | Array<String> | N | 枪口号列表 |
### 反参
| 字段名 | 类型 | 是否必传 | 备注 |
| -------- | -------------------------- | -------- | ------------ |
| pageNum | Number | Y | 页码 |
| pageSize | Number | Y | 每页数量 |
| list | Array<PileConnectorInfoVO> | Y | 充电枪口对象 |
| total | Number | Y | 总数 |
| pages | Number | Y | 总页数 |
### PileConnectorInfoVO
| 字段名 | 类型 | 是否必传 | 备注 |
| ------------------ | ---------- | :------: | ------------------------------------------------------------ |
| connectorId | String | Y | 充电枪口id |
| connectorCode | String | Y | 枪口编号 |
| connectorQrCodeUrl | String | Y | 枪口二维码 |
| status | Number | Y | 状态 0：离网 (默认)；1：空闲；2：占用（未充电）；3：占用（充电中）；4：占用（预约锁定） ；255：故障 |
| stationId | String | Y | 站点id |
| merchantId | String | Y | 运营商id |
| merchantName | String | Y | 运营商名称 |
| pileSn | String | Y | 充电桩编号 |
| type | String | Y | 类型 1-直流接口 汽车桩+快充 2-交流接口 汽车桩+慢充 3-插座接口 电单车桩 |
| instantPower | BigDecimal | Y | 即时功率 |
| electricity | BigDecimal | Y | 电量 |
| equipmentOrderNum | String | Y | 设备订单号 |
| platformOrderNum | String | Y | 平台订单 |
| chargingTime | String | Y | 充电时长 |
| voltage | BigDecimal | Y | 电压 |
| current | BigDecimal | Y | 电流 |
| gunLineTemperature | String | Y | 枪线温度 |
| userInfo | String | Y | 用户信息 |
| orderId | String | Y | 订单id |
| carNo | String | Y | 车牌号 |
| soc | String | Y | SOC |
| chargingAmount | BigDecimal | Y | 充电金额 |
| chargingDegree | BigDecimal | Y | 充电度数 |
| businessType | | y | 经营类型（1-运营桩；2-个人桩） |
### 示例：
```json
#入参：
{
"pageNum": 1,
"pageSize":10,
"connectorIdList":[1]
}
#反参：
{
"resCode": "00100000",
"msg": "操作成功",
"obj": {
"pageNum": 1,
"pageSize": 10,
"list": [
{
"connectorId": "1",
"connectorCode": "8800000000000101",
"connectorQrCodeUrl": "http://localhost/pileConnectorInfo&code=8800000000000101",
"status": 0,
"stationId": "2",
"merchantId": "5",
"merchantName": "举视(上海)新能源科技有限公司",
"pileSn": "88000000000001",
"type": "2",
"instantPower": 0.00,
"electricity": null,
"equipmentOrderNum": null,
"platformOrderNum": null,
"chargingTime": null,
"voltage": 0.0,
"current": 0.0,
"gunLineTemperature": "0",
"userInfo": null,
"orderId": null,
"carNo": null,
"chargingAmount": 0.00,
"chargingDegree": 0.00,
"soc": "0"
}
],
"total": 1,
"pages": 1
}
}
```
## 4001 启动充电
> 接口地址：http://localhost:8080/uniapp/order/generateOrder
>
> 请求方式：POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------------- | ------ | -------- | --------------------------- |
| pileSn | String | Y | 桩编码 |
| connectorCode | String | Y | 枪口号 |
| pileConnectorCode | String | Y | 桩枪口编号（桩编码+枪口号） |
| memToken | String | Y | 用户token（写在Header中） |
备注：pileSn + connectorCode 或 pileConnectorCode 选其一，接口都支持
### 反参
| 字段名 | 类型 | 是否必传 | 备注 |
| --------- | ------ | -------- | ------ |
| orderCode | String | Y | 订单号 |
## 4002 结束充电
> 接口地址：http://localhost:8080/uniapp/order/settleOrder
>
> 请求方式：POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------------- | ------ | -------- | --------------------------- |
| orderCode | String | Y | 订单号 |
| pileSn | String | Y | 桩编码 |
| connectorCode | String | Y | 枪口号 |
| pileConnectorCode | String | Y | 桩枪口编号（桩编码+枪口号） |
### 反参
null，若成功，msg中会有“==操作成功==”提示
## 5001 查询订单列表
> 请求地址：http://localhost:8080/uniapp/order/getOrderList
>
> 请求方式：POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------------- | ------ | -------- | --------------------------- |
| memberId | String | Y | 会员id |
| pageSize | Number | Y | |
| pageNum | Number | Y | |
| orderStatus | String | Y | 订单状态 1-全部 2-未完成 3-已完成 |
### 反参
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------------- | ------ | -------- | --------------------------- |
| orderCode | String | Y | 订单号 |
| pileSn | String | Y | 桩编码 |
| connectorCode | String | Y | 枪口号 |
| stationName | String | Y | 站点名称 |
| pileConnectorCode | String | Y | 桩枪口编号（桩编码+枪口号） |
| chargingDegree | BigDecimal | Y | 充电度数|
| orderAmount | BigDecimal | Y | 订单金额 |
| orderStatus | String | Y | 订单状态(0-待支付；1-充电中；2-待结算；3-待补缴；4-异常；5-可疑；6-订单完成) |
| startTime | String | Y | 订单开始时间 |
| endTime | String | Y | 订单结束时间 |
| payAmount | BigDecimal | Y | 用户支付金额 |
| payStatus | String | Y | 支付状态(0-待支付；1-支付完成) |
| reason | String | Y | 订单异常原因 |
## 60001 查询余额明细
> 请求地址： http://localhost:8080/uniapp/member/getMemberBalanceChanges
>
> 请求方式：POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------- | ------ | -------- | ------------------------ |
| memberToken | String | Y | 会员令牌 |
| type | String | Y | 交易类型 1-进账；2-出账 |
| pageSize | | | |
| pageNum | | | |
### 反参
| 字段名 | 类型 | 是否必传 | 备注 |
| ------------------ | ------ | -------- | -------------------------- |
| memberId | String | Y | 会员Id |
| principalBalance | Number | Y | 当前账户本金余额 |
| giftBalance | Number | Y | 当前账户赠送余额 |
| totalAccountAmount | Number | Y | 账户总余额 |
| type | String | Y | 交易类型 1-进账；2-出账 |
| subType | String | Y | 子类型 |
| amount | String | Y | 出账/入账金额 |
| transactionTime | String | Y | 交易时间 |
| category | String | Y | 余额类型（1-本金，2-赠送） |
## 7001 生成订单
> 请求地址：http://localhost:8080/uniapp/order/generateOrder
>
> 请求方式：POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------------- | ------ | -------- | ---------- |
| pileConnectorCode | String | Y | 桩枪口编码 |
| chargeAmount | Number | Y | 充电金额 |
### 反参
| 字段名 | 类型 | 是否必传 | 备注 |
| --------- | ------ | -------- | ------ |
| orderCode | String | Y | 订单号 |
## 7002 支付订单
> 请求地址：http://localhost:8080/uniapp/pay/payOrder
>
> 请求方式：POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| --------- | ------ | -------- | -------- |
| orderCode | String | Y | 订单号 |
| payMode | String | Y | 支付方式 |
| payAmount | String | Y | 支付金额 |
### 反参
null，提示”==操作成功==“
## 7003 订单停止充电
> 请求地址：http://localhost:8080/uniapp/order/stopCharging
>
> 请求方式：POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| --------- | ------ | -------- | ------ |
| orderCode | String | Y | 订单号 |
### 反参
null，提示”==操作成功==“
# 首页大数据展示
## 8001 概况
> 请求地址：http://localhost:8080/index/getGeneralSituation
>
> 请求方式：POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| --------- | ------ | -------- | ------ |
| stationId | String | N | 站点id |
### 反参
| 字段名 | 类型 | 是否必传 | 备注 |
| --------------------- | ------ | -------- | ---------- |
| totalChargingDegree | String | Y | 总充电电量 |
| totalChargingAmount | String | Y | 总充电费用 |
| totalChargingQuantity | String | Y | 总充电笔数 |
| totalPileQuantity | String | Y | 总设备数量 |
| totalMemberAmount | String | Y | 总客户余额 |
## 8002 订单
> 请求地址：http://localhost:8080/index/getOrderInfo
>
> 请求方式：POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| --------- | ------ | -------- | ------ |
| stationId | String | N | 站点id |
### 反参
| 字段名 | 类型 | 是否必传 | 备注 |
| -------------------------- | ------ | -------- | -------------- |
| date | String | Y | 日期 |
| totalElectricity | String | Y | 总用电量 |
| totalOrderAmount | String | Y | 总订单金额 |
| totalSharpUsedElectricity | String | Y | 尖时段总用电量 |
| totalPeakUsedElectricity | String | Y | 峰时段总用电量 |
| totalFlatUsedElectricity | String | Y | 平时段总用电量 |
| totalValleyUsedElectricity | String | Y | 谷时段总用电量 |
# 个人桩相关
## 9001 用户绑定个人桩
> 请求地址： http://localhost:8080/uniapp/personalPile/pileMemberBinding
>
> 请求方式： POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| ---------------- | ------ | -------- | -------------- |
| pileSn | String | Y | 桩编码 |
| phoneNumber | String | Y | 用户手机号码 |
| verificationCode | String | Y | 用户手机验证码 |
### 反参
## 9002 桩管理员下发给其他用户
> 请求地址：http://localhost:8080/uniapp/personalPile/adminIssuePile
>
> 请求方式： POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------- | ------ | -------- | -------------------- |
| PileSn | String | Y | 桩编码 |
| phoneNumber | String | Y | 另一个用户的手机号码 |
## 9003 获取个人桩列表
> 请求地址： http://localhost:8080/uniapp/personalPile/getPersonalPileList
>
> 请求方式： GET
### 反参
### List<PersonalPileInfoVO>
| 字段名 | 类型 | 是否必传 | 备注 |
| ------------ | ------ | -------- | ---------------------------- |
| pileSn | String | Y | 桩编码 |
| connectorNum | String | Y | 枪口数量==(2023.02.23新增)== |
| memberId | String | Y | 会员id |
| type | String | Y | 身份类型 |
| modelName | String | Y | 型号 |
| ratedPower | String | Y | 额定功率 |
| ratedCurrent | String | Y | 额定电流 |
| ratedVoltage | String | Y | 额定电压 |
| speedType | String | Y | 充电类型 |
## 9004 获取枪口实时数据
> 请求地址：http://localhost:8080/uniapp/personalPile/getConnectorRealTimeInfo
>
> 请求方式：POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------------- | ------ | -------- | -------- |
| pileConnectorCode | String | Y | 桩枪口号 |
### 反参
| 字段名 | 类型 | 是否必传 | 备注 |
| -------------- | ------ | -------- | -------- |
| instantCurrent | Number | Y | 实时电流 |
| instantVoltage | Number | Y | 实时电压 |
| instantPower | Number | Y | 实时功率 |
## 9005 累积充电量数据
> 请求地址：http://localhost:8080/uniapp/personalPile/getAccumulativeInfo
>
> 请求方式：POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------------- | ------ | -------- | -------- |
| pileConnectorCode | String | Y | 桩枪口号 |
| startTime | String | Y | 开始日期 |
| endTime | String | Y | 结束日期 |
### 反参
| 字段名 | 类型 | 是否必传 | 备注 |
| ---------------------- | ------ | -------- | ------------ |
| memberId | String | Y | 会员id |
| startTime | String | Y | 开始日期 |
| endTime | String | Y | 结束日期 |
| sumChargingElectricity | String | Y | 累计充电量 |
| sumChargingTime | String | Y | 累计充电时长 |
## 9006 充电记录
请求地址：http://localhost:8080/uniapp/personalPile/getChargingRecord
请求方式：POST
### 入参
| 字段名 | 类型 | 是否必传 | 备注 |
| ----------------- | ------ | -------- | -------- |
| pileConnectorCode | String | Y | 桩枪口号 |
| pageNum | Number | Y | 页码 |
| pageSize | Number | Y | 每页数量 |
### 反参
| 字段名 | 类型 | 是否必传 | 备注 |
| ------------------- | ------ | -------- | -------- |
| startChargingTime | String | Y | 启动时间 |
| endChargingTime | String | Y | 结束时间 |
| chargingElectricity | String | Y | 用电量 |
| chargingTime | String | Y | 充电时长 |

5
doc/测试问题.md Normal file
View File

@@ -0,0 +1,5 @@
# 测试问题
1、充电桩型号表 pile_model_info ==speed_type== 和==charger_pile_type==字段，在前台新增桩型号时未设置值
2、用户正常开始充电后，桩由于意外情况清除订单记录，此时后台该订单一直为充电中状态，用户的开始扣款金额无法退回