============================================================
|
接口变更说明(相对当前已提交代码)
|
日期: 2026-06-26 版本: v3.0.1 作者: rk
|
依据: git 工作区相对 master 已提交代码的实际差异
|
============================================================
|
|
|
【管理端 platform】(Shiro 鉴权)
|
------------------------------------------------------------
|
新增接口:
|
一、抖音核销配置(加在既有 SystemDictDataController,/system/dictData)
|
1. POST /system/dictData/getDouyinConfigDTO
|
查询抖音核销配置(四项字典值)。无入参。
|
2. POST /system/dictData/updateDouyinAppConfigDTO
|
更新抖音应用配置(client_key/client_secret/account_id)。
|
入参(body):clientKey / clientSecret / accountId
|
3. POST /system/dictData/updateDouyinPoiIdDTO
|
更新核销门店ID(单门店)。
|
入参(query):poiId
|
|
二、抖音券核销(新文件 DouyinVerifyController,/business/douyinVerify)
|
4. POST /business/douyinVerify/page 核销记录分页(对外)
|
5. POST /business/douyinVerify/poiList 查询抖音商户下门店ID列表(无入参,返回 List<String>)
|
6. POST /business/douyinVerify/cancel 撤销核销(管理端,不受1小时限制)
|
|
三、抖音商品(新文件 DouyinProductController,/business/douyinProduct)
|
7. POST /business/douyinProduct/sync 从抖音同步商品(全量)
|
8. POST /business/douyinProduct/page 分页查询
|
9. GET /business/douyinProduct/{id} 根据ID查询(含SKU)
|
10. POST /business/douyinProduct/bindDiscount 绑定/解绑本地套餐
|
|
四、数据报表(新文件 ReportController,/business/report)
|
鉴权:无 @RequiresPermissions,仅 Shiro 登录校验,登录后台即可访问。
|
Service 复用 services 模块 ReportService(与 web 端 /web/report 同源)。
|
11. GET /business/report/incomeStat30 近30天收益统计(按日柱状图+累计+环比/同比)
|
12. GET /business/report/bikeUsageStat 车辆使用情况(自行车/电动车 × 使用中/空闲;禁用车辆排除)
|
13. GET /business/report/packageSourceStat 套餐销售来源(本月/本年 × 抖音兑换/小程序购买)
|
14. GET /business/report/dashboard 综合看板(本月/昨日/今日收益+订单数+车辆总数+客户数)
|
|
各接口出参字段:
|
· incomeStat30 → IncomeStatVO(dailyList/totalIncome/环比/同比),固定近30天,无入参
|
· bikeUsageStat → BikeUsageStatVO:bikeIdle/bikeInUse/eleBikeIdle/eleBikeInUse
|
· packageSourceStat → PackageSourceStatVO:month{douyinCount,miniCount} + year{douyinCount,miniCount}
|
· dashboard → DashboardVO:monthIncome/yesterdayIncome/todayIncome(元)
|
+ monthOrderCount/yesterdayOrderCount/todayOrderCount
|
+ totalBikeCount + totalMemberCount/yesterdayNewMember/todayNewMember
|
|
|
============================================================
|
|
【接口端 web】(JWT 鉴权)
|
------------------------------------------------------------
|
新增接口:
|
一、抖音(新文件 DouyinApi,/web/douyin)
|
1. GET /web/douyin/testQuery 联调测试:从抖音全量同步商品入库
|
2. GET /web/douyin/testPoiList 联调测试:查询抖音商户下门店ID列表(返回 List<String>)
|
3. POST /web/douyin/scanVerify 扫码一步核销(验券准备+核销合并)。@LoginRequired + @PreventRepeat
|
入参(body):qrContent(扫码内容)/ code(券码明文)二选一 + poiId(门店ID,选填)
|
4. POST /web/douyin/page 核销记录分页。@LoginRequired
|
5. GET /web/douyin/{id} 核销记录详情。@LoginRequired
|
|
二、数据报表(新文件 ReportController,/web/report,从管理端迁回)
|
鉴权:JWT + 管理员校验(需登录且 user.sysuser 非空,否则 NOT_ALLOWED)
|
6. GET /web/report/overview 概览统计
|
7. POST /web/report/bikeIncome 收入车型分析
|
8. POST /web/report/incomeStat 收入统计
|
9. GET /web/report/operationCenter 运营中心数据
|
10. POST /web/report/operationOrderPage 运营中心订单查询(分页)
|
11. GET /web/report/orderRides 订单骑行记录+轨迹
|
|
|
变化接口:
|
1. GET /web/home/home 返回值新增字段
|
HomeResponse 新增:douyinExchangeTips(抖音券兑换说明,String)
|
入参无变化,仅返回体增加一个字段(值来自字典 DOUYIN_EXCHANGE_TIPS)。
|
|
|
============================================================
|
说明:
|
- 上述清单基于 git 工作区实际差异(DouyinApi / ReportController /
|
DouyinVerifyController / DouyinProductController 均为新增文件,
|
在已提交代码中不存在;SystemDictDataController、HomeResponse 为既有文件被修改)。
|
- 相关数据库变更见 db/changeSql.sql(抖音商品/核销记录/操作日志/轨迹表 +
|
DOUYIN_CONFIG / DOUYIN_EXCHANGE_TIPS 字典项)。
|
============================================================
|
